com.github.jlgrock.javascriptframework.sourcearchive.AbstractSourceArchiveMojo Maven / Gradle / Ivy
package com.github.jlgrock.javascriptframework.sourcearchive;
import java.io.File;
import java.io.IOException;
import java.util.Collections;
import java.util.Iterator;
import java.util.List;
import org.apache.log4j.Logger;
import org.apache.maven.archiver.MavenArchiveConfiguration;
import org.apache.maven.artifact.repository.ArtifactRepository;
import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.plugin.assembly.AssemblerConfigurationSource;
import org.apache.maven.plugin.assembly.InvalidAssemblerConfigurationException;
import org.apache.maven.plugin.assembly.archive.ArchiveCreationException;
import org.apache.maven.plugin.assembly.archive.AssemblyArchiver;
import org.apache.maven.plugin.assembly.format.AssemblyFormattingException;
import org.apache.maven.plugin.assembly.io.AssemblyReadException;
import org.apache.maven.plugin.assembly.io.AssemblyReader;
import org.apache.maven.plugin.assembly.model.Assembly;
import org.apache.maven.plugin.assembly.utils.AssemblyFormatUtils;
import org.apache.maven.project.MavenProject;
import org.apache.maven.project.MavenProjectHelper;
import org.apache.maven.shared.filtering.MavenFileFilter;
import org.codehaus.plexus.configuration.PlexusConfiguration;
import com.github.jlgrock.javascriptframework.mavenutils.io.DirectoryIO;
import com.github.jlgrock.javascriptframework.mavenutils.io.ResourceIO;
import com.github.jlgrock.javascriptframework.mavenutils.logging.MojoLogAppender;
/**
* Essentially the same as the Assembly Plugin Mojo, with a convenience function
* to have the src assembly xml files set up for you already. Unfortunately
* there is no way to extend from one plugin space to another within the plexus
* system, so I copied the entire Mojo.
*
* This is just to help automate and minimize the amount of code in the poms.
*
* @threadSafe
*/
public abstract class AbstractSourceArchiveMojo extends AbstractMojo implements
AssemblerConfigurationSource {
/**
* The Logger.
*/
static final Logger LOGGER = Logger.getLogger(AbstractSourceArchiveMojo.class);
/**
* Location to get the assembly descriptor.
*
* @parameter default-value=
* "${project.build.directory}${file.separator}assemblyDescriptor${file.separator}assembly.xml"
* @required
*/
protected String assemblyDescriptorLocation;
/**
* Remove target directories before starting work.
*
* @throws IOException if unable to delete
*/
protected final void cleanup() throws IOException {
File assemblyDesc = new File(assemblyDescriptorLocation);
if (assemblyDesc.exists()) {
if (assemblyDesc.isDirectory()) {
DirectoryIO.recursivelyDeleteDirectory(assemblyDesc);
} else {
assemblyDesc.delete();
}
}
}
/**
* Copy the descriptor over to do the type of archiving required.
*
* @throws IOException if there is a problem copying
*/
protected final void copyDescriptorResource() throws IOException {
LOGGER.info("copying default descriptor to \""
+ assemblyDescriptorLocation + "\"");
if (assemblyDescriptorLocation == null) {
LOGGER.error("assemblyDescriptorLocation cannot be null");
}
File descLoc = new File(assemblyDescriptorLocation);
ResourceIO.copyResource(getDescriptorResourceName(), descLoc);
}
/**
* Accessor to the descriptor resource name that will be defined in children
* objects.
*
* @return the descriptor resource name
*/
protected abstract String getDescriptorResourceName();
/**
* Local Maven repository where artifacts are cached during the build
* process.
*
* @parameter default-value="${localRepository}"
* @required
* @readonly
*/
private ArtifactRepository localRepository;
/**
* @parameter default-value="${project.remoteArtifactRepositories}"
* @required
* @readonly
*/
private List remoteRepositories;
/**
* Contains the full list of projects in the reactor.
*
* @parameter default-value="${reactorProjects}"
* @required
* @readonly
*/
private List reactorProjects;
/**
* The output directory of the assembled distribution file.
*
* @parameter default-value="${project.build.directory}"
* @required
*/
private File outputDirectory;
/**
* The filename of the assembled distribution file.
*
* @parameter default-value="${project.build.finalName}"
* @required
*/
private String finalName;
/**
* Directory to unpack JARs into if needed.
*
* @parameter default-value="${project.build.directory}/assembly/work"
* @required
*/
private File workDirectory;
/**
* A list of descriptor files to generate from.
*
* @parameter
*/
private String[] descriptors;
/**
* A list of references to assembly descriptors available on the plugin's
* classpath. The default classpath includes these built-in descriptors:
* bin, jar-with-dependencies, src,
* and project. You can add others by adding dependencies to
* the plugin.
*
* @parameter
*/
private String[] descriptorRefs;
/**
* Directory to scan for descriptor files in. NOTE: This may not work
* correctly with assembly components.
*
* @parameter
*/
private File descriptorSourceDirectory;
/**
* This is the base directory from which archive files are created. This
* base directory pre-pended to any <directory>
* specifications in the assembly descriptor. This is an optional parameter.
*
* @parameter
*/
private File archiveBaseDirectory;
/**
* Sets the TarArchiver behavior on file paths with more than 100 characters
* length. Valid values are: "warn" (default), "fail", "truncate", "gnu", or
* "omit".
*
* @parameter expression="${assembly.tarLongFileMode}" default-value="warn"
*/
private String tarLongFileMode;
/**
* Base directory of the project.
*
* @parameter default-value="${project.basedir}"
* @required
* @readonly
*/
private File basedir;
/**
* Maven ProjectHelper.
*
* @component
*/
private MavenProjectHelper projectHelper;
/**
* Maven shared filtering utility.
*
* @component
*/
private MavenFileFilter mavenFileFilter;
/**
* The Maven Session Object.
*
* @parameter default-value="${session}"
* @required
* @readonly
*/
private MavenSession mavenSession;
/**
* Temporary directory that contain the files to be assembled.
*
* @parameter default-value="${project.build.directory}/archive-tmp"
* @required
* @readonly
*/
private File tempRoot;
/**
* Directory for site generated.
*
* @parameter default-value="${project.reporting.outputDirectory}"
* @readonly
*/
private File siteDirectory;
/**
* Set to true in order to not fail when a descriptor is missing.
*
* @parameter expression="${assembly.ignoreMissingDescriptor}"
* default-value="false"
*/
protected boolean ignoreMissingDescriptor;
/**
* This is a set of instructions to the archive builder, especially for
* building .jar files. It enables you to specify a Manifest file for the
* jar, in addition to other options.
*
* @parameter
*/
private MavenArchiveConfiguration archive;
/**
* @parameter
*/
protected List filters;
/**
* @component
*/
private AssemblyArchiver assemblyArchiver;
/**
* @component
*/
private AssemblyReader assemblyReader;
/**
* Allows additional configuration options that are specific to a particular
* type of archive format. This is intended to capture an XML configuration
* that will be used to reflectively setup the options on the archiver
* instance.
* For instance, to direct an assembly with the "ear" format to use a
* particular deployment descriptor, you should specify the following for
* the archiverConfig value in your plugin configuration:
*
*
* <appxml>${project.basedir}/somepath/app.xml</appxml>
*
*
* @parameter
* @since 2.2-beta-3
*/
private PlexusConfiguration archiverConfig;
/**
*
* Set to true in order to avoid all chmod calls.
*
*
*
* NOTE: This will cause the assembly plugin to DISREGARD all
* fileMode/directoryMode settings in the assembly descriptor, and all file
* permissions in unpacked dependencies!
*
*
* @parameter expression="${assembly.ignorePermissions}"
* default-value="false"
* @since 2.2
*/
private boolean ignorePermissions;
@Override
public final void execute() throws MojoExecutionException, MojoFailureException {
MojoLogAppender.beginLogging(this);
try {
LOGGER.info("initial cleanup");
cleanup();
LOGGER.info("copying descriptor resource for assembly.");
copyDescriptorResource();
String[] descLocs = { assemblyDescriptorLocation };
setDescriptors(descLocs);
LOGGER.info("executing assembly.");
List assemblies;
try {
assemblies = assemblyReader.readAssemblies(this);
} catch (final AssemblyReadException e) {
throw new MojoExecutionException("Error reading assemblies: "
+ e.getMessage(), e);
} catch (final InvalidAssemblerConfigurationException e) {
throw new MojoFailureException(assemblyReader, e.getMessage(),
"Mojo configuration is invalid: " + e.getMessage());
}
for (final Iterator assemblyIterator = assemblies
.iterator(); assemblyIterator.hasNext();) {
final Assembly assembly = assemblyIterator.next();
try {
final String fullName = AssemblyFormatUtils
.getDistributionName(assembly, this);
for (final String format : assembly.getFormats()) {
final File destFile = assemblyArchiver.createArchive(
assembly, fullName, format, this);
if (destFile.isFile()) {
projectHelper.attachArtifact(getProject(), format, getClassifier(), destFile);
} else {
LOGGER.warn("Assembly file: "
+ destFile
+ " is not a regular file (it may be a directory). It cannot be attached to the project build for installation or deployment.");
}
}
} catch (final ArchiveCreationException e) {
throw new MojoExecutionException(
"Failed to create assembly: " + e.getMessage(), e);
} catch (final AssemblyFormattingException e) {
throw new MojoExecutionException(
"Failed to create assembly: " + e.getMessage(), e);
} catch (final InvalidAssemblerConfigurationException e) {
throw new MojoFailureException(assembly,
"Assembly is incorrectly configured: "
+ assembly.getId(), "Assembly: "
+ assembly.getId()
+ " is not configured correctly: "
+ e.getMessage());
}
}
} catch (Exception e) {
LOGGER.error(
"Full Source Archive has encountered an error. Please check stack trace for details. : "
+ e.getMessage(), e);
throw new MojoExecutionException(e.getMessage(), e);
} finally {
MojoLogAppender.endLogging();
}
}
/**
* @return assembly archiver
*/
protected final AssemblyArchiver getAssemblyArchiver() {
return assemblyArchiver;
}
/**
* @return assembly reader
*/
protected final AssemblyReader getAssemblyReader() {
return assemblyReader;
}
@Override
public final File getBasedir() {
return basedir;
}
@Override
public final String[] getDescriptorReferences() {
return descriptorRefs;
}
@Override
public final File getDescriptorSourceDirectory() {
return descriptorSourceDirectory;
}
@Override
public final String[] getDescriptors() {
return descriptors;
}
@Override
public abstract MavenProject getProject();
@Override
public final File getSiteDirectory() {
return siteDirectory;
}
@Override
public final String getFinalName() {
return finalName;
}
@Override
public final boolean isAssemblyIdAppended() {
return false;
}
@Override
public final String getTarLongFileMode() {
return tarLongFileMode;
}
@Override
public final File getOutputDirectory() {
return outputDirectory;
}
@Override
public final MavenArchiveConfiguration getJarArchiveConfiguration() {
return archive;
}
@Override
public final File getWorkingDirectory() {
return workDirectory;
}
@Override
public final ArtifactRepository getLocalRepository() {
return localRepository;
}
@Override
public final File getTemporaryRootDirectory() {
return tempRoot;
}
@Override
public final File getArchiveBaseDirectory() {
return archiveBaseDirectory;
}
@Override
public final List getFilters() {
if (filters == null) {
filters = getProject().getBuild().getFilters();
if (filters == null) {
filters = Collections.emptyList();
}
}
return filters;
}
@Override
public final List getReactorProjects() {
return reactorProjects;
}
@Override
public final String getClassifier() {
return "sources";
}
/**
* @return projectHelper
*/
protected final MavenProjectHelper getProjectHelper() {
return projectHelper;
}
/**
* Mutator.
*
* @param archiveIn the value to change to
*/
public final void setArchive(final MavenArchiveConfiguration archiveIn) {
this.archive = archiveIn;
}
/**
* Mutator.
*
* @param archiveBaseDirectoryIn the value to change to
*/
public final void setArchiveBaseDirectory(final File archiveBaseDirectoryIn) {
this.archiveBaseDirectory = archiveBaseDirectoryIn;
}
/**
* Mutator.
*
* @param assemblyArchiverIn the value to change to
*/
public final void setAssemblyArchiver(final AssemblyArchiver assemblyArchiverIn) {
this.assemblyArchiver = assemblyArchiverIn;
}
/**
* Mutator.
*
* @param assemblyReaderIn the value to change to
*/
public final void setAssemblyReader(final AssemblyReader assemblyReaderIn) {
this.assemblyReader = assemblyReaderIn;
}
/**
* Mutator.
*
* @param basedirIn the value to change to
*/
public final void setBasedir(final File basedirIn) {
this.basedir = basedirIn;
}
/**
* Mutator.
*
* @param descriptorRefsIn the value to change to
*/
public final void setDescriptorRefs(final String[] descriptorRefsIn) {
this.descriptorRefs = descriptorRefsIn;
}
/**
* Mutator.
*
* @param descriptorsIn the value to change to
*/
public final void setDescriptors(final String[] descriptorsIn) {
this.descriptors = descriptorsIn;
}
/**
* Mutator.
*
* @param descriptorSourceDirectoryIn the value to change to
*/
public final void setDescriptorSourceDirectory(
final File descriptorSourceDirectoryIn) {
this.descriptorSourceDirectory = descriptorSourceDirectoryIn;
}
/**
* Mutator.
*
* @param filtersIn the value to change to
*/
public final void setFilters(final List filtersIn) {
this.filters = filtersIn;
}
/**
* Mutator.
*
* @param finalNameIn the value to change to
*/
public final void setFinalName(final String finalNameIn) {
this.finalName = finalNameIn;
}
/**
* Mutator.
*
* @param tempRootIn the value to change to
*/
public final void setTempRoot(final File tempRootIn) {
this.tempRoot = tempRootIn;
}
/**
* Mutator.
*
* @param workDirectoryIn the value to change to
*/
public final void setWorkDirectory(final File workDirectoryIn) {
this.workDirectory = workDirectoryIn;
}
@Override
public final List getRemoteRepositories() {
return remoteRepositories;
}
@Override
public final boolean isIgnoreMissingDescriptor() {
return ignoreMissingDescriptor;
}
/**
* Mutator.
*
* @param ignoreMissingDescriptorIn the value to change to
*/
public final void setIgnoreMissingDescriptor(final boolean ignoreMissingDescriptorIn) {
this.ignoreMissingDescriptor = ignoreMissingDescriptorIn;
}
@Override
public final MavenSession getMavenSession() {
return mavenSession;
}
@Override
public final String getArchiverConfig() {
return archiverConfig == null ? null : archiverConfig.toString();
}
@Override
public final MavenFileFilter getMavenFileFilter() {
return mavenFileFilter;
}
@Override
public final boolean isUpdateOnly() {
return false;
}
@Override
public final boolean isUseJvmChmod() {
return false;
}
@Override
public final boolean isIgnorePermissions() {
return ignorePermissions;
}
@Override
public String getDescriptor() {
return null;
}
@Override
public String getDescriptorId() {
return null;
}
@Override
public boolean isSiteIncluded() {
return false;
}
@Override
public boolean isDryRun() {
return false;
}
@Override
public boolean isIgnoreDirFormatExtensions() {
return false;
}
}