開發(fā)軟件時,我的主要目標(biāo)之一是:要么防止將缺陷引入代碼庫,要么限制缺陷的生存期;換言之,要盡早找到缺陷。很顯然,越是了解如何編寫更好的代碼以及如何有效測試軟件,就越能及早地捕捉到缺陷。我也很想要一張能發(fā)現(xiàn)潛在缺陷的安全之網(wǎng)。
在本系列 八月份 的那期文章中,我得出了這樣的結(jié)論:將檢驗工具集成到構(gòu)建過程(例如,使用 Ant 或 Maven)中,能夠建立起一種尋找潛在缺陷的方法。盡管這種方法使一致性成為可能并超越了 IDE,但它也有一點反作用。必須在本地構(gòu)建軟件或等待 Continuous Integration 構(gòu)建的運(yùn)行。如果使用 Eclipse 插件,就可以在通過 Continuous Integration 構(gòu)建或集成前 發(fā)現(xiàn)一些這樣的沖突。這就促成了我稱為漸進(jìn)編程 的編程方式,在這種方式下,允許在編碼過程中進(jìn)行一定程度的質(zhì)量檢驗 ——再也不能比這個更早了!
本文涵蓋了我所認(rèn)為的 “五大” 代碼分析領(lǐng)域:
- 編碼標(biāo)準(zhǔn)
- 代碼重復(fù)
- 代碼覆蓋率
- 依賴項分析
- 復(fù)雜度監(jiān)控
可以用接下來的幾個靈活的 Eclipse 插件來揭示這些分析領(lǐng)域:
- CheckStyle:用于編碼標(biāo)準(zhǔn)
- PMD 的 CPD:幫助發(fā)現(xiàn)代碼重復(fù)
- Coverlipse:測量代碼覆蓋率
- JDepend:提供依賴項分析
- Eclipse Metric 插件:有效地查出復(fù)雜度
安裝 Eclipse 插件
安裝 Eclipse 插件再簡單不過了,只需要幾個步驟。在開始之前,最好把該插件下載站點的 URL 準(zhǔn)備好。表 1 是本文用到的插件的列表:
表 1. 代碼改進(jìn)插件和相應(yīng)的下載站點 URL工具 | 目的 | Eclipse 插件的 URL |
---|
CheckStyle | 編碼標(biāo)準(zhǔn)分析 | http://eclipse-cs.sourceforge.net/update/ |
Coverlipse | 測試代碼覆蓋率 | http://coverlipse.sf.net/update |
CPD | 復(fù)制/粘貼檢驗 | http://pmd.sourceforge.net/eclipse/ |
JDepend | 包依賴項分析 | http://andrei.gmxhome.de/eclipse/ |
Metrics | 復(fù)雜度監(jiān)控 | http://metrics.sourceforge.net/update |
知道了這些有用插件的下載地址后,安裝插件就是一個極簡單的過程。啟動 Eclipse,然后遵循下列步驟:
- 選擇 Help | Software Updates | Find and Install,如圖 1 所示:
圖 1. 尋找并安裝 Eclipse 插件

- 選擇 Search for new features to install 單選按鈕,單擊 Next。
- 單擊 New Remote Site,輸入要安裝的插件名和 URL(參見圖 2),單擊 OK,然后單擊 Finish 來顯示 Eclipse 更新管理器。
圖 2. 配置新的遠(yuǎn)程站點

- 在 Eclipse 更新管理器中,有一個查看插件各方面特性的選項。我通常選擇頂級項,如圖 3 所示。選擇您需要的選項并單擊 Finish。Eclipse 現(xiàn)在安裝該插件。您需要重啟 Eclipse 實例。
圖 3. 安裝 Eclipse 插件

請遵循上述這些步驟來安裝其他的 Eclipse 插件;只需改變插件名和相應(yīng)的下載位置即可。
回頁首
用 CheckStyle 校正標(biāo)準(zhǔn)
代碼庫的可維護(hù)性直接影響著軟件的整個成本。另外,不佳的可維護(hù)性還會讓開發(fā)人員十分頭痛(進(jìn)而導(dǎo)致開發(fā)人員的缺乏)—— 代碼越容易修改,就越容易添加新的產(chǎn)品特性。像 CheckStyle 這樣的工具可以協(xié)助尋找那些可影響到可維護(hù)性、與編碼標(biāo)準(zhǔn)相沖突的地方,比方說,過大的類、太長的方法和未使用的變量等等。
使用 Eclipse 的 CheckStyle 插件的好處是能夠在編碼過程中了解到源代碼上下文的各種編碼沖突,讓開發(fā)人員更可能在簽入該代碼前真正處理好這些沖突。您也幾乎可以把 CheckStyle 插件視作一個連續(xù)的代碼復(fù)查工具!
安裝 CheckStyle 插件并做如下配置(參見圖 4):
- 選擇 Project,然后選擇 Eclipse 菜單中的 Properties 菜單項。
- 選擇 CheckStyle active for this project 復(fù)選框,單擊 OK。
圖 4. 在 Eclipse 中配置 CheckStyle 插件

Eclipse 重新構(gòu)建工作空間,并在 Eclipse 控制臺中列示已發(fā)現(xiàn)的編碼沖突,如圖 5 所示:
圖 5. Eclipse 中 CheckStyle 的代碼沖突列表 
使用 CheckStyle 插件在 Eclipse 內(nèi)嵌入編碼標(biāo)準(zhǔn)檢驗是一種很棒的方法,用這種方法可以在編碼時 積極地改進(jìn)代碼,從而在開發(fā)周期的早期發(fā)現(xiàn)源代碼中潛在的缺陷。這么做還有更多的好處,如節(jié)省時間、減少失敗,也因此會減少項目的成本。沒錯,這就是一種積極主動的方式!
回頁首
用 Coverlipse 確認(rèn)覆蓋率
Coverlipse 是一個用于 Cobertura 的 Eclipse 插件,Cobertura 是一個代碼覆蓋率工具,可以用它來評估具有相應(yīng)測試的源代碼的比率。Cobertura 也提供一個 Ant 任務(wù)和 Maven 插件,但用 Cobertura,您可以在編寫代碼時 評估代碼覆蓋率。您見過這樣的模式嗎?
通過選擇 Eclipse 菜單項 Run 安裝 Coverlipse 插件并將其和 JUnit 關(guān)聯(lián)起來,該操作會顯示一系列運(yùn)行配置選項,例如 JUnit、SWT 應(yīng)用程序和 Java™ 應(yīng)用程序。右鍵單擊它并選擇 JUnit w/Coverlipse 節(jié)點中的 New。在這里,需要確定 JUnit 測試的位置,如圖 6 所示:
圖 6. 配置 Coverlipse 以獲取代碼覆蓋率 
一旦單擊了 Run,Eclipse 會運(yùn)行 Coverlipse 并在源代碼(如圖 7 所示)中嵌入標(biāo)記,該標(biāo)記顯示了具有相關(guān) JUnit 測試的代碼部分:
圖 7. Coverlipse 生成的具有嵌入類標(biāo)記的報告 
正如您所見,使用 Coverlipse Eclipse 插件可以更快地確定代碼覆蓋率。例如,這種實時數(shù)據(jù)功能有助于在將代碼簽入 CM 系統(tǒng)前 更好地進(jìn)行測試。這對漸進(jìn)編程來說意味著什么呢?
回頁首
用 CPD 捕捉代碼重復(fù)
Eclipse 的 PMD 插件提供了一項叫做 CPD(或復(fù)制粘貼探測器)的功能,用于尋找重復(fù)的代碼。為在 Eclipse 中使用這項便利的工具,需要安裝具有 PMD 的 Eclipse 插件,該插件具有 CPD 功能。
為尋找重復(fù)的代碼,請用右鍵單擊一個 Eclipse 項目并選擇 PMD | Find Suspect Cut and Paste,如圖 8 所示:
圖 8. 使用 CPD 插件運(yùn)行復(fù)制粘貼檢驗
一旦運(yùn)行了 CPD,您的 Eclipse 根目錄下就會創(chuàng)建出一個 report
文件夾,其中包含一個叫做 cpd.txt 的文件,文件中列示了所有重復(fù)的代碼。圖 9 中是一個 cpd.txt 文件的例子:
圖 9. Eclipse 插件生成的 CPD 文本文件
靠人工來尋找重復(fù)的代碼是一項挑戰(zhàn),但使用像 CPD 這樣的插件卻能在編碼時輕松地發(fā)現(xiàn)重復(fù)的代碼。
回頁首
使用 JDepend 進(jìn)行依賴項檢查
JDepend 是個可免費獲取的開源工具,它為包依賴項提供面向?qū)ο蟮亩攘恐担源酥该鞔a庫的彈性。換句話說,JDepend 可有效測量一個架構(gòu)的健壯性(反之,脆弱性)。
除了 Eclipse 插件,JDepend 還提供一個 Ant 任務(wù)、Maven 插件和一個 Java 應(yīng)用程序,用以獲取這些度量值。對于相同的信息,它們有著不同的傳遞機(jī)制;但 Eclipse 插件的特別之處和相應(yīng)優(yōu)點是:它能以更接近源代碼(即,編碼時)的方式傳遞這條信息。
圖 10 演示了使用 Eclipse JDepend 插件的方法:通過右鍵單擊源文件夾并選擇 Run JDepend Analysis。一定要選擇一個含源代碼的源文件夾;否則看不到此菜單項。
圖 10. 使用 JDepend Analysis 分析代碼
圖 11 顯示了運(yùn)行 JDepend Analysis 時生成的報告。左邊顯示包,右邊顯示針對每個包的依賴項度量值。
圖 11. Eclipse 項目中的包依賴項 
正如您所見,JDepend 插件提供了有助于不斷觀察架構(gòu)可維護(hù)性變化的大量信息 —— 這其中最大的好處是您可以在編碼時看到這些數(shù)據(jù)。
回頁首
用 Metrics 測量復(fù)雜度
“五大”代碼分析最后的一項是測量復(fù)雜度。Eclipse 提供一種叫做 Metrics 的插件,使用該插件可以進(jìn)行許多有用的代碼度量,包括圈復(fù)雜度度量,它用于測量方法中惟一路徑的數(shù)目。
安裝 Metrics 插件并重啟 Eclipse;然后遵循下列步驟:
- 右鍵單擊您的項目并選擇 Properties 菜單。在結(jié)果窗口中,選擇 Enable Metrics plugin 復(fù)選框并單擊 OK,如圖 12 所示:
圖 12. 為項目配置 Metrics

- 從 Eclipse 中選擇 Window 菜單打開 Metrics 視圖,然后選擇 Show View | Other...。
- 選擇 Metrics | Metrics View 打開如圖 13 中顯示的窗口。您需要使用 Java 透視圖并重新構(gòu)建項目,從而顯示這些度量值。
圖 13. 打開 Eclipse 中的 Metrics View

- 單擊 OK 來顯示如圖 14 中的窗口。
在此例中,我正在查看一個單獨方法的圈復(fù)雜度。真正妙的是您可以雙擊 Metrics 列表中的方法,該插件會在 Eclipse 編輯器中為此方法打開源代碼。這就讓修正變得超級簡單(如果需要的話)!
圖 14. 查看方法的圈復(fù)雜度

正如我之前提到過的,Eclipse Metrics 插件還提供了許多功能強(qiáng)大的度量值,有助于您在開發(fā)軟件的過程中改進(jìn)代碼 —— 可見,它是一個漸進(jìn)編程意義上的插件!
回頁首
合適的才是最好的
正如您從本文中看到的那樣,將“五大”測量方法,即編碼標(biāo)準(zhǔn)、代碼重復(fù)、代碼覆蓋率、依賴項分析和復(fù)雜度監(jiān)控,用于改進(jìn)代碼質(zhì)量十分重要。但適合您的才是好的。請記住還有其他許多可用的 Eclipse 插件(比如 PMD 和 FindBugs)能夠幫助您在開發(fā)周期的早期改進(jìn)代碼質(zhì)量。不管您想要的工具或偏愛的方法是什么,重要的是:行動起來去積極改進(jìn)代碼質(zhì)量并讓手工代碼檢驗的過程變得更加有效。我估計您使用這些插件一段時間后,就再也離不開它們了。
參考資料
學(xué)習(xí)
獲得產(chǎn)品和技術(shù)
討論
- 提高代碼質(zhì)量論壇:developerWorks 的積極貢獻(xiàn)者 Andrew Glover 是一名專注于改進(jìn)代碼質(zhì)量的顧問,他為這個由他主持的論壇帶來了很多相當(dāng)專業(yè)的知識。
關(guān)于作者