檔案規範
JAR檔案檔案在規定位置包含META-INF/MANIFEST.MF。在一個檔案檔案中,只能有一個Manifest檔案,而且必須在規定的META-INF資料夾中。
由JDK1.0創建的Manifest檔案內容如下:
其中包含的所有條目均為名/值對。檔案頭的名和值由冒號分隔。默認的Manifest檔案顯示它遵從Manifest資源配置檔案規範1.0。 Manifest檔案還可以包含該檔案檔案中所打包的其他檔案的信息。具體Manifest檔案中記錄的檔案信息由該JAR檔案的預期使用對象決定。默認的Manifest檔案並不包含其他檔案的信息,因此只包含唯一一行關於該Manifest檔案自身的數據。
特殊用法的Manifest檔案頭
默認Manifest檔案可以根據JAR檔案的用處而作相應修改。如果JAR檔案僅僅是用作存檔,那么MANIFEST.MF檔案則只包含默認信息。 然而,大多數JAR檔案都不僅僅是用作壓縮存檔,相應的Manifest的檔案也包含了特定的信息。下面列出了一些主要的特殊用法的Manifest檔案頭:
JAR應用程式: 如果JAR檔案被用作可執行的應用程式,那么應用程式需要告訴Java虛擬機入口點位置。任意包含public static void main(String[] args)方法的類即為入口點。該信息由檔案頭Main-Class提供,基本格式如下:
classname值可由應用程式的入口點代替。
可下載擴展: 可下載擴展檔案是由其他JAR檔案中的Manifest檔案所提及的JAR檔案。通常情況下,JAR檔案可以包含一個Applet小應用程式,該JAR檔案的Manifest檔案則指向一系列的JAR檔案作為可下載擴展來支持該小應用程式。擴展之間也可以使用相同方法來進行指向。 可下載擴展信息是由小應用程式或另一擴展中的Manifest檔案的Class-Path檔案頭提供的。通常可見的Class-Path檔案頭內容如下:
在該檔案頭信息中,servlet.jar,infobus.jar以及acme/beans.jar中的類將作為可下載擴展為Applet小應用程式或Java應用程式服務。Class-Path中給出的超連結是該Applet小應用程式或Java應用程式的相對地址。
封裝加封: JAR檔案中的封裝可以選擇進行加封,即該封裝中所定義的類必須被存檔在相同的JAR檔案中。封裝加封可以用來確保類版本的連貫性或作為安全措施。 要對封裝進行加封,需要對該封裝加入檔案頭Name,然後加入檔案頭Sealed,如下:
檔案頭Name的值為該封裝的相對路徑名。注意,該路徑名由‘/’結束以區別於檔案名稱。在檔案頭Name之後未採用空行隔開的檔案頭,一律作用於該Name檔案頭制定的檔案或封裝。在上述例子中,由於Sealed緊接在Name: myCompany/myPackage header之後且沒有空行隔開,那么該Sealed檔案頭僅作用於myCompany/myPackage封裝。該代碼無法執行。
封裝版本:封裝版本規範定義了一系列Manifest檔案頭來記錄版本信息。每個封裝都可以套用一系列Manifest檔案頭。版本檔案頭應當直接跟隨在Name檔案頭。下面的例子展示了所有的版本檔案頭:
指定從屬檔案:
MANIFEST.MF檔案可以用來指定應用程式運行所必須載入的所有類檔案。