Class WriteAbortedException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.io.IOException
-
- java.io.ObjectStreamException
-
- java.io.WriteAbortedException
- All Implemented Interfaces:
Serializable
public class WriteAbortedException extends ObjectStreamException
Signals that one of the ObjectStreamExceptions was thrown during a write operation. Thrown during a read operation when one of the ObjectStreamExceptions was thrown during a write operation. The exception that terminated the write can be found in the detail field. The stream is reset to it's initial state and all references to objects already deserialized are discarded.
As of release 1.4, this exception has been retrofitted to conform to the general purpose exception-chaining mechanism. The "exception causing the abort" that is provided at construction time and accessed via the public detail
field is now known as the cause, and may be accessed via the Throwable.getCause()
method, as well as the aforementioned "legacy field."
- Since:
- 1.1
- See Also:
- Serialized Form
Field Summary
Modifier and Type | Field | Description |
---|---|---|
Exception | detail | Exception that was caught while writing the ObjectStream. |
Constructor Summary
Constructor | Description |
---|---|
WriteAbortedException(String s,
Exception ex) | Constructs a WriteAbortedException with a string describing the exception and the exception causing the abort. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
Throwable | getCause() | Returns the exception that terminated the operation (the cause). |
String | getMessage() | Produce the message and include the message from the nested exception, if there is one. |
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Field Detail
detail
public Exception detail
Exception that was caught while writing the ObjectStream.
This field predates the general-purpose exception chaining facility. The Throwable.getCause()
method is now the preferred means of obtaining this information.
Constructor Detail
WriteAbortedException
public WriteAbortedException(String s, Exception ex)
Constructs a WriteAbortedException with a string describing the exception and the exception causing the abort.
- Parameters:
-
s
- String describing the exception. -
ex
- Exception causing the abort.
Method Detail
getMessage
public String getMessage()
Produce the message and include the message from the nested exception, if there is one.
- Overrides:
-
getMessage
in classThrowable
- Returns:
- the detail message string of this
Throwable
instance (which may benull
).
getCause
public Throwable getCause()
Returns the exception that terminated the operation (the cause).