Package org.apache.commons.lang

Class NullArgumentException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalArgumentException

org.apache.commons.lang.NullArgumentException

All Implemented Interfaces:

java.io.Serializable

@Deprecated(since="2021-04-30")
public class NullArgumentException
extends java.lang.IllegalArgumentException

Deprecated.

Commons Lang 2 is in maintenance mode. Commons Lang 3 should be used instead.

Thrown to indicate that an argument was null and should not have been. This exception supplements the standard IllegalArgumentException by providing a more semantically rich description of the problem.

NullArgumentException represents the case where a method takes in a parameter that must not be null. Some coding standards would use NullPointerException for this case, others will use IllegalArgumentException. Thus this exception would be used in place of IllegalArgumentException, yet it still extends it.

  public void foo(String str) {
    if (str == null) {
      throw new NullArgumentException("str");
    }
    // do something with the string
  }
  

Since:

2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
NullArgumentException(java.lang.String argName)	Deprecated. Instantiates with the given argument name.

Method Summary

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NullArgumentException

public NullArgumentException(java.lang.String argName)

Deprecated.

Instantiates with the given argument name.

Parameters:

argName - the name of the argument that was null.