Package com.nsdev.lettergenerator.exception

Class PdfGenerationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.nsdev.lettergenerator.exception.LetterPdfException

com.nsdev.lettergenerator.exception.PdfGenerationException

All Implemented Interfaces:

Serializable

public final class PdfGenerationException
extends LetterPdfException

Indicates failure while composing, laying out, rendering or post-processing a PDF. The generator returns no PDF byte array when this exception is thrown. Its cause can provide engine or watermark-processing details; invalid input detected by validation instead uses InvalidLetterException.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
PdfGenerationException(String message, Throwable cause)	Creates a rendering failure while retaining its underlying cause.
PdfGenerationException(String message, Throwable cause, List<Diagnostic> diagnostics)	Creates a rejected layout with classified errors and its underlying cause.

Method Summary

Modifier and Type	Method	Description
List<Diagnostic>	diagnostics()

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

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

PdfGenerationException

public PdfGenerationException(String message,
 Throwable cause)

Creates a rendering failure while retaining its underlying cause.

Parameters:

message - diagnostic describing the failed generation stage, or null

cause - underlying engine or post-processing failure, or null

PdfGenerationException

public PdfGenerationException(String message,
 Throwable cause,
 List<Diagnostic> diagnostics)

Creates a rejected layout with classified errors and its underlying cause.

Parameters:

message - readable failure explanation

cause - underlying engine failure

diagnostics - structured errors, snapshotted

Method Details

diagnostics

public List<Diagnostic> diagnostics()

Returns:

immutable layout errors, empty for unclassified processing failures