Exception (Java Platform SE 7 ) (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, 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 and 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%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
* #### 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%28java.lang.Throwable%29). * #### 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%28java.lang.Throwable%29). Parameters: `message` \- the detail message. The detail message is saved for later retrieval by the [Throwable.getMessage()](../../java/lang/Throwable.html#getMessage%28%29) 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%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.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%28%29) 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, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.