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

InstanceExceptionHandlerEntry

internal data class InstanceExceptionHandlerEntry(val target: WeakReference<Any>, val invoker: InstanceExceptionInvokers, val priority: Int) : ExceptionHandlerEntry

Internal representation of an instance-bound exception handler.

An InstanceExceptionHandlerEntry binds a discovered @ExceptionHandler method to a specific subscriber object. The subscriber is held via a WeakReference, allowing it to be garbage-collected without requiring an explicit unsubscribe call. When the target is collected, the entry is treated as invalid and can be pruned during normal cache maintenance.

Constructors

constructor(target: WeakReference<Any>, invoker: InstanceExceptionInvokers, priority: Int)

Properties

invoker

open override val invoker: InstanceExceptionInvokers

the compiled InstanceExceptionInvokers strategy used to invoke the handler on target.

priority

open override val priority: Int

execution ordering hint; higher values are invoked before lower values when multiple handlers match the same failure.

target

val target: WeakReference<Any>

a weak reference to the subscriber instance that owns the exception handler method.

Functions

specificityRank

private fun ExceptionHandlerEntry.specificityRank(): Int

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