Package com.tnsai.rag

Class DocumentProcessingException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.tnsai.rag.DocumentProcessingException

All Implemented Interfaces:

Serializable

public final class DocumentProcessingException
extends RuntimeException

Typed failure for document detection, extraction, and chunking.

The public message contains declaration identity, source URI, effective format, and a framework-controlled detail only. Document bytes and extracted content are never interpolated into it.

Since:

0.13.0

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	DocumentProcessingException.Stage	Stable stages across the document-ingestion pipeline.

Constructor Summary

Constructors

Constructor	Description
DocumentProcessingException(DocumentProcessingException.Stage stage, String sourceName, URI source, DocumentFormat format, String detail)	Creates a typed document-processing failure.
DocumentProcessingException(DocumentProcessingException.Stage stage, String sourceName, URI source, DocumentFormat format, String detail, Throwable cause)	Creates a typed document-processing failure with an underlying cause.

Method Summary

Modifier and Type	Method	Description
DocumentFormat	format()	Returns the effective format, or AUTO when detection failed.
URI	source()	Returns the canonical source URI.
String	sourceName()	Returns the knowledge-source declaration name.
DocumentProcessingException.Stage	stage()	Returns the stable pipeline stage.

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

DocumentProcessingException

public DocumentProcessingException(DocumentProcessingException.Stage stage,
 String sourceName,
 URI source,
 DocumentFormat format,
 String detail)

Creates a typed document-processing failure.

Parameters:

stage - failing pipeline stage

sourceName - knowledge-source declaration name

source - canonical source URI

format - effective format, or AUTO when detection failed

detail - framework-controlled diagnostic detail

DocumentProcessingException

public DocumentProcessingException(DocumentProcessingException.Stage stage,
 String sourceName,
 URI source,
 DocumentFormat format,
 String detail,
 Throwable cause)

Creates a typed document-processing failure with an underlying cause.

Parameters:

stage - failing pipeline stage

sourceName - knowledge-source declaration name

source - canonical source URI

format - effective format, or AUTO when detection failed

detail - framework-controlled diagnostic detail

cause - original failure

Method Details

stage

public DocumentProcessingException.Stage stage()

Returns the stable pipeline stage.

sourceName

public String sourceName()

Returns the knowledge-source declaration name.

source

public URI source()

Returns the canonical source URI.

format

public DocumentFormat format()

Returns the effective format, or AUTO when detection failed.