Exception (Java Platform SE 8 ) (original) (raw)
- java.lang.Throwable
- java.lang.Exception
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
AclNotFoundException, ActivationException, AlreadyBoundException, ApplicationException, AWTException, BackingStoreException, BadAttributeValueExpException, BadBinaryOpValueExpException, BadLocationException, BadStringOperationException, BrokenBarrierException, CertificateException, CloneNotSupportedException, DataFormatException, DatatypeConfigurationException, DestroyFailedException, ExecutionException, ExpandVetoException, FontFormatException, GeneralSecurityException, GSSException, IllegalClassFormatException, InterruptedException, IntrospectionException, InvalidApplicationException, InvalidMidiDataException, InvalidPreferencesFormatException, InvalidTargetObjectTypeException, IOException, JAXBException, JMException, KeySelectorException, LambdaConversionException, LastOwnerException, LineUnavailableException, MarshalException, MidiUnavailableException, MimeTypeParseException, MimeTypeParseException, NamingException, NoninvertibleTransformException, NotBoundException, NotOwnerException, ParseException, ParserConfigurationException, PrinterException, PrintException, PrivilegedActionException, PropertyVetoException, ReflectiveOperationException, RefreshFailedException, RemarshalException, RuntimeException, SAXException, ScriptException, ServerNotActiveException, SOAPException, SQLException, TimeoutException, TooManyListenersException, TransformerException, TransformException, UnmodifiableClassException, UnsupportedAudioFileException, UnsupportedCallbackException, UnsupportedFlavorException, UnsupportedLookAndFeelException, URIReferenceException, URISyntaxException, UserException, XAException, XMLParseException, XMLSignatureException, XMLStreamException, XPathException
public class Exception
extends Throwable
The class Exception and its subclasses are a form ofThrowable that indicates conditions that a reasonable application might want to catch.
The class Exception and any subclasses that are not also subclasses of RuntimeException are checked exceptions. Checked exceptions need to be declared in a method or constructor's throws clause if they can be thrown by the execution of the method or constructor and propagate outside the method or constructor boundary.
Since:
JDK1.0
See Also:
Error, Serialized Form
See The Java™ Language Specification:
11.2 Compile-Time Checking of Exceptions
Constructor Summary
Constructors
Modifier Constructor Description Exception() Constructs a new exception with null as its detail message. Exception(String message) Constructs a new exception with the specified detail message. Exception(String message,Throwable cause) Constructs a new exception with the specified detail message and cause. protected Exception(String message,Throwable cause, boolean enableSuppression, boolean writableStackTrace) Constructs a new exception with the specified detail message, cause, suppression enabled or disabled, and writable stack trace enabled or disabled. Exception(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
* #### Exception public Exception() Constructs a new exception with `null` as its detail message. The cause is not initialized, and may subsequently be initialized by a call to [Throwable.initCause(java.lang.Throwable)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-). * #### Exception public Exception([String](../../java/lang/String.html "class in java.lang") message) Constructs a new exception with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to [Throwable.initCause(java.lang.Throwable)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-). Parameters: `message` \- the detail message. The detail message is saved for later retrieval by the [Throwable.getMessage()](../../java/lang/Throwable.html#getMessage--) method. * #### Exception public Exception([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.4 * #### Exception public Exception([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.4 * #### Exception protected Exception([String](../../java/lang/String.html "class in java.lang") message, [Throwable](../../java/lang/Throwable.html "class in java.lang") cause, boolean enableSuppression, boolean writableStackTrace) Constructs a new exception with the specified detail message, cause, suppression enabled or disabled, and writable stack trace enabled or disabled. Parameters: `message` \- the detail message. `cause` \- the cause. (A `null` value is permitted, and indicates that the cause is nonexistent or unknown.) `enableSuppression` \- whether or not suppression is enabled or disabled `writableStackTrace` \- whether or not the stack trace should be writable Since: 1.7
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.