java.lang: public class: IllegalStateException

java.lang
public class: IllegalStateException [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         java.lang.RuntimeException
            java.lang.IllegalStateException

All Implemented Interfaces:
Serializable

Direct Known Subclasses:
ConnectionPendingException, FormatterClosedException, NoConnectionPendingException, ClosedWatchServiceException, NonReadableChannelException, NotYetBoundException, AlreadyConnectedException, CancellationException, ClosedFileSystemException, IllegalComponentStateException, CancelledKeyException, ClosedSelectorException, IllegalBlockingModeException, InvalidMarkException, NonWritableChannelException, InvalidDnDOperationException, ClosedDirectoryStreamException, OverlappingFileLockException, NotYetConnectedException

Signals that a method has been invoked at an illegal or inappropriate time. In other words, the Java environment or Java application is not in an appropriate state for the requested operation.

author: Jonni - Kanerva

since: JDK1.1 -

Field Summary
static final long	serialVersionUID

Fields inherited from java.lang.RuntimeException:
serialVersionUID

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public IllegalStateException() { super(); } Constructs an IllegalStateException with no detail message. A detail message is a String that describes this particular exception.
public IllegalStateException(String s) { super(s); } Constructs an IllegalStateException with the specified detail message. A detail message is a String that describes this particular exception. Parameters: `s` - the String that contains a detailed message
public IllegalStateException(Throwable cause) { super(cause); } Constructs a new exception with the specified cause and a detail message of `(cause==null ? null : cause.toString())` (which typically contains the class and detail message of `cause`). This constructor is useful for exceptions that are little more than wrappers for other throwables (for example, java.security.PrivilegedActionException ). Parameters: `cause` - the cause (which is saved for later retrieval by the Throwable#getCause() method). (A `null` value is permitted, and indicates that the cause is nonexistent or unknown.) since: `1.5` -
public IllegalStateException(String message, Throwable cause) { super(message, cause); } Constructs a new exception with the specified detail message and cause. Note that the detail message associated with `cause` is not automatically incorporated in this exception's detail message. Parameters: `message` - the detail message (which is saved for later retrieval by the Throwable#getMessage() method). `cause` - the cause (which is saved for later retrieval by the Throwable#getCause() method). (A `null` value is permitted, and indicates that the cause is nonexistent or unknown.) since: `1.5` -

 public IllegalStateException() {
        super();
}

Constructs an IllegalStateException with no detail message. A detail message is a String that describes this particular exception.

 public IllegalStateException(String s) {
        super(s);
}

Constructs an IllegalStateException with the specified detail message. A detail message is a String that describes this particular exception.

Parameters:

s - the String that contains a detailed message

 public IllegalStateException(Throwable cause) {
        super(cause);
}

(cause==null ? null : cause.toString())

cause

java.security.PrivilegedActionException

Parameters:

cause - the cause (which is saved for later retrieval by the Throwable#getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

since: 1.5 -

 public IllegalStateException(String message,
    Throwable cause) {
        super(message, cause);
}

Note that the detail message associated with cause is not automatically incorporated in this exception's detail message.

Parameters:

message - the detail message (which is saved for later retrieval by the Throwable#getMessage() method).

cause - the cause (which is saved for later retrieval by the Throwable#getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

since: 1.5 -

Methods from java.lang.Throwable:
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getStackTraceDepth, getStackTraceElement, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait