Class HandlerInterceptor.PreparedInterceptedHandler

java.lang.Object

io.fluxzero.sdk.tracking.handling.HandlerInterceptor.PreparedInterceptedHandler

All Implemented Interfaces:

Handler<DeserializingMessage>

Enclosing interface:

HandlerInterceptor

public static class HandlerInterceptor.PreparedInterceptedHandler
extends Object
implements Handler<DeserializingMessage>

Merged wrapper for interceptors that explicitly support method preparation.

Nested Class Summary

Nested classes/interfaces inherited from interface Handler

Handler.DelegatingHandler<M>

Constructor Summary

Constructors

Constructor	Description
PreparedInterceptedHandler(Handler<DeserializingMessage> delegate, HandlerInterceptor interceptor)

Method Summary

Modifier and Type	Method	Description
HandlerMethod<DeserializingMessage>	getHandlerMethodOrNull(DeserializingMessage message)	Returns a reusable HandlerMethod capable of processing the given message, or null when unavailable.
HandlerMethodPlanner<DeserializingMessage>	getHandlerMethodPlanner()	Returns the planner used to select and prepare this handler's methods.
HandlerMethodPlan<DeserializingMessage>	getHandlerMethodPlanOrNull(DeserializingMessage message)	Returns a reusable plan for the handler method selected for this message.
Optional<HandlerInvoker>	getInvoker(DeserializingMessage message)	Returns a HandlerInvoker capable of processing the given message, if available.
HandlerInvoker	getInvokerOrNull(DeserializingMessage message)	Returns a HandlerInvoker capable of processing the given message, or null when unavailable.
Class<?>	getTargetClass()	Returns the class of the handler's target object.
String	toString()

Methods inherited from class Object

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

Methods inherited from interface Handler

or

Constructor Details

PreparedInterceptedHandler

public PreparedInterceptedHandler(Handler<DeserializingMessage> delegate,
 HandlerInterceptor interceptor)

Method Details

getInvoker

public Optional<HandlerInvoker> getInvoker(DeserializingMessage message)

Description copied from interface: Handler

Returns a HandlerInvoker capable of processing the given message, if available.

Specified by:

getInvoker in interface Handler<DeserializingMessage>

Parameters:

message - the message to be handled

Returns:

an optional HandlerInvoker if this handler can handle the message; otherwise Optional.empty()

getInvokerOrNull

public HandlerInvoker getInvokerOrNull(DeserializingMessage message)

Description copied from interface: Handler

Returns a HandlerInvoker capable of processing the given message, or null when unavailable.

This is a lower-allocation counterpart to Handler.getInvoker(Object) for internal hot paths. Implementations that can resolve an invoker without creating an Optional should override this method.

Specified by:

getInvokerOrNull in interface Handler<DeserializingMessage>

Parameters:

message - the message to be handled

Returns:

an invoker if this handler can handle the message; null otherwise

getHandlerMethodOrNull

public HandlerMethod<DeserializingMessage> getHandlerMethodOrNull(DeserializingMessage message)

Description copied from interface: Handler

Returns a reusable HandlerMethod capable of processing the given message, or null when unavailable.

This is an optional lower-allocation path for handlers whose target and method plan can be reused across messages. Implementations that cannot expose a stable method should return null and rely on Handler.getInvokerOrNull(Object).

Specified by:

getHandlerMethodOrNull in interface Handler<DeserializingMessage>

Parameters:

message - the message to be handled

Returns:

a handler method if this handler can handle the message through a reusable method; null otherwise

getHandlerMethodPlanOrNull

public HandlerMethodPlan<DeserializingMessage> getHandlerMethodPlanOrNull(DeserializingMessage message)

Description copied from interface: Handler

Returns a reusable plan for the handler method selected for this message.

The default asks Handler.getHandlerMethodPlanner() to prepare the plan. A null result means that this handler cannot safely prepare the invocation, so the caller should use Handler.getInvokerOrNull(Object) or Handler.getHandlerMethodOrNull(Object) instead.

Specified by:

getHandlerMethodPlanOrNull in interface Handler<DeserializingMessage>

Parameters:

message - the message to match

Returns:

the prepared invocation plan, or null when preparation is unsupported or no method matches

getHandlerMethodPlanner

public HandlerMethodPlanner<DeserializingMessage> getHandlerMethodPlanner()

Description copied from interface: Handler

Returns the planner used to select and prepare this handler's methods.

The returned planner may be cached and invoked concurrently. The default returns null, which keeps implementations that only support regular per-message matching fully compatible.

Specified by:

getHandlerMethodPlanner in interface Handler<DeserializingMessage>

Returns:

a thread-safe handler method planner, or null when this handler does not support preparation

getTargetClass

public Class<?> getTargetClass()

Description copied from interface: Handler

Returns the class of the handler's target object. This may be used for reflective operations, logging, or framework-level behavior.

Specified by:

getTargetClass in interface Handler<DeserializingMessage>

Returns:

the class of the handler's target

toString

public String toString()

Overrides:

toString in class Object