Class Exception
- java.lang.Object
-
- 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 classException
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 ofRuntimeException
are checked exceptions. Checked exceptions need to be declared in a method or constructor'sthrows
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 withnull
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
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
Exception
public Exception()
Constructs a new exception withnull
as its detail message. The cause is not initialized, and may subsequently be initialized by a call toThrowable.initCause(java.lang.Throwable)
.
Exception
public Exception(String message)
Constructs a new exception with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call toThrowable.initCause(java.lang.Throwable)
.- Parameters:
-
message
- the detail message. The detail message is saved for later retrieval by theThrowable.getMessage()
method.
Exception
public Exception(String message, Throwable 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 theThrowable.getMessage()
method). -
cause
- the cause (which is saved for later retrieval by theThrowable.getCause()
method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.) - Since:
- 1.4
Exception
public 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). This constructor is useful for exceptions that are little more than wrappers for other throwables (for example,PrivilegedActionException
).- Parameters:
-
cause
- the cause (which is saved for later retrieval by theThrowable.getCause()
method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.) - Since:
- 1.4
Exception
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.- Parameters:
-
message
- the detail message. -
cause
- the cause. (Anull
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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.