引介 (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")