引介 (Introductions)

引介(在 AspectJ 中称为 inter-type declarations)使切面能够声明被通知对象实现给定接口,并代表这些对象提供该接口的实现。

你可以使用 @DeclareParents 注解进行引介。此注解用于声明匹配类型具有新的父级(因此得名)。例如,给定一个名为 UsageTracked 的接口和该接口的一个实现 DefaultUsageTracked,以下切面声明所有服务接口的实现类也实现 UsageTracked 接口(例如,用于通过 JMX 进行统计)

  • Java

  • Kotlin

@Aspect
public class UsageTracking {

	@DeclareParents(value="com.xyz.service.*+", defaultImpl=DefaultUsageTracked.class)
	public static UsageTracked mixin;

	@Before("execution(* com.xyz..service.*.*(..)) && this(usageTracked)")
	public void recordUsage(UsageTracked usageTracked) {
		usageTracked.incrementUseCount();
	}

}
@Aspect
class UsageTracking {

	companion object {
		@DeclareParents(value = "com.xyz.service.*+",
			defaultImpl = DefaultUsageTracked::class)
		lateinit var mixin: UsageTracked
	}

	@Before("execution(* com.xyz..service.*.*(..)) && this(usageTracked)")
	fun recordUsage(usageTracked: UsageTracked) {
		usageTracked.incrementUseCount()
	}
}

要实现的接口由注解字段的类型决定。@DeclareParents 注解的 value 属性是一个 AspectJ 类型模式。任何匹配类型的 bean 都实现了 UsageTracked 接口。请注意,在前面示例的 before advice 中,服务 bean 可以直接用作 UsageTracked 接口的实现。如果以编程式方式访问 bean,你可以按如下方式编写

  • Java

  • Kotlin

UsageTracked usageTracked = context.getBean("myService", UsageTracked.class);
val usageTracked = context.getBean<UsageTracked>("myService")