几个重要术语:Joinpoint、Pointcut、Advice
Joinpoint:连接点,如类的某个方法调用前、调用后、抛出异常等,Spring仅支持方法的连接点。 Pointcut:切点,例如下文中的 "execution(( com.companyserver.controller..*(..)))" 是告诉Spring我们要找com.companyserver.controller包下所有controller的方法,返回值和参数格式不限。 Advice:增强(另一种直白的翻译是通知,但是增强更好理解一些,本身作用就是植入目标类添加额外的功能)里。当然,增强并不能是随便一段代码,还必须配合连接点的方位,例如MethodBeforeAdvice就只能织入方法调用前的位置,AfterReturningAdvice只能织入方法返回后的位置
Advice的几种用法
//后置增强,在方法正常完成后执行。 import java.lang.reflect.Method; import org.springframework.aop.AfterReturningAdvice; public class BibiAdvice implements AfterReturningAdvice { @Override public void afterReturning(Object returnObj, Method method, Object[] args,Object obj)throws Throwable { System.out.println("方法完成"); } } //前置增强 public class BeforeAdviceDemo implements MethodBeforeAdvice { @Override public void before(Method method, Object[] args, Object obj) throws Throwable { System.out.println("方法执行前"); } } //环绕增强 public class AroundAdviceDemo implements MethodInterceptor { @Override public Object invoke(MethodInvocation invocation)throws Throwable { Object[] args = invocation.getArguments(); String name = (String)args[0]; System.out.println("Hi, "+ name); Object obj = invocation.proceed();//调用目标方法 System.out.println("Goodbye! "+ name); return obj; } } //异常抛出 public class ThrowsAdviceDemo implements ThrowsAdvice { public void afterThrowing (Method method, Object[] args, Object target, Exception ex) throws Throwable { System.out.println("抛出异常:"+ ex.getMessage()); System.out.println("异常处理..."); } }用代码创建代理(实际开发中不会使用这种代码的方式,Spring会帮我们完成自动创建代理工作)
public interface Test { void test(); } public class MyTest implements Test { @Override public void test() { System.out.println("--正在执行--"); } } import org.springframework.aop.AfterReturningAdvice; import org.springframework.aop.framework.ProxyFactory; public class Client { public static void main(String[] args) { Test test =new MyTest(); AfterReturningAdvice advice =new BibiAdvice(); ProxyFactory pf =new ProxyFactory(); pf.setTarget(test); pf.setInterfaces(test.getClass().getInterfaces()); pf.addAdvice(advice); Test proxy = (Test)pf.getProxy(); proxy.test(); } }target :目标对象,ref另一个bean proxyTargetClass :是否对类进行代理(而不是对接口),true或false,设置为true时,使用CGLib代理技术 interceptorNames :织入目标对象的Advice(实现了Advisor或者MethodInterceptor接口的bean) proxyInterfaces :代理所要实现的接口,如果指定了proxyTargetClass=true,此属性会被忽略 optimize :设置为true时,强制使用CGLib代理技术
使用@Aspec即可使用拦截 @Aspec : 作用是把当前类标识为一个切面供容器读取 @Pointcut :是指那些方法需要被执行"AOP @Around : 环绕增强,相当于MethodInterceptor @DeclareParents : 引介增强,相当于IntroductionInterceptor @Before : 标识一个前置增强方法,相当于BeforeAdvice的功能,相似功能的还有 @After : final增强,不管是抛出异常或者正常退出都会执行 @AfterReturning : 后置增强,相当于AfterReturningAdvice,方法正常退出时执行 @AfterThrowing : 异常抛出增强,相当于ThrowsAdvice
任何一个增强方法都可以通过将第一个入参声明为JoinPoint访问到连接点上下文的信息。我们先来了解一下这两个接口的主要方法:
1)JoinPoint
java.lang.Object[] getArgs():获取连接点方法运行时的入参列表; Signature getSignature() :获取连接点的方法签名对象; java.lang.Object getTarget() :获取连接点所在的目标对象; java.lang.Object getThis() :获取代理对象本身;
2)ProceedingJoinPoint
ProceedingJoinPoint继承JoinPoint子接口,它新增了两个用于执行连接点方法的方法:
java.lang.Object proceed() throws java.lang.Throwable:通过反射执行目标对象的连接点处的方法; java.lang.Object proceed(java.lang.Object[] args) throws java.lang.Throwable:通过反射执行目标对象连接点处的方法,不过使用新的入参替换原来的入参。 MethodSignature :连接点的方法签名对象execution切点函数
参数部分允许使用通配符:
* 匹配任意字符,但只能匹配一个元素.. 匹配任意字符,可以匹配任意多个元素,表示类时,必须和*联合使用+ 必须跟在类名后面,如Horseman+,表示类本身和继承或扩展指定类的所有类 示例: * chop(..)解读为: 1.方法修饰符 : 无 2.返回类型 : \*匹配任意数量字符,表示返回类型不限 3.方法名 : chop表示匹配名称为chop的方法 4. 参数 : (..)表示匹配任意数量和类型的输入参数 5. 异常模式: 不限更多示例:
void chop(String,int)配目标类任意修饰符方法、返回void、方法名chop、带有一个String和一个int型参数的方法
public void chop(*)匹配目标类public修饰、返回void、方法名chop、带有一个任意类型参数的方法
public String *o*(..)匹配目标类public修饰、返回String类型、方法名中带有一个o字符、带有任意数量任意类型参数的方法
public void *o*(String,..)匹配目标类public修饰、返回void、方法名中带有一个o字符、带有任意数量任意类型参数,但第一个参数必须有且为String型的方法, 也可以指定类:
public void examples.chap03.Horseman.*(..)匹配Horseman的public修饰、返回void、不限方法名、带有任意数量任意类型参数的方法
public void examples.chap03.*man.*(..)匹配以man结尾的类中public修饰、返回void、不限方法名、带有任意数量任意类型参数的方法 指定包:
public void examples.chap03.*.chop(..)匹配examples.chap03包下所有类中public修饰、返回void、方法名chop、带有任意数量任意类型参数的方法
public void examples..*.chop(..)匹配examples.包下和所有子包中的类中public修饰、返回void、方法名chop、带有任意数量任意类型参数的方法
可以用这些表达式替换StorageAdvisor中的代码并观察效果
例如 @annotation(org.springframework.transaction.annotation.Transactional) 表示标注了@Transactional的方法
例如 args(String) 表示有且仅有一个String型参数的方法
如 @args(org.springframework.stereotype.Service) 表示有且仅有一个标注了@Service的类参数的方法
如 with(examples.chap03.Horseman) 表示Horseman的所有方法
如 target(examples.chap03.Horseman) 且Elephantman extends Horseman,则两个类的所有方法都匹配
如 @within(org.springframework.stereotype.Service) 给Horseman加上@Service标注,则Horseman和Elephantman 的所有方法都匹配
如 @target(org.springframework.stereotype.Service) 表示所有标注了@Service的类的所有方法
与操作,求交集,也可以写成and
例如 execution(* chop(..)) && target(Horseman) 表示Horseman及其子类的chop方法
或操作,求并集,也可以写成or
例如 execution(* chop(..)) || args(String) 表示名称为chop的方法或者有一个String型参数的方法
非操作,求反集,也可以写成not
例如 execution(* chop(..)) and !args(String) 表示名称为chop的方法但是不能是只有一个String型参数的方法
package com.companyserver.interceptor; import com.companyserver.security.JwtTokenUtil; import com.companyserver.utils.TimeProvider; import com.companyserver.vo.Result; import org.aspectj.lang.ProceedingJoinPoint; import org.aspectj.lang.annotation.Around; import org.aspectj.lang.annotation.Aspect; import org.aspectj.lang.annotation.Pointcut; import org.aspectj.lang.reflect.MethodSignature; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Component; import javax.servlet.http.HttpServletRequest; import java.lang.reflect.Method; import java.util.Date; import java.util.LinkedHashSet; import java.util.Set; /** * 拦截器:记录用户操作日志,检查用户token是否需要属刷新…… *@author lpfasd */ @Aspect @Component public classControllerInterceptor { private static final Logger logger= LoggerFactory.getLogger(ControllerInterceptor.class); @Value("${jwt.header}") private String tokenHeader; @Autowired private JwtTokenUtil jwtTokenUtil; @Autowired privateTimeProvider timeProvider; /** * 定义拦截规则:拦截com.companyserver.controller包下面的所有类中方法。 */ @Pointcut("execution(* com.companyserver.controller..*(..))") public void controllerMethodPointcut(){} /** * 拦截器具体实现 * @parampjp * @return Result(被拦截方法的执行结果,或需要登录的错误提示。) */ @Around("controllerMethodPointcut()")//指定拦截器规则;也可以直接把“execution(* com.companyserver.........)”写进这里 public ObjectInterceptor(ProceedingJoinPoint pjp){ logger.info("{}",pjp); long beginTime = System.currentTimeMillis(); MethodSignature signature = (MethodSignature) pjp.getSignature(); Method method = signature.getMethod();//获取被拦截的方法 String methodName = method.getName();//获取被拦截的方法名 Set allParams =newLinkedHashSet<>();//保存所有请求参数,用于输出到日志中 logger.info("请求开始,方法:{}",methodName); Object result =null; Object[] args = pjp.getArgs(); HttpServletRequest request =null; for(Object arg : args){ if(arg instanceofHttpServle tRequest){ request = (HttpServletRequest) arg; } logger.info("参数列表 : "+ arg); } try{ if(result ==null){ // 一切正常的情况下,继续执行被拦截的方法 result = pjp.proceed(); } }catch(Throwable e) { logger.info("exception: ",e); result = Result.FAIL("服务器错误"); } if(resultinstanceofResult){ String authToken = request.getHeader(tokenHeader); Date expiration =jwtTokenUtil.getExpirationDateFromToken(authToken); if(expiration.before(timeProvider.now()) && new Date(expiration.getTime() + 30*60*1000 ) .after(timeProvider.now())){ String refreshToken =jwtTokenUtil.refreshToken(authToken); ((Result) result).setToken(refreshToken); } long costMs = System.currentTimeMillis() - beginTime; logger.info("{}请求结束,耗时:{}ms",methodName,costMs); } return result; } }