您好,登錄后才能下訂單哦!
這篇文章主要介紹“jar和javadoc的用法有哪些”,在日常操作中,相信很多人在jar和javadoc的用法有哪些問題上存在疑惑,小編查閱了各式資料,整理出簡(jiǎn)單好用的操作方法,希望對(duì)大家解答”jar和javadoc的用法有哪些”的疑惑有所幫助!接下來,請(qǐng)跟著小編一起來學(xué)習(xí)吧!
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è)歸檔文件。
[@more@]
將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
JavaDoc命令使用詳解
javadoc的命令行語法如下: |
到此,關(guān)于“jar和javadoc的用法有哪些”的學(xué)習(xí)就結(jié)束了,希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí),快去試試吧!若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí),請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站,小編會(huì)繼續(xù)努力為大家?guī)砀鄬?shí)用的文章!
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。