參考百度百科的解釋如下:
http://baike.baidu.com/item/MANIFEST.MF
MANIFEST.MF:這個 manifest 文件定義了與擴展和包相關的數據。單詞“manifest”的意思是“顯示”
打開Java的JAR文件我們經常可以看到文件中包含着一個META-INF目錄,這個目錄下會有一些文件,其中必有一個MANIFEST.MF,這個文件描述了該Jar文件的很多信息,下面將詳細介紹MANIFEST.MF文件的內容,先來看struts.jar中包含的MANIFEST.MF文件內容:
Manifest-Version: 1.0
Created-By: Apache Ant 1.5.1
Extension-Name: Struts Framework
Specification-Title: Struts Framework
Specification-Vendor: Apache Software Foundation
Specification-Version: 1.1
Implementation-Title: Struts Framework
Implementation-Vendor: Apache Software Foundation
Implementation-Vendor-Id: org.apache
Implementation-Version: 1.1
Class-Path: commons-beanutils.jar commons-collections.jar commons-digester.jar commons-logging.jar commons-validator.jar jakarta-oro.jar struts-legacy.jar
如果我們把MANIFEST中的配置信息進行分類,可以歸納出下面幾個大類:
一. 一般屬性
1. Manifest-Version
用來定義manifest文件的版本,例如:Manifest-Version: 1.0
2. Created-By
聲明該文件的生成者,一般該屬性是由jar命令行工具生成的,例如:Created-By: Apache Ant 1.5.1
3. Signature-Version
定義jar文件的簽名版本
4. Class-Path
應用程序或者類裝載器使用該值來構建內部的類搜索路徑
二. 應用程序相關屬性
1. Main-Class
定義jar文件的入口類,該類必須是一個可執行的類,一旦定義了該屬性即可通過 java -jar x.jar來運行該jar文件。
三. 小程序(Applet)相關屬性
1. Extendsion-List
該屬性指定了小程序需要的擴展信息列表,列表中的每個名字對應以下的屬性
2. <extension>-Extension-Name
3. <extension>-Specification-Version
4. <extension>-Implementation-Version
5. <extension>-Implementation-Vendor-Id
5. <extension>-Implementation-URL
四. 擴展標識屬性
1. Extension-Name
該屬性定義了jar文件的標識,例如Extension-Name: Struts Framework
五. 包擴展屬性
1. Implementation-Title 定義了擴展實現的標題
2. Implementation-Version 定義擴展實現的版本
3. Implementation-Vendor 定義擴展實現的組織
4. Implementation-Vendor-Id 定義擴展實現的組織的標識
5. Implementation-URL : 定義該擴展包的下載地址(URL)
6. Specification-Title 定義擴展規范的標題
7. Specification-Version 定義擴展規范的版本
8. Specification-Vendor 聲明了維護該規范的組織
9. Sealed 定義jar文件是否封存,值可以是true或者false (這點我還不是很理解)
六. 簽名相關屬性
簽名方面的屬性我們可以來參照JavaMail所提供的mail.jar中的一段
Name: javax/mail/Address.class
Digest-Algorithms: SHA MD5
SHA-Digest: AjR7RqnN//cdYGouxbd06mSVfI4=
MD5-Digest: ZnTIQ2aQAtSNIOWXI1pQpw==
這段內容定義類簽名的類名、計算摘要的算法名以及對應的摘要內容(使用BASE64方法進行編碼)
七.自定義屬性
除了前面提到的一些屬性外,你也可以在MANIFEST.MF中增加自己的屬性以及響應的值,例如J2ME程序jar包中就可能包含着如下信息
MicroEdition-Configuration: CLDC-1.0
MIDlet-Name: J2ME_MOBBER Midlet Suite
MIDlet-Info-URL: http://www.javayou.com/
MIDlet-Icon: /icon.png
MIDlet-Vendor: Midlet Suite Vendor
MIDlet-1: mobber,/icon.png,mobber
MIDlet-Version: 1.0.0
MicroEdition-Profile: MIDP-1.0
MIDlet-Description: Communicator
關鍵在於我們怎么來讀取這些信息呢?其實很簡單,JDK給我們提供了用於處理這些信息的API,詳細的信息請見java.util.jar包中,我們可以通過給JarFile傳遞一個jar文件的路徑,然后調用JarFile的getManifest方法來獲取Manifest信息。
備注:更詳細的說明,參考oracle提供的文檔:http://docs.oracle.com/javase/1.5.0/docs/guide/jar/jar.html(這個地址其實是有規律的,試下后面的版本號更新到特定的)
編寫MANIFEST.MF文件時的注意事項:
說明:一般編寫MANIFEST.MF文件只需要用到Manifest-Version(MF文件版本號)、Main-Class(包含main方法的類)、Class-Path(執行這個jar包時的ClassPath,第三方依賴)
比如以下的例子:
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
以下是需要注意的各個要點:
0. 最后一樣一定要回車,空一行,不然無法識別最后一行的配置。
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目錄下。