基于注解的Spring AOP的配置和使用--转载
本文内容纲要:
-InterfaceSignature
-getDeclaringTypeName
-getName
AOP是OOP的延续,是AspectOrientedProgramming的缩写,意思是面向切面编程。可以通过预编译方式和运行期动态代理实现在不修改源代码的情况下给程序动态统一添加功能的一种技术。AOP实际是GoF设计模式的延续,设计模式孜孜不倦追求的是调用者和被调用者之间的解耦,AOP可以说也是这种目标的一种实现。
我们现在做的一些非业务,如:日志、事务、安全等都会写在业务代码中(也即是说,这些非业务类横切于业务类),但这些代码往往是重复,复制——粘贴式的代码会给程序的维护带来不便,AOP就实现了把这些业务需求与系统需求分开来做。这种解决的方式也称代理机制。
先来了解一下AOP的相关概念,《Spring参考手册》中定义了以下几个AOP的重要概念,结合以上代码分析如下:
- **切面(Aspect):**官方的抽象定义为“一个关注点的模块化,这个关注点可能会横切多个对象”,在本例中,“切面”就是类TestAspect所关注的具体行为,例如,AServiceImpl.barA()的调用就是切面TestAspect所关注的行为之一。“切面”在ApplicationContext中aop:aspect来配置。
- 连接点(Joinpoint):程序执行过程中的某一行为,例如,UserService.get的调用或者UserService.delete抛出异常等行为。
- 通知(Advice):“切面”对于某个“连接点”所产生的动作,例如,TestAspect中对com.spring.service包下所有类的方法进行日志记录的动作就是一个Advice。其中,一个“切面”可以包含多个“Advice”,例如ServiceAspect。
- 切入点(Pointcut):匹配连接点的断言,在AOP中通知和一个切入点表达式关联。例如,TestAspect中的所有通知所关注的连接点,都由切入点表达式execution(*com.spring.service.*.*(..))来决定。
- 目标对象(TargetObject):被一个或者多个切面所通知的对象。例如,AServcieImpl和BServiceImpl,当然在实际运行时,SpringAOP采用代理实现,实际AOP操作的是TargetObject的代理对象。
- AOP代理(AOPProxy):在SpringAOP中有两种代理方式,JDK动态代理和CGLIB代理。默认情况下,TargetObject实现了接口时,则采用JDK动态代理,例如,AServiceImpl;反之,采用CGLIB代理,例如,BServiceImpl。强制使用CGLIB代理需要将aop:config的proxy-target-class属性设为true。
通知(Advice)类型:
- **前置通知(Beforeadvice):**在某连接点(JoinPoint)之前执行的通知,但这个通知不能阻止连接点前的执行。ApplicationContext中在aop:aspect里面使用aop:before元素进行声明。例如,TestAspect中的doBefore方法。
- **后置通知(Afteradvice):**当某连接点退出的时候执行的通知(不论是正常返回还是异常退出)。ApplicationContext中在aop:aspect里面使用aop:after元素进行声明。例如,ServiceAspect中的returnAfter方法,所以Teser中调用UserService.delete抛出异常时,returnAfter方法仍然执行。
- **返回后通知(Afterreturnadvice):**在某连接点正常完成后执行的通知,不包括抛出异常的情况。ApplicationContext中在aop:aspect里面使用元素进行声明。
- **环绕通知(Aroundadvice):**包围一个连接点的通知,类似Web中Servlet规范中的Filter的doFilter方法。可以在方法的调用前后完成自定义的行为,也可以选择不执行。ApplicationContext中在
aop:aspect里面使用aop:around元素进行声明。例如,ServiceAspect中的around方法。 - **抛出异常后通知(Afterthrowingadvice):**在方法抛出异常退出时执行的通知。ApplicationContext中在aop:aspect里面使用aop:after-throwing元素进行声明。例如,ServiceAspect中的returnThrow方法。
**注:**可以将多个通知应用到一个目标对象上,即可以将多个切面织入到同一目标对象。
使用SpringAOP可以基于两种方式,一种是比较方便和强大的注解方式,另一种则是中规中矩的xml配置方式。
先说注解,使用注解配置SpringAOP总体分为两步,第一步是在xml文件中声明激活自动扫描组件功能,同时激活自动代理功能(同时在xml中添加一个UserService的普通服务层组件,来测试AOP的注解功能):
<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/aophttp://www.springframework.org/schema/aop/spring-aop-3.1.xsd
http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context-3.0.xsd">
<!--激活组件扫描功能,在包cn.ysh.studio.spring.aop及其子包下面自动扫描通过注解配置的组件-->
<context:component-scanbase-package="cn.ysh.studio.spring.aop"/>
<!--激活自动代理功能-->
<aop:aspectj-autoproxyproxy-target-class="true"/>
<!--用户服务对象-->
<beanid="userService"class="cn.ysh.studio.spring.aop.service.UserService"/>
</beans>
第二步是为Aspect切面类添加注解:
packagecn.ysh.studio.spring.aop.aspect;
importorg.apache.commons.logging.Log;
importorg.apache.commons.logging.LogFactory;
importorg.aspectj.lang.JoinPoint;
importorg.aspectj.lang.ProceedingJoinPoint;
importorg.aspectj.lang.annotation.After;
importorg.aspectj.lang.annotation.AfterReturning;
importorg.aspectj.lang.annotation.AfterThrowing;
importorg.aspectj.lang.annotation.Around;
importorg.aspectj.lang.annotation.Aspect;
importorg.aspectj.lang.annotation.Before;
importorg.aspectj.lang.annotation.Pointcut;
importorg.springframework.stereotype.Component;
/**
*系统服务组件Aspect切面Bean
*@authorShenghany
*@date2013-5-28
*/
//声明这是一个组件
@Component
//声明这是一个切面Bean
@Aspect
publicclassServiceAspect{
privatefinalstaticLoglog=LogFactory.getLog(ServiceAspect.class);
//配置切入点,该方法无方法体,主要为方便同类中其他方法使用此处配置的切入点
@Pointcut("execution(*cn.ysh.studio.spring.aop.service..*(..))")
publicvoidaspect(){ }
/*
*配置前置通知,使用在方法aspect()上注册的切入点
*同时接受JoinPoint切入点对象,可以没有该参数
*/
@Before("aspect()")
publicvoidbefore(JoinPointjoinPoint){
if(log.isInfoEnabled()){
log.info("before"+joinPoint);
}
}
//配置后置通知,使用在方法aspect()上注册的切入点
@After("aspect()")
publicvoidafter(JoinPointjoinPoint){
if(log.isInfoEnabled()){
log.info("after"+joinPoint);
}
}
//配置环绕通知,使用在方法aspect()上注册的切入点
@Around("aspect()")
publicvoidaround(JoinPointjoinPoint){
longstart=System.currentTimeMillis();
try{
((ProceedingJoinPoint)joinPoint).proceed();
longend=System.currentTimeMillis();
if(log.isInfoEnabled()){
log.info("around"+joinPoint+"\tUsetime:"+(end-start)+"ms!");
}
}catch(Throwablee){
longend=System.currentTimeMillis();
if(log.isInfoEnabled()){
log.info("around"+joinPoint+"\tUsetime:"+(end-start)+"mswithexception:"+e.getMessage());
}
}
}
//配置后置返回通知,使用在方法aspect()上注册的切入点
@AfterReturning("aspect()")
publicvoidafterReturn(JoinPointjoinPoint){
if(log.isInfoEnabled()){
log.info("afterReturn"+joinPoint);
}
}
//配置抛出异常后通知,使用在方法aspect()上注册的切入点
@AfterThrowing(pointcut="aspect()",throwing="ex")
publicvoidafterThrow(JoinPointjoinPoint,Exceptionex){
if(log.isInfoEnabled()){
log.info("afterThrow"+joinPoint+"\t"+ex.getMessage());
}
}
}
测试代码:
packagecn.ysh.studio.spring.aop;
importorg.apache.commons.logging.Log;
importorg.apache.commons.logging.LogFactory;
importorg.springframework.context.ApplicationContext;
importorg.springframework.context.support.ClassPathXmlApplicationContext;
importcn.ysh.studio.spring.aop.service.UserService;
importcn.ysh.studio.spring.mvc.bean.User;
/**
*SpringAOP测试
*@authorShenghany
*@date2013-5-28
*/
publicclassTester{
privatefinalstaticLoglog=LogFactory.getLog(Tester.class);
publicstaticvoidmain(String[]args){
//启动Spring容器
ApplicationContextcontext=newClassPathXmlApplicationContext("applicationContext.xml");
//获取service组件
UserServiceservice=(UserService)context.getBean("userService");
//以普通的方式调用UserService对象的三个方法
Useruser=service.get(1L);
service.save(user);
try{
service.delete(1L);
}catch(Exceptione){
if(log.isWarnEnabled()){
log.warn("Deleteuser:"+e.getMessage());
}
}
}
}
控制台输出如下:
INFO[spring.aop.aspect.ServiceAspect:40]beforeexecution(Usercn.ysh.studio.spring.aop.service.UserService.get(long))
INFO[spring.aop.service.UserService:19]getUsermethod...
INFO[spring.aop.aspect.ServiceAspect:60]aroundexecution(Usercn.ysh.studio.spring.aop.service.UserService.get(long)) Usetime:42ms!
INFO[spring.aop.aspect.ServiceAspect:48]afterexecution(Usercn.ysh.studio.spring.aop.service.UserService.get(long))
INFO[spring.aop.aspect.ServiceAspect:74]afterReturnexecution(Usercn.ysh.studio.spring.aop.service.UserService.get(long))
INFO[spring.aop.aspect.ServiceAspect:40]beforeexecution(voidcn.ysh.studio.spring.aop.service.UserService.save(User))
INFO[spring.aop.service.UserService:26]saveUsermethod...
INFO[spring.aop.aspect.ServiceAspect:60]aroundexecution(voidcn.ysh.studio.spring.aop.service.UserService.save(User)) Usetime:2ms!
INFO[spring.aop.aspect.ServiceAspect:48]afterexecution(voidcn.ysh.studio.spring.aop.service.UserService.save(User))
INFO[spring.aop.aspect.ServiceAspect:74]afterReturnexecution(voidcn.ysh.studio.spring.aop.service.UserService.save(User))
INFO[spring.aop.aspect.ServiceAspect:40]beforeexecution(booleancn.ysh.studio.spring.aop.service.UserService.delete(long))
INFO[spring.aop.service.UserService:32]deletemethod...
INFO[spring.aop.aspect.ServiceAspect:65]aroundexecution(booleancn.ysh.studio.spring.aop.service.UserService.delete(long)) Usetime:5mswithexception:springaopThrowAdvice演示
INFO[spring.aop.aspect.ServiceAspect:48]afterexecution(booleancn.ysh.studio.spring.aop.service.UserService.delete(long))
INFO[spring.aop.aspect.ServiceAspect:74]afterReturnexecution(booleancn.ysh.studio.spring.aop.service.UserService.delete(long))
WARN[studio.spring.aop.Tester:32]Deleteuser:Nullreturnvaluefromadvicedoesnotmatchprimitivereturntypefor:publicbooleancn.ysh.studio.spring.aop.service.UserService.delete(long)throwsjava.lang.Exception
可以看到,正如我们预期的那样,虽然我们并没有对UserSerivce类包括其调用方式做任何改变,但是Spring仍然拦截到了其中方法的调用,或许这正是AOP的魔力所在。
再简单说一下xml配置方式,其实也一样简单:
<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/aophttp://www.springframework.org/schema/aop/spring-aop-3.1.xsd
http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context-3.0.xsd">
<!--系统服务组件的切面Bean-->
<beanid="serviceAspect"class="cn.ysh.studio.spring.aop.aspect.ServiceAspect"/>
<!--AOP配置-->
<aop:config>
<!--声明一个切面,并注入切面Bean,相当于@Aspect-->
<aop:aspectid="simpleAspect"ref="serviceAspect">
<!--配置一个切入点,相当于@Pointcut-->
<aop:pointcutexpression="execution(*cn.ysh.studio.spring.aop.service..*(..))"id="simplePointcut"/>
<!--配置通知,相当于@Before、@After、@AfterReturn、@Around、@AfterThrowing-->
<aop:beforepointcut-ref="simplePointcut"method="before"/>
<aop:afterpointcut-ref="simplePointcut"method="after"/>
<aop:after-returningpointcut-ref="simplePointcut"method="afterReturn"/>
<aop:after-throwingpointcut-ref="simplePointcut"method="afterThrow"throwing="ex"/>
</aop:aspect>
</aop:config>
</beans>
个人觉得不如注解灵活和强大,你可以不同意这个观点,但是不知道如下的代码会不会让你的想法有所改善:
//配置前置通知,拦截返回值为cn.ysh.studio.spring.mvc.bean.User的方法
@Before("execution(cn.ysh.studio.spring.mvc.bean.Usercn.ysh.studio.spring.aop.service..*(..))")
publicvoidbeforeReturnUser(JoinPointjoinPoint){
if(log.isInfoEnabled()){
log.info("beforeReturnUser"+joinPoint);
}
}
//配置前置通知,拦截参数为cn.ysh.studio.spring.mvc.bean.User的方法
@Before("execution(*cn.ysh.studio.spring.aop.service..*(cn.ysh.studio.spring.mvc.bean.User))")
publicvoidbeforeArgUser(JoinPointjoinPoint){
if(log.isInfoEnabled()){
log.info("beforeArgUser"+joinPoint);
}
}
//配置前置通知,拦截含有long类型参数的方法,并将参数值注入到当前方法的形参id中
@Before("aspect()&&args(id)")
publicvoidbeforeArgId(JoinPointjoinPoint,longid){
if(log.isInfoEnabled()){
log.info("beforeArgId"+joinPoint+"\tID:"+id);
}
}
附上UserService的代码(其实很简单):
packagecn.ysh.studio.spring.aop.service;
importorg.apache.commons.logging.Log;
importorg.apache.commons.logging.LogFactory;
importcn.ysh.studio.spring.mvc.bean.User;
/**
*用户服务模型
*@authorShenghany
*@date2013-5-28
*/
publicclassUserService{
privatefinalstaticLoglog=LogFactory.getLog(UserService.class);
publicUserget(longid){
if(log.isInfoEnabled()){
log.info("getUsermethod...");
}
returnnewUser();
}
publicvoidsave(Useruser){
if(log.isInfoEnabled()){
log.info("saveUsermethod...");
}
}
publicbooleandelete(longid)throwsException{
if(log.isInfoEnabled()){
log.info("deletemethod...");
thrownewException("springaopThrowAdvice演示");
}
returnfalse;
}
}
应该说学习SpringAOP有两个难点,第一点在于理解AOP的理念和相关概念,第二点在于灵活掌握和使用切入点表达式。概念的理解通常不在一朝一夕,慢慢浸泡的时间长了,自然就明白了,下面我们简单地介绍一下切入点表达式的配置规则吧。
通常情况下,表达式中使用”execution“就可以满足大部分的要求。表达式格式如下:
execution(modifiers-pattern?ret-type-patterndeclaring-type-pattern?name-pattern(param-pattern)throws-pattern?)
- modifiers-pattern:方法的操作权限
- ret-type-pattern:返回值
- declaring-type-pattern:方法所在的包
- name-pattern:方法名
- parm-pattern:参数名
- throws-pattern:异常
其中,除ret-type-pattern和name-pattern之外,其他都是可选的。上例中,execution(*com.spring.service.*.*(..))表示com.spring.service包下,返回值为任意类型;方法名任意;参数不作限制的所有方法。
最后说一下通知参数
可以通过args来绑定参数,这样就可以在通知(Advice)中访问具体参数了。例如,aop:aspect配置如下:
<aop:config>
<aop:aspectid="TestAspect"ref="aspectBean">
<aop:pointcutid="businessService"
expression="execution(*com.spring.service.*.*(String,..))andargs(msg,..)"/>
<aop:afterpointcut-ref="businessService"method="doAfter"/>
</aop:aspect>
</aop:config>
上面的代码args(msg,..)是指将切入点方法上的第一个String类型参数添加到参数名为msg的通知的入参上,这样就可以直接使用该参数啦。
访问当前的连接点
在上面的Aspect切面Bean中已经看到了,每个通知方法第一个参数都是JoinPoint。其实,在Spring中,任何通知(Advice)方法都可以将第一个参数定义为org.aspectj.lang.JoinPoint类型用以接受当前连接点对象。JoinPoint接口提供了一系列有用的方法,比如getArgs()(返回方法参数)、getThis()(返回代理对象)、getTarget()(返回目标)、getSignature()(返回正在被通知的方法相关信息)和toString()(打印出正在被通知的方法的有用信息)。
来源:http://ntzrj513.blog.163.com/blog/static/27945612201362232315/
appendix:
InterfaceSignature
AllKnownSubinterfaces:
AdviceSignature,CatchClauseSignature,CodeSignature,ConstructorSignature,FieldSignature,InitializerSignature,LockSignature,MemberSignature,MethodSignature,UnlockSignature
AllKnownImplementingClasses:
FieldSignatureImpl
publicinterfaceSignature
Representsthesignatureatajoinpoint.Thisinterfaceparallelsjava.lang.reflect.Member
.
Thisinterfaceistypicallyusedfortracingorloggingapplicationstoobtainreflectiveinformationaboutthejoinpoint,i.e.usingthej2se1.4java.util.logging
API
aspectLogging{
Loggerlogger=Logger.getLogger("MethodEntries");
before():within(com.bigboxco..*)&&execution(public**(..)){
Signaturesig=thisJoinPoint.getSignature();
logger.entering(sig.getDeclaringType().getName(),
sig.getName());
}
}
MoredetailedinformationaboutaspecifickindofsignaturecanbeobtainedbycastingthisSignature
objectintooneofitsmorespecificsub-typesavailableinorg.aspectj.lang.reflect
.
SeeAlso:
Member
,java.util.logging.Logger
getDeclaringTypeName
java.lang.StringgetDeclaringTypeName()
Returnsthefully-qualifiednameofthedeclaringtype.ThisisequivalenttocallinggetDeclaringType().getName(),butcachestheresultforgreaterefficiency.
getName
java.lang.StringgetName()
Returnstheidentifierpartofthissignature.Formethodsthiswillreturnthemethodname.
SeeAlso:
Member.getName()
来源:http://www.eclipse.org/aspectj/doc/released/runtime-api/org/aspectj/lang/Signature.html
本文内容总结:InterfaceSignature,getDeclaringTypeName,getName,
原文链接:https://www.cnblogs.com/davidwang456/p/4013631.html