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信息。

更詳細關於JAR文件的規範請見
http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html

中文說明
http://www-900.ibm.com/developerWorks/cn/java/j-jar/

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章