Manifest文件
JAR文件可以可选地在META-INF
目录中包含名为MANIFEST.MF
的Manifest
文件。Manifest
文件包含有关JAR文件及其条目的信息。Manifest
文件可以包含有关JAR文件的CLASSPATH
设置及其主条目类的信息。
主条目类是具有启动独立应用程序的main()
方法的类,包的版本信息等。
manifest
文件被分成由空白行分隔的部分。每个部分包含名称 - 值对。 一个新行分隔每个名称/值对。冒号分隔名称及其对应的值。
清单文件必须以新行结束。以下是样本清单文件:
Manifest-Version: 1.0
Created-By: 1.8.0_20-ea-b05 (Oracle Corporation)
Main-Class: com.yiibai.Main
Profile: compact1
上面的manifest
文件有一个具有四个属性的部分:
- Manifest-Version
- Created-By
- Main-Class
- Profile
Jar清单文件中的部分
manifest
文件中有两种类型的部分:主部分和各个部分。
空行必须分隔任何两个部分。主部分中的条目适用于整个JAR文件。单个部分中的条目适用于特定条目。
单个部分中的属性覆盖主部分中的相同属性。单个条目以“Name”属性开头,其值是JAR文件中条目的名称,后面是该条目的其他属性。
Manifest-Version: 1.0
Created-By: 1.6.0 (Sun Microsystems Inc.)
Main-Class: com.yiibai.Main
Sealed: true
Name: book/data/
Sealed: false
Name: images/logo.bmp
Content-Type: image/bmp
上面的清单文件包含三个部分:一个主部分和两个单独部分。
在两个部分之间有一个空白行。
第一个单独部分指示包装书/数据未被密封。 这个单独的section
属性“Sealed:false
”将覆盖主部分的属性“Sealed:true
”。
第二个单独部分用于名为images/logo.bmp
的条目。它表示条目的内容类型是bmp
类型的图片。
Jar Manifest文件中的值
jar命令可以创建默认 Manifest
文件并将其添加到JAR文件。默认清单文件仅包含两个属性:Manifest-Version
和Created-By
。可以使用选项M
告诉jar工具忽略默认Manifest
文件。
以下命令将创建一个test.jar
文件,而不添加默认Manifest
文件:
jar cMf test.jar *
jar命令提供了自定义Manifest
文件内容的选项。选项m
指定具有Manifest
文件内容的文件。
jar命令将从指定Manifest
文件读取名称/值对,并将其添加到MANIFEST.MF
文件。
假设有一个名为manifest.txt
的文件,其中有一个属性条目。请确保在文件末尾添加新行。 文件内容如下:
Main-Class: com.yiibai.Main
要通过将当前工作目录中的所有类文件包含在新的test.jar
文件中,从manifest.txt
文件中添加Main-Class
属性值,请执行以下命令:
jar cfm test.jar manifest.txt *.class
指定选项m
时,还必须指定Manifest
文件名。指定新JAR文件名和Manifest
文件名的顺序必须与选项m
和f
的顺序匹配。
例如,可以通过以不同的顺序指定f
和m
选项来更改上述命令,如下所示:
jar cmf manifest.txt test.jar *.class
此命令将向test.jar
文件添加具有以下内容的manifest
文件:
Manifest-Version: 1.0
Created-By: 1.8.0_20-ea (Oracle Corporation)
Main-Class: com.yiibai.Main
如果未在manifest
文件中指定manifest
文件和创建者属性,这工具将会自己添加它们。它默认的manifest
版本为1.0。创建者默认为使用的JDK版本。
主类
以下代码显示如何使用java命令运行Java程序,并指定具有main()
方法的类名,如下所示:
java com.yiibai.Main
com.yiibai
是包名称。可以使用-jar
选项与java命令运行jar文件,如下所示:
java -jar test.jar
当运行上述命令时,JVM将在test.jar
文件中的MANIFEST.MF
文件中查找Main-Class
属性的值,并尝试运行该类。
如果在test.jar
文件中未包含Main-Class
属性,则上述命令将生成错误。
还可以在manifest
文件中添加Main-Class
属性值,而无需创建自己的manifest
文件。
在创建/更新jar
文件时,使用选项e
与jar工具。以下命令将在test.jar
文件中的MANIFEST.MF
文件中添加com.yiibai.Main
作为Main-Class
的值:
jar cfe test.jar com.yiibai.Main *.class
以下命令将使用选项u
将com.yiibai.Main
用来更新添加到test.jar
文件中MANIFEST.MF
文件中Main-Class
的值:
jar ufe test.jar com.yiibai.Main
类路径
可以在其manifest
文件中为JAR文件设置CLASSPATH
。属性名称叫作类路径,必须在自定义清单文件中指定。 它是一个空格分隔的jar文件,zip文件和目录的列表。 manifest
文件中的Class-Path
属性看起来像 -
Class-Path: Main.jar file:/c:/book/ http://www.yiibai.com/tutorial.jar
上面的条目有三个CLASSPATH
项目:一个JAR
文件Main.jar
,一个使用文件协议文件的目录:c:/book/
和另一个使用HTTP协议的JAR文件http://www.yiibai.com/tutorial.jar
。
java -jar test.jar
当使用java命令使用-jar
选项运行JAR文件时,将忽略JAR文件(在上述情况为test.jar
文件)的 manifest
文件之外的任何CLASSPATH
设置。Class-Path
属性的另一个用途是使用jar工具的选项i
生成所有包的索引。
以下命令将为test.jar
文件中清单文件的Class-Path
属性中列出的所有JAR文件中的所有包生成索引:
jar i test.jar
在JAR文件中封装包
在JAR文件中封装包意味着该包中声明的所有类必须存档在同一个JAR文件中。要在JAR文件中封装包,请包括两个属性:Name
和Sealed
。 Name
属性的值是包的名称,Sealed
属性的值为true
。
manifest
文件中的以下条目将封装名为com.yiibai
的包。 程序包名称必须以正斜杠(/)结尾。
Name: com/yiibai/ Sealed: true
默认情况下,JAR文件中的所有包都不会被封装。 如果想要密封JAR文件本身,则可以包含Sealed
属性,如下所示:
Sealed: true
封装JAR文件将会封装该JAR文件中的所有包。 但是,可以通过不单独密封包装来覆盖它。manifest
文件中的以下条目将封装JAR文件中的所有包,除了book/tutorial/package
之外:
Sealed: true
Name: book/tutorial/
Sealed: false