java.io: public class: WriteAbortedException

java.io
public class: WriteAbortedException [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         java.io.IOException
            java.io.ObjectStreamException
               java.io.WriteAbortedException

All Implemented Interfaces:
Serializable

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."

author: unascribed -

since: JDK1.1 -

Field Summary
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. serial:

Field Summary

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.

serial:

Fields inherited from java.io.IOException:
serialVersionUID

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public WriteAbortedException(String s, Exception ex) { super(s); initCause(null); // Disallow subsequent initCause detail = 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.

 public WriteAbortedException(String s,
    Exception ex) {
                                       
        super(s);
        initCause(null);  // Disallow subsequent initCause
        detail = 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 from java.io.WriteAbortedException Summary:
getCause, getMessage

Methods from java.lang.Throwable:
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from java.io.WriteAbortedException Detail:
public Throwable getCause() { return detail; } Returns the exception that terminated the operation (the cause).
public String getMessage() { if (detail == null) return super.getMessage(); else return super.getMessage() + "; " + detail.toString(); } Produce the message and include the message from the nested exception, if there is one.

Method from java.io.WriteAbortedException Detail:

 public Throwable getCause() {
        return detail;
}

cause

 public String getMessage() {
        if (detail == null)
            return super.getMessage();
        else
            return super.getMessage() + "; " + detail.toString();
}

Produce the message and include the message from the nested exception, if there is one.