Class ValidatingInterceptor

java.lang.Object

io.fluxzero.sdk.tracking.handling.validation.ValidatingInterceptor

All Implemented Interfaces:

HandlerDecorator, HandlerInterceptor

public class ValidatingInterceptor
extends Object
implements HandlerInterceptor

A HandlerInterceptor that validates the payload of messages before they are handled. When the supplied validator supports contextual method constraints, the current message context can be used to resolve constrained method parameters.

Nested Class Summary

Nested classes/interfaces inherited from interface HandlerDecorator

HandlerDecorator.MergedDecorator

Nested classes/interfaces inherited from interface HandlerInterceptor

HandlerInterceptor.InterceptedHandler, HandlerInterceptor.PreparedHandlerFunction, HandlerInterceptor.PreparedHandlerInputFunction, HandlerInterceptor.PreparedHandlerInputInterceptor, HandlerInterceptor.PreparedHandlerInterceptor, HandlerInterceptor.PreparedInterceptedHandler

Field Summary

Fields inherited from interface HandlerDecorator

noOp

Fields inherited from interface HandlerInterceptor

defaultInterceptors

Constructor Summary

Constructors

Constructor	Description
ValidatingInterceptor()	Creates an interceptor backed by the default validator.
ValidatingInterceptor(Validator validator)	Creates an interceptor backed by the supplied validator.
ValidatingInterceptor(Validator validator, boolean validatePayload)	Creates an interceptor backed by the supplied validator.

Method Summary

Modifier and Type	Method	Description
Function<DeserializingMessage, Object>	interceptHandling(Function<DeserializingMessage, Object> function, io.fluxzero.common.handling.HandlerInvoker invoker)	Wraps handler invocation with payload validation before invocation.
HandlerInterceptor.PreparedHandlerInterceptor	prepare(io.fluxzero.common.handling.HandlerDescriptor handler)	Prepares this interceptor for a specific handler method.
HandlerInterceptor.PreparedHandlerInputInterceptor	prepareInput(io.fluxzero.common.handling.HandlerDescriptor handler)	Prepares this interceptor to run without first creating a complete message.
HandlerInterceptor.PreparedHandlerInputInterceptor	prepareInput(io.fluxzero.common.handling.HandlerDescriptor handler, io.fluxzero.common.handling.HandlerInput<DeserializingMessage> preparedInput)	Prepares this interceptor using both the selected handler method and a representative input.
boolean	supportsPreparation()	Indicates whether this interceptor opts into the prepared, mergeable handler wrapper.

Methods inherited from class Object

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

Methods inherited from interface HandlerDecorator

andThen

Methods inherited from interface HandlerInterceptor

wrap

Constructor Details

ValidatingInterceptor

public ValidatingInterceptor()

Creates an interceptor backed by the default validator.

ValidatingInterceptor

public ValidatingInterceptor(Validator validator)

Creates an interceptor backed by the supplied validator.

Parameters:

validator - the validator to use for payload and return value validation

ValidatingInterceptor

public ValidatingInterceptor(Validator validator,
 boolean validatePayload)

Creates an interceptor backed by the supplied validator.

Parameters:

validator - the validator to use for validation

validatePayload - whether incoming message payloads should be validated before handler invocation

Method Details

interceptHandling

public Function<DeserializingMessage, Object> interceptHandling(Function<DeserializingMessage, Object> function,
 io.fluxzero.common.handling.HandlerInvoker invoker)

Wraps handler invocation with payload validation before invocation. Non-passive request handlers with a method annotation also get return value validation when the handler method declares return constraints.

Specified by:

interceptHandling in interface HandlerInterceptor

Parameters:

function - handler invocation function

invoker - handler metadata and invocation context

Returns:

a validating handler invocation function

prepare

public HandlerInterceptor.PreparedHandlerInterceptor prepare(io.fluxzero.common.handling.HandlerDescriptor handler)

Description copied from interface: HandlerInterceptor

Prepares this interceptor for a specific handler method.

The returned interceptor is cached and reused concurrently for invocations with the same stable handler metadata. Implementations may use this hook to resolve annotation- or signature-based policy once while keeping message-dependent decisions inside HandlerInterceptor.PreparedHandlerInterceptor.interceptHandling(DeserializingMessage, HandlerDescriptor, BiFunction, HandlerInterceptor.PreparedHandlerFunction).

The default adapter preserves the existing HandlerInterceptor.interceptHandling(Function, HandlerInvoker) contract and deliberately disables the reusable HandlerMethod path. Custom interceptors therefore retain their current behavior unless they explicitly opt into preparation.

Specified by:

prepare in interface HandlerInterceptor

Parameters:

handler - stable metadata for the handler method

Returns:

a thread-safe prepared interceptor

prepareInput

public HandlerInterceptor.PreparedHandlerInputInterceptor prepareInput(io.fluxzero.common.handling.HandlerDescriptor handler)

Description copied from interface: HandlerInterceptor

Prepares this interceptor to run without first creating a complete message.

Return null when the interceptor requires the regular message-based handling path. The default only supports an interceptor whose prepared behavior is the shared no-op policy, so existing interceptors retain their exact behavior unless they opt in explicitly.

The returned policy may be cached and invoked concurrently.

Specified by:

prepareInput in interface HandlerInterceptor

Parameters:

handler - stable information about the selected handler method

Returns:

a thread-safe payload-first policy, or null to use regular message-based handling

prepareInput

public HandlerInterceptor.PreparedHandlerInputInterceptor prepareInput(io.fluxzero.common.handling.HandlerDescriptor handler,
 io.fluxzero.common.handling.HandlerInput<DeserializingMessage> preparedInput)

Description copied from interface: HandlerInterceptor

Prepares this interceptor using both the selected handler method and a representative input.

Override this overload when the interceptor's ability to use payload-first handling depends on input characteristics. The default delegates to HandlerInterceptor.prepareInput(HandlerDescriptor).

Specified by:

prepareInput in interface HandlerInterceptor

Parameters:

handler - stable information about the selected handler method

preparedInput - a representative input for the prepared handler plan

Returns:

a thread-safe payload-first policy, or null to use regular message-based handling

supportsPreparation

public boolean supportsPreparation()

Description copied from interface: HandlerInterceptor

Indicates whether this interceptor opts into the prepared, mergeable handler wrapper.

The default is false, preserving the exact wrapper behavior of existing custom interceptors. An interceptor should return true only when HandlerInterceptor.prepare(HandlerDescriptor) returns a thread-safe plan that fully represents its handling behavior. If a subclass overrides only the legacy HandlerInterceptor.interceptHandling(Function, HandlerInvoker) method, the legacy wrapper is retained automatically.

Specified by:

supportsPreparation in interface HandlerInterceptor

Returns:

true when this interceptor may be merged into a prepared wrapper