jar文件使用詳解

式被廣泛使用，因此易與使用，有很多中工具可以操作這種格式的文件。也正是因爲這個原因，jar文件本身並不能表達所包含應用程序的標籤信息。

　　Manifest 因此得以出現

　　爲了要提供存檔的標籤信息，jar 文件指定了一個特定目錄來存放標籤信息：META-INF 目錄，其中我們來關注該目錄中的MANIFEST.MF文件，他就是JAR的manifest文件，他包含了JAR文件的內容描述，並在運行時向JVM提供應用程序的信息，大多數JAR文件含有一個默認生成的manifest 文件,執行JAR命令或使用zip工具，都可以產生它

　　如果是由jar命令產生的 manifest 文件，形如:

　　Manifest-Version: 1.0

　　Created-By:1.4.0-beta

　　(Sun Microsystems Inc.)

　　這些信息沒甚麼用,僅僅告訴我們使用的是1.0的manifest文件,第一行定義manifest的格式，第二行說明使用 SUN 的JDK1.4的jar工具生成該文件，如果manifest文件是由其他 （如ant） 創建的，那將會出現 “Created-By: Ant 1.2” 之類的內容，如果你是自己創建manifest文件，你可以加入自己的一些相關信息.

　　基礎格式

　　manifest 文件的格式 是很簡單的，每一行都是 名－值 對應的 “屬性名:[空格]屬性值” ，屬性名後接着是 ":" ，然後是一空格，再是屬性值，每行最多72個字符，如果需要增加，你可以在下一行續行，續行以空格開頭，以空格開頭的行都會被視爲前一行的續行。

　　所有在開頭的屬性都是全局的，你也可以定義特定class 或package的屬性，稍後將介紹這種

manifest文件作用：

　　1、把manifest文件插入JAR文件，用來描述jar文件

　　使用 m 選項，把指定文件名的manifest文件 傳入，例如

　　jar cvfm myapplication.jar myapplication.mf -C classdir

　　如果你使用ant來創建時，在ant 的build.xml 加入如下條目

　　<target name="jar">

　　<jar jarfile ="myapplication.jar"

　　manifest="myapplication.mf">

　　<fileset dir="classdir"

　　includes="**/*.class"/>

　　</jar>

　　</target>

　　運行Java程序

　　現在我們來體驗一下manifest文件的作用，如果現在我們有一個Java 應用程序打包在myapplication.jar中， main class爲 com.example.myapp.MyAppMain ，那麼我們可以用以下的命令來運行

　　java -classpath myapplication.jar com.example.myapp.MyAppMain

　　這顯然太麻煩了，現在我們來創建自己的manifest文件，如下：

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Main-Class: com.example.myapp.MyAppMain

　　這樣我們就可以使用如下的命令來運行程序了：（明顯簡單多了，也不會造成無謂的拼寫錯誤）

　　java -jar myapplication.jar

管理JAR的依賴資源

　　很少Java應用會僅僅只有一個jar文件，一般還需要 其他類庫。比如我的應用程序用到了Sun 的 Javamail classes ，在classpath中我需要包含activation.jar 和 mail.jar,這樣在運行程序時,相比上面的例子,我們要增加一些:

　　java -classpath mail.jar:activation.jar -jar myapplication.jar

　　在不同的操作系統中,jar包間的分隔符也不一樣，在UNIX用“：”，在window中使用 “；”，這樣也不方便

　　同樣，我們改寫我們的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，用空格分隔兩個jar包）

　　這樣我們仍然可以使用和上例中相同的命令來執行該程序：

　　java -jar myapplication.jar

　　Class-Path屬性中包含了用空格分隔的jar文件，在這些jar文件名中要對特定的字符使用逃逸符，比如空格，要表示成"%20"，在路徑的表示中，都採用“/”來分隔目錄，無論是在什麼操作系統中，(即使在window中)，而且這裏用的是相對路徑（相對於本身的JAR文件）：

　　Manifest-Version: 1.0

　　Created-By: JDJ example

　　Main-Class: com.example.myapp.MyAppMain

　　Class-Path: ext/mail.jar ext/activation.jar

上面的方法打包後生成的jar文件中不包括ext/mail.jar ext/activation.jar兩個包，要運行生成的包，必須同時存在Class-Path中的包，且相對位置不能改變。這樣運行一個包，要附帶幾個包，很不方便，那有什麼辦法讓這些包都集成一個包中呢？當然可以。這裏介紹一種方法：將所引用到的包全部解壓到同一個目錄下（當前目錄切換到此目錄），自己的包也在該目錄下，manifest.mf文件(此時無須再包含Class-Path屬性)和圖片文件也放在此目錄下（當前目錄不包含不相關文件），然後將當前目錄下所有文件打包，命令如下：

當前目錄>jar cvfm my.jar manifest.mf -C ./ *

用法：jar {ctxu}[vfm0Mi] [jar-文件] [manifest-文件] [-C 目錄] 文件名

"-C ./"中"./"代表當前目錄，其與後面的"*"之間有空格，"*"代表所有文件，這樣就將引用的包加進來了，可以雙擊運行。雖然圖片文件也打到包中了，但好象沒有用，當存在於包外時有用。

另外,你也可以加入一些其他必要的文件:jar cvmf MANIFEST.MF a.jar *.class *.png 這樣你就可以把程序中需要的一些圖片文件打包到jar包中了。

但是把圖片打包到jar中可能會存在這樣的情況，就是不打包時還可以加載圖片，打了包之後程序加載不上圖片，那麼你的程序需要稍微改一下，在新建圖標對象的時候：

Icon pica=new ImageIcon(a.class.getResource("pica.png"));
Icon picb=new ImageIcon(a.class.getResource("picb.png"));

其中a.class是你的主類名，這樣就可以加載上圖片了。


　　Implementation-Title

　　Implementation-Version

　　Implementation-Vendor

　　當要提供一個類庫或編程接口時，描述信息顯得是很重要，見以下範例：

　　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 查詢

　　在manifest文件中加入package描述後，就可以使用Java提供的java.lang.Package class進行Package 的信息查詢，這裏列舉3個最基本的獲取package object的方法

　　1.Package.getPackages():返回系統中所有定義的package列表

　　2.Package.getPackage(String packagename):按名返回package

　　3.Class.getPackage():返回給定class所在的package

　　使用者這方法就可以動態的獲取package信息.

　　需要注意的是如果給定的package中沒有class被加載,則也無法獲得package 對象

　　Manifest 技巧

　　總是以Manifest-Version屬性開頭

　　每行最長72個字符，如果超過的化，採用續行

　　確認每行都以回車結束，否則改行將會被忽略

　　如果Class-Path 中的存在路徑，使用"/"分隔目錄，與平臺無關

　　使用空行分隔主屬性和package屬性

　　使用"/"而不是"."來分隔package 和class ,比如 com/example/myapp/

　　class 要以.class結尾，package 要以 / 結尾


　　Multiple Main Classes（多主類）

　　還有一種Multiple Main Classes情況，如果你的應用程序可能有命令行版本 和GUI版本，或者一些不同的應用卻共享很多相同的代碼，這時你可能有多個Main Class，我們建議你採取這樣的策略：把共享的類打成lib包，然後把不同的應用打成不同的包，分別標誌主類：如下

　　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

　　2、用來描述包 Package Versioning

　　完成發佈後，如果使用者想了解 ，哪些代碼是誰的？目前是什麼版本？使用什麼版本的類庫？解決的方法很多 ，manifest提供了一個較好的方法，你可以在manifest文件中描述每一個包的信息。

　　Java 秉承了實現說明與描述分離的原則，package 的描述 定義了package 是什麼，實現說明 定義了誰提供了描述的實現，描述和實現包含 名、版本號和提供者。要得到這些信息，可以查看JVM的系統屬性（使用 java.lang.System.getProperty() ）

　　在manifest文件中，我可以爲每個package定義描述和實現版本，聲明名字，並加入描述屬性和實現屬性，這些屬性是

　　Specification-Title

　　Specification-Version

　　Specification-Vendor
引用自：http://hi.baidu.com/suofang/blog/item/271e8682f943c291f603a629.html