一個Bug,讓我發現了 Java 界的.AJ(錐)!

作者:小傅哥
部落格://bugstack.cn

沉澱、分享、成長,讓自己和他人都能有所收穫!😄

一、前言

話我放這,踩過的坑越多頭髮越少!

說來也是奇怪,只要是學編程的,從初次接觸的 Java 到安裝 JDK、IDEA、MYSQL, 再到接觸 Spring、MyBatis、RPC、MQ,哪怕有時候在淺的坑也會跳進去嘗嘗鮮,一遍抓著頭髮,一手點著滑鼠也幾乎是你的常態。你的鍵盤裡總是有很多被抓碎的頭髮!

但,哪怕是抓了這麼頭髮,還是遇到了一個滿腦子都是騷操作的小伙。「傅哥,我的切面怎麼攔截不到?我是照著你的《SpringBoot 中間件設計和開發》專欄寫的,你給我看看吧,我都弄了一天了」

接下來我帶著大家一起看看什麼是快樂星球,他是怎麼一頓騷操作讓切面攔截不到的!

二、滿腦子都是騷操作

1. 遇到問題

上周,謝飛機(化名)發過來了自己的手擼的中間件源碼,說這程式碼都沒有啥怎麼就不能切面呢?

  • 最開始我大意了,讓謝飛機發了一些程式碼截圖。
  • 看截圖的程式碼,這完全就和我寫的中間件里的程式碼一毛一樣,沒啥問題呀,包路徑也能掃描到,咋就不能切面了?
  • 我說你打個斷點調試下,看看怎麼切不到了呢?嘿,調試了,直接通過,就是沒切面到。
  • 此時我思考了JDK版本、環境配置、Spring上下文、切面的定義、包的路徑以及這小子是否忽悠我?
  • 最後我抱著這小子忽悠我的心裡,把源碼要過來了。

2. 發現問題

看了幾遍源碼沒發現問題,開始調試,還真它哈拉哨的不進這個切面,接下來;

  • 謝飛機的源碼保留,複製出來一份新的。
  • 我的目的要先讓他跑起來,在研究。接下來我把自己的工程里的 DoJoinPoint 拷貝過來粘貼進去,噗察一下貼進去了,沒提示替換,雖然有報錯但兩個類能共存,如下:

    • 這就神奇了哈,我當時懷疑是不它那 DoJoinPoint 不是一個正經 Java 類,路徑不對?有看不見的特殊字元?
  • 既然發現這個類不對,那行先刪掉。讓程式先跑起來,確保除了這個類其他的內容沒有問題,這樣也好排查問題。
  • 還別說,去掉這個錯誤類,程式可以正常運行,攔截到切面內容了。
  • 既然程式能跑了,我就想著這可以看看問題出在哪了,沒想到就只打開個文件夾,就發現了一個神奇的AJ!這貨壓根就不是 Java 類!

3. 排查問題

要不是IDEA把 .aj 這貨顯示成 C 類的圖標,可能早就發現問題了。緊接著把這錯誤類的截圖發給了謝飛機,問它你是怎麼創建的?他說實話了

  • 謝飛機先說自己偷懶了,哈哈哈,讓人怪不好意思的!
  • 他說在創建 DoJoinPoint 時,看到一個 Aspect 的選項,以為這個就是創建切面的快捷操作,如圖;
  • 創建完成以後發現有點不對,不是 class 類型的,是個 aspect,於是他手動把 aspect 改成了 class,如圖;
  • 所以,謝飛機實際創建出來的是一個 aspect 的以 .aj 結尾的類,並不是一個正經的 Java 類,所以切面不到,也根本沒有對應的 class 文件。

三、如何正確使用 Aspect 的 .aj 類

AspectJ,簡稱 AJ 我自己說的

AspectJ 其實也是 AOP 的一種實現技術,功能類似於攔截器,在集成在 IntelliJ IDEA 開發工具里。在使用 IntelliJ IDEA 編寫 AspectJ 程式碼之前需要本機先安裝 AspectJ 工具包。否則你的 .aj 類不能運行,同時IDEA類顯示出來的 .aj 類,也是C的標識

接下來我們就來聊聊關於這個東西怎麼使用,別再被 .aj 騙了。

1. 安裝 AspectJ

在使用 AspectJ 之前,需要去官網下載一個安裝包,地址://www.eclipse.org/aspectj/downloads.php 如果官網下載的很慢,可以從我提供的源碼中獲取,也可以從其他途徑搜索下載 aspectj-1.9.4.jar

下載完成安裝;

  • 雙擊安裝
  • 命令安裝 java -jar aspectj-1.9.4.jar
  • 配置說明:沒有配置,傻瓜式下一步就可以了

  • 默認配置安裝完成以後會在C盤創建出一個文件夾 C:\aspectj1.9,包括:bin、doc、lib等,後面我們就會使用到這些內容。

2. AspectJ 插件

在專業版 IDEA 中開發 AspectJ,需要安裝以下兩個插件:

  • Spring AOP/@AspectJ
  • AspectJ Support

3. 添加依賴 aspectjrt.jar

開始之前需要在項目中添加 aspectjrt.jar 依賴,aspectjrt.jar 即 AspectJ 安裝目錄中lib目錄下的jar包。你可以複製到工程中引入,也可以直接引入

  1. 在工程上滑鼠右鍵,點擊 Open Module Setting 打開 Project Structure
  2. 點擊 Libraries 選項卡,和上面的 + 號,創建 New Project Library
  3. 選擇 C:\aspectj1.9\lib\aspectjrt.jar 路徑,點擊即可配置完成

4. 配置AspectJ編譯器

IDEA 默認使用 javac 編譯器,這裡需要配置 AspectJ 的編譯器 ajc,在 IDEA 中做相應配置。

  1. 打開 IDEA -> File -> Settings 對話
  2. 選擇 Build,Execution,Deployment -> Compiler -> Java Compiler
  3. Use complier:選擇 Ajc
  4. 在 Path to aspectjtools.jar 里配置路徑 C:\aspectj1.9\lib\aspectjtools.jar

5. 案例測試

創建 Aspect 類

public aspect DoAspect {

    pointcut logPointcut():call(* ApiTest.hi(..));

    void around():call(void ApiTest.hi(..)){
        System.out.println("call 開始...");
        proceed();
        System.out.println("call 結束...");
    }

    before(): logPointcut(){
        System.out.println("方法執行 before");
    }

    after(): logPointcut(){
        System.out.println("方法執行 after");
    }

}

測試類

public class ApiTest {

    public void hi(){
        System.out.println("Hi Aspect");
    }

    public static void main(String[] args) {
        ApiTest apiTest = new ApiTest();
        apiTest.hi();
    }

}

測試結果

call 開始...
方法執行 before
Hi Aspect
call 結束...
方法執行 after

Process finished with exit code 0
  • 到這,才是一個關於 Aspect 類的正確打開方式,關於 Aspect 的使用也可以嘗試搞搞,此篇還只是關於此類切面寫法的一個入門。

四、總結

  • 你的程式碼越粗獷、越豪放、越騷氣,幾乎你遇到的問題也是越多的,可能就是因為沒有遵守一定的研發執行規範,所以遇到的這些有點傻的問題,幾乎會浪費掉你一個上午或者一天。
  • 但有些時候如果你能認真對待你弄出來的bug,深入分析下它是如何產生的,並把它復現出來一點點深入研究下,可能也會得到意想不到的收穫,也說不定。所以凡是認真,凡事沒有壞事。
  • 關於切面、關於源碼、關於開發,可能並不應該只注重於功能實現,甚至有時候要想辦法逃離日復一日沒有成長的工作內容。多在那些有價值的技術上下功夫,那你的收穫也是最多的。

五、系列推薦