什么是Jar文件?
在開(kāi)發(fā)過(guò)程中,我們可以直接使用Java class文件來(lái)運行程序,但這并不是一個(gè)好方式,好在Java 提供了 Jar(Java Archive)文件來(lái)提供發(fā)布和運行。
Jar 文件實(shí)際上是class 文件的ZIP壓縮存檔,這種格式被廣泛使用,因此易與使用,有很多中工具可以操作這種格式的文件。也正是因為這個(gè)原因,Jar文件本身并不能表達所包含應用程序的標簽信息。
Manifest 因此得以出現
為了要提供存檔的標簽信息,Jar 文件指定了一個(gè)特定目錄來(lái)存放標簽信息:META-INF目錄,其中我們來(lái)關(guān)注該目錄中的MANIFEST.MF文件,他就是Jar的manifest文件,他包含了Jar文件的內容描述,并在運行時(shí)向JVM提供應用程序的信息,大多數Jar文件含有一個(gè)默認生成的manifest 文件,執行Jar命令或使用zip工具,都可以產(chǎn)生它
如果是由Jar命令產(chǎn)生的 manifest 文件,形如:
Manifest-Version: 1.0 Created-By:1.4.0-beta (Sun Microsystems Inc.)
這些信息沒(méi)甚么用,僅僅告訴我們使用的是1.0的manifest文件,第一行定義manifest的格式,第二行說(shuō)明使用 SUN的JDK1.4的Jar工具生成該文件,如果manifest文件是由其他 (如ant) 創(chuàng )建的,那將會(huì )出現 “Created-By: Ant1.2” 之類(lèi)的內容,如果你是自己創(chuàng )建manifest文件,你可以加入自己的一些相關(guān)信息。
基礎格式
manifest 文件的格式 是很簡(jiǎn)單的,每一行都是 名-值 對應的:屬性名開(kāi)頭,接著(zhù)是 ":" ,然后是屬性值,每行最多72個(gè)字符,如果需要增加,你可以在下一行續行,續行以空格開(kāi)頭,以空格開(kāi)頭的行都會(huì )被視為前一行的續行。
所有在開(kāi)頭的屬性都是全局的,你也可以定義特定class或package的屬性,稍后將介紹這種把manifest文件插入Jar文件,使用 m 選項,把指定文件名的manifest文件傳入,例如:
Jar cvfm myapplication.Jar myapplication.mf -C classdir
如果你使用ant來(lái)創(chuàng )建時(shí),在ant 的build.xml 加入如下條目:
<target name="Jar"> <Jar Jarfile ="myapplication.Jar" manifest="myapplication.mf"> <fileset dir="classdir" includes="**/*.class"/> </Jar> </target>
運行Java程序
現在我們來(lái)體驗一下manifest文件的作用,如果現在我們有一個(gè)Java應用程序打包在myapplication.Jar中, main class為com.example.myapp.MyAppMain,那么我們可以用以下的命令來(lái)運行
java -classpath myapplication.Jar com.example.myapp.MyAppMain
這顯然太麻煩了,現在我們來(lái)創(chuàng )建自己的manifest文件,如下:
Manifest-Version: 1.0 Created-By: JDJ example Main-Class: com.example.myapp.MyAppMain
這樣我們就可以使用如下的命令來(lái)運行程序了:(明顯簡(jiǎn)單多了,也不會(huì )造成無(wú)謂的拼寫(xiě)錯誤)
java -Jar myapplication.Jar
管理Jar的依賴(lài)資源
很少Java應用會(huì )僅僅只有一個(gè)Jar文件,一般還需要其他類(lèi)庫。比如我的應用程序用到了Sun 的 Javamailclasses ,在classpath中我需要包含activation.Jar 和mail.Jar,這樣在運行程序時(shí),相比上面的例子,我們要增加一些:
java -classpath mail.Jar: activation.Jar -Jar myapplication.Jar
在不同的操作系統中,Jar包間的分隔符也不一樣,在UNIX用“:”,在window中使用 “;”,這樣也不方便。同樣,我們改寫(xiě)我們的manifest文件,如下:
Manifest-Version: 1.0 Created-By: JDJ example Main-Class: com.example.myapp.MyAppMain Class-Path: mail.Jar activation.Jar 加入了Class-Path: mail.Jar activation.Jar,用空格分隔兩個(gè)Jar包
這樣我們仍然可以使用和上例中相同的命令來(lái)執行該程序:
java -Jar myapplication.Jar
Class-Path屬性中包含了用空格分隔的Jar文件,在這些Jar文件名中要對特定的字符使用逃逸符,比如空格,要表示成"%20",在路徑的表示中,都采用“/”來(lái)分隔目錄,無(wú)論是在什么操作系統中,(即使在window中),而且這里用的是相對路徑(相對于本身的Jar文件):
Manifest-Version: 1.0 Created-By: JDJ example Main-Class: com.example.myapp.MyAppMain Class-Path: ext/mail.Jar ext/activation.Jar Multiple Main Classes(多主類(lèi))
還有一種Multiple MainClasses情況,如果你的應用程序可能有命令行版本和GUI版本,或者一些不同的應用卻共享很多相同的代碼,這時(shí)你可能有多個(gè)MainClass,我們建議你采取這樣的策略:把共享的類(lèi)打成lib包,然后把不同的應用打成不同的包,分別標志主類(lèi):如下:
Manifest for myapplicationlib.Jar: Manifest-Version: 1.0 Created-By: JDJ example Class-Path: mail.Jar activation.Jar Manifest for myappconsole.Jar: Manifest-Version: 1.0 Created-By: JDJ example Class-Path: myapplicationlib.Jar Main-Class: com.example.myapp.MyAppMain Manifest for myappadmin.Jar: Manifest-Version: 1.0 Created-By: JDJ example Class-Path: myapplicationlib.Jar Main-Class: com.example.myapp.MyAdminTool 在myappconsole.Jar 和 myappadmin.Jar的manifest 文件中分別注明各自的 Main Class Package Versioning
完成發(fā)布后,如果使用者想了解,哪些代碼是誰(shuí)的?目前是什么版本?使用什么版本的類(lèi)庫?解決的方法很多,manifest提供了一個(gè)較好的方法,你可以在manifest文件中描述每一個(gè)包的信息。
Java秉承了實(shí)現說(shuō)明與描述分離的原則,package的描述定義了package是什么,實(shí)現說(shuō)明定義了誰(shuí)提供了描述的實(shí)現,描述和實(shí)現包含名、版本號和提供者。要得到這些信息,可以查看JVM的系統屬性(使用java.lang.System.getProperty() )
在manifest文件中,我可以為每個(gè)package定義描述和實(shí)現版本,聲明名字,并加入描述屬性和實(shí)現屬性,這些屬性是:
Specification-Title Specification-Version Specification-Vendor Implementation-Title Implementation-Version Implementation-Vendor
當要提供一個(gè)類(lèi)庫或編程接口時(shí),描述信息顯得是很重要,見(jiàn)以下范例:
Manifest-Version: 1.0 Created-By: JDJ example Class-Path: mail.Jar activation.Jar Name: com/example/myapp/ Specification-Title: MyApp Specification-Version: 2.4 Specification-Vendor: example.com Implementation-Title: com.example.myapp Implementation-Version: 2002-03-05-A Implementation-Vendor: example.com
Package Version 查詢(xún)
在manifest文件中加入package描述后,就可以使用Java提供的java.lang.Package class進(jìn)行Package 的信息查詢(xún),這里列舉3個(gè)最基本的獲取package object的方法
1.Package.getPackages():返回系統中所有定義的package列表
2.Package.getPackage(String packagename):按名返回package
3.Class.getPackage():返回給定class所在的package
使用者這方法就可以動(dòng)態(tài)的獲取package信息。
需要注意的是如果給定的package中沒(méi)有class被加載,則也無(wú)法獲得package對象。
Manifest 技巧
1、總是以Manifest-Version屬性開(kāi)頭
2、每行最長(cháng)72個(gè)字符,如果超過(guò)的化,采用續行
3、確認每行都以回車(chē)結束,否則改行將會(huì )被忽略
4、如果Class-Path 中的存在路徑,使用"/"分隔目錄,與平臺無(wú)關(guān)
5、使用空行分隔主屬性和package屬性
6、使用"/"而不是"."來(lái)分隔package 和class ,比如 com/example/myapp/
7、class 要以.class結尾,package 要以 / 結尾