Java Opensources for Web Development Part I：
Chapter 5 檢測程式碼
Lession 21 : Doctorj

Java 程式碼的部份，利用 PMD 或是 Checkstyle 就可以將大多數的檢測出來，許多利用 JavaDoc 作為程式碼註解的開發團隊，就可以利用 doctorj 來檢查程式碼註解的部份是否有一些問題，例如拼字錯誤，或是參數順序有問題，這些都不算是編譯性的錯誤，所以開發工具無法針對這類錯誤進行除錯。

不過我們可以利用 Doctorj (https://www.incava.org/projects/java/doctorj/ ) 檢查 javadoc 內容是否是正確的，畢竟，提供正確的註譯對於未來整合或承接維護的工程師，能夠參考的最有價值文件。

其實利用 doctorj 的方法很簡單，當你下載解壓縮之後，先利用 ant install，進行所有的 compile 產生出 doctorj.jar ( 應該會在 /share/doctorj 的目錄之中 )，接著只要設定 set classpath=%classpath%;x:\xxxx\share\doctorj\doctorj.jar 即可。
我們只需要利用以下的指令進行檢測即可 ( 假設有存在 YourJavaFile.java )

java org.incava.doctorj.DoctorJ YourJavaFile.java

例如

*** Undocumented public class     10.         Logger log = Logger.getLogger(this.getClass().getName());                        <->

屬於 public 的 attribute 應該要清楚說明相關的使用方式。

 

例如

37.          * @return             <-----> *** @return without description.

就是說明文件中 @return 應該要說明清楚回傳值到是什麼。

總之，如果要生成完整且具有可靠度的 javadoc，我會建議使用 doctorj 來進行最後文件輸出的把關工作。