Apache Ant Tasks 简明教程

Apache Ant Tasks - EAR

Description

Ear 任务是对 Jar 任务的扩展,对应该最终出现在 Enterprise 应用存档中的文件采取特殊处理。

Ear task is an extension of the Jar task with special treatment for files that should end up in an Enterprise Application archive.

Properties

Sr.No

Attributes & Description

1

Destfile the EAR file to create.

2

app.xml The deployment descriptor to use (META-INF/application.xml).

3

Basedir the directory from which to jar the files.

4

Compress Not only store data but also compress them. Unless you set the keep compression attribute to false, this will apply to the entire archive, not only the files you’ve added while updating.

5

Keepcompression For entries coming from existing archives (like nested zipfilesets or while updating the archive), keep the compression as it has been originally instead of using the compress attribute.

6

Encoding The character encoding to use for filenames inside the archive.

7

Filesonly Store only file entries.

8

Include comma- or space-separated list of patterns of files that must be included.

9

Includesfile name of a file. Each line of this file is taken to be an include pattern.

10

Excludes comma- or space-separated list of patterns of files that must be excluded.

11

Excludesfile Name of a file. Each line of this file is taken to be an exclude pattern.

12

Defaultexcludes Indicates whether default excludes should be used or not (yes

no).

13

Menifest The manifest file to use.

14

Filesetmanifest Behavior when a manifest file is found in a zipfileset or zipgroupfileset file. Valid values are skip, merge, and mergewithoutmain. merge will merge all of the manifests together, and merge this into any other specified manifests. mergewithoutmain merges everything but the Main section of the manifests.

15

Whenmanifestonly Behavior when no files match. Valid values are fail, skip, and create.

16

Manifestencoding The encoding used to read the JAR manifest, when a manifest file is specified.

17

Index whether to create an index list to speed up classloading. Unless you specify additional jars with nested indexjars elements, only the contents of this jar will be included in the index.

18

IndexMetaInf Whether to include META-INF and its children in the index. Doesn’t have any effect if index is false. Oracle’s jar implementation used to skip the META-INF directory and Ant followed that example. The behavior has been changed with Java 5. In order to avoid problems with Ant generated jars on Java 1.4 or earlier, Ant will not include META-INF unless explicitly asked to.

19

Manifestencoding The encoding used to read the JAR manifest, when a manifest file is specified.

20

Update indicates whether to update or overwrite the destination file if it already exists.

21

Duplicate Behavior when a duplicate file is found. Valid values are add, preserve, and fail.

22

Roundup Whether the file modification times will be rounded up to the next even number of seconds.

23

Level Non-default level at which file compression should be performed. Valid values range from 0 (no compression/fastest) to 9 (maximum compression/slowest).

24

Preserve0permissions When updating an archive or adding entries from a different archive Ant will assume that a Unix permissions value of 0 (nobody is allowed to do anything to the file/directory) means that the permissions haven’t been stored at all rather than real permissions and will instead apply its own default values.

25

*UseLanguageEncodingFlag * Whether to set the language encoding flag if the encoding is UTF-8. This setting doesn’t have any effect if the encoding is not UTF-8.

26

CreateUnicodeExtraFields Whether to create Unicode extra fields to store the file names a second time inside the entry’s metadata.

27

FallbacktoUTF8 Whether to use UTF-8 and the language encoding flag instead of the specified encoding if a file name cannot be encoded using the specified encoding.

28

MergeClassPathAttributes Whether to merge the Class-Path attributes found in different manifests (if merging manifests). If false, only the attribute of the last merged manifest will be preserved.

29

FlattenAttributes Whether to merge attributes occurring more than once in a section (this can only happen for the Class-Path attribute) into a single attribute.

30

Example

Usage

使用以下内容创建 build.xml −

Create build.xml with the following content −

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <property name="src.dir" value="src" />
   <property name="build.dir" value="build" />
   <target name="info">
      <ear destfile="${build.dir}/myapp.ear" appxml="${src.dir}/metadata/application.xml">
         <fileset dir="${build.dir}" includes="*.jar,*.war"/>
      </ear>
   </target>
</project>

上述脚本将在当前目录中创建一个名为 myapp.ear 的 ear 文件。

Above script will create an ear file in the current directory as myapp.ear.

Output

在上述构建文件上运行 Ant 会生成以下输出:

Running Ant on the above build file produces the following output −

F:\tutorialspoint\ant>ant
Buildfile: F:\tutorialspoint\ant\build.xml

info:
   [ear] Building ear: F:\tutorialspoint\ant\build\myapp.ear

BUILD SUCCESSFUL
Total time: 1 second