AspectJ切入点语法详解
本文轉(zhuǎn)自http://jinnianshilongnian.iteye.com/blog/1415606,很喜歡該作者的文章,在此對作者表示敬意!
?
6.5.1? Spring AOP支持的AspectJ切入點指示符
?????? 切入點指示符用來指示切入點表達式目的,,在Spring AOP中目前只有執(zhí)行方法這一個連接點,Spring AOP支持的AspectJ切入點指示符如下:
? ? ? ? ?execution:用于匹配方法執(zhí)行的連接點;
? ? ? ? ?within:用于匹配指定類型內(nèi)的方法執(zhí)行;
? ? ? ? ?this:用于匹配當(dāng)前AOP代理對象類型的執(zhí)行方法;注意是AOP代理對象的類型匹配,這樣就可能包括引入接口也類型匹配;
? ? ? ? ?target:用于匹配當(dāng)前目標(biāo)對象類型的執(zhí)行方法;注意是目標(biāo)對象的類型匹配,這樣就不包括引入接口也類型匹配;
? ? ? ? ?args:用于匹配當(dāng)前執(zhí)行的方法傳入的參數(shù)為指定類型的執(zhí)行方法;
? ? ? ? ?@within:用于匹配所以持有指定注解類型內(nèi)的方法;
? ? ? ? ?@target:用于匹配當(dāng)前目標(biāo)對象類型的執(zhí)行方法,其中目標(biāo)對象持有指定的注解;
? ? ? ? ?@args:用于匹配當(dāng)前執(zhí)行的方法傳入的參數(shù)持有指定注解的執(zhí)行;
? ? ? ? ?@annotation:用于匹配當(dāng)前執(zhí)行方法持有指定注解的方法;
? ? ? ? ?bean:Spring AOP擴展的,AspectJ沒有對于指示符,用于匹配特定名稱的Bean對象的執(zhí)行方法;
? ? ? ? ?reference pointcut:表示引用其他命名切入點,只有@ApectJ風(fēng)格支持,Schema風(fēng)格不支持。
?????? AspectJ切入點支持的切入點指示符還有: call、get、set、preinitialization、staticinitialization、initialization、handler、adviceexecution、withincode、cflow、cflowbelow、if、@this、@withincode;但Spring AOP目前不支持這些指示符,使用這些指示符將拋出IllegalArgumentException異常。這些指示符Spring AOP可能會在以后進行擴展。
6.5.1? 命名及匿名切入點
?????? 命名切入點可以被其他切入點引用,而匿名切入點是不可以的。
?????? 只有@AspectJ支持命名切入點,而Schema風(fēng)格不支持命名切入點。
如下所示,@AspectJ使用如下方式引用命名切入點:
?
6.5.2??????? ;類型匹配語法
首先讓我們來了解下AspectJ類型匹配的通配符:
? ? ? ? ?*:匹配任何數(shù)量字符;
? ? ? ? ?..:匹配任何數(shù)量字符的重復(fù),如在類型模式中匹配任何數(shù)量子包;而在方法參數(shù)模式中匹配任何數(shù)量參數(shù)。
? ? ? ? ?+:匹配指定類型的子類型;僅能作為后綴放在類型模式后邊。
?
接下來再看一下具體的匹配表達式類型吧:
? ? ? ? ?匹配類型:使用如下方式匹配
?
?
java代碼: 查看復(fù)制到剪貼板打印- 注解:可選,類型上持有的注解,如@Deprecated;
- 類的全限定名:必填,可以是任何類全限定名。
? ? ? ? ?匹配方法執(zhí)行:使用如下方式匹配:
?
?
java代碼: 查看復(fù)制到剪貼板打印?
?
- 注解:可選,方法上持有的注解,如@Deprecated;
- 修飾符:可選,如public、protected;
- 返回值類型:必填,可以是任何類型模式;“*”表示所有類型;
- 類型聲明:可選,可以是任何類型模式;
- 方法名:必填,可以使用“*”進行模式匹配;
- 參數(shù)列表:“()”表示方法沒有任何參數(shù);“(..)”表示匹配接受任意個參數(shù)的方法,“(..,java.lang.String)”表示匹配接受java.lang.String類型的參數(shù)結(jié)束,且其前邊可以接受有任意個參數(shù)的方法;“(java.lang.String,..)” 表示匹配接受java.lang.String類型的參數(shù)開始,且其后邊可以接受任意個參數(shù)的方法;“(*,java.lang.String)” 表示匹配接受java.lang.String類型的參數(shù)結(jié)束,且其前邊接受有一個任意類型參數(shù)的方法;
- 異常列表:可選,以“throws 異常全限定名列表”聲明,異常全限定名列表如有多個以“,”分割,如throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsException。
? ? ? ? ?匹配Bean名稱:可以使用Bean的id或name進行匹配,并且可使用通配符“*”;
6.5.3? 組合切入點表達式
?????? AspectJ使用 且(&&)、或(||)、非(!)來組合切入點表達式。
?????? 在Schema風(fēng)格下,由于在XML中使用“&&”需要使用轉(zhuǎn)義字符“&&”來代替之,所以很不方便,因此Spring ASP 提供了and、or、not來代替&&、||、!。
?
6.5.3? 切入點使用示例
???????一、execution:使用“execution(方法表達式)”匹配方法執(zhí)行;
?
| 模式 | 描述 |
| public * *(..) | 任何公共方法的執(zhí)行 |
| * cn.javass..IPointcutService.*() | cn.javass包及所有子包下IPointcutService接口中的任何無參方法 |
| * cn.javass..*.*(..) | cn.javass包及所有子包下任何類的任何方法 |
| * cn.javass..IPointcutService.*(*) | cn.javass包及所有子包下IPointcutService接口的任何只有一個參數(shù)方法 |
| * (!cn.javass..IPointcutService+).*(..) | 非“cn.javass包及所有子包下IPointcutService接口及子類型”的任何方法 |
| * cn.javass..IPointcutService+.*() | cn.javass包及所有子包下IPointcutService接口及子類型的的任何無參方法 |
| * cn.javass..IPointcut*.test*(java.util.Date) | cn.javass包及所有子包下IPointcut前綴類型的的以test開頭的只有一個參數(shù)類型為java.util.Date的方法,注意該匹配是根據(jù)方法簽名的參數(shù)類型進行匹配的,而不是根據(jù)執(zhí)行時傳入的參數(shù)類型決定的 如定義方法:public void test(Object obj);即使執(zhí)行時傳入java.util.Date,也不會匹配的; |
| * cn.javass..IPointcut*.test*(..)? throws ?IllegalArgumentException, ArrayIndexOutOfBoundsException | cn.javass包及所有子包下IPointcut前綴類型的的任何方法,且拋出IllegalArgumentException和ArrayIndexOutOfBoundsException異常 |
| * (cn.javass..IPointcutService+ && java.io.Serializable+).*(..) | 任何實現(xiàn)了cn.javass包及所有子包下IPointcutService接口和java.io.Serializable接口的類型的任何方法 |
| @java.lang.Deprecated * *(..) | 任何持有@java.lang.Deprecated注解的方法 |
| @java.lang.Deprecated @cn.javass..Secure ?* *(..) | 任何持有@java.lang.Deprecated和@cn.javass..Secure注解的方法 |
| @(java.lang.Deprecated || cn.javass..Secure) * *(..) | 任何持有@java.lang.Deprecated或@ cn.javass..Secure注解的方法 |
| (@cn.javass..Secure ?*)? *(..) | 任何返回值類型持有@cn.javass..Secure的方法 |
| * ?(@cn.javass..Secure *).*(..) | 任何定義方法的類型持有@cn.javass..Secure的方法 |
| * *(@cn.javass..Secure (*) , @cn.javass..Secure (*)) | 任何簽名帶有兩個參數(shù)的方法,且這個兩個參數(shù)都被@ Secure標(biāo)記了, 如public void test(@Secure String str1, ?@Secure String str1); |
| * *((@ cn.javass..Secure *))或 * *(@ cn.javass..Secure *) | 任何帶有一個參數(shù)的方法,且該參數(shù)類型持有@ cn.javass..Secure; 如public void test(Model model);且Model類上持有@Secure注解 |
| * *( @cn.javass..Secure (@cn.javass..Secure *) , @ cn.javass..Secure (@cn.javass..Secure *)) | 任何帶有兩個參數(shù)的方法,且這兩個參數(shù)都被@ cn.javass..Secure標(biāo)記了;且這兩個參數(shù)的類型上都持有@ cn.javass..Secure; ? |
| * *( java.util.Map<cn.javass..Model, cn.javass..Model> , ..) | 任何帶有一個java.util.Map參數(shù)的方法,且該參數(shù)類型是以< cn.javass..Model, cn.javass..Model >為泛型參數(shù);注意只匹配第一個參數(shù)為java.util.Map,不包括子類型; 如public void test(HashMap<Model, Model> map, String str);將不匹配,必須使用“* *( java.util.HashMap<cn.javass..Model,cn.javass..Model> , ..)”進行匹配; 而public void test(Map map, int i);也將不匹配,因為泛型參數(shù)不匹配 |
| * *(java.util.Collection<@cn.javass..Secure *>) | 任何帶有一個參數(shù)(類型為java.util.Collection)的方法,且該參數(shù)類型是有一個泛型參數(shù),該泛型參數(shù)類型上持有@cn.javass..Secure注解; 如public void test(Collection<Model> collection);Model類型上持有@cn.javass..Secure |
| * *(java.util.Set<? extends HashMap>) | 任何帶有一個參數(shù)的方法,且傳入的參數(shù)類型是有一個泛型參數(shù),該泛型參數(shù)類型繼承與HashMap; Spring AOP目前測試不能正常工作 |
| * *(java.util.List<? super HashMap>) | 任何帶有一個參數(shù)的方法,且傳入的參數(shù)類型是有一個泛型參數(shù),該泛型參數(shù)類型是HashMap的基類型;如public voi test(Map map); Spring AOP目前測試不能正常工作 |
| * *(*<@cn.javass..Secure *>) | 任何帶有一個參數(shù)的方法,且該參數(shù)類型是有一個泛型參數(shù),該泛型參數(shù)類型上持有@cn.javass..Secure注解; Spring AOP目前測試不能正常工作 |
?
二、within:使用“within(類型表達式)”匹配指定類型內(nèi)的方法執(zhí)行;
| 模式 | 描述 |
| within(cn.javass..*) | cn.javass包及子包下的任何方法執(zhí)行 |
| within(cn.javass..IPointcutService+) | cn.javass包或所有子包下IPointcutService類型及子類型的任何方法 |
| within(@cn.javass..Secure *) | 持有cn.javass..Secure注解的任何類型的任何方法 必須是在目標(biāo)對象上聲明這個注解,在接口上聲明的對它不起作用 |
?
三、this:使用“this(類型全限定名)”匹配當(dāng)前AOP代理對象類型的執(zhí)行方法;注意是AOP代理對象的類型匹配,這樣就可能包括引入接口方法也可以匹配;注意this中使用的表達式必須是類型全限定名,不支持通配符;
?
| 模式 | 描述 |
| this(cn.javass.spring.chapter6.service.IPointcutService) | 當(dāng)前AOP對象實現(xiàn)了 IPointcutService接口的任何方法 |
| this(cn.javass.spring.chapter6.service.IIntroductionService) | 當(dāng)前AOP對象實現(xiàn)了 IIntroductionService接口的任何方法 也可能是引入接口 |
?
?
?
?
?
?
四、target:使用“target(類型全限定名)”匹配當(dāng)前目標(biāo)對象類型的執(zhí)行方法;注意是目標(biāo)對象的類型匹配,這樣就不包括引入接口也類型匹配;注意target中使用的表達式必須是類型全限定名,不支持通配符;
| 模式 | 描述 |
| target(cn.javass.spring.chapter6.service.IPointcutService) | 當(dāng)前目標(biāo)對象(非AOP對象)實現(xiàn)了 IPointcutService接口的任何方法 |
| target(cn.javass.spring.chapter6.service.IIntroductionService) | 當(dāng)前目標(biāo)對象(非AOP對象) 實現(xiàn)了IIntroductionService 接口的任何方法 不可能是引入接口 |
?
?
?
?
?
?
?
?
五、args:使用“args(參數(shù)類型列表)”匹配當(dāng)前執(zhí)行的方法傳入的參數(shù)為指定類型的執(zhí)行方法;注意是匹配傳入的參數(shù)類型,不是匹配方法簽名的參數(shù)類型;參數(shù)類型列表中的參數(shù)必須是類型全限定名,通配符不支持;args屬于動態(tài)切入點,這種切入點開銷非常大,非特殊情況最好不要使用;
| 模式 | 描述 |
| args (java.io.Serializable,..) | 任何一個以接受“傳入?yún)?shù)類型為 java.io.Serializable” 開頭,且其后可跟任意個任意類型的參數(shù)的方法執(zhí)行,args指定的參數(shù)類型是在運行時動態(tài)匹配的 |
?
?
?
?
?
?
六、@within:使用“@within(注解類型)”匹配所以持有指定注解類型內(nèi)的方法;注解類型也必須是全限定類型名;
| 模式 | 描述 |
| @within cn.javass.spring.chapter6.Secure) | 任何目標(biāo)對象對應(yīng)的類型持有Secure注解的類方法; 必須是在目標(biāo)對象上聲明這個注解,在接口上聲明的對它不起作用 |
?
?
?
?
?
?
七、@target:使用“@target(注解類型)”匹配當(dāng)前目標(biāo)對象類型的執(zhí)行方法,其中目標(biāo)對象持有指定的注解;注解類型也必須是全限定類型名;?
?
| 模式 | 描述 |
| @target (cn.javass.spring.chapter6.Secure) | 任何目標(biāo)對象持有Secure注解的類方法; 必須是在目標(biāo)對象上聲明這個注解,在接口上聲明的對它不起作用 |
?
?
?
?
?
?
八、@args:使用“@args(注解列表)”匹配當(dāng)前執(zhí)行的方法傳入的參數(shù)持有指定注解的執(zhí)行;注解類型也必須是全限定類型名;
| 模式 | 描述 |
| @args (cn.javass.spring.chapter6.Secure) | 任何一個只接受一個參數(shù)的方法,且方法運行時傳入的參數(shù)持有注解 cn.javass.spring.chapter6.Secure;動態(tài)切入點,類似于arg指示符; |
?
?
?
?
?
?
九、@annotation:使用“@annotation(注解類型)”匹配當(dāng)前執(zhí)行方法持有指定注解的方法;注解類型也必須是全限定類型名;
| 模式 | 描述 |
| @annotation(cn.javass.spring.chapter6.Secure ) | 當(dāng)前執(zhí)行方法上持有注解 cn.javass.spring.chapter6.Secure將被匹配 |
?
?
?
?
?
十、bean:使用“bean(Bean id或名字通配符)”匹配特定名稱的Bean對象的執(zhí)行方法;Spring ASP擴展的,在AspectJ中無相應(yīng)概念;
| 模式 | 描述 |
| bean(*Service) | 匹配所有以Service命名(id或name)結(jié)尾的Bean |
?
?
?
?
十一、reference pointcut:表示引用其他命名切入點,只有@ApectJ風(fēng)格支持,Schema風(fēng)格不支持,如下所示:
?
??????
???????比如我們定義如下切面:
?
?
?????? 可以通過如下方式引用:
?
?
?????? 除了可以在@AspectJ風(fēng)格的切面內(nèi)引用外,也可以在Schema風(fēng)格的切面定義內(nèi)引用,引用方式與@AspectJ完全一樣。
?
?????? 到此我們切入點表達式語法示例就介紹完了,我們這些示例幾乎包含了日常開發(fā)中的所有情況,但當(dāng)然還有更復(fù)雜的語法等等,如果以上介紹的不能滿足您的需要,請參考AspectJ文檔。
?????? 由于測試代碼相當(dāng)長,所以為了節(jié)約篇幅本示例代碼在cn.javass.spring.chapter6. PointcutTest文件中,需要時請參考該文件。
6.6? 通知參數(shù)
?????? 前邊章節(jié)已經(jīng)介紹了聲明通知,但如果想獲取被被通知方法參數(shù)并傳遞給通知方法,該如何實現(xiàn)呢?接下來我們將介紹兩種獲取通知參數(shù)的方式。
- 使用JoinPoint獲取:Spring AOP提供使用org.aspectj.lang.JoinPoint類型獲取連接點數(shù)據(jù),任何通知方法的第一個參數(shù)都可以是JoinPoint(環(huán)繞通知是ProceedingJoinPoint,JoinPoint子類),當(dāng)然第一個參數(shù)位置也可以是JoinPoint.StaticPart類型,這個只返回連接點的靜態(tài)部分。
1) JoinPoint:提供訪問當(dāng)前被通知方法的目標(biāo)對象、代理對象、方法參數(shù)等數(shù)據(jù):
?
?
java代碼: 查看復(fù)制到剪貼板打印?
?
?
2)ProceedingJoinPoint:用于環(huán)繞通知,使用proceed()方法來執(zhí)行目標(biāo)方法:
?
?
3) JoinPoint.StaticPart:提供訪問連接點的靜態(tài)部分,如被通知方法簽名、連接點類型等:
?
java代碼: 查看復(fù)制到剪貼板打印?
使用如下方式在通知方法上聲明,必須是在第一個參數(shù),然后使用jp.getArgs()就能獲取到被通知方法參數(shù):
?
?
?
java代碼: 查看復(fù)制到剪貼板打印?
- 自動獲取:通過切入點表達式可以將相應(yīng)的參數(shù)自動傳遞給通知方法,例如前邊章節(jié)講過的返回值和異常是如何傳遞給通知方法的。
在Spring AOP中,除了execution和bean指示符不能傳遞參數(shù)給通知方法,其他指示符都可以將匹配的相應(yīng)參數(shù)或?qū)ο笞詣觽鬟f給通知方法。
?
?
java代碼: 查看復(fù)制到剪貼板打印?
?
?
?????? 切入點表達式execution(* test(*)) && args(param) :
1)首先execution(* test(*))匹配任何方法名為test,且有一個任何類型的參數(shù);
2)args(param)將首先查找通知方法上同名的參數(shù),并在方法執(zhí)行時(運行時)匹配傳入的參數(shù)是使用該同名參數(shù)類型,即java.lang.String;如果匹配將把該被通知參數(shù)傳遞給通知方法上同名參數(shù)。
其他指示符(除了execution和bean指示符)都可以使用這種方式進行參數(shù)綁定。
在此有一個問題,即前邊提到的類似于【3.1.2構(gòu)造器注入】中的參數(shù)名注入限制:在class文件中沒生成變量調(diào)試信息是獲取不到方法參數(shù)名字的。
所以我們可以使用策略來確定參數(shù)名:
?
java代碼: 查看復(fù)制到剪貼板打印?
?
java代碼: 查看復(fù)制到剪貼板打印?
?
java代碼: 查看復(fù)制到剪貼板打印?
?
java代碼: 查看復(fù)制到剪貼板打印總結(jié)
以上是生活随笔為你收集整理的AspectJ切入点语法详解的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 命令方式定时关机
- 下一篇: CXF2.7.3 与spring 3集成