战争：战争

全名：

org.apache.maven.plugins:maven-war-plugin:2.1.1:war

说明：

构建一个 WAR 文件。

属性：

  • 需要执行 Maven 2.0 项目。
  • 需要范围内工件的依赖关系解析：runtime.
  • 目标是线程安全的并支持并行构建。
  • 默认绑定到生命周期阶段：package.

必需参数

姓名 类型 自从 描述
缓存文件 File 2.1-alpha-1 包含 webapp 结构缓存的文件。
默认值为：${project.build.directory}/war/work/webapp-cache.xml。
输出目录 String - 生成的 WAR 的目录。
默认值为：${project.build.directory}。
战争名称 String - 生成的 WAR 的名称。
默认值为：${project.build.finalName}。
战争源目录 File - 要包含在 WAR 中的额外文件的单个目录。这是放置 JSP 文件的地方。
默认值为：${basedir}/src/main/webapp。
webapp目录 File - 构建 webapp 的目录。
默认值为：${project.build.directory}/${project.build.finalName}。
工作目录 File - 如果需要，将依赖的 WAR 解压到的目录。
默认值为：${project.build.directory}/war/work。

可选参数

姓名 类型 自从 描述
档案 MavenArchiveConfiguration - 要使用的存档配置。请参阅Maven 存档器参考。
归档类 boolean 2.0.1 是否将为 webapp 中的类创建 JAR 文件。使用此可选配置参数将使编译后的类归档到 JAR 文件中，然后将类目录从 webapp 中排除。
默认值为：false。
附加类 boolean 2.1-alpha-2 是否应将类（即 WEB-INF/classes 目录的内容）附加到项目中。
默认值为：false。
类分类器 String 2.1-alpha-2 用于附加类工件的分类器。
默认值为：classes。
分类器 String - 添加到生成的 WAR 的分类器。如果给出，工件将改为附件。分类器不会应用于项目的 JAR 文件 - 仅应用于 WAR 文件。
容器配置XML File - servlet 容器的配置文件的路径。请注意，不同 servlet 容器的文件名可能不同。Apache Tomcat 使用名为 context.xml 的配置文件。该文件将被复制到 META-INF 目录。
依赖战争不包括 String - 已弃用。改用 <overlay>/<excludes>
依赖战争包括 String - 已弃用。改用 <overlay>/<includes>
转义字符串 String 2.1-beta-1 不会插入此字符串前面的表达式。 ${foo}将替换为${foo}.
转义反斜杠InFilePath boolean 2.1-alpha-2 要使用 Windows 路径转义插值， c:\foo\bar将替换为 c:\foo\bar.
默认值为：false。
failOnMissingWebXml boolean 2.1-alpha-2 web.xml如果文件丢失，是否使构建失败。false如果您希望在没有web.xml文件的情况下构建 WAR，请设置为。如果您正在构建没有 web.xml 文件的覆盖，这可能很有用。
默认值为：true。
过滤部署描述符 boolean 2.1-alpha-2 过滤部署描述符。默认禁用。
默认值为：false。
过滤器 List - 在 pom.xml 插值期间要包含的过滤器（属性文件）。
非过滤文件扩展 List 2.1-alpha-2 不应过滤的文件扩展名列表。将在过滤 webResources 和覆盖时使用。
输出文件名映射 String 2.1-alpha-1 复制库和 TLD 时使用的文件名映射。如果未设置文件映射（默认），则使用标准名称复制文件。
叠加层 List 2.1-alpha-1 要应用的叠加层。
包装不包括 String 2.1-alpha-2 打包前要从 WAR 中排除的标记的逗号分隔列表。此选项可用于实现瘦 WAR 用例。
包装包括 String 2.1-beta-1 打包前要包含在 WAR 中的以逗号分隔的令牌列表。默认情况下，所有内容都包括在内。此选项可用于实现瘦 WAR 用例。
初级神器 boolean - 这是否是正在构建的主要工件。false如果您不想将其安装或部署到本地存储库而不是执行中的默认存储库，请设置为。
默认值为：true。
使用缓存 boolean 2.1-alpha-1 是否应使用缓存来跨多次运行保存 webapp 的状态。实验性功能默认禁用。
默认值为：false。
战争来源不包括 String - 复制 warSourceDirectory 的内容时要排除的逗号分隔的令牌列表。
战争来源包括 String - 复制 warSourceDirectory 的内容时要包含的逗号分隔的令牌列表。
默认值为：**。
网络资源 Resource[] - 我们要传输的 webResources 列表。
网页XML File - 要使用的 web.xml 文件的路径。

参数详情

存档：

要使用的存档配置。请参阅Maven 存档器参考。
  • 类型：org.apache.maven.archiver.MavenArchiveConfiguration
  • 必需：No

归档类：

是否将为 webapp 中的类创建 JAR 文件。使用此可选配置参数将使编译的类归档到 JAR 文件中，然后将类目录从 webapp 中排除。
  • 类型：boolean
  • 自：2.0.1
  • 必需：No
  • 表达式：${archiveClasses}
  • 默认：false

附加类：

是否应将类（即 WEB-INF/classes 目录的内容）附加到项目中。
  • 类型：boolean
  • 自：2.1-alpha-2
  • 必需：No
  • 默认：false

缓存文件：

包含 webapp 结构缓存的文件。
  • 类型：java.io.File
  • 自：2.1-alpha-1
  • 必需：Yes
  • 默认：${project.build.directory}/war/work/webapp-cache.xml

类分类器：

用于附加类工件的分类器。
  • 类型：java.lang.String
  • 自：2.1-alpha-2
  • 必需：No
  • 默认：classes

分类器：

添加到生成的 WAR 的分类器。如果给出，工件将改为附件。分类器不会应用于项目的 JAR 文件 - 仅应用于 WAR 文件。
  • 类型：java.lang.String
  • 必需：No

容器配置XML：

servlet 容器的配置文件的路径。请注意，不同 servlet 容器的文件名可能不同。Apache Tomcat 使用名为 context.xml 的配置文件。该文件将被复制到 META-INF 目录。
  • 类型：java.io.File
  • 必需：No
  • 表达式：${maven.war.containerConfigXML}

依赖战争排除：

已弃用。改用 <overlay>/<excludes>
进行 WAR 覆盖时要排除的逗号分隔的标记列表。
  • 类型：java.lang.String
  • 必需：No

依赖战争包括：

已弃用。改用 <overlay>/<includes>
进行 WAR 覆盖时要包含的逗号分隔的标记列表。默认为“**”
  • 类型：java.lang.String
  • 必需：No

转义字符串：

不会插入此字符串前面的表达式。 ${foo}将替换为${foo}.
  • 类型：java.lang.String
  • 自：2.1-beta-1
  • 必需：No
  • 表达式：${maven.war.escapeString}

escapedBackslashesInFilePath：

要使用 Windows 路径转义插值， c:\foo\bar将替换为 c:\foo\bar.
  • 类型：boolean
  • 自：2.1-alpha-2
  • 必需：No
  • 表达式：${maven.war.escapedBackslashesInFilePath}
  • 默认：false

failOnMissingWebXml：

web.xml如果文件丢失，是否使构建失败。false如果您希望在没有web.xml文件的情况下构建 WAR，请设置为。如果您正在构建没有 web.xml 文件的覆盖，这可能很有用。
  • 类型：boolean
  • 自：2.1-alpha-2
  • 必需：No
  • 表达式：${failOnMissingWebXml}
  • 默认：true

过滤部署描述符：

过滤部署描述符。默认禁用。
  • 类型：boolean
  • 自：2.1-alpha-2
  • 必需：No
  • 表达式：${maven.war.filteringDeploymentDescriptors}
  • 默认：false

过滤器：

在 pom.xml 插值期间要包含的过滤器（属性文件）。
  • 类型：java.util.List
  • 必需：No

非过滤文件扩展：

不应过滤的文件扩展名列表。将在过滤 webResources 和覆盖时使用。
  • 类型：java.util.List
  • 自：2.1-alpha-2
  • 必需：No

输出目录：

生成的 WAR 的目录。
  • 类型：java.lang.String
  • 必需：Yes
  • 默认：${project.build.directory}

输出文件名映射：

复制库和 TLD 时使用的文件名映射。如果未设置文件映射（默认），则使用标准名称复制文件。
  • 类型：java.lang.String
  • 自：2.1-alpha-1
  • 必需：No

叠加：

要应用的叠加层。
  • 类型：java.util.List
  • 自：2.1-alpha-1
  • 必需：No

包装不包括：

打包前要从 WAR 中排除的标记的逗号分隔列表。此选项可用于实现瘦 WAR 用例。
  • 类型：java.lang.String
  • 自：2.1-alpha-2
  • 必需：No

包装包括：

打包前要包含在 WAR 中的以逗号分隔的令牌列表。默认情况下，所有内容都包括在内。此选项可用于实现瘦 WAR 用例。
  • 类型：java.lang.String
  • 自：2.1-beta-1
  • 必需：No

主要神器：

这是否是正在构建的主要工件。false如果您不想将其安装或部署到本地存储库而不是执行中的默认存储库，请设置为。
  • 类型：boolean
  • 必需：No
  • 表达式：${primaryArtifact}
  • 默认：true

使用缓存：

是否应使用缓存来跨多次运行保存 webapp 的状态。实验性功能默认禁用。
  • 类型：boolean
  • 自：2.1-alpha-1
  • 必需：No
  • 表达式：${useCache}
  • 默认：false

战争名称：

生成的 WAR 的名称。
  • 类型：java.lang.String
  • 必需：Yes
  • 默认：${project.build.finalName}

战争来源目录：

要包含在 WAR 中的额外文件的单个目录。这是放置 JSP 文件的地方。
  • 类型：java.io.File
  • 必需：Yes
  • 默认：${basedir}/src/main/webapp

战争来源排除：

复制 warSourceDirectory 的内容时要排除的逗号分隔的令牌列表。
  • 类型：java.lang.String
  • 必需：No

战争来源包括：

复制 warSourceDirectory 的内容时要包含的逗号分隔的令牌列表。
  • 类型：java.lang.String
  • 必需：No
  • 默认：**

网络资源：

我们要传输的 webResources 列表。
  • 类型：org.apache.maven.model.Resource[]
  • 必需：No

网络 XML：

要使用的 web.xml 文件的路径。
  • 类型：java.io.File
  • 必需：No
  • 表达式：${maven.war.webxml}

网络应用目录：

构建 webapp 的目录。
  • 类型：java.io.File
  • 必需：Yes
  • 默认：${project.build.directory}/${project.build.finalName}

工作目录：

如果需要，将依赖的 WAR 解压到的目录。
  • 类型：java.io.File
  • 必需：Yes
  • 默认：${project.build.directory}/war/work