Package org.apache.tika.pipes.fork

Class PipesForkParserException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.apache.tika.exception.TikaException

org.apache.tika.pipes.fork.PipesForkParserException

All Implemented Interfaces:

Serializable

public class PipesForkParserException
extends TikaException

Exception thrown when PipesForkParser encounters an application error.

This exception is thrown for application-level errors that indicate infrastructure or configuration problems:

• Initialization failures (parser, fetcher, or emitter initialization)
• Configuration errors (fetcher or emitter not found)
• Client unavailable (no forked process available within timeout)

The following are NOT thrown as exceptions:

• Process crashes (OOM, timeout) - returned in result, next parse will automatically restart the forked process
• Per-document failures (fetch exception, parse exception) - returned in result so caller can handle gracefully

See Also:

• PipesForkResult.isProcessCrash()
• PipesForkResult#isApplicationError()
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
PipesForkParserException(PipesResult.RESULT_STATUS status, String message)	Creates a new exception with the given status and message.
PipesForkParserException(PipesResult.RESULT_STATUS status, String message, Throwable cause)	Creates a new exception with the given status, message, and cause.

Method Summary

Modifier and Type	Method	Description
PipesResult.RESULT_STATUS	getStatus()	Get the result status that caused this exception.
boolean	isConfigurationError()	Check if this exception was caused by a configuration error.
boolean	isInitializationFailure()	Check if this exception was caused by an initialization failure.

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 Details

PipesForkParserException

public PipesForkParserException(PipesResult.RESULT_STATUS status,
 String message)

Creates a new exception with the given status and message.

Parameters:

status - the result status that caused this exception

message - the error message

PipesForkParserException

public PipesForkParserException(PipesResult.RESULT_STATUS status,
 String message,
 Throwable cause)

Creates a new exception with the given status, message, and cause.

Parameters:

status - the result status that caused this exception

message - the error message

cause - the underlying cause

Method Details

getStatus

public PipesResult.RESULT_STATUS getStatus()

Get the result status that caused this exception.

Returns:

the result status

isInitializationFailure

public boolean isInitializationFailure()

Check if this exception was caused by an initialization failure.

Returns:

true if initialization failed

isConfigurationError

public boolean isConfigurationError()

Check if this exception was caused by a configuration error.

Returns:

true if there was a configuration error