IllegalStateException (Java Platform SE 7 ) (original) (raw)

• java.lang.Object

• • java.lang.Throwable
  • • java.lang.Exception
      • • java.lang.RuntimeException
          * * java.lang.IllegalStateException

• All Implemented Interfaces:
  Serializable
  Direct Known Subclasses:
  AcceptPendingException, AlreadyBoundException, AlreadyConnectedException, CancellationException, CancelledKeyException, ClosedDirectoryStreamException, ClosedFileSystemException, ClosedSelectorException, ClosedWatchServiceException, ConnectionPendingException, FormatterClosedException, IllegalBlockingModeException, IllegalComponentStateException, InvalidDnDOperationException, InvalidMarkException, NoConnectionPendingException, NonReadableChannelException, NonWritableChannelException, NotYetBoundException, NotYetConnectedException, OverlappingFileLockException, ReadPendingException, ShutdownChannelGroupException, WritePendingException

public class IllegalStateException
extends RuntimeException
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.
Since:
JDK1.1
See Also:
Serialized Form

• • Constructor Summary

  Constructors

  Constructor and Description
  IllegalStateException() Constructs an IllegalStateException with no detail message.
  IllegalStateException(String s) Constructs an IllegalStateException with the specified detail message.
  IllegalStateException(String message,Throwable cause) Constructs a new exception with the specified detail message and cause.
  IllegalStateException(Throwable 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).

  • Method Summary

    * ### Methods inherited from class java.lang.[Throwable](../../java/lang/Throwable.html "class in java.lang")  
    `[addSuppressed](../../java/lang/Throwable.html#addSuppressed%28java.lang.Throwable%29), [fillInStackTrace](../../java/lang/Throwable.html#fillInStackTrace%28%29), [getCause](../../java/lang/Throwable.html#getCause%28%29), [getLocalizedMessage](../../java/lang/Throwable.html#getLocalizedMessage%28%29), [getMessage](../../java/lang/Throwable.html#getMessage%28%29), [getStackTrace](../../java/lang/Throwable.html#getStackTrace%28%29), [getSuppressed](../../java/lang/Throwable.html#getSuppressed%28%29), [initCause](../../java/lang/Throwable.html#initCause%28java.lang.Throwable%29), [printStackTrace](../../java/lang/Throwable.html#printStackTrace%28%29), [printStackTrace](../../java/lang/Throwable.html#printStackTrace%28java.io.PrintStream%29), [printStackTrace](../../java/lang/Throwable.html#printStackTrace%28java.io.PrintWriter%29), [setStackTrace](../../java/lang/Throwable.html#setStackTrace%28java.lang.StackTraceElement[]%29), [toString](../../java/lang/Throwable.html#toString%28%29)`  
    * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
    `[clone](../../java/lang/Object.html#clone%28%29), [equals](../../java/lang/Object.html#equals%28java.lang.Object%29), [finalize](../../java/lang/Object.html#finalize%28%29), [getClass](../../java/lang/Object.html#getClass%28%29), [hashCode](../../java/lang/Object.html#hashCode%28%29), [notify](../../java/lang/Object.html#notify%28%29), [notifyAll](../../java/lang/Object.html#notifyAll%28%29), [wait](../../java/lang/Object.html#wait%28%29), [wait](../../java/lang/Object.html#wait%28long%29), [wait](../../java/lang/Object.html#wait%28long,%20int%29)`

• • Constructor Detail

     * #### IllegalStateException  
     public IllegalStateException()  
     Constructs an IllegalStateException with no detail message. A detail message is a String that describes this particular exception.  
     * #### IllegalStateException  
     public IllegalStateException([String](../../java/lang/String.html "class in java.lang") 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  
     * #### IllegalStateException  
     public IllegalStateException([String](../../java/lang/String.html "class in java.lang") message,  
                          [Throwable](../../java/lang/Throwable.html "class in java.lang") 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()](../../java/lang/Throwable.html#getMessage%28%29) method).  
     `cause` \- the cause (which is saved for later retrieval by the[Throwable.getCause()](../../java/lang/Throwable.html#getCause%28%29) method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)  
     Since:  
     1.5  
     * #### IllegalStateException  
     public IllegalStateException([Throwable](../../java/lang/Throwable.html "class in java.lang") 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, [PrivilegedActionException](../../java/security/PrivilegedActionException.html "class in java.security")).  
     Parameters:  
     `cause` \- the cause (which is saved for later retrieval by the[Throwable.getCause()](../../java/lang/Throwable.html#getCause%28%29) method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)  
     Since:  
     1.5

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.