event-library/com.smushytaco.event_library.internal.handlers/ExceptionHandlerEntryWithThrowable

ExceptionHandlerEntryWithThrowable

internal sealed interface ExceptionHandlerEntryWithThrowable : ExceptionHandlerEntry

Marker base type for exception handler entries that declare a throwable parameter in their method signature.

This is implemented by:

InstanceExceptionHandlerEntryWithThrowable for instance-bound handlers.
StaticExceptionHandlerEntryWithThrowable for static handlers.

Handlers represented by this type correspond to @ExceptionHandler methods with one of the following shapes:

(event: Event, throwable: Throwable)
(throwable: Throwable)

The throwableType records the declared throwable parameter type (e.g. IOException, NullPointerException, Throwable). At dispatch time, the event system uses this to perform polymorphic matching:

a handler is considered compatible if throwableType.isInstance(actualThrowable) is true.

Handlers without a throwable parameter (i.e. (event: Event) signatures) are represented by plain ExceptionHandlerEntry instead.

Inheritors

InstanceExceptionHandlerEntryWithThrowable

StaticExceptionHandlerEntryWithThrowable

Properties

invoker

abstract val invoker: ExceptionInvoker

strategy object responsible for invoking the underlying exception handler method when an event handler fails.

priority

abstract val priority: Int

execution ordering hint; larger values are dispatched first.

throwableType

abstract val throwableType: Class<out Throwable>

the concrete throwable type declared on the handler method. Used for filtering based on the actual thrown exception.

Functions

specificityRank

private fun ExceptionHandlerEntry.specificityRank(): Int

Computes a relative "specificity" rank for this exception handler entry.