实现该接口的对象可以从自定义的 Advice 类型创建 AOP Alliance 拦截器， * 从而使得这些 Advice 类型可以在 Spring AOP 框架中使用，该框架在底层使用拦截。 * *
大多数 Spring 用户无需实现此接口；只有在需要向 Spring 引入更多的 Advisor 或 Advice 类型时才需要这样做。 * * @author Rod Johnson */ public interface AdvisorAdapter { /** * 此适配器是否了解该通知对象？是否可以使用 Advisor 包含此通知作为参数调用 getInterceptors 方法？ * @param advice 一个 Advice，如 BeforeAdvice * @return 此适配器是否了解给定的 Advice 对象 * @see #getInterceptor(org.springframework.aop.Advisor) * @see org.springframework.aop.BeforeAdvice */ boolean supportsAdvice(Advice advice); /** * 返回一个 AOP Alliance MethodInterceptor，将给定 Advice 的行为暴露给基于拦截的 AOP 框架。 *
不必担心 Advisor 中包含的 Pointcut；AOP 框架将负责检查切点。 * @param advisor Advisor。supportsAdvice() 方法必须在此对象上返回 true * @return 此 Advisor 的 AOP Alliance 拦截器。无需为效率缓存实例，因为 AOP 框架会缓存 Advice 链。 */ MethodInterceptor getInterceptor(Advisor advisor); } ``` ### 五、主要实现 1. **MethodBeforeAdviceAdapter** + 用于将 `MethodBeforeAdvice` 类型的通知适配到 Spring AOP 拦截器链中。`MethodBeforeAdvice` 是一个在目标方法执行前执行的通知接口。 2. **ThrowsAdviceAdapter** + 用于将 `ThrowsAdvice` 类型的通知适配到 Spring AOP 拦截器链中。`ThrowsAdvice` 通知用于捕获目标方法抛出的异常。 3. **AfterReturningAdviceAdapter** + 用于将 `AfterReturningAdvice` 类型的通知适配到 Spring AOP 拦截器链中。`AfterReturningAdvice` 通知在目标方法正常返回后执行。 ### 六、最佳实践 用自定义的 AdvisorAdapter 和 Advice 来实现对目标方法的增强。在示例中，首先注册了一个自定义的 AdvisorAdapter（NullReturningAdviceAdapter），然后创建了一个代理工厂（ProxyFactory）并向其添加了一个自定义的通知（MyNullReturningAdvice）。最后，通过代理工厂获取了代理对象，并调用了两个方法，其中一个方法会触发通知，另一个方法不会触发通知。 ```java public class AdvisorAdapterDemo { public static void main(String[] args) { // 注册自定义适配器 GlobalAdvisorAdapterRegistry.getInstance().registerAdvisorAdapter(new NullReturningAdviceAdapter()); // 创建代理工厂 ProxyFactory proxyFactory = new ProxyFactory(new MyService()); // 添加Advisor proxyFactory.addAdvice(new MyNullReturningAdvice()); // 获取代理对象 MyService proxy = (MyService) proxyFactory.getProxy(); // 不会触发通知 System.out.println("foo return value : " + proxy.foo()); // 换行 System.out.println(); // 会触发通知 System.out.println("bar return value : " + proxy.bar()); } } ``` 一个空返回通知的适配器，用于将空返回通知（NullReturningAdvice）适配到拦截器链中。它实现了 AdvisorAdapter 接口，包含了支持给定通知和获取方法拦截器的功能，以便将特定类型的通知行为暴露给基于拦截的 AOP 框架。 ```java /** * 空返回通知适配器，用于将空返回通知（NullReturningAdvice）适配到拦截器链中。 */ public class NullReturningAdviceAdapter implements AdvisorAdapter { /** * 判断该适配器是否支持给定的通知。 * @param advice 一个通知，如空返回通知（NullReturningAdvice） * @return 如果该适配器支持给定的通知，则返回 true；否则返回 false */ @Override public boolean supportsAdvice(Advice advice) { return (advice instanceof NullReturningAdvice); } /** * 获取一个方法拦截器，将给定的通知行为暴露给基于拦截的 AOP 框架。 * @param advisor Advisor。supportsAdvice() 方法必须在此对象上返回 true * @return 给定 Advisor 的方法拦截器 */ @Override public MethodInterceptor getInterceptor(Advisor advisor) { NullReturningAdvice advice = (NullReturningAdvice) advisor.getAdvice(); return new NullReturningAdviceInterceptor(advice); } } ``` 一个空返回通知拦截器，用于在方法执行后检查返回值是否为空，并根据情况执行空返回通知的逻辑。它实现了 MethodInterceptor 和 AfterAdvice 接口，通过拦截方法调用后的返回值来判断是否需要执行空返回通知，并在必要时调用空返回通知的逻辑。 ```java /** * 空返回通知拦截器，用于在方法执行后检查返回值是否为空，并根据情况执行空返回通知的逻辑。 */ public class NullReturningAdviceInterceptor implements MethodInterceptor, AfterAdvice { /** 空返回通知 */ private final NullReturningAdvice advice; /** * 构造一个空返回通知拦截器。 * @param advice 空返回通知 */ public NullReturningAdviceInterceptor(NullReturningAdvice advice) { Assert.notNull(advice, "Advice must not be null"); this.advice = advice; } /** * 在方法执行后拦截，检查返回值是否为空，并根据情况执行空返回通知的逻辑。 * @param mi 方法调用信息 * @return 方法执行结果，如果返回值为空，则根据空返回通知执行后的返回值 * @throws Throwable 如果方法调用过程中发生异常，则抛出异常 */ @Override public Object invoke(MethodInvocation mi) throws Throwable { // 执行方法调用，获取返回值 Object retVal = mi.proceed(); // 如果返回值为空，则根据空返回通知执行后的返回值 if (retVal == null) { retVal = this.advice.nullReturning(mi.getMethod(), mi.getArguments(), mi.getThis()); } return retVal; } } ``` 一个空返回通知的定义，继承了 AfterAdvice 接口。它包含了一个方法 nullReturning，用于在目标方法返回值为空时执行相应的逻辑，并返回一个新的返回值。 ```java /** * 空返回通知接口，继承自 AfterAdvice。 */ public interface NullReturningAdvice extends AfterAdvice { /** * 当目标方法返回值为空时调用的方法。 * @param method 目标方法 * @param args 方法参数 * @param target 目标对象 * @return 空返回通知执行后的返回值 * @throws Throwable 如果在执行空返回通知的过程中发生异常，则抛出异常 */ Object nullReturning(Method method, Object[] args, @Nullable Object target) throws Throwable; } ``` 实现了`NullReturningAdvice`空返回通知接口，用于在目标方法返回值为空时执行特定逻辑。在 nullReturning 方法中，它打印出被调用的方法名称，并返回一个默认的字符串值。 ```java public class MyNullReturningAdvice implements NullReturningAdvice { @Override public Object nullReturning(Method method, Object[] args, Object target) throws Throwable { System.out.println("Null Returning method " + method.getName() + " is called."); return "hello default value"; } } ``` 简单的服务类，包含了两个方法 foo 和 bar。foo 方法执行后返回字符串 "hello foo"，而 bar 方法执行后返回 null。 ```java public class MyService { public String foo() { System.out.println("Executing foo method"); return "hello foo"; } public String bar() { System.out.println("Executing bar method"); return null; } } ``` 运行结果，调用了 foo 方法，它返回 "hello foo"；然后调用了 bar 方法，由于其返回值为 null，因此触发了空返回通知，打印了相应的消息，并返回了默认值 "hello default value"。 ```java Executing foo method foo return value : hello foo Executing bar method Null Returning method bar is called. bar return value : hello default value ``` ### 七、源码分析 暂无 ### 八、常见问题 1. **如何实现自定义的 AdvisorAdapter？** - 我们想要实现自定义的 `AdvisorAdapter` 接口以支持特定类型的通知。在这种情况下，他们需要了解如何适配不同类型的通知到拦截器链中，并确保适配器的实现正确地处理目标方法的执行。 2. **如何注册自定义的 AdvisorAdapter？** - 一旦实现了自定义的 `AdvisorAdapter` 接口，我们需要知道如何将其注册到 Spring AOP 框架中，以便在应用中使用。这涉及到配置文件、注解或编程方式的注册。 3. **适配器的执行顺序是如何确定的？** - 当一个目标方法被调用时，多个适配器会被调用以适配不同类型的通知。我们会关心适配器的执行顺序以确保通知被正确地应用。在 Spring AOP 中，通常使用 AdvisorAdapterRegistry 来管理适配器，并且它通常遵循注册的顺序来决定适配器的执行顺序。 4. **如何处理支持多种类型通知的适配器？** - 有些适配器支持多种类型的通知。在这种情况下，我们需要了解如何确保适配器可以正确地识别和处理不同类型的通知，并将其适配到拦截器链中。 5. **如何处理不支持的通知类型？** - 在某些情况下，会出现不支持的通知类型。我们需要了解如何处理这种情况，例如抛出异常或忽略不支持的通知类型。