Apache Ant 任務 - WAR



描述

War 任務是 Jar 任務的擴充套件,對應該最終位於 Web 應用程式存檔的 WEB-INF/lib、WEB-INF/classes 或 WEB-INF 目錄中的檔案進行特殊處理。

屬性

序號 屬性 & 描述
1

Destfile

要建立的 WAR 檔案。

2

Webxml

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

3

Basedir

從中打包檔案的目錄。

4

Compress

不僅儲存資料,還壓縮它們。除非您將 keepcompression 屬性設定為 false,否則這將應用於整個存檔,而不僅僅是您在更新時新增的檔案。

5

Keepcompression

對於來自現有存檔(如巢狀的 zipfileset 或更新存檔時)的條目,請保留其原始壓縮方式,而不是使用 compress 屬性。

6

Encoding

用於存檔內檔名的字元編碼。

7

Filesonly

僅儲存檔案條目。

8

Include

必須包含的檔案模式的逗號或空格分隔列表。

9

includesfile

檔名。此檔案的每一行都被視為一個包含模式。

10

Excludes

必須排除的檔案模式的逗號或空格分隔列表。

11

Excludesfile

檔名。此檔案的每一行都被視為一個排除模式。

12

defaultexcludes

指示是否應使用預設排除項 (yes|no)。

13

Menifest

要使用的清單檔案。

14

Filesetmanifest

在 zipfileset 或 zipgroupfileset 檔案中找到清單檔案時的行為。有效值為 skip、merge 和 mergewithoutmain。merge 將合併所有清單,並將此合併到任何其他指定的清單中。mergewithoutmain 合併所有內容,但清單的主部分除外。

15

Whenmanifestonly

當沒有檔案匹配時的行為。有效值為 fail、skip 和 create。

16

Manifestencoding

指定清單檔案時,用於讀取 JAR 清單的編碼。

17

Index

是否建立索引列表以加快類載入速度。除非您使用巢狀的 indexjars 元素指定其他 jar,否則只有此 jar 的內容將包含在索引中。

18

indexMetaInf

是否在索引中包含 META-INF 及其子項。如果 index 為 false,則沒有任何效果。Oracle 的 jar 實現過去會跳過 META-INF 目錄,Ant 遵循此示例。Java 5 已更改此行為。為了避免 Ant 生成的 jar 在 Java 1.4 或更早版本上出現問題,除非明確要求,否則 Ant 不會包含 META-INF。

19

Manifestencoding

指定清單檔案時,用於讀取 JAR 清單的編碼。

20

Update

指示如果目標檔案已存在,是否更新或覆蓋它。

21

Duplicate

找到重複檔案時的行為。有效值為 add、preserve 和 fail。

22

Roundup

檔案修改時間是否將四捨五入到下一個偶數秒。

23

Level

應執行檔案壓縮的非預設級別。有效值範圍為 0(無壓縮/最快)到 9(最大壓縮/最慢)。

24

preserve0permissions

更新存檔或從其他存檔新增條目時,Ant 將假定 Unix 許可權值為 0(沒有人被允許對檔案/目錄執行任何操作)表示許可權根本沒有儲存,而不是實際許可權,並將應用其自己的預設值。

25

useLanguageEncodingFlag

如果編碼為 UTF-8,是否設定語言編碼標誌。如果編碼不是 UTF-8,則此設定沒有任何效果。

26

createUnicodeExtraFields

是否建立 Unicode 附加欄位以在條目的元資料中第二次儲存檔名。

27

fallbacktoUTF8

如果無法使用指定的編碼對檔名進行編碼,是否使用 UTF-8 和語言編碼標誌代替指定的編碼。

28

mergeClassPathAttributes

是否合併不同清單中找到的 Class-Path 屬性(如果合併清單)。如果為 false,則只會保留最後一個合併的清單的屬性。

29

FlattenAttributes

是否將某個部分中出現多次的屬性(這隻能發生在 Class-Path 屬性中)合併到單個屬性中。

30

zip64Mode

何時對條目使用 Zip64 擴充套件。可能的值為 never、always 和 as-needed。

31

Needxmlfile

標誌,指示是否需要 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>

以上指令碼將在當前目錄中建立一個名為 myapp.ear 的 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
廣告

© . All rights reserved.