JDK的命令詳解(1)
功能說明:
rmic 為遠(yuǎn)程對(duì)象生成 stub 和 skeleton。
語法:
rmic [ options ] package-qualified-class-name(s)
補(bǔ)充說明:
rmic 編譯器根據(jù)編譯后的 Java 類(含有遠(yuǎn)程對(duì)象實(shí)現(xiàn))名,為遠(yuǎn)程對(duì)象生成 stub 和 skeleton(遠(yuǎn)程對(duì)象是指實(shí)現(xiàn) java.rmi.Remote 接口的對(duì)象)。在 rmic 命令中所給的類必須是經(jīng) javac 命令成功編譯且是完全包限定的類。
命令選項(xiàng)
-classpath[路徑] 指定 rmic 用于查詢類的路徑。如果設(shè)置了該選項(xiàng),它將覆蓋缺省值或 CLASSPATH 環(huán)境變量。目錄用冒號(hào)分隔。
-d[目錄] 指定類層次的根目錄。此選項(xiàng)可用來指定 stub 和 skeleton 文件的目標(biāo)目錄。
-depend 使編譯器考慮重新編譯從其它類引用的類。 一般來說,它只重新編譯從源代碼引用的遺漏或過期的類。
-g 允許生成調(diào)試表格。調(diào)試表格含有行號(hào)和局部變量的有關(guān)信息,即 Java 調(diào)試工具所使用的信息。缺省情況下,只生成行號(hào)。
-J 與 -D 選項(xiàng)聯(lián)用,它將緊跟其后的選項(xiàng)( -J 與 -D 之間無空格)傳給 java 解釋器。
-keepgenerated 為 stub 和 skeleton 文件保留所生成的 .java 源文件,并將這些源文件寫到與 .class 文件相同的目錄中,如果要指定目錄,則使用 -d 選項(xiàng)。
-nowarn 關(guān)閉警告。如果使用該選項(xiàng),則編譯器不輸出任何警告信息。
-show 顯示 rmic 編譯器的 GUI(圖形用戶界面)。輸入一個(gè)或多個(gè)包限定類名(以空格分隔),并按回車鍵或“顯示”按鈕,創(chuàng)建 stub 和 skeleton。
-vcompat (缺省值)創(chuàng)建與 JDK 1.1 和 1.2 stub 協(xié)議版本都兼容的 stub 和 skeleton。
-verbose 使編譯器和鏈接器輸出關(guān)于正在編譯哪些類和正在加載哪些類文件的信息。
-v1.1 創(chuàng)建 JDK 1.1 stub 協(xié)議版本的 stub 和 skeleton。
-v1.2 只創(chuàng)建 JDK 1.2 stub 協(xié)議版本的 stub。
rmid
功能說明:
rmid 啟動(dòng)激活系統(tǒng)守護(hù)進(jìn)程,以便能夠在 Java 虛擬機(jī)上注冊(cè)和激活對(duì)象。
語法:
rmid [-port port] [-log dir]
補(bǔ)充說明:
rmid 工具啟動(dòng)激活系統(tǒng)守護(hù)進(jìn)程。必須先啟動(dòng)激活系統(tǒng)守護(hù)進(jìn)程,才能向激活系統(tǒng)注冊(cè)可被激活的對(duì)象或在 Java 虛擬機(jī)上激活可被激活的對(duì)象。
命令選項(xiàng)
-C<某些命令行選項(xiàng)> 指定一個(gè)選項(xiàng),在創(chuàng)建每個(gè) rmid 的子守護(hù)進(jìn)程(激活組)時(shí),該選項(xiàng)以命令行參數(shù)的形式傳給該子守護(hù)進(jìn)程。
-log[目錄] 指定目錄的名稱,激活系統(tǒng)守護(hù)進(jìn)程在該目錄中寫入其數(shù)據(jù)庫及相關(guān)信息。缺省狀態(tài)下,將在執(zhí)行 rmid 命令的目錄中創(chuàng)建一個(gè) log 目錄。
-port[端口] 指定 rmid 的注冊(cè)服務(wù)程序所使用的端口。激活系統(tǒng)守護(hù)進(jìn)程將 ActivationSystem 與該注冊(cè)服務(wù)程序中的名稱java.rmi.activation.ActivationSystem 捆綁在一起。
-stop 停止 -port 選項(xiàng)所指定端口上的當(dāng)前 rmid 調(diào)用。若未指定端口,則將停止在端口 1098 上運(yùn)行的 rmid。
rmiregistry
功能說明:
rmiregistry 命令可在當(dāng)前主機(jī)的指定端口上啟動(dòng)遠(yuǎn)程對(duì)象注冊(cè)服務(wù)程序。
語法:
rmiregistry [port]
補(bǔ)充說明:
rmiregistry 命令在當(dāng)前主機(jī)的指定 port 上創(chuàng)建并啟動(dòng)遠(yuǎn)程對(duì)象注冊(cè)服務(wù)程序。如果省略 port,則注冊(cè)服務(wù)程序?qū)⒃?nbsp;1099 端口上啟動(dòng)。rmiregistry 命令不產(chǎn)生任何輸出而且一般在后臺(tái)運(yùn)行。遠(yuǎn)程對(duì)象注冊(cè)服務(wù)程序是自舉命名服務(wù)。主機(jī)上的 RMI 服務(wù)器將利用它將遠(yuǎn)程對(duì)象綁定到名字上。客戶機(jī)即可查詢遠(yuǎn)程對(duì)象并進(jìn)行遠(yuǎn)程方法調(diào)用。注冊(cè)服務(wù)程序一般用于定位應(yīng)用程序需調(diào)用其方法的第一個(gè)遠(yuǎn)程對(duì)象。該對(duì)象反過來對(duì)各應(yīng)用程序提供相應(yīng)的支持,用于查找其它對(duì)象。java.rmi.registry.LocateRegistry 類的方法可用于在某臺(tái)主機(jī)或主機(jī)和端口上獲取注冊(cè)服務(wù)程序操作。java.rmi.Naming 類的基于 URL 的方法將對(duì)注冊(cè)服務(wù)程序進(jìn)行操作,并可用于查詢遠(yuǎn)程對(duì)象、將簡(jiǎn)單(字符串)名稱綁定到遠(yuǎn)程對(duì)象、將新名稱重新綁定到遠(yuǎn)程對(duì)象(覆蓋舊綁定)、取消遠(yuǎn)程對(duì)象的綁定以及列出綁定在注冊(cè)服務(wù)程序上的 URL。
serialver
功能說明:
serialver 命令返回 serialVersionUID。
語法:
serialver [ 命令選項(xiàng) ]
補(bǔ)充說明:
serialver 以適于復(fù)制到演變類的形式返回一個(gè)或多個(gè)類的 serialVersionUID。不帶參數(shù)調(diào)用時(shí),它輸出用法行。
命令選項(xiàng)
-show 顯示一個(gè)簡(jiǎn)單的用戶界面。輸入完整的類名并按回車鍵或“顯示”按鈕可顯示 serialVersionUID。
jarsigner
功能說明:
為 Java 歸檔 (JAR) 文件產(chǎn)生簽名,并校驗(yàn)已簽名的 JAR 文件的簽名。
語法:
jarsigner [ 命令選項(xiàng) ] jar-file alias
jarsigner -verify [ 命令選項(xiàng) ] jar-file
補(bǔ)充說明:
jarsigner 工具用于兩個(gè)目的:
1:為 Java 歸檔 (JAR) 文件簽名
2:校驗(yàn)已簽名的 JAR 文件的簽名和完整性
命令選項(xiàng)
-keystore[url] 指定密鑰倉庫的 URL。缺省值是用戶的宿主目錄中的 .keystore 文件,它由系統(tǒng)屬性“user.home”決定。
-storetype[storetype] 指定要被實(shí)例化的密鑰倉庫類型。默認(rèn)的密鑰倉庫類型是安全屬性文件中 "keystore.type" 屬性值所指定的那個(gè)類型,由 java.security.KeyStore 中的靜態(tài)方法 getDefaultType 返回。
-storepass[password] 指定訪問密鑰倉庫所需的口令。這僅在簽名(不是校驗(yàn))JAR 文件時(shí)需要。在這種情況下,如果命令行中沒有提供 -storepass 選項(xiàng),用戶將被提示輸入口令。
-keypass[password] 指定用于保護(hù)密鑰倉庫項(xiàng)(由命令行中指定的別名標(biāo)出)的私鑰的口令。使用 jarsigner 為 JAR 文件簽名時(shí)需要該口令。如果命令行中沒有提供口令,且所需的口令與密鑰倉庫的口令不同,則將提示用戶輸入它。
-sigfile[file] 指定用于生成 .SF 和 .DSA 文件的基本文件名。
-signedjar[file] 指定用于已簽名的 JAR 文件的名稱。
-verify 如果它出現(xiàn)在命令行中,則指定的 JAR 文件將被校驗(yàn),而不是簽名。如果校驗(yàn)成功,將顯示“jar verified”。如果試圖校驗(yàn)未簽名的 JAR 文件,或校驗(yàn)被不支持的算法(例如未安裝 RSA 提供者時(shí)使用的 RSA)簽名的 JAR 文件,則將有如下顯示: "jar is unsigned. (signatures missing or not parsable)" 。
-certs 如果它與 -verify 和 -verbose 選項(xiàng)一起出現(xiàn)在命令行中,則輸出將包括 JAR 文件的每個(gè)簽名人的證書信息。
-verbose 如果它出現(xiàn)在命令行中,則代表“verbose”模式,它使 jarsigner 在 JAR 簽名或校驗(yàn)過程中輸出額外信息。
-internalsf 過去,JAR 文件被簽名時(shí)產(chǎn)生的 .DSA(簽名塊)文件包含一個(gè)同時(shí)產(chǎn)生的 .SF 文件(簽名文件)的完整編碼副本。這種做法已被更改。為了減小輸出 JAR 文件的整個(gè)大小,缺省情況下 .DSA 文件不再包含 .SF 文件的副本。但是如果 -internalsf 出現(xiàn)在命令行中,將采用舊的做法。該選項(xiàng)主要在測(cè)試時(shí)有用;實(shí)際上不應(yīng)使用它,因?yàn)檫@樣將消除有用的優(yōu)化。
-sectionsonly 如果它出現(xiàn)在命令行中,則 JAR 文件被簽名時(shí)生成的 .SF 文件(簽名文件)將不包括含有整個(gè)清單文件的散列的頭。它僅包含 與 JAR 中每個(gè)單獨(dú)的源文件相關(guān)的信息和散列。該選項(xiàng)主要在測(cè)試時(shí)有用;實(shí)際上不應(yīng)使用它,因?yàn)檫@樣將消除有用的優(yōu)化。
-J[javaoption] 將指定的 javaoption 串直接傳遞到 Java 解釋器。((jarsigner 實(shí)際上是解釋器的一個(gè) “wrapper”)。該選項(xiàng)不應(yīng)含有任何空格。它有助于調(diào)整執(zhí)行環(huán)境或內(nèi)存使用。要獲得可用的解釋器選項(xiàng)的清單,可在命令行鍵入 java -h 或 java -X。
JDK的命令詳解(2)
keytool
功能說明:
管理由私鑰和認(rèn)證相關(guān)公鑰的 X.509 證書鏈組成的密鑰倉庫(數(shù)據(jù)庫)。還管理來自可信任實(shí)體的證書。
語法:
keytool [ 命令 ]
補(bǔ)充說明:
keytool 是個(gè)密鑰和證書管理工具。它使用戶能夠管理自己的公鑰/私鑰對(duì)及相關(guān)證書,用于(通過數(shù)字簽名)自我認(rèn)證(用戶向別的用戶/服務(wù)認(rèn)證自己)或數(shù)據(jù)完整性以及認(rèn)證服務(wù)。它還允許用戶儲(chǔ)存他們的通信對(duì)等者的公鑰(以證書形式)。
native2ascii
功能說明:
將含有本地編碼字符(既非 Latin1 又非 Unicode 字符)的文件轉(zhuǎn)換為 Unicode 編碼字符的文件。
語法:
native2ascii [options] [inputfile [outputfile]]
補(bǔ)充說明:
Java 編譯器和其它 Java 工具只能處理含有 Latin-1 和/或 Unicode 編碼(udddd 記號(hào))字符的文件。native2ascii 將含有其它字符編碼的文件轉(zhuǎn)換成含 Latin-1 和/或 Unicode 編碼字符的文件。若省略 outputfile,則使用標(biāo)準(zhǔn)輸出設(shè)備輸出。此外,如果也省略 inputfile,則使用標(biāo)準(zhǔn)輸入設(shè)備輸入。
命令選項(xiàng)
-reverse 執(zhí)行相反的操作:將含 Latin-1 和/或 Unicode 編碼字符的文件轉(zhuǎn)換成含本地編碼字符的文件。
-encoding[encoding_name] 指定轉(zhuǎn)換過程使用的編碼名稱。缺省的編碼從系統(tǒng)屬性 file.encoding 中得到。
appletviewer
功能說明:
Java applet 瀏覽器。appletviewer 命令可在脫離萬維網(wǎng)瀏覽器環(huán)境的情況下運(yùn)行 applet。
語法:
appletviewer [ threads flag ] [ 命令選項(xiàng) ] urls ...
補(bǔ)充說明:
appletviewer 命令連接到 url 所指向的文檔或資源上,并在其自身的窗口中顯示文檔引用的每個(gè) applet。注意:如果 url 所指向的文檔不引用任何帶有 OBJECT、EMBED 或 APPLET 標(biāo)記的 applet,那么 appletviewer 就不做任何事情。
命令選項(xiàng)
-debug 在 Java 調(diào)試器 jdb 中啟動(dòng) appletviewer,使您可以調(diào)試文檔中的 applet。
-encoding[編碼名稱] 指定輸入 HTML 文件的編碼名稱。
-J[javaoption] 將 javaoption 字符串作為單個(gè)參數(shù)傳給運(yùn)行 appletviewer 的 Java 解釋器。參數(shù)不能含有空格。由多重參數(shù)組成的字符串,其中的每個(gè)參數(shù)都必須以前綴 -J 開頭,該前綴以后將被除去。這在調(diào)整編譯器的執(zhí)行環(huán)境或內(nèi)存使用時(shí)將很有用。
extcheck
功能說明:
extcheck 檢測(cè)目標(biāo) jar 文件與當(dāng)前安裝方式擴(kuò)展 jar 文件間的版本沖突。
語法:
extcheck [ -verbose ] targetfile.jar
補(bǔ)充說明:
extcheck 實(shí)用程序檢查指定 Jar 文件的標(biāo)題和版本與 JDK TM 軟件中所安裝的擴(kuò)展是否有沖突。在安裝某個(gè)擴(kuò)展前,可以用該實(shí)用程序查看是否已安裝了該擴(kuò)展的相同版本或更高的版本。
extcheck 實(shí)用程序?qū)?nbsp;targetfile.jar 文件清單的 specification-title 和 specification-version 頭與當(dāng)前安裝在擴(kuò)展目錄下所有 Jar 文件的相對(duì)應(yīng)的頭進(jìn)行比較(缺省擴(kuò)展目錄為 jre/lib/ext)。extcheck 實(shí)用程序比較版本號(hào)的方式與 java.lang.Package.isCompatibleWith 方法相同。若未檢測(cè)到?jīng)_突,則返回代碼為 0。如果擴(kuò)展目錄中任何一個(gè) jar 文件的清單有相同的 specification-title 和相同的或更新的 specification-version 號(hào),則返回非零錯(cuò)誤代碼。如果 targetfile.jar 的清單中沒有 specification-title 或 specification-version 屬性,則同樣返回非零錯(cuò)誤代碼。
命令選項(xiàng)
-verbose 對(duì)擴(kuò)展目錄中的 Jar 文件進(jìn)行檢查時(shí),列出文件。此外,還報(bào)告目標(biāo) jar 文件的清單屬性及所有沖突的 jar 文件。
jar
功能說明:
Java歸檔工具
語法:
jar [ 命令選項(xiàng) ] [manifest] destination input-file [input-files]
補(bǔ)充說明:
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ù)處理過程中對(duì)它們進(jìn)行下載,而不是對(duì)每個(gè)組件都要求一個(gè)新連接。這大大縮短了下載時(shí)間。jar還能壓縮文件,從而進(jìn)一步提高了下載速度。此外,它允許applet的作者對(duì)文件中的各個(gè)項(xiàng)進(jìn)行簽名,因而可認(rèn)證其來源。jar工具的語法基本上與tar命令的語法相同。
命令選項(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 通過添加文件或更改清單來更新現(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
功能說明
Java API文檔生成器從Java源文件生成API文檔HTML頁。
語法:
javadoc [ 命令選項(xiàng) ] [ 包名 ] [ 源文件名 ] [ @files ]
其中[ 包名 ]為用空格分隔的一系列包的名字,包名不允許使用通配符,如(*)。[ 源文件名 ]為用空格分隔的一系列的源文件名,源文件名可包括路徑和通配符,如(*)。[ @files ]是以任何次序包含包名和源文件的一個(gè)或多個(gè)文件。
補(bǔ)充說明
Javadoc解析Java源文件中的聲明和文檔注釋,并產(chǎn)生相應(yīng)的HTML頁缺省),描述公有類、保護(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所指定的“源”文件中獲取概述文檔,并將它放到概述頁中(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已位于搜索路徑中,則沒有必要使用該選項(xiàng)。
-1.1 生成具有用Javadoc 1.1生成的文檔的外觀和功能的文檔。也就是說,頁的背景為灰色,用圖像做頁眉,使用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將用來查找源文件和類文件的搜索路徑的一部分。在 classpathlist中用冒號(hào)(:)分隔目錄。
-extdirs dirlist 指定擴(kuò)展類所在的目錄。它們是任何使用Java擴(kuò)展機(jī)制的類。這個(gè) extdirs是Javadoc將用來查找源文件和在文件的搜索路徑的一部分。在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è)“用法”頁。該頁描述使用給定類或包的任何 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 <title> 標(biāo)記中的標(biāo)題。它將出現(xiàn)在窗口標(biāo)題欄中和為該頁創(chuàng)建的任何瀏覽器書簽(最喜愛的位置)中。該標(biāo)題不應(yīng)該包含任何 HTML 標(biāo)記,因?yàn)闉g覽器將不能正確解釋它們。在 title 中的任何內(nèi)部引號(hào)必須轉(zhuǎn)義。如果省略 -windowtitle,則 Javadoc 對(duì)該選項(xiàng)使用 -doctitle 的值。
-doctitle[title] 指定放置在靠近概述概覽文件頂部的標(biāo)題。該標(biāo)題將作為一級(jí)標(biāo)題,居中地直接放在導(dǎo)航欄下面。title 可包含 html 標(biāo)記和空格,但是如果這樣,則必須用引號(hào)將它括起。在 title 中的任何內(nèi)部引號(hào)必須轉(zhuǎn)義。
-title[title] 該選項(xiàng)不再存在。它僅存在于 Javadoc 1.2 的 Beta 版中。它已重命名為 -doctitle。重命名該選項(xiàng)是為了更清楚地表示它定義文檔標(biāo)題而不是窗口標(biāo)題。
-header[header] 指定放置在每個(gè)輸出文件頂部的頁眉文本。該頁眉將放在上部導(dǎo)航欄的右邊。header 可包含 HTML 標(biāo)記和空格,但是如果這樣則必須用引號(hào)將它括起。在 header 中的任何內(nèi)部引號(hào)必須轉(zhuǎn)義。
-footer[footer] 指定放置在每個(gè)輸出文件底部的腳注文本。腳本將放置在下部導(dǎo)航欄的右邊。footer 可包含 html 標(biāo)記和空格,但是如果這樣,則必須用引號(hào)將它括起。在 footer 中的任何內(nèi)部引號(hào)必須轉(zhuǎn)義。
-bottom[text] 指定放置在每個(gè)輸出文件底部的文本。該文本將放置在頁底,位于下部導(dǎo)航欄的下面。其中 text 可包含 HTML 標(biāo)記和空格,但是如果這樣,則必須用引號(hào)將它括起。在 text 中的任何內(nèi)部引號(hào)必須轉(zhuǎn)義。
-link[docURL] 創(chuàng)建鏈接指向已用 javadoc-生成的外部引用類的文檔。參數(shù) docURL是想要鏈接到的 javadoc-生成的外部文檔的 URL。該位置可以是相對(duì)的或絕對(duì)的 URL。
-linkoffline[docURL][packagelistURL] 該選項(xiàng)為外部引用類名字創(chuàng)建指向文檔的鏈接。
-group[groupheading]packagepattern:packagepattern:... 將概述頁上的包分成指定的組,每組一個(gè)表格。用不同的 -group 選項(xiàng)指定每個(gè)組。各組按命令行中指定的次序出現(xiàn)在頁面上。組內(nèi)的包按字母排序。對(duì)于給定 -group 選項(xiàng),與 packagepattern 表達(dá)式列表匹配的包出現(xiàn)在標(biāo)題為 groupheading 的表格中。
-nodeprecated 防止在文檔中生成任何不鼓勵(lì)使用的 API。它執(zhí)行-nodeprecatedlist 所做的事情,并且它不在文檔其余部分生成任何不鼓勵(lì)使用的 API。當(dāng)編寫代碼并不想被不鼓勵(lì)使用的代碼分心時(shí),這是非常有用的。
-nodeprecatedlist 防止在生成文件中包含不鼓勵(lì)使用的 API 列表(deprecated-list.html)并防止在導(dǎo)航欄中包含該頁的鏈接。(但是,javadoc 繼續(xù)在文檔其余部分生成不鼓勵(lì)使用的 API。) 如果源代碼未包含不鼓勵(lì)使用的 API,并且想要導(dǎo)航欄更干凈,則它是非常有用的。
-notree 在生成文檔中忽略類/接口層次。缺省地,將產(chǎn)生該層次。
-noindex 在生成文檔中忽略索引。缺省地,將產(chǎn)生索引。
-nohelp 在輸出的每頁頂部和底部的導(dǎo)航欄中忽略“幫助”鏈接。
-nonavbar 防止產(chǎn)生導(dǎo)航欄、頁眉和腳注,否則它們將出現(xiàn)在生成頁的頂部和底部。它對(duì)“bottom”選項(xiàng)沒有影響。當(dāng)只對(duì)內(nèi)容感興趣并且沒有必要導(dǎo)航時(shí),例如僅將文件轉(zhuǎn)換成 PostScript 或 PDF 以進(jìn)行打印,-nonavbar 選項(xiàng)是非常有用的。
-helpfile[path/filename] 指定頂部和底部導(dǎo)航欄中“幫助”鏈接所鏈接到的替代幫助文件 path/filename 的路徑。不使用該選項(xiàng)時(shí),Javadoc 自動(dòng)創(chuàng)建幫助文件 help-doc.html,它在 Javadoc 中硬編碼。該選項(xiàng)使得可覆蓋這種缺省情況。其中 filename 可以是任何名字,不局限于 help-doc.html -- Javadoc 將相應(yīng)調(diào)整導(dǎo)航欄中的鏈接。
-stylesheetfile[path/filename] 指定替代 HTML 樣式表單文件的路徑。不使用該選項(xiàng)時(shí),Javadoc 將自動(dòng)創(chuàng)建樣式表單文件 stylesheet.css,它在 Javadoc 中硬編碼。該選項(xiàng)使得可覆蓋這種缺省情況。其中 filename 可以是任何名字,不局限于 stylesheet.css。
-docencoding[name] 指定輸出 HTML 文件的編碼方式。
javah
功能說明:
C 頭文件和 Stub 文件生成器。javah 從 Java 類生成 C 頭文件和 C 源文件。這些文件提供了連接膠合,使 Java 和 C 代碼可進(jìn)行交互。
語法:
javah [ 命令選項(xiàng) ] fully-qualified-classname. . .
javah_g [ 命令選項(xiàng) ] fully-qualified-classname. . .
補(bǔ)充說明:
javah 生成實(shí)現(xiàn)本地方法所需的 C 頭文件和源文件。C 程序用生成的頭文件和源文件在本地源代碼中引用某一對(duì)象的實(shí)例變量。.h 文件含有一個(gè) struct 定義,該定義的布局與相應(yīng)類的布局平行。該 struct 中的域?qū)?yīng)于類中的實(shí)例變量。
頭文件名以及在頭文件中所聲明的結(jié)構(gòu)名都來源于類名。如果傳給 javah 的類是在某個(gè)包中,則頭文件名和結(jié)構(gòu)名前都要冠以該包名。下劃線 (_) 用作名稱分隔符。
缺省情況下,javah 為每個(gè)在命令行中列出的類都創(chuàng)建一個(gè)頭文件,且將該文件放在當(dāng)前目錄中。用 -stubs 選項(xiàng)創(chuàng)建源文件。用 -o 選項(xiàng)將所有列出類的結(jié)果串接成一個(gè)單一文件。
缺省情況下,javah 為每個(gè)在命令行中列出的類都創(chuàng)建一個(gè)頭文件,且將該文件放在當(dāng)前目錄中。用 -stubs 選項(xiàng)創(chuàng)建源文件。用 -o 選項(xiàng)將所有列出類的結(jié)果串接成一個(gè)單一文件。
命令選項(xiàng)
-o[輸出文件] 將命令行中列出的所有類的頭文件或源文件串接到輸出文件中。-o 或 -d 兩個(gè)選項(xiàng)只能選擇一個(gè)。
-d[目錄] 設(shè)置 javah 保存頭文件或 stub 文件的目錄。-d 或 -o 兩個(gè)選項(xiàng)只能選擇一個(gè)。
-stubs 使 javah 從 Java 對(duì)象文件生成 C 聲明。
-verbose 指明長(zhǎng)格式輸出,并使 javah 將所生成文件的有關(guān)狀態(tài)的信息輸出到標(biāo)準(zhǔn)輸出設(shè)備中。
-help 輸出 javah 用法的幫助信息。
-version 輸出 javah 的版本信息。
-jni 使 javah 創(chuàng)建一輸出文件,該文件包含 JNI 風(fēng)格的本地方法函數(shù)原型。這是缺省輸出,所以 -jni 的使用是可選的。
-classpath[路徑] 指定 javah 用來查詢類的路徑。如果設(shè)置了該選項(xiàng),它將覆蓋缺省值或 CLASSPATH 環(huán)境變量。目錄用冒號(hào)分隔。
-bootclasspath[路徑] 指定加載自舉類所用的路徑。缺省情況下,自舉類是實(shí)現(xiàn)核心 Java 平臺(tái)的類,位于 jrelib
t.jar 和 jrelibi18n.jar 中。
-old 指定應(yīng)當(dāng)生成舊 JDK1.0 風(fēng)格的頭文件。
-force 指定始終寫輸出文件。
javap
功能說明:
Java 類文件解析器。
語法:
javap [ 命令選項(xiàng) ] class. . .
補(bǔ)充說明:
javap 命令用于解析類文件。其輸出取決于所用的選項(xiàng)。若沒有使用選項(xiàng),javap 將輸出傳遞給它的類的 public 域及方法。javap 將其輸出到標(biāo)準(zhǔn)輸出設(shè)備上。
命令選項(xiàng)
-help 輸出 javap 的幫助信息。
-l 輸出行及局部變量表。
-b 確保與 JDK 1.1 javap 的向后兼容性。
-public 只顯示 public 類及成員。
-protected 只顯示 protected 和 public 類及成員。
-package 只顯示包、protected 和 public 類及成員。這是缺省設(shè)置。
-private 顯示所有類和成員。
-J[flag] 直接將 flag 傳給運(yùn)行時(shí)系統(tǒng)。
-s 輸出內(nèi)部類型簽名。
-c 輸出類中各方法的未解析的代碼,即構(gòu)成 Java 字節(jié)碼的指令。
-verbose 輸出堆棧大小、各方法的 locals 及 args 數(shù)。
-classpath[路徑] 指定 javap 用來查找類的路徑。如果設(shè)置了該選項(xiàng),則它將覆蓋缺省值或 CLASSPATH 環(huán)境變量。目錄用冒號(hào)分隔。
- bootclasspath[路徑] 指定加載自舉類所用的路徑。缺省情況下,自舉類是實(shí)現(xiàn)核心 Java 平臺(tái)的類,位于 jrelib
t.jar 和 jrelibi18n.jar 中。
-extdirs[dirs] 覆蓋搜索安裝方式擴(kuò)展的位置。擴(kuò)展的缺省位置是 jrelibext。
posted on 2008-04-14 20:48
周銳 閱讀(260)
評(píng)論(0) 編輯 收藏 所屬分類:
Java