Java產生javadoc

一、Javadoc介紹

Javadoc其實平常我們都會見到，JAVASE的API文檔就是一個javadoc，很明顯，Javadoc的目的是為了能夠讓外部客戶理解我們的代碼並使用我們對外的介面。

記住：編寫Javadoc的時候只需要對外的介面即可，不需要內部的介面也編寫Javadoc注釋;

二、Javadoc注釋

一般我們的注釋形式是：

(1) //

(2) /*     */

而Javadoc注釋的形式是：

/** *  * @return */

注意：必須以/**開頭；

三、Eclipse產生Javadoc文檔

1.編寫Javadoc注釋

在Eclipse中，如果在某個方法前面輸入/**後斷行符號，則會自動產生Javadoc注釋的格式，比如：

public void setAge(int age) {this.age = age;}

在以上代碼的上一行輸入/** 後斷行符號，則會產生如下形式的注釋：

/** *  * @param age  */public void setAge(int age) {this.age = age;}

2.產生Javadoc注釋

如果想產生某個檔案或工程的Javadoc文檔，則右擊後點擊Export，然後選擇javadoc，即可產生Javadoc；

（可能會出現編碼問題，比如一個瀏覽器不會出現亂碼，而一個瀏覽器會出現亂碼，比如我產生的中文文檔，safari是亂碼，IE不是亂碼）;

四、樣本

代碼如下：

/** * 建立Person對象的另一種方式 * @param name 姓名 * @param age 年齡 * @return Person對象 */public static Person getInstance(String name,int age){return new Person(name,age);}

則產生的形式如下：