在平時的學習/工作中,我們會經常面臨如下場景:
- 閱讀別人的程式碼
- 閱讀框架原始碼
- 閱讀自己很久之前寫的程式碼。
千萬不要覺得工作就是單純寫程式碼,實際工作中,你會發現你的大部分時間實際都花在了閱讀和理解已有程式碼上。
為了能夠更快更清晰地搞清物件之間的呼叫關係,我經常需要用到序列圖。手動畫序列圖還是很麻煩費時間的,不過 IDEA 提供了一個叫做SequenceDiagram 的外掛幫助我們解決這個問題。通過 SequenceDiagram 這個外掛,我們一鍵可以生成時序圖。
何為序列圖?
網上對於序列圖的定義有很多,我覺得都不太好理解,太抽象了。最神奇的是,大部分文章對於序列圖的定義竟然都是一模一樣,看來大家是充分發揮了寫程式碼的“精髓”啊!
我還是簡單說一說我的理解吧!不過,說實話,我自己對於 Sequence Diagram 也不是很明朗。下面的描述如有問題和需要完善的地方,還請指出。
序列圖(Sequence Diagram),亦稱為循序圖,是一種UML行為圖。表示系統執行某個方法/操作(如登入操作)時,物件之間的順序呼叫關係。
這個順序呼叫關係可以這樣理解:你需要執行系統中某個物件 a 提供的方法/操作 login(登入),但是這個物件又依賴了物件 b 提供的方法 getUser(獲取使用者)。因此,這裡就有了 a -> b 呼叫關係之說。
再舉兩個例子來說一下!
下圖是微信支付的業務流程時序圖。這個圖描述了微信支付相關角色(顧客,商家...)在微信支付場景下,基礎支付和支付的的順序呼叫關係。
下圖是我寫的一個 HTTP 框架中的執行某個方法的序列圖。這個圖描述了我們在呼叫 InterceptorFactory
類的 loadInterceptors()
方法的時候,所涉及到的類之間的呼叫關係。
另外,國內一般更喜歡稱呼序列圖為"時序圖"。
- 如果你按照純翻譯的角度來說, sequence 這個單詞並無"時間"的意思,只有序列,順序等意思,因此也有人說“時序圖”的說法是不準確的。
- 如果從定義角度來說,時序圖這個描述是沒問題的。因為 Sequence Diagram 中每條訊息的觸發時機確實是按照時間順序執行的。
我覺得稱呼 Sequence Diagram 為時序圖或者序列圖都是沒問題的,不用太糾結。
哪些場景下需要檢視類的時序圖?
我們在很多場景下都需要時序圖,比如說:
- 閱讀原始碼 :閱讀原始碼的時候,你可能需要檢視呼叫目標方法涉及的相關類的呼叫關係。特別是在程式碼的呼叫層級比較多的時候,對於我們理解原始碼非常有用。(題外話:實際工作中,大部分時間實際我們都花在了閱讀理解已有程式碼上。)
- 技術文件編寫 :我們在寫專案介紹文件的時候,為了讓別人更容易理解你的程式碼,你需要根據核心方法為相關的類生成時序圖來展示他們之間的呼叫關係。
- 梳理業務流程 :當我們的系統業務流程比較複雜的時候,我們可以通過序列圖將系統中涉及的重要的角色和物件的之間關係視覺化出來。
- ......
如何使用 IDEA 根據類中方法生成時序圖?
通過 SequenceDiagram 這個外掛,我們一鍵可以生成時序圖。
並且,你還可以:
- 點選時序圖中的類/方法即可跳轉到對應的地方。
- 從時序圖中刪除對應的類或者方法。
- 將生成的時序圖匯出為 PNG 圖片格式。
安裝
我們直接在 IDEA 的外掛市場即可找到這個外掛。我這裡已經安裝好了。
如果你因為網路問題沒辦法使用 IDEA 自帶的外掛市場的話,也可以通過IDEA 外掛市場的官網手動下載安裝。
簡單使用
- 選中方法名(注意不要選類名),然後點選滑鼠右鍵,選擇 Sequence Diagram 選項即可!
- 配置生成的序列圖的一些基本的引數比如呼叫深度之後,我們點選 ok 即可!
你還可以通過生成的時序圖來定位到相關的程式碼,這對於我們閱讀原始碼的時候尤其有幫助!
時序圖生成完成之後,你還可以選擇將其匯出為圖片。
我的開源專案推薦
- JavaGuide :「Java學習+面試指南」一份涵蓋大部分Java程式設計師所需要掌握的核心知識。準備 Java 面試,首選 JavaGuide!
- guide-rpc-framework :A custom RPC framework implemented by Netty+Kyro+Zookeeper.(一款基於 Netty+Kyro+Zookeeper 實現的自定義 RPC 框架-附詳細實現過程和相關教程)
- jsoncat :仿 Spring Boot 但不同於 Spring Boot 的一個輕量級的 HTTP 框架
- programmer-advancement :程式設計師應該有的一些好習慣+面試必知事項!
- springboot-guide :Not only Spring Boot but also important knowledge of Spring(不只是SpringBoot還有Spring重要知識點)
- awesome-java :Collection of awesome Java project on Github(Github 上非常棒的 Java 開源專案集合).
我是 Guide 哥,一 Java 後端開發,會一點前端,自由的少年。我們下期再見!微信搜“JavaGuide”回覆“面試突擊”領取我整理的 4 本原創PDF