java.lang
Class IllegalArgumentException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              java.lang.IllegalArgumentException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

IllegalCharsetNameException, IllegalFormatException, IllegalSelectorException, IllegalThreadStateException, InvalidKeyException, InvalidOpenTypeException, InvalidParameterException, KeyAlreadyExistsException, NumberFormatException, PatternSyntaxException, UnresolvedAddressException, UnsupportedAddressTypeException, UnsupportedCharsetException

public class IllegalArgumentException
extends RuntimeException

IllegalArgumentException is thrown when a method is called with an illegal argument value.

See Also:

Serialized Form

Constructor Summary

IllegalArgumentException()
Constructor for an IllegalArgumentException with no detail message.

IllegalArgumentException(String s)
Constructor for an IllegalArgumentException with given detail message.

IllegalArgumentException(String message, Throwable cause)
Constructs a IllegalArgumentException using the specified error message, which should give further details as to the reason for this exception.

IllegalArgumentException(Throwable cause)
Constructs a IllegalArgumentException using the specified cause Throwable, which may be used to provide additional history, with regards to the root of the problem.

Method Summary

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

IllegalArgumentException

public IllegalArgumentException()

Constructor for an IllegalArgumentException with no detail message.

IllegalArgumentException

public IllegalArgumentException(String s)

Constructor for an IllegalArgumentException with given detail message.

ensures

    (s != null IMPLIES getMessage().equals(s));
 

Parameters:

s - the detail message.

IllegalArgumentException

public IllegalArgumentException(String message,
                                Throwable cause)

Constructs a IllegalArgumentException using the specified error message, which should give further details as to the reason for this exception. The specified cause Throwable may be used to provide additional history, with regards to the root of the problem. It is perfectly valid for this to be null, if the cause of the problem is unknown.

Note: the detail message from the cause is not automatically incorporated into the resulting detail message of this exception.

Parameters:

message - the detail message, which should give the reason for

                this exception being thrown.
 

cause - the cause of this exception, or null if the cause

              is unknown.
 

Since:

1.5

IllegalArgumentException

public IllegalArgumentException(Throwable cause)

Constructs a IllegalArgumentException using the specified cause Throwable, which may be used to provide additional history, with regards to the root of the problem. It is perfectly valid for this to be null, if the cause of the problem is unknown.

The detail message is automatically constructed from the detail message of the supplied causal exception. If the cause is null, then the detail message will also be null. Otherwise, the detail message of this exception will be that of the causal exception. This makes this constructor very useful for simply wrapping another exception.

Parameters:

cause - the cause of this exception, or null if the cause

              is unknown.
 

Since:

1.5