「IDEA插件精選」安利一個IDEA騷操作:一鍵生成方法的序列圖

在平時的學習/工作中,我們會經(jīng)常面臨如下場景:

  1. 閱讀別人的代碼
  2. 閱讀框架源碼
  3. 閱讀自己很久之前寫的代碼。

千萬不要覺得工作就是單純寫代碼,實際工作中,你會發(fā)現(xiàn)你的大部分時間實際都花在了閱讀和理解已有代碼上。

為了能夠更快更清晰地搞清對象之間的調(diào)用關(guān)系,我經(jīng)常需要用到序列圖。手動畫序列圖還是很麻煩費時間的,不過 IDEA 提供了一個叫做SequenceDiagram 的插件幫助我們解決這個問題。通過 SequenceDiagram 這個插件,我們一鍵可以生成時序圖。

何為序列圖?

網(wǎng)上對于序列圖的定義有很多,我覺得都不太好理解,太抽象了。最神奇的是,大部分文章對于序列圖的定義竟然都是一模一樣,看來大家是充分發(fā)揮了寫代碼的“精髓”??!

我還是簡單說一說我的理解吧!不過,說實話,我自己對于 Sequence Diagram 也不是很明朗。下面的描述如有問題和需要完善的地方,還請指出。

序列圖(Sequence Diagram),亦稱為循序圖,是一種UML行為圖。表示系統(tǒng)執(zhí)行某個方法/操作(如登錄操作)時,對象之間的順序調(diào)用關(guān)系。

這個順序調(diào)用關(guān)系可以這樣理解:你需要執(zhí)行系統(tǒng)中某個對象 a 提供的方法/操作 login(登錄),但是這個對象又依賴了對象 b 提供的方法 getUser(獲取用戶)。因此,這里就有了 a -> b 調(diào)用關(guān)系之說。

再舉兩個例子來說一下!

下圖是微信支付的業(yè)務(wù)流程時序圖。這個圖描述了微信支付相關(guān)角色(顧客,商家...)在微信支付場景下,基礎(chǔ)支付和支付的的順序調(diào)用關(guān)系。

img

下圖是我寫的一個 HTTP 框架中的執(zhí)行某個方法的序列圖。這個圖描述了我們在調(diào)用 InterceptorFactory類的 loadInterceptors() 方法的時候,所涉及到的類之間的調(diào)用關(guān)系。

另外,國內(nèi)一般更喜歡稱呼序列圖為"時序圖"。

  • 如果你按照純翻譯的角度來說, sequence 這個單詞并無"時間"的意思,只有序列,順序等意思,因此也有人說“時序圖”的說法是不準確的。
  • 如果從定義角度來說,時序圖這個描述是沒問題的。因為 Sequence Diagram 中每條消息的觸發(fā)時機確實是按照時間順序執(zhí)行的。

我覺得稱呼 Sequence Diagram 為時序圖或者序列圖都是沒問題的,不用太糾結(jié)。

哪些場景下需要查看類的時序圖?

我們在很多場景下都需要時序圖,比如說:

  1. 閱讀源碼 :閱讀源碼的時候,你可能需要查看調(diào)用目標方法涉及的相關(guān)類的調(diào)用關(guān)系。特別是在代碼的調(diào)用層級比較多的時候,對于我們理解源碼非常有用。(題外話:實際工作中,大部分時間實際我們都花在了閱讀理解已有代碼上。
  2. 技術(shù)文檔編寫 :我們在寫項目介紹文檔的時候,為了讓別人更容易理解你的代碼,你需要根據(jù)核心方法為相關(guān)的類生成時序圖來展示他們之間的調(diào)用關(guān)系。
  3. 梳理業(yè)務(wù)流程 :當我們的系統(tǒng)業(yè)務(wù)流程比較復雜的時候,我們可以通過序列圖將系統(tǒng)中涉及的重要的角色和對象的之間關(guān)系可視化出來。
  4. ......

如何使用 IDEA 根據(jù)類中方法生成時序圖?

通過 SequenceDiagram 這個插件,我們一鍵可以生成時序圖。

并且,你還可以:

  1. 點擊時序圖中的類/方法即可跳轉(zhuǎn)到對應(yīng)的地方。
  2. 從時序圖中刪除對應(yīng)的類或者方法。
  3. 將生成的時序圖導出為 PNG 圖片格式。

安裝

我們直接在 IDEA 的插件市場即可找到這個插件。我這里已經(jīng)安裝好了。

如果你因為網(wǎng)絡(luò)問題沒辦法使用 IDEA 自帶的插件市場的話,也可以通過IDEA 插件市場的官網(wǎng)手動下載安裝。

簡單使用

  1. 選中方法名(注意不要選類名),然后點擊鼠標右鍵,選擇 Sequence Diagram 選項即可!
  1. 配置生成的序列圖的一些基本的參數(shù)比如調(diào)用深度之后,我們點擊 ok 即可!

你還可以通過生成的時序圖來定位到相關(guān)的代碼,這對于我們閱讀源碼的時候尤其有幫助!

時序圖生成完成之后,你還可以選擇將其導出為圖片。

我的開源項目推薦

  1. JavaGuide :「Java學習+面試指南」一份涵蓋大部分Java程序員所需要掌握的核心知識。準備 Java 面試,首選 JavaGuide!
  2. guide-rpc-framework :A custom RPC framework implemented by Netty+Kyro+Zookeeper.(一款基于 Netty+Kyro+Zookeeper 實現(xiàn)的自定義 RPC 框架-附詳細實現(xiàn)過程和相關(guān)教程)
  3. jsoncat :仿 Spring Boot 但不同于 Spring Boot 的一個輕量級的 HTTP 框架
  4. programmer-advancement :程序員應(yīng)該有的一些好習慣+面試必知事項!
  5. springboot-guide :Not only Spring Boot but also important knowledge of Spring(不只是SpringBoot還有Spring重要知識點)
  6. awesome-java :Collection of awesome Java project on Github(Github 上非常棒的 Java 開源項目集合).

作者介紹: Github 70k Star 項目 JavaGuide(公眾號同名) 作者。每周都會在公眾號更新一些自己原創(chuàng)干貨。公眾hao后臺回復“1”領(lǐng)取Java工程師必備學習資料+面試突擊pdf。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容