Apache Ant 任务 - WAR


描述

War 任务是 Jar 任务的扩展,对最终应位于 Web 应用程序存档的 WEB-INF/lib、WEB-INF/classes 或 WEB-INF 目录中的文件进行特殊处理。

特性

先生编号 属性和描述
1

目标文件

要创建的 WAR 文件。

2

WebXML

要使用的 servlet 配置描述符 (WEB-INF/web.xml)。

3

巴迪尔

从中打包文件的目录。

4

压缩

不仅存储数据而且压缩它们。除非您将 keepcompression 属性设置为 false,否则这将应用于整个存档,而不仅仅是您在更新时添加的文件。

5

保持压缩

对于来自现有存档的条目(例如嵌套的 zipfileset 或更新存档时),请保持原来的压缩状态,而不是使用 compress 属性。

6

编码

用于存档内文件名的字符编码。

7

仅文件

仅存储文件条目。

8

包括

必须包含的文件模式的逗号或空格分隔列表。

9

包含文件

文件名。该文件的每一行都被视为一个包含模式。

10

不包括

必须排除的文件模式的逗号或空格分隔列表。

11

排除文件

文件名。该文件的每一行都被视为排除模式。

12

默认排除

指示是否应使用默认排除(是|否)。

13

梅尼弗节

要使用的清单文件。

14

文件集清单

在 zipfileset 或 zipgroupfileset 文件中找到清单文件时的Behave。有效值为skip、merge 和mergewithoutmain。merge 会将所有清单合并在一起,并将其合并到任何其他指定的清单中。mergewithoutmain 合并清单中除 Main 部分之外的所有内容。

15

当明显地

没有文件匹配时的Behave。有效值为失败、跳过和创建。

16

清单编码

当指定清单文件时,用于读取 JAR 清单的编码。

17 号

指数

是否创建索引列表以加速类加载。除非您使用嵌套的 indexjars 元素指定其他 jar,否则只有该 jar 的内容才会包含在索引中。

18

索引元信息

是否在索引中包含 META-INF 及其子项。如果索引为假,则没有任何影响。Oracle 的 jar 实现过去常常跳过 META-INF 目录,而 Ant 也遵循了该示例。Java 5 中的Behave已更改。为了避免在 Java 1.4 或更早版本上 Ant 生成的 jar 出现问题,除非明确要求,否则 Ant 将不会包含 META-INF。

19

清单编码

当指定清单文件时,用于读取 JAR 清单的编码。

20

更新

指示是否更新或覆盖目标文件(如果已存在)。

21

复制

发现重复文件时的Behave。有效值为添加、保留和失败。

22

围捕

文件修改时间是否将四舍五入到下一个偶数秒。

23

等级

应执行文件压缩的​​非默认级别。有效值范围从 0(无压缩/最快)到 9(最大压缩/最慢)。

24

保留0权限

当更新存档或添加来自不同存档的条目时,Ant 将假定 Unix 权限值为 0(不允许任何人对文件/目录执行任何操作)意味着根本没有存储权限,而不是真正的权限,并且将会应用它自己的默认值。

25

使用语言编码标志

如果编码为UTF-8,是否设置语言编码标志。如果编码不是 UTF-8,则此设置不会产生任何影响。

26

创建Unicode额外字段

是否创建 Unicode 额外字段以在条目的元数据中再次存储文件名。

27

回退到 UTF8

如果文件名无法使用指定的编码进行编码,是否使用 UTF-8 和语言编码标志来代替指定的编码。

28

合并类路径属性

是否合并在不同清单中找到的类路径属性(如果合并清单)。如果为 false,则仅保留最后合并的清单的属性。

29

扁平化属性

是否将在一个部分中多次出现的属性(这只可能发生在类路径属性中)合并到单个属性中。

30

zip64模式

何时对条目使用 Zip64 扩展名。可能的值从不、总是并且根据需要。

31

需要xml文件

指示是否需要 web.xml 文件的标志。当生成没有 web.xml 文件的 servlet 2.5+ WAR 文件时,应将其设置为 false。

例子

用法

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

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <target name="info">
      <war destfile="myapp.war" webxml="web.xml"></war>
   </target>
</project>

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

输出

在上面的构建文件上运行 Ant 会产生以下输出 -

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

info:
   [war] Building war: F:\tutorialspoint\ant\myapp.war

BUILD SUCCESSFUL
Total time: 1 second