Android AOP — AspectJ的使用

如需轉(zhuǎn)載請?jiān)u論或簡信截碴,并注明出處呀伙,未經(jīng)允許不得轉(zhuǎn)載

目錄

前言

AspectJ是一個(gè)面向切面的框架你稚,它擴(kuò)展了Java語言。AspectJ定義了AOP語法醒颖,它有一個(gè)專門的編譯器(ajc)用來生成遵守Java字節(jié)編碼規(guī)范的Class文件

有關(guān)AOP的概念不是很清楚的可以看:http://www.reibang.com/p/c40528c8df17

為什么要使用AspectJ

在使用Aspectj之前妻怎,先來看下面這么一個(gè)例子,以便于我們理解我們?yōu)槭裁匆褂盟?/p>

最近項(xiàng)目在做性能優(yōu)化泞歉,需要統(tǒng)計(jì)一些方法的的耗時(shí)逼侦,那我們一般會這么去做

    public void parserHtml() {
        long currentTimeMillis = System.currentTimeMillis();
       
        //下面省略解析html的業(yè)務(wù)代碼
        .........
      
        long time = System.currentTimeMillis() - currentTimeMillis;
        System.out.println("parserHtml方法耗時(shí):" + time + "ms");
    }

但是如果我們有很多方法都需要做耗時(shí)統(tǒng)計(jì)呢,如果這些統(tǒng)計(jì)策略隨著產(chǎn)品需求所改變呢腰耙。難道我們需要在每個(gè)方法中的前后都手動編寫這樣的統(tǒng)計(jì)代碼榛丢?這樣的寫法不僅會產(chǎn)生代碼的重復(fù),同時(shí)也給代碼的維護(hù)工作造成了麻煩挺庞。所以這時(shí)候我們就要用到AOP這種面向切面編程的思想來進(jìn)行程序設(shè)計(jì)

AspectJ提供了相應(yīng)的方法晰赞,可以幫助我們方便快捷的在編譯期對方法前后進(jìn)行代碼插樁,從而實(shí)現(xiàn)業(yè)務(wù)需求和功能需求的解耦

AspectJ集成步驟

在實(shí)際項(xiàng)目中选侨,我們往往會把AspectJ相關(guān)的代碼單獨(dú)放到一個(gè)module中

  1. 新建android module命名為aspectj
目錄結(jié)構(gòu)
  1. 在aspectJ module中添加jar包依賴
repositories {
    mavenCentral()
}
dependencies {
    api 'org.aspectj:aspectjrt:1.8.9'
}
  1. 在aspectJ module中添加classpath依賴
buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'org.aspectj:aspectjtools:1.8.9'
    }
}
  1. 在aspectJ module中添加gradle執(zhí)行腳本
import org.aspectj.bridge.IMessage
import org.aspectj.bridge.MessageHandler
import org.aspectj.tools.ajc.Main

android.libraryVariants.all { variant ->
    JavaCompile javaCompile = variant.javaCompile
    javaCompile.doLast {
        String[] args = ["-showWeaveInfo",
                         "-1.5",
                         "-inpath", javaCompile.destinationDir.toString(),
                         "-aspectpath", javaCompile.classpath.asPath,
                         "-d", javaCompile.destinationDir.toString(),
                         "-classpath", javaCompile.classpath.asPath,
                         "-bootclasspath", project.android.bootClasspath.join(File.pathSeparator)
        ]

        MessageHandler handler = new MessageHandler(true);
        new Main().run(args, handler)

        def log = project.logger
        for (IMessage message : handler.getMessages(null, true)) {
            switch (message.getKind()) {
                case IMessage.ABORT:
                case IMessage.ERROR:
                case IMessage.FAIL:
                    log.error message.message, message.thrown
                    break;
                case IMessage.WARNING:
                case IMessage.INFO:
                    log.info message.message, message.thrown
                    break;
                case IMessage.DEBUG:
                    log.debug message.message, message.thrown
                    break;
            }
        }
    }
}
  1. 在app module中添加aspect module依賴
dependencies {
    api project(':aspectj')
}
  1. 同樣需要在app module下添加classpath依賴和gradle執(zhí)行腳本

app/build.gradle完整代碼

aspectj/build.gradle完整代碼

gradle配置參考文章:Aspect Oriented Programming in Android

AspectJ初體驗(yàn)

我們現(xiàn)在使用AspectJ來實(shí)現(xiàn)我們上面說到的方法統(tǒng)計(jì)

  1. 新建一個(gè)注解類BehaviorTrace

這是一個(gè)運(yùn)行時(shí)注解掖鱼。雖然我們在編譯期間就完成了代碼的注入,但是我們將我們的注解保留到運(yùn)行時(shí)援制,以便于獲取注解中的value

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface BehaviorTrace {
    String value();
}
  1. 在需要統(tǒng)計(jì)耗時(shí)的方法上加上BehaviorTrace注解
@BehaviorTrace("搖一搖")
public void shake(View btn) {
    Log.i(TAG, "搖一搖...");
    //模擬執(zhí)行耗費(fèi)時(shí)間的代碼
    SystemClock.sleep(20);
}
  1. 編寫切面類

我們先嘗試跟著注釋理解一下代碼戏挡,稍后還會做更詳細(xì)地介紹

@Aspect
public class BehaviorAspect {
    private static final String POINTCUT_METHOD =
            "execution(@com.geekholt.aspectj.annotation.BehaviorTrace * *(..))";

    //任何一個(gè)包下面的任何一個(gè)類下面的任何一個(gè)帶有BehaviorTrace的方法,構(gòu)成了這個(gè)切面
    @Pointcut(POINTCUT_METHOD)
    public void annoHaviorTrace() {
        Log.i("geekholt", "annoHaviorTrace");
    }

    //攔截方法
    @Around("annoHaviorTrace()")
    public Object weaveJoinPoint(ProceedingJoinPoint joinPoint) throws Throwable {
        Log.i("", "weaveJoinPoint");
        //拿到方法的簽名
        MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature();
        //類名
        String className = methodSignature.getDeclaringType().getSimpleName();
        //方法名
        String methodName = methodSignature.getName();
        //功能名
        BehaviorTrace behaviorTrace = methodSignature.getMethod().getAnnotation(BehaviorTrace.class);
        String fun = behaviorTrace.value();

        //方法執(zhí)行前
        long begin = System.currentTimeMillis();

        //執(zhí)行攔截方法
        Object result = joinPoint.proceed();

        //方法執(zhí)行后
        long duration = System.currentTimeMillis() - begin;
        Log.i("geekholt", String.format("功能:%s晨仑,%s的%s方法執(zhí)行褐墅,耗時(shí):%d ms", fun, className, methodName, duration));
        return result;
    }
}
  1. 運(yùn)行程序

我們只在shake方法上加上了注解,并沒有在方法中添加其他代碼洪己,但是卻完成了方法耗時(shí)統(tǒng)計(jì)妥凳。如果還有別的方法需要進(jìn)行統(tǒng)計(jì),我們同樣只需要在方法上加上注解就可以了

運(yùn)行結(jié)果

使用AspectJ實(shí)現(xiàn)方法統(tǒng)計(jì)不僅代碼優(yōu)雅码泛,侵入性非常低猾封,還可以將業(yè)務(wù)代碼和相關(guān)功能代碼在不同的模塊中進(jìn)行管理

  1. 查看build? /?intermediates?/javac目錄下的文件

可以看出澄耍,aspectJ會在編譯時(shí)幫我們在shake方法中插入一些代碼

 @BehaviorTrace("搖一搖")
    public void shake(View btn) {
        JoinPoint var3 = Factory.makeJP(ajc$tjp_0, this, this, btn);
        BehaviorAspect var10000 = BehaviorAspect.aspectOf();
        Object[] var4 = new Object[]{this, btn, var3};
        var10000.weaveJoinPoint((new MainActivity$AjcClosure1(var4)).linkClosureAndJoinPoint(69648));
    }

AspectJ詳解

相關(guān)注解介紹

  • @Aspect:聲明切面噪珊,標(biāo)記類
  • @Pointcut(切點(diǎn)表達(dá)式):定義切點(diǎn),標(biāo)記方法
  • @Before(切點(diǎn)表達(dá)式):前置通知齐莲,切點(diǎn)之前執(zhí)行
  • @Around(切點(diǎn)表達(dá)式):環(huán)繞通知痢站,切點(diǎn)前后執(zhí)行
  • @After(切點(diǎn)表達(dá)式):后置通知,切點(diǎn)之后執(zhí)行
  • @AfterReturning(切點(diǎn)表達(dá)式):返回通知选酗,切點(diǎn)方法返回結(jié)果之后執(zhí)行
  • @AfterThrowing(切點(diǎn)表達(dá)式):異常通知阵难,切點(diǎn)拋出異常時(shí)執(zhí)行

@Pointcut、@Before芒填、@Around呜叫、@After空繁、@AfterReturning、@AfterThrowing需要在切面類中使用朱庆,即標(biāo)注了@Aspect的類中

切點(diǎn)表達(dá)式

切點(diǎn)表達(dá)式的組成如下:

除了返回類型模式盛泡、方法名模式參數(shù)模式外,其它項(xiàng)都是可選的娱颊。修飾符模式指的是public傲诵、private、protected箱硕,異常模式指的是NullPointException等

execution(<修飾符模式>? <返回類型模式> <方法名模式>(<參數(shù)模式>) <異常模式>?)

下面列出幾個(gè)例子說明一下

  • 匹配所有public方法拴竹,在方法執(zhí)行之前打印"Geekholt"
@Before("execution(public * *(..))")
public void before(JoinPoint point) {
    System.out.println("Geekholt");
}
  • 匹配所有以"to"結(jié)尾的方法,在方法執(zhí)行之前打印"Geek"剧罩,在方法執(zhí)行之后打印"holt"
@Around("execution(* *to(..))")
public void around(ProceedingJoinPoint joinPoint) {
    System.out.println("Geek");
    joinPoint.proceed();
    System.out.println("holt");
}
  • 匹配com.geekholt包下及其子包中以"to"結(jié)尾的方法栓拜,在方法執(zhí)行之后打印"Geekholt"
@After("execution(* com.geekholt..*to(..))")
public void after(JoinPoint point) {
    System.out.println("Geekholt");
}
  • 匹配com.geekholt包下所有返回類型是int的方法,在方法返回結(jié)果之后打印"Geekholt"
@AfterReturning("execution(int com.geekholt.*(..))")
public void afterReturning(JoinPoint point, Object returnValue) {
    System.out.println("Geekholt");
}
  • 匹配com.geekholt包及其子包中的所有方法斑响,當(dāng)方法拋出異常時(shí)菱属,打印"ex = 報(bào)錯(cuò)信息"
@AfterThrowing(value = "execution(* com.geekholt..*(..))", throwing = "ex")
public void afterThrowing(Throwable ex) {
    System.out.println("ex = " + ex.getMessage());
}

@Pointcut的使用

@Pointcut是專門用來定義切點(diǎn)的,讓切點(diǎn)表達(dá)式可以復(fù)用

你可能需要在切點(diǎn)執(zhí)行之前和切點(diǎn)報(bào)出異常時(shí)做些動作(如:出錯(cuò)時(shí)記錄日志)舰罚,可以這么做:

@Before("execution(* com.geekholt..*(..))")
public void before(JoinPoint point) {
    System.out.println("Geekholt");
}

@AfterThrowing(value = "execution(* com.geekholt..*(..))", throwing = "ex")
public void afterThrowing(Throwable ex) {
    System.out.println("記錄日志");
}

可以看到纽门,表達(dá)式是一樣的,那要怎么重用這個(gè)表達(dá)式呢营罢?這就需要用到@Pointcut注解了赏陵,@Pointcut注解是注解在一個(gè)空方法上的,如:

@Pointcut("execution(* com.geekholt..*(..))")
public void pointcut() {}

這時(shí)饲漾,pointcut()就等價(jià)于execution(* com.geekholt..*(..))蝙搔,那么上面的代碼就可以改成這樣

@Pointcut("execution(* com.geekholt..*(..))")
public void pointcut() {}

@Before("pointcut()")
public void before(JoinPoint point) {
    System.out.println("Geekholt");
}

@AfterThrowing(value = "pointcut()", throwing = "ex")
public void afterThrowing(Throwable ex) {
    System.out.println("記錄日志");
}

Kotlin中使用AspectJ

雖然是kotlin和java之間可以互相調(diào)用,但是想要在kotlin中直接使用aspectJ是不會有效果的考传,這里推薦一個(gè)大神寫的框架aspectjx吃型,很好的支持了Kotlin,具體的使用直接看github上的文檔,這里就不過多介紹啦

總結(jié)

AspectJ在Android中還可以做很多事情,比如無埋點(diǎn)旋廷、參數(shù)校驗(yàn)和判空锚烦、Android API23+權(quán)限控制、事件防抖、異常處理、緩存等等
學(xué)習(xí)AspectJ重要的是理解AOP的思想,在合適的場景下使用AOP挺邀,通過正確的切點(diǎn)表達(dá)式找準(zhǔn)切入點(diǎn)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子端铛,更是在濱河造成了極大的恐慌泣矛,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,682評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件禾蚕,死亡現(xiàn)場離奇詭異乳蓄,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)夕膀,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,277評論 3 395
  • 文/潘曉璐 我一進(jìn)店門虚倒,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人产舞,你說我怎么就攤上這事魂奥。” “怎么了易猫?”我有些...
    開封第一講書人閱讀 165,083評論 0 355
  • 文/不壞的土叔 我叫張陵耻煤,是天一觀的道長。 經(jīng)常有香客問我准颓,道長哈蝇,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,763評論 1 295
  • 正文 為了忘掉前任攘已,我火速辦了婚禮炮赦,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘样勃。我一直安慰自己吠勘,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,785評論 6 392
  • 文/花漫 我一把揭開白布峡眶。 她就那樣靜靜地躺著剧防,像睡著了一般。 火紅的嫁衣襯著肌膚如雪辫樱。 梳的紋絲不亂的頭發(fā)上峭拘,一...
    開封第一講書人閱讀 51,624評論 1 305
  • 那天,我揣著相機(jī)與錄音狮暑,去河邊找鬼鸡挠。 笑死,一個(gè)胖子當(dāng)著我的面吹牛心例,可吹牛的內(nèi)容都是我干的宵凌。 我是一名探鬼主播鞋囊,決...
    沈念sama閱讀 40,358評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼止后,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起译株,我...
    開封第一講書人閱讀 39,261評論 0 276
  • 序言:老撾萬榮一對情侶失蹤瓜喇,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后歉糜,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體乘寒,經(jīng)...
    沈念sama閱讀 45,722評論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,900評論 3 336
  • 正文 我和宋清朗相戀三年匪补,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了伞辛。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,030評論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡夯缺,死狀恐怖蚤氏,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情踊兜,我是刑警寧澤竿滨,帶...
    沈念sama閱讀 35,737評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站捏境,受9級特大地震影響于游,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜垫言,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,360評論 3 330
  • 文/蒙蒙 一贰剥、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧筷频,春花似錦鸠澈、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,941評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至葵袭,卻和暖如春涵妥,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背坡锡。 一陣腳步聲響...
    開封第一講書人閱讀 33,057評論 1 270
  • 我被黑心中介騙來泰國打工蓬网, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人鹉勒。 一個(gè)月前我還...
    沈念sama閱讀 48,237評論 3 371
  • 正文 我出身青樓帆锋,卻偏偏與公主長得像,于是被迫代替她去往敵國和親禽额。 傳聞我的和親對象是個(gè)殘疾皇子锯厢,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,976評論 2 355