JAR包中的MANIFEST.MF文件詳解以及編寫規范


參考百度百科的解釋如下:

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目錄下。

參考:http://www.cnblogs.com/gaoguofeng/p/5646442.html


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM