WriteAbortedException (Java 2 Platform SE 5.0) (original) (raw)

java.lang.Object extended by 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:

JDK1.1

See Also:

Serialized Form

Field Summary
Exception	detail Exception that was caught while writing the ObjectStream.

Constructor Summary
[WriteAbortedException](../../java/io/WriteAbortedException.html#WriteAbortedException%28java.lang.String, java.lang.Exception%29)(String s,Exception ex) Constructs a WriteAbortedException with a string describing the exception and the exception causing the abort.

Method Summary
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 inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

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](../../java/lang/Throwable.html#getMessage%28%29) in class [Throwable](../../java/lang/Throwable.html "class in java.lang")

Returns:

the detail message string of this Throwable instance (which may be null).

getCause

public Throwable getCause()

Returns the exception that terminated the operation (the cause).

Overrides:

[getCause](../../java/lang/Throwable.html#getCause%28%29) in class [Throwable](../../java/lang/Throwable.html "class in java.lang")

Returns:

the exception that terminated the operation (the cause), which may be null.

Since:

1.4

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.