com.agentclientprotocol.sdk.agent.support.interceptor

接口 AcpInterceptor

public interface AcpInterceptor

Interceptor interface for ACP handler invocations.

Interceptors allow cross-cutting concerns to be applied to handler invocations. Common uses include logging, metrics, authentication, and error handling.

The lifecycle methods are called in this order:

1. preInvoke(com.agentclientprotocol.sdk.agent.support.AcpInvocationContext) - before handler invocation (all interceptors)
2. Handler method execution
3. postInvoke(com.agentclientprotocol.sdk.agent.support.AcpInvocationContext, java.lang.Object) - after successful invocation (reverse order)
4. OR onError(com.agentclientprotocol.sdk.agent.support.AcpInvocationContext, java.lang.Throwable) - if an exception occurred (reverse order)
5. afterCompletion(com.agentclientprotocol.sdk.agent.support.AcpInvocationContext) - always called for cleanup (reverse order)

从以下版本开始:

1.0.0

另请参阅:

InterceptorChain

字段概要

字段

限定符和类型	字段和说明
static int	DEFAULT_ORDER Default order value for interceptors (middle priority).

方法概要

限定符和类型	方法和说明
default void	afterCompletion(AcpInvocationContext context) Called after invocation completes (success or failure).
default int	getOrder() Get the order of this interceptor.
default java.lang.Object	onError(AcpInvocationContext context, java.lang.Throwable ex) Called when handler throws an exception.
default java.lang.Object	postInvoke(AcpInvocationContext context, java.lang.Object result) Called after successful handler invocation.
default boolean	preInvoke(AcpInvocationContext context) Called before handler invocation.

字段详细资料

DEFAULT_ORDER

static final int DEFAULT_ORDER

Default order value for interceptors (middle priority).

另请参阅:

常量字段值

方法详细资料

getOrder

default int getOrder()

Get the order of this interceptor. Lower values execute first.

返回:

the order value

preInvoke

default boolean preInvoke(AcpInvocationContext context)

Called before handler invocation.

参数:

context - the invocation context

返回:

true to continue, false to abort invocation

postInvoke

default java.lang.Object postInvoke(AcpInvocationContext context,
                                    java.lang.Object result)

Called after successful handler invocation.

参数:

context - the invocation context

result - the handler result

返回:

the (possibly modified) result

onError

default java.lang.Object onError(AcpInvocationContext context,
                                 java.lang.Throwable ex)

Called when handler throws an exception.

参数:

context - the invocation context

ex - the exception

返回:

replacement result (non-null to suppress exception), or null to propagate

afterCompletion

default void afterCompletion(AcpInvocationContext context)

Called after invocation completes (success or failure). Always called for interceptors that had their preInvoke succeed. Use for resource cleanup.

参数:

context - the invocation context