Class HandlerInvoker.DelegatingHandlerInvoker

java.lang.Object

io.fluxzero.common.handling.HandlerInvoker.DelegatingHandlerInvoker

All Implemented Interfaces:

HandlerDescriptor, HandlerInvoker

Enclosing interface:

HandlerInvoker

public abstract static class HandlerInvoker.DelegatingHandlerInvoker
extends Object
implements HandlerInvoker

A HandlerInvoker that delegates all behavior to another instance. This is commonly used to wrap or extend behavior without altering core logic.

Nested Class Summary

Nested classes/interfaces inherited from interface HandlerInvoker

HandlerInvoker.DelegatingHandlerInvoker, HandlerInvoker.SimpleInvoker

Field Summary

Fields

Modifier and Type	Field	Description
protected final HandlerInvoker	delegate

Constructor Summary

Constructors

Constructor	Description
DelegatingHandlerInvoker()

Method Summary

Modifier and Type	Method	Description
boolean	expectResult()	Indicates whether the handler method has a return value.
Executable	getMethod()	The Executable representing the handler method (can be a static or instance Method or Constructor).
<A extends Annotation> A	getMethodAnnotation()	Retrieves a specific annotation from the handler method, if present.
Class<?>	getTargetClass()	The target class that contains the handler method.
boolean	isPassive()	Indicates whether this handler operates in passive mode (i.e., results will not be published).
boolean	isSkipPending()	Whether a deferred invocation has yet to decide if it will be skipped.
boolean	maySkip()	Whether this invoker can silently skip after selection, possibly during asynchronous completion.
void	onSkipDecision(Runnable callback)	Runs a callback when the pending skip decision is available, including a silent refusal.
String	toString()
boolean	wasSkipped()	Indicates whether this invocation was deliberately skipped after handler selection.

Methods inherited from class Object

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

Methods inherited from interface HandlerInvoker

andFinally, invoke, invoke

Field Details

delegate

protected final HandlerInvoker delegate

Constructor Details

DelegatingHandlerInvoker

public DelegatingHandlerInvoker()

Method Details

getTargetClass

public Class<?> getTargetClass()

Description copied from interface: HandlerInvoker

The target class that contains the handler method.

Specified by:

getTargetClass in interface HandlerDescriptor

Specified by:

getTargetClass in interface HandlerInvoker

Returns:

the declaring class of the handler

getMethod

public Executable getMethod()

Description copied from interface: HandlerInvoker

The Executable representing the handler method (can be a static or instance Method or Constructor).

Specified by:

getMethod in interface HandlerDescriptor

Specified by:

getMethod in interface HandlerInvoker

Returns:

the executable method

getMethodAnnotation

public <A extends Annotation> A getMethodAnnotation()

Description copied from interface: HandlerInvoker

Retrieves a specific annotation from the handler method, if present.

Specified by:

getMethodAnnotation in interface HandlerDescriptor

Specified by:

getMethodAnnotation in interface HandlerInvoker

Type Parameters:

A - the annotation type

Returns:

the annotation instance, or null if not found

expectResult

public boolean expectResult()

Description copied from interface: HandlerInvoker

Indicates whether the handler method has a return value.

This is based on the method's signature: if it returns void, this returns false; otherwise, it returns true.

Specified by:

expectResult in interface HandlerDescriptor

Specified by:

expectResult in interface HandlerInvoker

Returns:

true if the method returns a value; false if it is void

isPassive

public boolean isPassive()

Description copied from interface: HandlerInvoker

Indicates whether this handler operates in passive mode (i.e., results will not be published).

Specified by:

isPassive in interface HandlerDescriptor

Specified by:

isPassive in interface HandlerInvoker

Returns:

true if passive; otherwise false

maySkip

public boolean maySkip()

Description copied from interface: HandlerInvoker

Whether this invoker can silently skip after selection, possibly during asynchronous completion. Callers that publish a result must recheck HandlerInvoker.wasSkipped() after the result completes in that case.

Specified by:

maySkip in interface HandlerInvoker

isSkipPending

public boolean isSkipPending()

Description copied from interface: HandlerInvoker

Whether a deferred invocation has yet to decide if it will be skipped. Local mirroring must wait for that decision, but may proceed immediately once authorization has allowed the handler to start.

Specified by:

isSkipPending in interface HandlerInvoker

onSkipDecision

public void onSkipDecision(Runnable callback)

Description copied from interface: HandlerInvoker

Runs a callback when the pending skip decision is available, including a silent refusal. The callback may run on the completing thread; callers own context propagation. Ordinary invokers invoke it immediately.

Specified by:

onSkipDecision in interface HandlerInvoker

wasSkipped

public boolean wasSkipped()

Description copied from interface: HandlerInvoker

Indicates whether this invocation was deliberately skipped after handler selection.

Specified by:

wasSkipped in interface HandlerInvoker

Returns:

true if the underlying handler method was not invoked

toString

public String toString()

Overrides:

toString in class Object