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

小傅哥發表於2021-04-22
Java

作者：小傅哥
部落格：https://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 之前，需要去官網下載一個安裝包，地址：https://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，深入分析下它是如何產生的，並把它復現出來一點點深入研究下，可能也會得到意想不到的收穫，也說不定。所以凡是認真，凡事沒有壞事。
  • 關於切面、關於原始碼、關於開發，可能並不應該只注重於功能實現，甚至有時候要想辦法逃離日復一日沒有成長的工作內容。多在那些有價值的技術上下功夫，那你的收穫也是最多的。

五、系列推薦

相關文章