Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

java.lang
Class IllegalArgumentException  view IllegalArgumentException download IllegalArgumentException.java

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended byjava.lang.IllegalArgumentException
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
IllegalThreadStateException, NumberFormatException

public class IllegalArgumentException
extends RuntimeException

Thrown when a method is passed an illegal or inappropriate argument. For example:

 wait(-1);
 


Nested Class Summary
 
Nested classes inherited from class java.lang.Throwable
 
Field Summary
private static long serialVersionUID
          Compatible with JDK 1.0+.
 
Fields inherited from class java.lang.Throwable
 
Constructor Summary
IllegalArgumentException()
          Create an exception without a message.
IllegalArgumentException(String s)
          Create an exception with a 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.
 
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
 

Field Detail

serialVersionUID

private static final long serialVersionUID
Compatible with JDK 1.0+.

See Also:
Constant Field Values
Constructor Detail

IllegalArgumentException

public IllegalArgumentException()
Create an exception without a message.


IllegalArgumentException

public IllegalArgumentException(String s)
Create an exception with a 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.

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.

Since:
1.5