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

An implementation of ExceptionHandler that chains multiple ExceptionHandler objects to be invoked in sequence.

This class encapsulates an ordered collection of ExceptionHandler instances and calls each of them in turn when an exception occurs. If an ExceptionHandler in the chain itself throws an exception, this exception will be logged and the next ExceptionHandler in the chain will be called.

When constructing a new instance, all ExceptionHandlers that are instances of IgnoresEverything will be filtered out. Furthermore, any ExceptionHandler that is an instance of ThreadLocalisedExceptionHandler will be unwrapped to its underlying ExceptionHandler.

Constructor Summary

Constructors

Constructor and Description
ChainedExceptionHandler(ExceptionHandler... chain)

Method Summary

Modifier and Type	Method and Description
@NotNull ExceptionHandler[]	chain()
void	on(@NotNull Class<?> clazz, @Nullable String message, @Nullable Throwable thrown) The default method to call when an exception occurs.
void	on(@NotNull org.slf4j.Logger logger, @Nullable String message, Throwable thrown) Handles an exception occurred with a specific logger, message and throwable.

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)

Method Detail

on

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

Description copied from interface: ExceptionHandler

The default method to call when an exception occurs. It attempts to log the exception using SLF4J, and if this fails, it falls back to a secondary logging mechanism.

Specified by:

on in interface ExceptionHandler

Parameters:

clazz - the class where the exception occurred. Must not be null.

message - a custom message providing additional information about the exception, or an empty string if not available.

thrown - the exception that needs to be handled, or null if there is no exception.

on

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

Description copied from interface: ExceptionHandler

Handles an exception occurred with a specific logger, message and throwable.

Specified by:

on in interface ExceptionHandler

Parameters:

logger - the logger instance to log the error. Must not be null.

message - a custom message detailing the error, or null.

thrown - the throwable instance representing the error, or null.

chain

@NotNull
public @NotNull ExceptionHandler[] chain()