Guice之bindInterceptor

bindInterceptor` 是 Guice 框架中用于绑定方法拦截器的 API。这个方法允许你为匹配特定条件的方法设置一个拦截器，当这些方法被调用时，拦截器中的代码会被执行。

方法签名

bindInterceptor 的方法签名如下：

void bindInterceptor(Matcher<? super Class<?>> classMatcher,
                     Matcher<? super Method> methodMatcher,
                     MethodInterceptor... interceptors);

• classMatcher: 用于匹配类的条件。只有匹配该条件的类中的方法才会被拦截器处理。
• methodMatcher: 用于匹配方法的条件。只有当类已匹配classMatcher时，类中匹配该条件的方法才会被拦截器处理。
• interceptors: 一个或多个MethodInterceptor实例，当匹配的方法被调用时，这些拦截器会按照指定的顺序执行。

如何工作

当 Guice 创建一个对象实例时，它会检查这个对象的类以及其方法是否与通过bindInterceptor设定的匹配器相匹配。如果匹配，Guice 会为这个对象创建一个代理，并在代理中插入拦截器逻辑。当代理对象上的方法被调用时，拦截器的逻辑会被执行。

拦截器执行流程

1. 方法调用：当调用一个被拦截的方法时，方法的调用会首先被代理捕获。
2. 拦截器链：拦截器链中的每个MethodInterceptor会按照绑定时的顺序被调用。
3. invoke 方法：拦截器中的invoke方法会被执行。拦截器可以在调用原始方法之前或之后执行自定义逻辑。
4. 原始方法执行：通过MethodInvocation.proceed()调用原始方法。
5. 返回结果：方法的执行结果会被返回给调用者，经过拦截器链的处理。

示例

以下是一个使用bindInterceptor绑定拦截器的示例：

public class LoggingInterceptor implements MethodInterceptor {
    @Override
    public Object invoke(MethodInvocation invocation) throws Throwable {
        System.out.println("Before method: " + invocation.getMethod().getName());
        Object result = invocation.proceed();
        System.out.println("After method: " + invocation.getMethod().getName());
        return result;
    }
}

public class AopModule extends AbstractModule {
    @Override
    protected void configure() {
        MethodInterceptor interceptor = new LoggingInterceptor();
        // 绑定拦截器到所有类的所有公共方法
        bindInterceptor(Matchers.any(), Matchers.any(), interceptor);
    }
}

在这个例子中，LoggingInterceptor会在任何类的任何方法被调用之前和之后打印日志。Matchers.any()是一个匹配所有对象的匹配器。

注意事项

• 拦截器只会作用于通过 Guice 创建的对象。如果你直接使用new关键字创建对象，拦截器不会被应用。
• bindInterceptor需要在 Guice 模块的configure方法中调用。
• 你可以使用更复杂的匹配器来精细控制哪些类和方法被拦截。
• 方法拦截器会增加额外的运行时开销，因此应当谨慎使用。