Jar使用說(shuō)明和JavaDoc的使用說(shuō)明
Jar使用說(shuō)明
功能說(shuō)明：
Java歸檔工具
語(yǔ)法：
jar [ 命令選項(xiàng) ] [manifest] destination input-file [input-files]
補(bǔ)充說(shuō)明：
jar工具是個(gè)java應(yīng)用程序，可將多個(gè)文件合并為單個(gè)JAR歸檔文件。jar是個(gè)多用途的存檔及壓縮工具，它基于ZIP和ZLIB壓縮格式。然而，設(shè)計(jì)jar的主要目的是便于將java applet或應(yīng)用程序打包成單個(gè)歸檔文件。將applet或應(yīng)用程序的組件(.class 文件、圖像和聲音)合并成單個(gè)歸檔文件時(shí)，可以用java代理(如瀏覽器)在一次HTTP事務(wù)處理過(guò)程中對(duì)它們進(jìn)行下載，而不是對(duì)每個(gè)組件都要求一個(gè)新連接。這大大縮短了下載時(shí)間。jar還能壓縮文件，從而進(jìn)一步提高了下載速度。此外，它允許applet的作者對(duì)文件中的各個(gè)項(xiàng)進(jìn)行簽名，因而可認(rèn)證其來(lái)源。jar工具的語(yǔ)法基本上與tar命令的語(yǔ)法相同。
命令選項(xiàng)
-c 在標(biāo)準(zhǔn)輸出上創(chuàng)建新歸檔或空歸檔。
-t 在標(biāo)準(zhǔn)輸出上列出內(nèi)容表。
-x[file] 從標(biāo)準(zhǔn)輸入提取所有文件，或只提取指定的文件。如果省略了file，則提取所有文件；否則只提取指定文件。
-f 第二個(gè)參數(shù)指定要處理的jar文件。在-c(創(chuàng)建)情形中，第二個(gè)參數(shù)指的是要?jiǎng)?chuàng)建的jar文件的名稱(不是在標(biāo)準(zhǔn)輸出上)。在-t(表(或-x(抽取)這兩種情形中，第二個(gè)參數(shù)指定要列出或抽取的jar文件。
-v 在標(biāo)準(zhǔn)錯(cuò)誤輸出設(shè)備上生成長(zhǎng)格式的輸出結(jié)果。
-m 包括指定的現(xiàn)有清單文件中的清單信息。用法舉例：“jar cmf myManifestFile myJarFile *.class”
-0 只儲(chǔ)存，不進(jìn)行 ZIP 壓縮。
-M 不創(chuàng)建項(xiàng)目的清單文件。
-u 通過(guò)添加文件或更改清單來(lái)更新現(xiàn)有的 JAR 文件。例如：“jar -uf foo.jar foo.class”將文件 foo.class 添加到現(xiàn)有的JAR文件foo.jar中，而“jar umf manifest foo.jar”則用manifest中的信息更新foo.jar的清單。
-C 在執(zhí)行 jar 命令期間更改目錄。例如：“jar -uf foo.jar -C classes *”將classes目錄內(nèi)的所有文件加到foo.jar中，但不添加類目錄本身。
程序示例
1:將當(dāng)前目錄下所有CLASS文件打包成新的JAR文件：
jar cf file.jar *.class
2:顯示一個(gè)JAR文件中的文件列表
jar tf file.jar
3:將當(dāng)前目錄下的所有文件增加到一個(gè)已經(jīng)存在的JAR文件中
jar cvf file.jar *
javadoc使用說(shuō)明
功能說(shuō)明
Java API文檔生成器從Java源文件生成API文檔HTML頁(yè)。
語(yǔ)法：
javadoc [ 命令選項(xiàng) ] [ 包名 ] [ 源文件名 ] [ @files ]
其中[ 包名 ]為用空格分隔的一系列包的名字，包名不允許使用通配符，如（*）。[ 源文件名 ]為用空格分隔的一系列的源文件名，源文件名可包括路徑和通配符，如（*）。[ @files ]是以任何次序包含包名和源文件的一個(gè)或多個(gè)文件。
補(bǔ)充說(shuō)明
Javadoc解析Java源文件中的聲明和文檔注釋，并產(chǎn)生相應(yīng)的HTML頁(yè)缺省），描述公有類、保護(hù)類、內(nèi)部類、接口、構(gòu)造函數(shù)、方法和域。
在實(shí)現(xiàn)時(shí)，Javadoc要求且依賴于java編譯器完成其工作。Javadoc調(diào)用部分javac編譯聲明部分，忽略成員實(shí)現(xiàn)。它建立類的內(nèi)容豐富的內(nèi)部表示，包括類層次和“使用”關(guān)系，然后從中生成HTML。Javadoc還從源代碼的文檔注釋中獲得用戶提供的文檔。
當(dāng)Javadoc建立其內(nèi)部文檔結(jié)構(gòu)時(shí)，它將加載所有引用的類。由于這一點(diǎn)，Javadoc必須能查找到所有引用的類，包括引導(dǎo)類、擴(kuò)展類和用戶類。
命令選項(xiàng)
-overview i>path/filename 指定javadoc應(yīng)該從path/filename所指定的“源”文件中獲取概述文檔，并將它放到概述頁(yè)中（overview-summary.html）。其中path/filename 是相對(duì)于-sourcepath的相對(duì)路徑名。
-public 只顯示公有類及成員。
-protected 只顯示受保護(hù)的和公有的類及成員。這是缺省狀態(tài)。
-package 只顯示包、受保護(hù)的和公有的類及成員。
-private 顯示所有類和成員。
-help 顯示聯(lián)機(jī)幫助，它將列出這些javadoc和doclet命令行選項(xiàng)。
-doclet class 指定啟動(dòng)用于生成文檔的docle 的類文件。該doclet定義了輸出的內(nèi)容和格式。如果未使用-doclet選項(xiàng)，則javadoc使用標(biāo)準(zhǔn)doclet生成缺省HTML格式。該類必須包含start(Root)法。該啟動(dòng)類的路徑由 -docletpath選項(xiàng)定義。
-docletpath classpathlist 指定doclet類文件的路徑，該類文件用-doclet選項(xiàng)指定。如果doclet已位于搜索路徑中，則沒(méi)有必要使用該選項(xiàng)。
-1.1 生成具有用Javadoc 1.1生成的文檔的外觀和功能的文檔。也就是說(shuō)，頁(yè)的背景為灰色，用圖像做頁(yè)眉，使用bullet列表而不是表格，具有單層目的目錄結(jié)構(gòu)，不包含繼承 API，不使?*** TML框架，并且不支持內(nèi)部類。該選項(xiàng)還自動(dòng)將索引分割成每個(gè)字母一個(gè)文件。如果想要這種外觀，則該選項(xiàng)比javadoc 1.1優(yōu)越之處等于修正了一些錯(cuò)誤。
-sourcepath sourcepathlist
當(dāng)將包名傳遞到j(luò)avadoc命令中時(shí)，指定定位源文件（.java）的搜索路徑。注意只有當(dāng)用 javadoc命令指定包名時(shí)才能使用sourcepath選項(xiàng) -- 它將不會(huì)查找傳遞到j(luò)avadoc命令中的.java文件。如果省略-sourcepath，則javadoc使用類路徑查找源文件。
-classpath classpathlist 指定javadoc將在其中查找引用類的路徑 -- 引用類是指帶文檔的類加上它們引用的任何類。Javadoc將搜索指定路徑的所有子目錄。classpathlist可以包括多個(gè)路徑，彼此用逗號(hào)分隔。
-bootclasspath classpathlist 指定自舉類所在路徑。它們名義上是Java平臺(tái)類。這個(gè)bootclasspath是Javadoc將用來(lái)查找源文件和類文件的搜索路徑的一部分。在 classpathlist中用冒號(hào)（:）分隔目錄。
-extdirs dirlist 指定擴(kuò)展類所在的目錄。它們是任何使用Java擴(kuò)展機(jī)制的類。這個(gè) extdirs是Javadoc將用來(lái)查找源文件和在文件的搜索路徑的一部分。在dirlist中用冒號(hào)（:）分隔目錄。
-verbose 在javadoc運(yùn)行時(shí)提供更詳細(xì)的信息。不使用verbose選項(xiàng)時(shí)，將顯示加載源文件、生成文檔（每個(gè)源文件一條信息）和排序的信息。verbose選項(xiàng)導(dǎo)致打印額外的信息，指定解析每個(gè)java源文件的毫秒數(shù)。
-locale language_country_variant 指定javadoc在生成文檔時(shí)使用的環(huán)境。
-encoding name 指定源文件編碼名，例如EUCJIS/SJIS。如果未指定該選項(xiàng)，則使用平臺(tái)缺省轉(zhuǎn)換器。
-J[flag] 將flag直接傳遞給運(yùn)行javadoc的運(yùn)行時(shí)系統(tǒng)java。注意在J和flag之間不能有空格。
標(biāo)準(zhǔn) Doclet 提供的選項(xiàng)
-d directory 指定javadoc保存生成的HTML件的目的目錄。省略該選項(xiàng)將導(dǎo)致把文件保存到當(dāng)前目錄中。其中directory可以是絕對(duì)路徑或相對(duì)當(dāng)前工作目錄的相對(duì)路徑。
-use 對(duì)每個(gè)帶文檔類和包包括一個(gè)“用法”頁(yè)。該頁(yè)描述使用給定類或包的任何 API 的包、類、方法、構(gòu)造函數(shù)和域。對(duì)于給定類 C，使用類 C 的任何東西將包括 C 的子類、聲明為 C 的域、返回 C 的方法以及具有 C 類型參數(shù)的方法和構(gòu)造函數(shù)。
-version 在生成文檔中包括 @version 文本。缺省地將省略該文本。
-author 在生成文檔中包括 @author 文本。
-splitindex 將索引文件按字母分割成多個(gè)文件，每個(gè)字母一個(gè)文件，再加上一個(gè)包含所有以非字母字符開頭的索引項(xiàng)的文件。
-windowtitle[title] 指定放入 HTML
相關(guān)文章：
>>Cookie的傳遞流程及安全問(wèn)題
>>JAVA生成JPG縮略圖
>>上傳圖片的縮放處理
>>學(xué)習(xí)JSP的一些心得.jsp
>>怎樣打包成可執(zhí)行的jar文件.jsp
>>開發(fā)晉級(jí)篇：Java性能優(yōu)化技巧集錦
>>為何我寫的郵件發(fā)送程序不能正確發(fā)送郵件？
>>一個(gè)郵件發(fā)送的API（可以帶附件和群發(fā)）
JavaDoc命令使用說(shuō)明
作者：未知 轉(zhuǎn)貼自：網(wǎng)絡(luò)收藏 點(diǎn)擊數(shù)：25
javadoc的命令行語(yǔ)法如下：
javadoc [ options ] [ packagenames ] [ sourcefiles ] [ @files ]
參數(shù)可以按照任意順序排列。下面分別就這些參數(shù)和相關(guān)的一些內(nèi)容進(jìn)行說(shuō)明：
• Packagenames 包列表。這個(gè)選項(xiàng)可以是一系列的包名（用空格隔開），例如java.lang java.lang.reflect java.awt。不過(guò)，因?yàn)閖avadoc不遞歸作用于子包，不允許對(duì)包名使用通配符；所以你必須顯示地列出希望建立文檔的每一個(gè)包。
• Sourcefiles 源文件列表。這個(gè)選項(xiàng)可以是一系列的源文件名（用空格隔開），可以使用通配符。javadoc允許四種源文件：類源代碼文件、包描述文件、總體概述文件、其他雜文件。
◇ 類源代碼文件：類或者接口的源代碼文件。
◇ 包描述文件：每一個(gè)包都可以有自己的包描述文件。包描述文件的名稱必須是package.html，與包的.java文件放置在一起。包描述文件的內(nèi)容通常是使用HTML標(biāo)記寫的文檔。javadoc執(zhí)行時(shí)將自動(dòng)尋找包描述文件。如果找到，javadoc將首先對(duì)描述文件中之間的內(nèi)容進(jìn)行處理，然后把處理結(jié)果放到該包的Package Summary頁(yè)面中，最后把包描述文件的第一句（緊靠）放到輸出的Overview summary頁(yè)面中，并在語(yǔ)句前面加上該包的包名。
◇ 總體概述文件：javadoc可以創(chuàng)建一個(gè)總體概述文件描述整個(gè)應(yīng)用或者所有包。總體概述文件可以被任意命名，也可以放置到任意位置。-overview選項(xiàng)可以指示總體概述文件的路徑和名稱。總體概述文件的內(nèi)容是使用HTML標(biāo)記寫的文檔。javadoc在執(zhí)行的時(shí)候，如果發(fā)現(xiàn)-overview選項(xiàng)，那么它將首先對(duì)文件中之間的內(nèi)容進(jìn)行處理；然后把處理后的結(jié)果放到輸出的Overview summary 頁(yè)面的底部；最后把總體概述文件中的第一句放到輸出的Overview summary頁(yè)面的頂部。
◇ 其他雜文件：這些文件通常是指與javadoc輸出的HTML文件相關(guān)的一些圖片文件、Java源代碼文件（.java）、Java程序（.class）、Java小程序（Applets）、HTML文件。這些文件必須放在doc-files目錄中。每一個(gè)包都可以有自己的doc-files目錄。舉個(gè)例子，你希望在java.awt.Button的HTML文檔中使用一幅按鈕的圖片（Button.gif）。首先，你必須把圖片文件放到C:usersrcjavaawtdoc-files中；然后在Button.java文件中加入下面注釋
/**
* This button looks like this:
*
*/
• @files 包含文件。為了簡(jiǎn)化javadoc命令，你可以把需要建立文檔的文件名和包名放在一個(gè)或多個(gè)文本文件中。例如，為了簡(jiǎn)化下面命令：
javadoc -d apidoc com.mypackage1 com.mypackage2 com.mypackage3
你可以建立一個(gè)名稱為mypackage.txt的文件，其內(nèi)容如下：
com.mypackage1
com.mypackage2
com.mypackage3
然后執(zhí)行下面命令即可：
javadoc -d apidoc @mypackage.txt
• options 命令行選項(xiàng)。javadoc使用doclets（doclets是指用doclet API編寫的程序。）來(lái)確定輸出的內(nèi)容和格式。命令行選項(xiàng)中一部分是可用于所有doclet的通用選項(xiàng)，一部分是由默認(rèn)的標(biāo)準(zhǔn)doclet提供的專用的選項(xiàng)。下面對(duì)各自一些常用的選項(xiàng)分別進(jìn)行介紹：
通用選項(xiàng)：
◇ -1.1 生成具有javadoc 1.1版本生成的文檔的外觀和功能的文檔。不是所有的選項(xiàng)都可以用于-1.1選項(xiàng)，具體可以使用javadoc -1.1 -help察看。
◇ -help 顯示聯(lián)機(jī)幫助。
◇ -bootclasspath classpathlist 指定根類（通常是Java平臺(tái)自帶的一些類。例如java.awt.*等）的路徑。
◇ -sourcepath sourcepathlist 指定包的源文件搜索路徑。但是必須注意，只有在javadoc命令中指定了包名的時(shí)候才可以使用-sourcepath選項(xiàng)。如果指定了包名，而省略了-sourcepath，那么javadoc使用類路徑查找源文件。舉例說(shuō)明：假定你打算為com.mypackage建立文檔，其源文件的位置是C:usersrc。那么你可以使用下面的命令：
javadoc -sourcepath c:usersrc com.mypackage
◇ -classpath classpathlist 指定javadoc查找引用類的路徑。引用類是指帶文檔的類加上它們引用的任何類。javadoc將搜索指定路徑的所有子目錄。Classpathlist可以包含多個(gè)路徑（使用;隔開）。如果省略-classpath，則javadoc使用-sourcepath查找源文件和類文件。舉例說(shuō)明：假定你打算為com.mypackage建立文檔，其源文件的位置是C:usersrc，包依賴C:userlib中的庫(kù)。那么你可以使用下面的命令：
javadoc -classpath c:userlib -sourcepath c:usersrc com.mypackage
◇ -overview pathfilename 告訴javadoc從pathfilename所指定的文件中獲取概述文檔，并且把它放到輸出的概述頁(yè)面（overview-summary.html）中。其中pathfilename是相對(duì)于-sourcepath的相對(duì)路徑。
◇ -public 只顯示公共類以及成員。
◇ -protected 只顯示受保護(hù)的和公共的類以及成員。缺省選項(xiàng)。
◇ -package只顯示包、受保護(hù)的和公共的類以及成員。
◇ -private 顯示所有類和成員。
◇ -doclet class 指定javadoc產(chǎn)生輸出內(nèi)容的自定義doclet類。如果忽略這個(gè)選項(xiàng)，javadoc將使用默認(rèn)的doclet產(chǎn)生一系列HTML文檔。
◇ -docletpath classpathlist 與- doclet選項(xiàng)相關(guān)，制定自定義的doclet類文件的路徑。Classpathlist可以包含多條路徑（用;隔開）。
◇ -verbose 在javadoc運(yùn)行時(shí)提供更詳細(xì)的信息。
標(biāo)準(zhǔn)doclet專用選項(xiàng)：
◇ -author 在生成的文檔中包含作者項(xiàng)。
◇ - d directory 指定javadoc保存生成的HTML文件的目錄。省略該選項(xiàng)將把文件保存在當(dāng)前目錄。Directory可以是絕對(duì)目錄，也可以是相對(duì)當(dāng)前目錄的相對(duì)目錄。
◇ -version 在生成的文檔中包含版本項(xiàng)。
◇ -use 為類和包生成use（用法）頁(yè)面。這些頁(yè)面描述了該類和包在javadoc命令涉及的文件中被使用的情況。例如：對(duì)于給定的類C，在C的用法頁(yè)面中將包含C的子類，類型為C的域，返回變量類型為C的方法以及在參數(shù)中有變量類型為C的方法和構(gòu)造器。
◇ -splitindex 把索引文件按照字母順序分為多個(gè)文件。每一個(gè)文件對(duì)應(yīng)一個(gè)字母。
◇ -windowtitle title 指定輸出的HTML文檔的標(biāo)題。
◇ -header header 指定輸出的HTML文檔的頁(yè)眉文本。
◇ -footer footer 指定輸出的HTML文檔的腳注文本。
◇ -bottom text 指定輸出的HTML文檔底部的文本。
◇ - group groupheading packagepatten;packagepatten;… 在總體概述頁(yè)面中按照命令的指定方式分隔各個(gè)包。例如執(zhí)行下面命令：
javadoc -group Core Packages java.lang*:java.util
-group Extension Packages javax.*
java.lang java.lang.reflect java.util javax.servlet java.new
在頁(yè)面中將有如下結(jié)果：
Core Packages
java.lang
java.lang.reflect
java.util
Extension Packages
javax.servlet
Other Packages
java.new
◇ - noindex 不輸出索引文件。
◇ - help 在文件的導(dǎo)航條中忽略help鏈接。
◇ - helpfile pathfilename 指定導(dǎo)航條中的help鏈接所指向的幫助文件。忽略該選項(xiàng)，javadoc將生成缺省的幫助文件。
◇ -stylesheetfile pathfilename 指定javadoc的HTML樣式表文件的路徑。忽略該選項(xiàng)，javadoc將自動(dòng)產(chǎn)生一個(gè)樣式表文件stylesheet.css。
JavaDoc文檔標(biāo)記
javadoc注釋以/**開始，以*/結(jié)束，里面可以包含普通文本、HTML標(biāo)記和javadoc標(biāo)記。javadoc只處理源文件中在類/接口定義、方法、域、構(gòu)造器之前的注釋，忽略位于其他地方的注釋。舉例如下：
/**
*Demo--Helloworld
*@author sunjl
*@version 1.0 2001/10/15
*/
public class myHelloworld
{
/**
*在main( )方法中使用的顯示用字符串
*@see #main(java.lang.String[])
*/
static String SDisplay;
/**
*顯示HelloWorld
*@param args 從命令行中帶入的字符串
*@return 無(wú)
*/
public static void main(String args[])
{
SDisplay = Hello World ;
System.out.println( SDisplay );
}
}
使用下面命令：
javadoc -private -d doc -author -version myHelloworld.java
即可以生成漂亮的關(guān)于myHelloworld.java的API文檔了。
上面例子中以@開頭的標(biāo)記就是javadoc標(biāo)記。在Java程序中正確使用javadoc標(biāo)記是一個(gè)良好的注釋習(xí)慣，將非常有助于javadoc自動(dòng)從源代碼文件生成完整的格式化API文檔。下面就對(duì)各種標(biāo)記進(jìn)行詳細(xì)說(shuō)明。
◇ @author name-text 指定生成文檔中的作者項(xiàng)，從JDK/SDK 1.0開始引入。name-text可以指定多個(gè)名字（使用,隔開）。文檔注釋可以包含多個(gè)類。
◇ {@docroot} 代表產(chǎn)生文檔的根路徑，從JDK/SDK 1.3開始引入。用法舉例如下
/**
*see the copyright
*/
假定生成文檔的根目錄是doc，上面注釋所在的文件最后生成的文件是docutilityutl.html，那么copyright的鏈接會(huì)指向..copyright.html。
◇ @deprecated deprecated-text 添加注釋，表明不推薦使用該API。
◇ @exception class-name description @throw的同義標(biāo)記，從JDK/SDK 1.0開始引入。
◇ {@link package.class#member label} 插入指向package.class#member的內(nèi)嵌鏈接，從JDK/SDK 1.2開始引入。舉例說(shuō)明，假定注釋中有如下文檔：
/** Use the {@link #getComponentAt(int, int) getComponentAt} method. */
那么javadoc最終生成的HTML頁(yè)面中將有如下內(nèi)容
Use the getComponentAt method.
◇ @param parameter-name description 描述參數(shù)，從JDK/SDK 1.0開始引入。
◇ @return description 描述返回值，從JDK/SDK 1.0開始引入。
◇ @see reference 添加參見標(biāo)題，其中有指向reference的鏈接或者文本項(xiàng)，從JDK/SDK 1.0開始引入。@see標(biāo)記有三種形式，下面分別說(shuō)明：
（1）、@see string 為string添加文本項(xiàng)，不產(chǎn)生鏈接。
（2）、@see Label 使用HTML標(biāo)記產(chǎn)生鏈接
（3）、@see package.class#member Label 使用Java語(yǔ)言的名字package.class #member產(chǎn)生鏈接。
◇ @serial field-description 用于缺省可序列化域的注釋，從JDK/SDK 1.2開始引入。
◇ @serialField field-name field-type field-description 建立Serializable類的serialPersistentFields成員的ObjectStreamField組件的文檔，從JDK/SDK 1.2開始引入。
◇ @serialData data-description data-description建立數(shù)據(jù)序列和類型的文檔，從JDK/SDK 1.2開始引入。
◇ @since since-text 利用since-text內(nèi)容為文檔增加since標(biāo)題，從JDK/SDK 1.1開始引入。
◇ @throws class-name description 與@exception同義。用class-name和description為輸出文檔添加拋出標(biāo)題，從JDK/SDK 1.2開始引入。
◇ @version version-text 添加版權(quán)標(biāo)題，從JDK/SDK 1.0開始引入。
上面介紹了標(biāo)準(zhǔn)doclet提供的所有標(biāo)記。不過(guò)，需要注意這些標(biāo)記的使用是有位置限制的。其中可以出現(xiàn)在類或者接口文檔注釋中的標(biāo)記有：@see、{@link}、@since、@deprecated、@author、@version。可以出現(xiàn)在方法或者構(gòu)造器文檔注釋中的標(biāo)記有：@see、{@link}、@since、@deprecated、@param、@return、@throws、@exception、@serialData。可以出現(xiàn)在域文檔注釋中的有：@see、{@link}、@since、@desprecated、@serial、@serialField。
除了javadoc自身提供的標(biāo)準(zhǔn)標(biāo)記以外，我們可以定制自己的標(biāo)記嗎？當(dāng)然可以。只需要對(duì)javadoc標(biāo)準(zhǔn)的doclet程序進(jìn)行擴(kuò)充即可。實(shí)際上，利用javadoc提供的doclet API，不僅可以擴(kuò)充doclet標(biāo)記，甚至還可以改變javadoc的整個(gè)輸出。為了滿足需要，你可以使javadoc輸出普通文本、XML文件等。由于擴(kuò)充doclet涉及到Java編程，本文不再做深入介紹。
總之，javadoc提供了完整規(guī)范的API文檔功能。在軟件項(xiàng)目管理中，合理地使用javadoc不僅可以減少開發(fā)時(shí)的文檔工作量，提高效率；而且還非常有利于將來(lái)軟件的修改和維護(hù)。
JavaDoc 書寫規(guī)范：
1、 File Header Comments : 每個(gè)文件都應(yīng)該加上文件頭標(biāo)記，包括文件名、修改歷史、版權(quán)信息和附加信息。例如：
/**
* @(#)demo.java 1.00 2002/05/27
*
* Copyright (c) 2000-2002 中國(guó)平安保險(xiǎn)股份有限公司 版權(quán)所有
* Ping An Insurance Company of China. All rights reserved.
* This software is the confidential and proprietary
* information of Ping An Insurance Company of China.
* (Confidential Information). You shall not disclose
* such Confidential Information and shall use it only
* in accordance with the terms of the contract agreement
* you entered into with Ping An.
*/
2、class description:類信息，概括的描述類的功能和實(shí)現(xiàn)。
/** class description
*/
3、Variable Description:描述變量的意義和取值含義。
/** var variable description
*/
4、Method Description:標(biāo)明每個(gè)方法的輸入、輸出參數(shù)和返回值類型，說(shuō)明特殊變量取值的含義。相關(guān)類文檔鏈接。
/** method description
* @param var signification
* @exception exception class name
* @return return_value return signification
*/
5、Association Description:關(guān)聯(lián)類文檔描述，在注釋當(dāng)中需要參引其它文檔描述的地方，可在相應(yīng)的注釋當(dāng)中如下插入：
/** method description
* @param var signification
* @exception exception class name
* @return return_value return signification
* @see package.class#member label
*/
6、包描述文件：概括描述包的功能和設(shè)計(jì)概要。為每個(gè)包創(chuàng)建一個(gè)描述文件，命名為package.html，與包的java文件放在一起。
注：javadoc生成文檔時(shí)，會(huì)將該html文件的第一句放在package summary中，而把整個(gè)內(nèi)容放在Overview summary中.
轉(zhuǎn)載自:Jar使用說(shuō)明和JavaDoc的使用說(shuō)明