com.linecorp.armeria.common.util

Class Exceptions

java.lang.Object

com.linecorp.armeria.common.util.Exceptions

public final class Exceptions
extends java.lang.Object

Provides the methods that are useful for handling exceptions.

Method Summary

Modifier and Type	Method and Description
static <T extends java.lang.Throwable> T	clearTrace(T exception) Empties the stack trace of the specified exception.
static boolean	isExpected(java.lang.Throwable cause) Returns true if the specified exception is expected to occur in well-known circumstances.
static boolean	isVerbose() Returns whether the verbose mode is enabled.
static void	logIfUnexpected(org.slf4j.Logger logger, io.netty.channel.Channel ch, SessionProtocol protocol, java.lang.String debugData, java.lang.Throwable cause) Logs the specified exception if it is isExpected(Throwable) unexpected}.
static void	logIfUnexpected(org.slf4j.Logger logger, io.netty.channel.Channel ch, SessionProtocol protocol, java.lang.Throwable cause) Logs the specified exception if it is isExpected(Throwable) unexpected}.
static void	logIfUnexpected(org.slf4j.Logger logger, io.netty.channel.Channel ch, java.lang.String debugData, java.lang.Throwable cause) Logs the specified exception if it is isExpected(Throwable) unexpected}.
static void	logIfUnexpected(org.slf4j.Logger logger, io.netty.channel.Channel ch, java.lang.Throwable cause) Logs the specified exception if it is isExpected(Throwable) unexpected}.
static java.lang.String	traceText(java.lang.Throwable exception) Deprecated. Use Throwables.getStackTraceAsString(Throwable).

Methods inherited from class java.lang.Object

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

Method Detail

isVerbose

public static boolean isVerbose()

Returns whether the verbose mode is enabled. When enabled, the exceptions frequently thrown by Armeria will have full stack trace. When disabled, such exceptions will have empty stack trace to eliminate the cost of capturing the stack trace.

The verbose mode is disabled by default. Specify the -Dcom.linecorp.armeria.verboseExceptions=true JVM option to enable it.

logIfUnexpected

public static void logIfUnexpected(org.slf4j.Logger logger,
                                   io.netty.channel.Channel ch,
                                   java.lang.Throwable cause)

Logs the specified exception if it is isExpected(Throwable) unexpected}.

logIfUnexpected

public static void logIfUnexpected(org.slf4j.Logger logger,
                                   io.netty.channel.Channel ch,
                                   java.lang.String debugData,
                                   java.lang.Throwable cause)

Logs the specified exception if it is isExpected(Throwable) unexpected}.

logIfUnexpected

public static void logIfUnexpected(org.slf4j.Logger logger,
                                   io.netty.channel.Channel ch,
                                   SessionProtocol protocol,
                                   java.lang.Throwable cause)

Logs the specified exception if it is isExpected(Throwable) unexpected}.

logIfUnexpected

public static void logIfUnexpected(org.slf4j.Logger logger,
                                   io.netty.channel.Channel ch,
                                   SessionProtocol protocol,
                                   java.lang.String debugData,
                                   java.lang.Throwable cause)

Logs the specified exception if it is isExpected(Throwable) unexpected}.

isExpected

public static boolean isExpected(java.lang.Throwable cause)

Returns true if the specified exception is expected to occur in well-known circumstances.

• ClosedChannelException
• ClosedSessionException
• IOException - 'Connection reset/closed/aborted by peer'
• 'Broken pipe'
• Http2Exception - 'Stream closed'

clearTrace

public static <T extends java.lang.Throwable> T clearTrace(T exception)

Empties the stack trace of the specified exception.

traceText

@Deprecated
public static java.lang.String traceText(java.lang.Throwable exception)

Deprecated. Use Throwables.getStackTraceAsString(Throwable).

Returns the stack trace of the specified exception as a String instead.