1. 程式人生 > >Jar命令 Manifest.mf的用法

Jar命令 Manifest.mf的用法

1.在命令列中輸入“jar -help”,就k可看到jar的詳細用法了。

2.示例:

   1)將兩個class文件歸檔到一個jar檔案中:jar -cvf  XX.jar  A.class B.class

   2 )使用清單檔案Manifest.mf將dir目錄下的所有檔案歸檔到一個jar中:jar -cvfm   XX.jar  Manifest.mf dir/*

      manifest 檔案的格式很簡單,每一行都是  " 名-值 "  對應的:

      屬性名開頭,接著是 ":" ,然後是屬性值,每行最多72個字元,如果需要增加,你可以在下一行續行,續行以空格開頭,以空格開頭的行       都會被視為前一行的續行。 
      使用 m 選項,把指定檔名的manifest檔案傳入,例如 
      jar cvfm myapplication.jar myapplication.mf [-C]classdir

Manifest.mf的詳細用法(轉)

現在我們來體驗一下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


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
Package Versioning
完成釋出後,如果使用者想了解 ,哪些程式碼是誰的?目前是什麼版本?使用什麼版本的類庫?解決的方法很多 ,manifest提供了一個較好的方法,你可以在manifest檔案中描述每一個包的資訊。


Java 秉承了實現說明與描述分離的原則,package 的描述 定義了package 是什麼,實現說明 定義了誰提供了描述的實現,描述和實現包含 名、版本號和提供者。要得到這些資訊,可以檢視JVM的系統屬性(使用 java.lang.System.getProperty() )
在manifest檔案中,我可以為每個package定義描述和實現版本,宣告名字,並加入描述屬性和實現屬性,這些屬性是
Specification-Title
Specification-Version
Specification-Vendor
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 要以 / 結尾