自定义注解实现AOP
AOP简要概述自定义注解annotation配置AOP切面使用AOP简要概述
AOP:
AOP为Aspect Oriented Programming的缩写,意为:面向切面编程,通过预编译方式或运行时动态代理实现程序功能增强的一种技术,如在方法执行前、或执行后、或是在执行中出现异常后这些地方进行拦截处理或叫做增强处理。AOP现有两个主要的流行框架,即Spring AOP和Spring + AspectJ。
两者的不同
Spring AOP:
1、采用的是动态织入,基于动态代理来实现,默认如果被代理的类实现一个接口,用JDK提供的动态代理实现,如果没有则使用CGLIB实现。
2、Spring AOP需要依赖IOC容器来管理,并且只能作用于Spring容器,使用纯Java代码实现
3、在性能上,由于Spring AOP是基于动态代理来实现的,在容器启动时需要生成代理实例,在方法调用上也会增加栈的深度,使得Spring AOP的性能不如AspectJ的那么好
AspectJ:
1、是静态织入,指在编译时期就织入,即:编译出来的class文件,字节码就已经被织入了,所以说它生成的类是没有额外运行时开销的。
(有如下几个织入的时机:)
1、编译期织入(Compile-time weaving): 如类 A 使用 AspectJ 添加了一个属性,类 B 引用了它,这个场景就需要编译期的时候就进行织入,否则没法编译类 B。
2、编译后织入(Post-compile weaving): 也就是已经生成了 .class 文件,或已经打成 jar 包了,这种情况我们需要增强处理的话,就要用到编译后织入。
3、类加载后织入(Load-time weaving): 指的是在加载类的时候进行织入,要实现这个时期的织入,有几种常见的方法。1、自定义类加载器来干这个,这个应该是最容易想到的办法,在被织入类加载到 JVM 前去对它进行加载,这样就可以在加载的时候定义行为了。
现在Spring AOP 已经集成了 AspectJ ,AspectJ 应该算的上是 Java 生态系统中最完整的 AOP 框架了。如果我们的切面比较少,那么两者性能差异不大。但是,当切面太多的话,最好选择 AspectJ ,它比 Spring AOP 快很多。
动态代理:
所谓的动态代理就是说AOP框架不会去改动原有代码,而是在内存中临时为方法生成一个AOP对象,这个对象在特定的切点做了增强处理。Spring AOP中的动态代理主要有两种实现方式,JDK动态代理和CGLIB动态代理。
JDK动态代理:
通过反射来接收被代理的类,并且要求被代理的类实现一个接口,它的核心是InvocationHandler接口和Proxy类。如果被代理类没有实现接口,那么Spring AOP就会选择使用CGLIB来动态代理目标类。
CGLIB(Code Generation Library):
是一个代码生成的类库,可以在运行时动态地生成某个类的子类,它是通过继承的方式做的动态代理,因此如果某个类被标记为final(无法被继承),那么它是无法使用CGLIB做动态代理的。
AOP常用使用场景:
日志记录、性能统计、权限控制、事务处理、异常处理、懒加载
自定义注解annotation
一些元注解的说明:
@Retention:什么时候使用该注解,我们定义为运行时;
SOURCE, 编译器处理完该注解后不存储在class中CLASS, 编译器把该注解存储在class字节码文件中RUNTIME, 编译器把该注解存储在class字节码文件中,并且可以由JVM读取,在运行时可以通过反射获取到
@Target:注解用于什么地方,我们定义为作用于方法和类上;
@Target(ElementType.TYPE) //接口、类、枚举、注解@Target(ElementType.METHOD) //方法上@Target(ElementType.FIELD) //字段、枚举的常量@Target(ElementType.PARAMETER) //方法参数@Target(ElementType.CONSTRUCTOR) //构造函数@Target(ElementType.LOCAL_VARIABLE) //局部变量@Target(ElementType.ANNOTATION_TYPE) //注解@Target(ElementType.PACKAGE) ///包
@Documented:这个Annotation可以被写入javadoc;
@Inherited:这个Annotation 可以被继承,如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。
自定义一个用于日志打印的注解
import java.lang.annotation.*;@Retention(RetentionPolicy.RUNTIME)@Target({ElementType.TYPE, ElementType.METHOD})@Documentedpublic @interface MonitorLog {String description() default "";}
一个自定义注解就完成了。
配置AOP切面
aspectj相关注解的作用:
@Aspect :定义一个切面,标注在类上
@Pointcut :定义一个切点(在切点前后增强),定义需要拦截的内容,切点分为execution方式和annotation方式。前者可以用路径表达式指定哪些类织入切面,后者可以指定被哪些注解修饰的代码织入切面。
execution表达式:
以execution(* com.mutest.controller..*.*(..))
表达式为例:
第一个 * 号的位置:表示返回值类型,* 表示所有类型。包名:表示需要拦截的包名,后面的两个句点表示当前包和当前包的所有子包,在本例中指 com.mutest.controller包、子包下所有类的方法。第二个 * 号的位置:表示类名,* 表示所有类。(…):这个星号表示方法名,表示所有的方法,后面括弧里面表示方法的参数,两个句点表示任何参数。
annotation() 表达式:
annotation() 方式是针对某个注解来定义切点。
5种切入方式:
@Around :环绕增强,可以在切入点前后织入代码,并且可以自由的控制何时执行切点
@Before :在切点之前,织入相关代码
@After :在切点之后,织入相关代码
@AfterReturning :在切点返回内容后,织入相关代码,一般用于对返回值做些加工处理的场景
@AfterThrowing :用来处理当织入的代码抛出异常后的逻辑处理
5种增强类型和具体实现类的执行顺序为:aroud、before、实现类、afterReturning、after、around
定义一个切面类MonitorLogAspect,声明一个切点,并织入
@Aspect@Componentpublic class MonitorLogAspect{private final static Logger logger = LoggerFactory.getLogger(MonitorLogAspect.class);/** 以自定义 @MonitorLog 注解为切点 */@Pointcut("@annotation(com.webser.interceptor.MonitorLog)")public void aspectMethod() {}/** 定义环绕增强 可以监控和统计API执行时间,以计算API的性能*/@Around("aspectMethod()")public Object doAround(ProceedingJoinPoint joinPoint) throws Throwable {long start = System.currentTimeMillis(); //记录调用接口的开始时间Object result = joinPoint.proceed(); //执行切点,会依次调用@Before -> 接口逻辑代码 -> @After -> @AfterReturninglong end = System.currentTimeMillis(); //记录结束时间logger.info("Time-Consuming: {} ms", end - start); //记录耗时return result; //返回接口参数结果}/** 在切点之前织入 可以做一些信息的统计,比如获取用户的请求 URL 以及用户的 IP 地址等等*/@Before("aspectMethod()")public void doBefore(JoinPoint joinPoint) throws Throwable {ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();HttpServletRequest request = attributes.getRequest();// 获取 @WebLog 注解的描述信息String methodDescription = getAspectLogDescription(joinPoint);// 打印请求相关参数logger.info("============================== Start ==============================");// 打印请求 urllogger.info("URL : {}", request.getRequestURL().toString());// 打印 Http methodlogger.info("HTTP Method : {}", request.getMethod());// 打印调用 controller 的全路径以及执行方法logger.info("Class Method : {}.{}", joinPoint.getSignature().getDeclaringTypeName(), joinPoint.getSignature().getName());// 打印请求的 IPlogger.info("IP : {}", request.getRemoteAddr());// 打印请求入参logger.info("Request Args : {}", new Gson().toJson(joinPoint.getArgs()));}}
使用
我们的切点是自定义注解 @MonitorLog, 所以我们仅仅需要在 Controller 控制器的每个接口方法添加 @MonitorLog 注解即可,如果我们不想某个接口打印出日志,不加注解就可以了。
@PostMapping("/user/login")@MonitorLogpublic User userLogin(@RequestBody User user) {logger.info("user login...");return user;}
对于那些性能要求较高的应用,不想在生产环境中打印日志,只想在开发环境或者测试环境中使用,要怎么做呢?我们只需为切面添加 @Profile 就可以了,如下所示:
@Aspect@Component@Profile({"dev","test"})public class MonitorLogAspect{...}
这样就指定了只能作用于 dev 开发环境和 test 测试环境,生产环境 prod 是不生效的。
AOP如何实现的?
AspectJ是如何在没有修改源代码的情况下增加新功能的呢?注解@Aspect
多切面如何指定优先级?
假设说我们的服务中不止定义了一个切面,比如说我们针对 Web 层的接口,不止要打印日志,还要校验 token 等。要如何指定切面的优先级呢?也就是如何指定切面的执行顺序?
我们可以通过 @Order(i)注解来指定优先级,根据i的大小来确定优先级。
在切点之前,@Order 从小到大被执行,也就是说越小的优先级越高;
在切点之后,@Order 从大到小被执行,也就是说越大的优先级越高;