Package org.apache.tika.utils

Class ExceptionUtils

java.lang.Object

org.apache.tika.utils.ExceptionUtils

public class ExceptionUtils
extends Object

Turns a Throwable into the string Tika reports to callers, under the ExceptionReporting policy in effect. Tika's own channels record and emit exception text through format(Throwable, ParseContext) so that one config setting governs them all; exception text produced by third-party libraries is outside its reach.

NOTE: If your stacktraces are truncated, make sure to start your jvm with: -XX:-OmitStackTraceInFastThrow

Constructor Summary

Constructors

Constructor	Description
ExceptionUtils()

Method Summary

Modifier and Type	Method	Description
static String	format(Throwable t, ExceptionReporting reporting)	Formats t for channels that have no ParseContext, such as server error responses and pipes crash messages.
static String	format(Throwable t, ParseContext context)	Formats t under the ExceptionReporting found in context (or the default policy if the context is null or has none).
static String	getFilteredStackTrace(Throwable t)	Deprecated. since 4.1, removal planned for 5.0; use format(Throwable, ParseContext) so the configured policy applies.
static String	getStackTrace(Throwable t)	Deprecated. since 4.1, removal planned for 5.0; use format(Throwable, ParseContext) so the configured policy applies
static String	truncate(String s, int maxLength)	Truncates s to the policy's ExceptionReporting.getMaxLength() (no-op when unlimited), for channels that report exception text they did not format themselves.

Methods inherited from class java.lang.Object

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

Constructor Details

ExceptionUtils

public ExceptionUtils()

Method Details

format

public static String format(Throwable t,
 ParseContext context)

Formats t under the ExceptionReporting found in context (or the default policy if the context is null or has none).

format

public static String format(Throwable t,
 ExceptionReporting reporting)

Formats t for channels that have no ParseContext, such as server error responses and pipes crash messages.

getFilteredStackTrace

@Deprecated
public static String getFilteredStackTrace(Throwable t)

Deprecated.

since 4.1, removal planned for 5.0; use format(Throwable, ParseContext) so the configured policy applies. Unlike this method, it keeps a bare TikaException wrapper.

getStackTrace

@Deprecated
public static String getStackTrace(Throwable t)

Deprecated.

since 4.1, removal planned for 5.0; use format(Throwable, ParseContext) so the configured policy applies

truncate

public static String truncate(String s,
 int maxLength)

Truncates s to the policy's ExceptionReporting.getMaxLength() (no-op when unlimited), for channels that report exception text they did not format themselves.