Class DefaultAssemblyArchiver

java.lang.Object

org.apache.maven.plugins.assembly.archive.DefaultAssemblyArchiver

All Implemented Interfaces:

AssemblyArchiver

@Named
public class DefaultAssemblyArchiver
extends Object
implements AssemblyArchiver

Controller component designed to organize the many activities involved in creating an assembly archive. This includes locating and configuring Archiver instances, executing multiple .archive.phase.AssemblyArchiverPhase instances to interpret the various sections of the assembly descriptor and determine which files to add, and other associated activities.

Field Summary

Fields

Modifier and Type	Field	Description
private final org.codehaus.plexus.archiver.manager.ArchiverManager	archiverManager
private final List<AssemblyArchiverPhase>	assemblyPhases
private final org.codehaus.plexus.component.configurator.BasicComponentConfigurator	configurator
private final org.codehaus.plexus.PlexusContainer	container
private final Map<String, ContainerDescriptorHandler>	containerDescriptorHandlers
private static final org.slf4j.Logger	LOGGER

Constructor Summary

Constructors

Constructor	Description
DefaultAssemblyArchiver(org.codehaus.plexus.archiver.manager.ArchiverManager archiverManager, List<AssemblyArchiverPhase> assemblyPhases, Map<String, ContainerDescriptorHandler> containerDescriptorHandlers, org.codehaus.plexus.PlexusContainer container, org.codehaus.plexus.component.configurator.BasicComponentConfigurator configurator)

Method Summary

Modifier and Type	Method	Description
private void	configureArchiver(org.codehaus.plexus.archiver.Archiver archiver, AssemblerConfigurationSource configSource)
private void	configureComponent(Object component, org.codehaus.plexus.util.xml.Xpp3Dom config, AssemblerConfigurationSource configSource)
private void	configureContainerDescriptorHandler(ContainerDescriptorHandler handler, org.codehaus.plexus.util.xml.Xpp3Dom config, AssemblerConfigurationSource configSource)
private void	configureJarArchiver(org.codehaus.plexus.archiver.jar.JarArchiver archiver, String mergeManifestMode)
File	createArchive(Assembly assembly, String fullName, String format, AssemblerConfigurationSource configSource, FileTime outputTimestamp)	Create the assembly archive.
protected org.codehaus.plexus.archiver.Archiver	createArchiver(String format, boolean includeBaseDir, String finalName, AssemblerConfigurationSource configSource, List<ContainerDescriptorHandler> containerHandlers, FileTime outputTimestamp)	Creates the necessary archiver to build the distribution file.
private List<ContainerDescriptorHandler>	selectContainerDescriptorHandlers(List<ContainerDescriptorHandlerConfig> requestedContainerDescriptorHandlers, AssemblerConfigurationSource configSource)
private List<AssemblyArchiverPhase>	sortedPhases()
private void	validate(Assembly assembly)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOGGER

private static final org.slf4j.Logger LOGGER

archiverManager

private final org.codehaus.plexus.archiver.manager.ArchiverManager archiverManager

assemblyPhases

private final List<AssemblyArchiverPhase> assemblyPhases

containerDescriptorHandlers

private final Map<String, ContainerDescriptorHandler> containerDescriptorHandlers

container

private final org.codehaus.plexus.PlexusContainer container

configurator

private final org.codehaus.plexus.component.configurator.BasicComponentConfigurator configurator

Constructor Details

DefaultAssemblyArchiver

@Inject
public DefaultAssemblyArchiver(org.codehaus.plexus.archiver.manager.ArchiverManager archiverManager,
 List<AssemblyArchiverPhase> assemblyPhases,
 Map<String, ContainerDescriptorHandler> containerDescriptorHandlers,
 org.codehaus.plexus.PlexusContainer container,
 org.codehaus.plexus.component.configurator.BasicComponentConfigurator configurator)

Method Details

sortedPhases

private List<AssemblyArchiverPhase> sortedPhases()

createArchive

public File createArchive(Assembly assembly,
 String fullName,
 String format,
 AssemblerConfigurationSource configSource,
 FileTime outputTimestamp)
                   throws ArchiveCreationException,
AssemblyFormattingException,
InvalidAssemblerConfigurationException

Create the assembly archive. Generally:

1. Setup any directory structures for temporary files
2. Calculate the output directory/file for the assembly
3. Setup any handler components for special descriptor files we may encounter
4. Lookup and configure the Archiver to be used
5. Determine what, if any, dependency resolution will be required, and resolve any dependency-version conflicts up front to produce a managed-version map for the whole assembly process.
6. Iterate through the available AssemblyArchiverPhase instances, executing each to handle a different top-level section of the assembly descriptor, if that section is present.

Specified by:

createArchive in interface AssemblyArchiver

Parameters:

assembly - The Assembly

fullName - The full name.

format - The format.

configSource - The AssemblerConfigurationSource

outputTimestamp - Timestamp for reproducible archive entries

Returns:

The resulting archive file.

Throws:

ArchiveCreationException - when creation fails

AssemblyFormattingException - when formatting fails

InvalidAssemblerConfigurationException - when the configuration is bad

validate

private void validate(Assembly assembly)
               throws InvalidAssemblerConfigurationException

Throws:

InvalidAssemblerConfigurationException

selectContainerDescriptorHandlers

private List<ContainerDescriptorHandler> selectContainerDescriptorHandlers(List<ContainerDescriptorHandlerConfig> requestedContainerDescriptorHandlers,
 AssemblerConfigurationSource configSource)
                                                                    throws InvalidAssemblerConfigurationException

Throws:

InvalidAssemblerConfigurationException

createArchiver

protected org.codehaus.plexus.archiver.Archiver createArchiver(String format,
 boolean includeBaseDir,
 String finalName,
 AssemblerConfigurationSource configSource,
 List<ContainerDescriptorHandler> containerHandlers,
 FileTime outputTimestamp)
                                                        throws org.codehaus.plexus.archiver.manager.NoSuchArchiverException

Creates the necessary archiver to build the distribution file.

Parameters:

format - Archive format

includeBaseDir - the base directory for include.

finalName - The final name.

configSource - AssemblerConfigurationSource

containerHandlers - The list of ContainerDescriptorHandler

Returns:

archiver Archiver generated

Throws:

org.codehaus.plexus.archiver.ArchiverException

org.codehaus.plexus.archiver.manager.NoSuchArchiverException

configureJarArchiver

private void configureJarArchiver(org.codehaus.plexus.archiver.jar.JarArchiver archiver,
 String mergeManifestMode)

configureContainerDescriptorHandler

private void configureContainerDescriptorHandler(ContainerDescriptorHandler handler,
 org.codehaus.plexus.util.xml.Xpp3Dom config,
 AssemblerConfigurationSource configSource)
                                          throws InvalidAssemblerConfigurationException

Throws:

InvalidAssemblerConfigurationException

configureArchiver

private void configureArchiver(org.codehaus.plexus.archiver.Archiver archiver,
 AssemblerConfigurationSource configSource)

configureComponent

private void configureComponent(Object component,
 org.codehaus.plexus.util.xml.Xpp3Dom config,
 AssemblerConfigurationSource configSource)
                         throws org.codehaus.plexus.component.repository.exception.ComponentLookupException,
org.codehaus.plexus.component.configurator.ComponentConfigurationException

Throws:

org.codehaus.plexus.component.repository.exception.ComponentLookupException

org.codehaus.plexus.component.configurator.ComponentConfigurationException