net.openhft.chronicle.core.onoes

Class ChainedExceptionHandler

java.lang.Object

net.openhft.chronicle.core.onoes.ChainedExceptionHandler

All Implemented Interfaces:

ExceptionHandler

public class ChainedExceptionHandler
extends Object
implements ExceptionHandler

Chains exception handlers.

Handlers are evaluated left to right. If a handler throws, the failure is logged at error level and the next handler is called.

Construction prunes instances of IgnoresEverything and unwraps any ThreadLocalisedExceptionHandler.

The chain is immutable and has no internal synchronisation. It is thread-safe provided the supplied handlers are thread-safe.

 ExceptionHandler chain = new ChainedExceptionHandler(
     Slf4jExceptionHandler.ERROR,
     new RecordingExceptionHandler(LogLevel.ERROR, map, true)
 );
 

Constructor Summary

Constructors

Constructor and Description
ChainedExceptionHandler(ExceptionHandler... chain) Creates a new chain of handlers.

Method Summary

Modifier and Type	Method and Description
@NotNull ExceptionHandler[]	chain() Returns the handlers in evaluation order.
void	on(@NotNull Class<?> clazz, @Nullable String message, @Nullable Throwable thrown) Passes the event to each handler.
void	on(@NotNull org.slf4j.Logger logger, @Nullable String message, Throwable thrown) Passes the event to each handler.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.core.onoes.ExceptionHandler

defaultHandler, ignoresEverything, isEnabled, on, on, on

Constructor Detail

ChainedExceptionHandler

public ChainedExceptionHandler(@NotNull
                               ExceptionHandler... chain)

Creates a new chain of handlers.

Parameters:

chain - the handlers to evaluate from left to right

Throws:

NullPointerException - if chain or any element is null

Method Detail

on

public void on(@NotNull
               @NotNull Class<?> clazz,
               @Nullable
               @Nullable String message,
               @Nullable
               @Nullable Throwable thrown)

Passes the event to each handler.

Specified by:

on in interface ExceptionHandler

Parameters:

clazz - the originating class, not null

message - an optional message

thrown - an optional throwable

Throws:

NullPointerException - if clazz is null

on

public void on(@NotNull
               @NotNull org.slf4j.Logger logger,
               @Nullable
               @Nullable String message,
               Throwable thrown)

Passes the event to each handler.

Specified by:

on in interface ExceptionHandler

Parameters:

logger - the logger to use, not null

message - an optional message

thrown - an optional throwable

Throws:

NullPointerException - if logger is null

chain

@NotNull
public @NotNull ExceptionHandler[] chain()

Returns the handlers in evaluation order.

Returns:

the immutable handler array