IllegalStateException (Java Platform SE 8 ) (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	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-java.lang.Throwable-), [fillInStackTrace](../../java/lang/Throwable.html#fillInStackTrace--), [getCause](../../java/lang/Throwable.html#getCause--), [getLocalizedMessage](../../java/lang/Throwable.html#getLocalizedMessage--), [getMessage](../../java/lang/Throwable.html#getMessage--), [getStackTrace](../../java/lang/Throwable.html#getStackTrace--), [getSuppressed](../../java/lang/Throwable.html#getSuppressed--), [initCause](../../java/lang/Throwable.html#initCause-java.lang.Throwable-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace--), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-), [setStackTrace](../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-), [toString](../../java/lang/Throwable.html#toString--)`  
    * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
    `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`

• • 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--) method).  
     `cause` \- the cause (which is saved for later retrieval by the[Throwable.getCause()](../../java/lang/Throwable.html#getCause--) 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--) 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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.