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檔名中要對特定的字元使用逃逸符,比如空格,要表示成" ",在路徑的表示中,都採用“/” 來分隔目錄(),無論是在什麼作業系統中,(即使在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 要以 / 結尾

打包可執行jar包時,MANIFEST.MF總是個讓人頭疼的東西,經常出現這種那種問題。
一個例子:
================================================================================
Manifest-Version: 1.0
Main-Class: test.Main
Class-Path: ./ ./lib/commons-collections-3.2.jar ./lib/commons-dbcp-1.2.2.jar
  ./lib/commons-lang-2.3.jar ./lib/commons-logging-1.1.jar

================================================================================
各部分解釋:
Manifest-Version MF檔案版本號
Main-Class 包含main方法的類
Class-Path 執行這個jar包時的ClassPath

以下是需要注意的各個要點:
1. Manifest-Version、Main-Class和Class-Path後面跟著一個英文的冒號,冒號後面必須跟著一個空格,然後才是版本號、類和ClassPath。
2. Class-Path中的各項應使用空格分隔,不是逗號或分號。
3. Class-Path中如果有很多項,寫成一行打包的時候會報錯line too long,這時需要把Class-Path分多行寫。注意:從第二行開始,必須以兩個空格開頭,三個以上我沒試過,不過不用空格開頭和一個空格開頭都是不行的,我已經試過了。
4. Class-Path寫完之後最後一定要有一個空行
5. jar包內有些配置檔案想放在jar包外面,比如檔案config.properties:如果這個檔案是以路徑方式載入的,比如new file("./config/config.properties"),那麼將config.properties放在jar包相同目錄下的config目錄下即可,也就是說“./”路徑等價於jar包所在目錄;如果這個檔案是以ClassPath下的檔案這種方式載入的,比如在Spring中載入classpath:config.properties,則在MF檔案的配置檔案的ClassPath中新增“./”,然後將這個配置檔案與jar包放在同一個目錄即可,當然也可以在MF檔案的配置檔案的ClassPath中新增“./config/”,然後把配置檔案都放在jar包相同目錄下的config目錄下。