java.time.format

Class DateTimePrintException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.time.DateTimeException

java.time.format.DateTimePrintException

All Implemented Interfaces:

java.io.Serializable

public class DateTimePrintException
extends DateTimeException

An exception thrown when an error occurs during printing.

This will be triggered by violations specific to printing or an IO exception.

Specification for implementors

This class is intended for use in a single thread.

Since:

1.8

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DateTimePrintException(java.lang.String message) Constructs a new exception with the specified message.
DateTimePrintException(java.lang.String message, java.lang.Throwable cause) Constructs a new exception with the specified message and cause.

Method Summary

Modifier and Type	Method and Description
void	rethrowIOException() Checks if the cause of this exception was an IOException, and if so re-throws it

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DateTimePrintException

public DateTimePrintException(java.lang.String message)

Constructs a new exception with the specified message.

Parameters:

message - the message to use for this exception, may be null

DateTimePrintException

public DateTimePrintException(java.lang.String message,
                      java.lang.Throwable cause)

Constructs a new exception with the specified message and cause.

Parameters:

message - the message to use for this exception, may be null

cause - the cause of the exception, may be null

Method Detail

rethrowIOException

public void rethrowIOException()
                        throws java.io.IOException

Checks if the cause of this exception was an IOException, and if so re-throws it

This method is useful if you call a printer with an open stream or writer and want to ensure that IOExceptions are not lost.

 try {
   printer.print(writer, dateTime);
 } catch (DateTimePrintException ex) {
   ex.rethrowIOException();
   // if code reaches here exception was caused by date-time issues
 }
 

Note that calling this method will re-throw the original IOException, causing this DateTimePrintException to be lost.

Throws:

java.io.IOException - if the cause of this exception is an IOException