FileDocCategorySizeDatePackage
WriteAbortedException.javaAPI DocJava SE 5 API2520Fri Aug 26 14:57:00 BST 2005java.io

WriteAbortedException

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 {@link #detail} field is now known as the cause, and may be accessed via the {@link Throwable#getCause()} method, as well as the aforementioned "legacy field."

author
unascribed
version
1.18, 12/19/03
since
JDK1.1

Fields Summary
static final long
serialVersionUID
public Exception
detail
Exception that was caught while writing the ObjectStream.

This field predates the general-purpose exception chaining facility. The {@link Throwable#getCause()} method is now the preferred means of obtaining this information.

Constructors Summary
public WriteAbortedException(String s, Exception ex)
Constructs a WriteAbortedException with a string describing the exception and the exception causing the abort.

param
s String describing the exception.
param
ex Exception causing the abort.


                                       
         
	super(s);
        initCause(null);  // Disallow subsequent initCause
	detail = ex;
Methods Summary
public java.lang.ThrowablegetCause()
Returns the exception that terminated the operation (the cause).

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

        return detail;
public java.lang.StringgetMessage()
Produce the message and include the message from the nested exception, if there is one.

	if (detail == null)
	    return super.getMessage();
	else
	    return super.getMessage() + "; " + detail.toString();