Maven War Plugin

war:war

Full name:

org.apache.maven.plugins:maven-war-plugin:2.1-alpha-2:war

Description:

Build a war/webapp.

Attributes:

Requires a Maven 2.0 project to be executed.
Requires dependency resolution of artifacts in scope: runtime.
Binds by default to the lifecycle phase: package.

Required Parameters

Name	Type	Since	Description
cacheFile	`File`	`2.1`	The file containing the webapp structure cache.
outputDirectory	`String`	`-`	The directory for the generated WAR.
warName	`String`	`-`	The name of the generated WAR.
warSourceDirectory	`File`	`-`	Single directory for extra files to include in the WAR.
webappDirectory	`File`	`-`	The directory where the webapp is built.
workDirectory	`File`	`-`	Directory to unpack dependent WARs into if needed

Optional Parameters

Name	Type	Since	Description
archive	`MavenArchiveConfiguration`	`-`	The archive configuration to use. See Maven Archiver Reference.
archiveClasses	`boolean`	`-`	Whether a JAR file will be created for the classes in the webapp. Using this optional configuration parameter will make the generated classes to be archived into a jar file and the classes directory will then be excluded from the webapp. Default value is: `false`.
attachClasses	`boolean`	`-`	Whether classes (that is the content of the WEB-INF/classes directory) should be attached to the project. Default value is: `false`.
classesClassifier	`String`	`-`	The classifier to use for the attached classes artifact. Default value is: `classes`.
classifier	`String`	`-`	Classifier to add to the artifact generated. If given, the artifact will be an attachment instead.
containerConfigXML	`File`	`-`	The path to the context.xml file to use.
dependentWarExcludes	`String`	`-`	Deprecated. use the excludes in the overlay object instead
dependentWarIncludes	`String`	`-`	Deprecated. use the includes in the overlay object instead
escapedBackslashesInFilePath	`boolean`	`2.1-alpha-2`	To escape interpolated value with windows path c:\foo\bar will be replace with c\:\\foo\\bar Default value is: `false`.
failOnMissingWebXml	`boolean`	`-`	Whether or not to fail the build is the `web.xml` file is missing. Set to `false` if you want you war built without a `web.xml` file. Default value is: `true`.
filteringDeploymentDescriptors	`boolean`	`2.1-alpha-2`	To filtering deployment descriptors disabled by default Default value is: `false`.
filters	`List`	`-`	Filters (property files) to include during the interpolation of the pom.xml.
nonFilteredFileExtensions	`List`	`2.1-alpha-2`	A list of file extensions to not filtering. will be used for webResources and overlay filtering
outputFileNameMapping	`String`	`2.0.3`	The file name mapping to use to copy libraries and tlds. If no file mapping is set (default) the file is copied with its standard name.
overlays	`List`	`2.1`	The overlays to apply.
packagingExcludes	`String`	`-`	The comma separated list of tokens to exclude from the WAR before packaging. This option may be used to implement the skinny war use case.
primaryArtifact	`boolean`	`-`	Whether this is the main artifact being built. Set to `false` if you don't want to install or deploy it to the local repository instead of the default one in an execution. Default value is: `true`.
useCache	`boolean`	`2.1`	Whether the cache should be used to save the status of the webapp accross multiple runs. Default value is: `true`.
warSourceExcludes	`String`	`-`	The comma separated list of tokens to exclude when copying content of the warSourceDirectory.
warSourceIncludes	`String`	`-`	The comma separated list of tokens to include when copying content of the warSourceDirectory. Default is '**'.
webResources	`Resource[]`	`-`	The list of webResources we want to transfer.
webXml	`File`	`-`	The path to the web.xml file to use.

Parameter Details

archive:

The archive configuration to use. See Maven Archiver Reference.

Type: org.apache.maven.archiver.MavenArchiveConfiguration
Required: No

archiveClasses:

Whether a JAR file will be created for the classes in the webapp. Using this optional configuration parameter will make the generated classes to be archived into a jar file and the classes directory will then be excluded from the webapp.

Type: boolean
Required: No
Expression: ${archiveClasses}
Default: false

attachClasses:

Whether classes (that is the content of the WEB-INF/classes directory) should be attached to the project.

Type: boolean
Required: No
Default: false

cacheFile:

The file containing the webapp structure cache.

Type: java.io.File
Since: 2.1
Required: Yes
Expression: ${project.build.directory}/war/work/webapp-cache.xml

classesClassifier:

The classifier to use for the attached classes artifact.

Type: java.lang.String
Required: No
Default: classes

classifier:

Classifier to add to the artifact generated. If given, the artifact will be an attachment instead.

Type: java.lang.String
Required: No

containerConfigXML:

The path to the context.xml file to use.

Type: java.io.File
Required: No
Expression: ${maven.war.containerConfigXML}

dependentWarExcludes:

Deprecated. use the excludes in the overlay object instead

The comma separated list of tokens to exclude when doing a war overlay.

Type: java.lang.String
Required: No

dependentWarIncludes:

Deprecated. use the includes in the overlay object instead

The comma separated list of tokens to include when doing a war overlay. Default is '**'

Type: java.lang.String
Required: No

escapedBackslashesInFilePath:

To escape interpolated value with windows path c:\foo\bar will be replace with c\:\\foo\\bar

Type: boolean
Since: 2.1-alpha-2
Required: No
Expression: ${maven.war.escapedBackslashesInFilePath}
Default: false

failOnMissingWebXml:

Whether or not to fail the build is the web.xml file is missing. Set to false if you want you war built without a web.xml file.

Type: boolean
Required: No
Expression: ${failOnMissingWebXml}
Default: true

filteringDeploymentDescriptors:

To filtering deployment descriptors disabled by default

Type: boolean
Since: 2.1-alpha-2
Required: No
Expression: ${maven.war.filteringDeploymentDescriptors}
Default: false

filters:

Filters (property files) to include during the interpolation of the pom.xml.

Type: java.util.List
Required: No

nonFilteredFileExtensions:

A list of file extensions to not filtering. will be used for webResources and overlay filtering

Type: java.util.List
Since: 2.1-alpha-2
Required: No

outputDirectory:

The directory for the generated WAR.

Type: java.lang.String
Required: Yes
Expression: ${project.build.directory}

outputFileNameMapping:

The file name mapping to use to copy libraries and tlds. If no file mapping is set (default) the file is copied with its standard name.

Type: java.lang.String
Since: 2.0.3
Required: No

overlays:

The overlays to apply.

Type: java.util.List
Since: 2.1
Required: No

packagingExcludes:

The comma separated list of tokens to exclude from the WAR before packaging. This option may be used to implement the skinny war use case.

Type: java.lang.String
Required: No

primaryArtifact:

Whether this is the main artifact being built. Set to false if you don't want to install or deploy it to the local repository instead of the default one in an execution.

Type: boolean
Required: No
Expression: ${primaryArtifact}
Default: true

useCache:

Whether the cache should be used to save the status of the webapp accross multiple runs.