Spring-AOP @AspectJ切点函数之@annotation()

@annotation()概述

@annotation表示标注了某个注解的所有方法。

下面通过一个实例说明@annotation()的用法。 AnnotationTestAspect定义了一个后置切面增强，该增强将应用到标注了NeedTest的目标方法中。

---

实例

代码已托管到Github—> https://github.com/yangshangwei/SpringMaster

首先我们先自定义一个注解@NeedTest。

如何自定义注解请参考Java-Java5.0注解解读

package com.xgj.aop.spring.advisor.aspectJ.function;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 
 * 
 * @ClassName: NeedTest
 * 
 * @Description: 自定义注解@NeedTest
 * 
 * @author: Mr.Yang
 * 
 * @date: 2017年8月26日 下午11:19:12
 */

// 声明注解的保留期限
@Retention(RetentionPolicy.RUNTIME)
// 声明可以使用该注解的目标类型
@Target(ElementType.METHOD)
@Documented
public @interface NeedTest {
	// 声明注解成员
	boolean value() default false;
}

下面我们定义接口 Waiter

package com.xgj.aop.spring.advisor.aspectJ.function;

public interface Waiter {
	public void greetTo(String clientName);

	public void serverTo(String clientName);
}

接口实现类 两个NaiveWaiter 和 NaughtWaiter

package com.xgj.aop.spring.advisor.aspectJ.function;

public class NaiveWaiter implements Waiter {

	@NeedTest(true)
	@Override
	public void greetTo(String clientName) {
		System.out.println("NaiveWaiter:greet to " + clientName);
	}

	@Override
	public void serverTo(String clientName) {
		System.out.println("NaiveWaiter:server to " + clientName);
	}

	public void smile(String clientName, int times) {
		System.out.println("NaiveWaiter:smile to  " + clientName + " " + times
				+ " times");
	}
}

package com.xgj.aop.spring.advisor.aspectJ.function;

public class NaughtWaiter implements Waiter {

	@Override
	public void greetTo(String clientName) {
		System.out.println("NaughtWaiter:greet to " + clientName);
	}

	@NeedTest(true)
	@Override
	public void serverTo(String clientName) {
		System.out.println("NaughtWaiter:server to " + clientName);
	}

	public void joke(String clientName, int times) {
		System.out.println("NaughtyWaiter:play " + times + " jokes to "
				+ clientName);
	}
}

我们可以看到 NaiveWaiter#greetTo()方法标注了@NeedTest， NaughtWaiter#serverTo()也标注了@NeedTest，我们的目标就是将后置增强织入到这两个标注了@NeedTest的方法中。

---

接下来编写切面的横切逻辑

package com.xgj.aop.spring.advisor.aspectJ.function.annotationFun;

import org.aspectj.lang.annotation.AfterReturning;
import org.aspectj.lang.annotation.Aspect;

/**
 * 
 * 
 * @ClassName: AnnotationTestAspect
 * 
 * @Description: 切面 、 后置增强 ,@annotation表示标注了某个注解的所有方法
 * 
 * @author: Mr.Yang
 * 
 * @date: 2017年8月26日 下午11:23:53
 */

@Aspect
public class AnnotationTestAspect {

	@AfterReturning("@annotation(com.xgj.aop.spring.advisor.aspectJ.function.NeedTest)")
	public void needTest() {
		System.out.println("needTest() executed,some logic is here");
	}

}

接下来通过Spring自动应用切面，配置文件如下

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:aop="http://www.springframework.org/schema/aop"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans 
		http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/aop
		http://www.springframework.org/schema/aop/spring-aop.xsd">

<!-- 使用基于Schema的aop命名空间进行配置 -->
 

<!-- 基于@AspectJ切面的驱动器 -->
<aop:aspectj-autoproxy/>
 
<!-- 目标Bean -->
<bean id="naiveWaiter" class="com.xgj.aop.spring.advisor.aspectJ.function.NaiveWaiter"/>

<bean id="naughtWaiter" class="com.xgj.aop.spring.advisor.aspectJ.function.NaughtWaiter"/>

<!-- 使用了@AspectJ注解的切面类 -->
<bean class="com.xgj.aop.spring.advisor.aspectJ.function.annotationFun.AnnotationTestAspect"/>

</beans>

最后编写测试代码：

package com.xgj.aop.spring.advisor.aspectJ.function.annotationFun;

import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.xgj.aop.spring.advisor.aspectJ.function.Waiter;

public class AnnotationTestAspcetTest {

	@Test
	public void test() {
		ApplicationContext ctx = new ClassPathXmlApplicationContext(
				"com/xgj/aop/spring/advisor/aspectJ/function/annotationFun/conf-annotation.xml");

		// 必须是接口类型,否则抛类型转换异常
		Waiter waiter = (Waiter) ctx.getBean("naiveWaiter");

		// 因为greetTo标注了@NeedTest,因此会被后置增强
		waiter.greetTo("XiaoGongJiang");
		waiter.serverTo("XiaoGongJiang");

		Waiter naughtWaiter = (Waiter) ctx.getBean("naughtWaiter");
		// serverTo标注了@NeedTest,因此会被后置增强
		naughtWaiter.serverTo("XiaoGongJiang");
	}
}

运行结果：

2017-08-27 01:24:22,551  INFO [main] (AbstractApplicationContext.java:583) - Refreshing org.springframework.context.support.ClassPathXmlApplicationContext@6ac604: startup date [Sun Aug 27 01:24:22 BOT 2017]; root of context hierarchy
2017-08-27 01:24:22,647  INFO [main] (XmlBeanDefinitionReader.java:317) - Loading XML bean definitions from class path resource [com/xgj/aop/spring/advisor/aspectJ/function/annotationFun/conf-annotation.xml]
NaiveWaiter:greet to XiaoGongJiang
needTest() executed,some logic is here
NaiveWaiter:server to XiaoGongJiang
NaughtWaiter:server to XiaoGongJiang
needTest() executed,some logic is here

从输出结果中可以看出，切面被正确的织入到了标注有@NeedTest注解的方法中。