Interface WarPackagingContext
public interface WarPackagingContext
The packaging context.
- Author:
- Stephane Nicoll
-
Method Summary
Modifier and TypeMethodDescriptionvoidaddResource(String resource) Add a live resource to the war.booleanSpecify whether the classes resources should be archived in theWEB-INF/libof the generated web app.voidDelete outdated resources, ie resources that are found in the war but that were not added by the current packaging process, then are supposed to be content from a previous run.org.apache.maven.archiver.MavenArchiveConfigurationThe maven archive configuration to use.org.codehaus.plexus.archiver.manager.ArchiverManagerReturns the archiver manager to use.org.apache.maven.artifact.factory.ArtifactFactoryReturns the directory holding generated classes.Returns the list of filter files to use.List<org.apache.maven.shared.filtering.FilterWrapper> org.codehaus.plexus.archiver.jar.JarArchiverReturns the Jar archiver needed for archiving classes directory into jar file under WEB-INF/lib.org.apache.maven.plugin.logging.LoggetLog()Returns the logger to use to output logging event.org.apache.maven.shared.filtering.MavenFileFilterReturns theMavenFileFilterinstance to use.Returns the output file name mapping to use, if any.Output timestamp for reproducible archive creation.Returns the directory to unpack dependent WARs into if needed.Returns the list of registered overlays for this session.org.apache.maven.project.MavenProjectReturns the maven project.Returns the encoding to use for resources that are properties files.Returns the encoding to use for resources.org.apache.maven.execution.MavenSessionReturns the Maven session.Returns the webapp directory.Returns the main webapp source directory.String[]Returns the webapp source excludes.String[]Returns the webapp source includes.Returns theWebappStructure.Returns the flag that switch on/off the missing web.xml validationbooleanbooleanisNonFilteredExtension(String fileName) Specify if the givenfileNamebelongs to the list of extensions that must not be filteredbooleanbooleanReturnstrueif empty directories should be includes, otherwisefalse
-
Method Details
-
getProject
org.apache.maven.project.MavenProject getProject()Returns the maven project.- Returns:
- the project
-
getWebappDirectory
File getWebappDirectory()Returns the webapp directory. Packaging tasks should use this directory to generate the webapp.- Returns:
- the webapp directory
-
getWebappSourceDirectory
File getWebappSourceDirectory()Returns the main webapp source directory.- Returns:
- the webapp source directory
-
getWebappSourceIncludes
String[] getWebappSourceIncludes()Returns the webapp source includes.- Returns:
- the webapp source includes
-
isWebappSourceIncludeEmptyDirectories
boolean isWebappSourceIncludeEmptyDirectories()Returnstrueif empty directories should be includes, otherwisefalse- Returns:
trueif empty directories should be includes, otherwisefalse
-
getWebappSourceExcludes
String[] getWebappSourceExcludes()Returns the webapp source excludes.- Returns:
- the webapp source excludes
-
getClassesDirectory
File getClassesDirectory()Returns the directory holding generated classes.- Returns:
- the classes directory
-
archiveClasses
boolean archiveClasses()Specify whether the classes resources should be archived in theWEB-INF/libof the generated web app.- Returns:
- true if the classes should be archived, false otherwise
-
getLog
org.apache.maven.plugin.logging.Log getLog()Returns the logger to use to output logging event.- Returns:
- the logger
-
getOverlaysWorkDirectory
File getOverlaysWorkDirectory()Returns the directory to unpack dependent WARs into if needed.- Returns:
- the overlays work directory
-
getArchiverManager
org.codehaus.plexus.archiver.manager.ArchiverManager getArchiverManager()Returns the archiver manager to use.- Returns:
- the archiver manager
-
getArchive
org.apache.maven.archiver.MavenArchiveConfiguration getArchive()The maven archive configuration to use.- Returns:
- the maven archive configuration
-
getJarArchiver
org.codehaus.plexus.archiver.jar.JarArchiver getJarArchiver()Returns the Jar archiver needed for archiving classes directory into jar file under WEB-INF/lib.- Returns:
- the jar archiver to user
-
getOutputFileNameMapping
String getOutputFileNameMapping()Returns the output file name mapping to use, if any. Returnsnullif no file name mapping is set.- Returns:
- the output file name mapping or
null
-
getFilters
Returns the list of filter files to use.- Returns:
- a list of filter files
-
getWebappStructure
WebappStructure getWebappStructure()Returns theWebappStructure.- Returns:
- the webapp structure
-
getOwnerIds
Returns the list of registered overlays for this session.- Returns:
- the list of registered overlays, including the current project
-
getMavenFileFilter
org.apache.maven.shared.filtering.MavenFileFilter getMavenFileFilter()Returns theMavenFileFilterinstance to use.- Returns:
- the maven file filter to use
- Since:
- 2.1-alpha-2
-
getFilterWrappers
List<org.apache.maven.shared.filtering.FilterWrapper> getFilterWrappers()- Returns:
ListofFilterWrapper- Since:
- 2.1-alpha-2
-
isNonFilteredExtension
Specify if the givenfileNamebelongs to the list of extensions that must not be filtered- Parameters:
fileName- the name of file- Returns:
trueif it should not be filtered,falseotherwise- Since:
- 2.1-alpha-2
-
isFilteringDeploymentDescriptors
boolean isFilteringDeploymentDescriptors()- Returns:
- filtering deployment descriptor.
-
getArtifactFactory
org.apache.maven.artifact.factory.ArtifactFactory getArtifactFactory()- Returns:
ArtifactFactory
-
getSession
org.apache.maven.execution.MavenSession getSession()Returns the Maven session.- Returns:
- the Maven session
- Since:
- 2.2
-
getResourceEncoding
String getResourceEncoding()Returns the encoding to use for resources.- Returns:
- the resource encoding
- Since:
- 2.3
-
getPropertiesEncoding
String getPropertiesEncoding()Returns the encoding to use for resources that are properties files.- Returns:
- the encoding for properties files
- Since:
- 3.4.0
-
isUseJvmChmod
boolean isUseJvmChmod()- Returns:
- to use jvmChmod rather than forking chmod cli
- Since:
- 2.4
-
isFailOnMissingWebXml
Boolean isFailOnMissingWebXml()Returns the flag that switch on/off the missing web.xml validation- Returns:
- failOnMissingWebXml
-
addResource
Add a live resource to the war. Used to keep track of existing resources and all copied files. All others are outdated and will be removed. This prevent callingmvn cleanwhen resources are removed.- Parameters:
resource- the resource that is to me marked as not outdated- Since:
- 3.3.0
- See Also:
-
deleteOutdatedResources
void deleteOutdatedResources()Delete outdated resources, ie resources that are found in the war but that were not added by the current packaging process, then are supposed to be content from a previous run. This prevent callingmvn cleanwhen resources are removed.- Since:
- 3.3.0
- See Also:
-
getOutputTimestamp
String getOutputTimestamp()Output timestamp for reproducible archive creation.- Returns:
- the output timestamp (may be null)
- Since:
- 3.3.0
-
getPackagingExcludes
- Returns:
- list of packaging excludes.
- Since:
- 3.4.1
-
getPackagingIncludes
- Returns:
- list of packaging includes.
- Since:
- 3.4.1
-