< prev index next >
src/java.desktop/share/classes/java/awt/print/PrinterIOException.java
Print this page
*** 25,41 ****
package java.awt.print;
import java.io.IOException;
/**
! * The <code>PrinterIOException</code> class is a subclass of
* {@link PrinterException} and is used to indicate that an IO error
* of some sort has occurred while printing.
*
* <p>As of release 1.4, this exception has been retrofitted to conform to
* the general purpose exception-chaining mechanism. The
! * "<code>IOException</code> that terminated the print job"
* that is provided at construction time and accessed via the
* {@link #getIOException()} method is now known as the <i>cause</i>,
* and may be accessed via the {@link Throwable#getCause()} method,
* as well as the aforementioned "legacy method."
*/
--- 25,41 ----
package java.awt.print;
import java.io.IOException;
/**
! * The {@code PrinterIOException} class is a subclass of
* {@link PrinterException} and is used to indicate that an IO error
* of some sort has occurred while printing.
*
* <p>As of release 1.4, this exception has been retrofitted to conform to
* the general purpose exception-chaining mechanism. The
! * "{@code IOException} that terminated the print job"
* that is provided at construction time and accessed via the
* {@link #getIOException()} method is now known as the <i>cause</i>,
* and may be accessed via the {@link Throwable#getCause()} method,
* as well as the aforementioned "legacy method."
*/
*** 47,84 ****
* @serial
*/
private IOException mException;
/**
! * Constructs a new <code>PrinterIOException</code>
* with the string representation of the specified
* {@link IOException}.
! * @param exception the specified <code>IOException</code>
*/
public PrinterIOException(IOException exception) {
initCause(null); // Disallow subsequent initCause
mException = exception;
}
/**
! * Returns the <code>IOException</code> that terminated
* the print job.
*
* <p>This method predates the general-purpose exception chaining facility.
* The {@link Throwable#getCause()} method is now the preferred means of
* obtaining this information.
*
! * @return the <code>IOException</code> that terminated
* the print job.
* @see IOException
*/
public IOException getIOException() {
return mException;
}
/**
! * Returns the cause of this exception (the <code>IOException</code>
* that terminated the print job).
*
* @return the cause of this exception.
* @since 1.4
*/
--- 47,84 ----
* @serial
*/
private IOException mException;
/**
! * Constructs a new {@code PrinterIOException}
* with the string representation of the specified
* {@link IOException}.
! * @param exception the specified {@code IOException}
*/
public PrinterIOException(IOException exception) {
initCause(null); // Disallow subsequent initCause
mException = exception;
}
/**
! * Returns the {@code IOException} that terminated
* the print job.
*
* <p>This method predates the general-purpose exception chaining facility.
* The {@link Throwable#getCause()} method is now the preferred means of
* obtaining this information.
*
! * @return the {@code IOException} that terminated
* the print job.
* @see IOException
*/
public IOException getIOException() {
return mException;
}
/**
! * Returns the cause of this exception (the {@code IOException}
* that terminated the print job).
*
* @return the cause of this exception.
* @since 1.4
*/
< prev index next >