org.codehaus.mojo.license

Class UpdateProjectLicenseMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.codehaus.mojo.license.AbstractLicenseMojo

org.codehaus.mojo.license.AbstractLicenseNameMojo

org.codehaus.mojo.license.UpdateProjectLicenseMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

@Mojo(name="update-project-license",
      requiresProject=true,
      defaultPhase=GENERATE_RESOURCES)
public class UpdateProjectLicenseMojo
extends AbstractLicenseNameMojo

Updates (or creates) the main project license file according to the given license defines as licenseName. Can also generate a bundled license file (to avoid collision names in class-path). This file is by default generated in META-INF class-path directory.

Since:

1.0

Author:

tchemit dev@tchemit.fr

Field Summary

Fields

Modifier and Type	Field and Description
protected String	bundleLicensePath The path of the bundled license file to produce when generateBundle is on.
protected boolean	force A flag to force to generate project license file even if it is up-to-date.
protected boolean	generateBundle A flag to copy the main license file in a bundled place.
protected File	licenseFile Project license file to synchronize with main license defined in descriptor file.
protected File	outputDirectory The directory where to generate license resources.
protected boolean	skipUpdateProjectLicense A flag to skip the goal.

Fields inherited from class org.codehaus.mojo.license.AbstractLicenseNameMojo

copyrightOwners, DEFAULT_EXCLUDES, DEFAULT_INCLUDES, DEFAULT_ROOTS, extraTemplateParameters, inceptionYear, organizationName, projectName

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
UpdateProjectLicenseMojo()

Method Summary

Modifier and Type	Method and Description
protected void	doAction() Do plugin action.
protected void	init() Method to initialize the mojo before doing any concrete actions.
boolean	isSkip() When is sets to true, will skip execution.

Methods inherited from class org.codehaus.mojo.license.AbstractLicenseNameMojo

getCopyrightOwners, getLicense, getLicense, getLicenseName, isKeepBackup, processLicenseContext

Methods inherited from class org.codehaus.mojo.license.AbstractLicenseMojo

acceptPackaging, addResourceDir, afterExecute, checkEncoding, checkPackaging, checkSkip, execute, getBuildTimestamp, getEncoding, getProject, getSession, hasClassPath, isSkipAll, isVerbose, rejectPackaging, setEncoding, setVerbose

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

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

Field Detail

licenseFile

@Parameter(property="license.licenceFile",
           defaultValue="${basedir}/LICENSE.txt")
protected File licenseFile

Project license file to synchronize with main license defined in descriptor file.

Since:

1.0

outputDirectory

@Parameter(property="license.outputDirectory",
           defaultValue="target/generated-sources/license")
protected File outputDirectory

The directory where to generate license resources. Note: This option is not available for pom module types.

Since:

1.0

generateBundle

@Parameter(property="license.generateBundle",
           defaultValue="false")
protected boolean generateBundle

A flag to copy the main license file in a bundled place. This is usefull for final application to have a none confusing location to seek for the application license. If Sets to true, will copy the license file to the bundleLicensePath to outputDirectory. Note: This option is not available for pom module types.

Since:

1.0

bundleLicensePath

@Parameter(property="license.bundleLicensePath",
           defaultValue="META-INF/${project.artifactId}-LICENSE.txt")
protected String bundleLicensePath

The path of the bundled license file to produce when generateBundle is on. Note: This option is not available for pom module types.

Since:

1.0

force

@Parameter(property="license.force",
           defaultValue="false")
protected boolean force

A flag to force to generate project license file even if it is up-to-date.

Since:

1.0.0

skipUpdateProjectLicense

@Parameter(property="license.skipUpdateProjectLicense",
           defaultValue="false")
protected boolean skipUpdateProjectLicense

A flag to skip the goal.

Since:

1.0

Constructor Detail

UpdateProjectLicenseMojo

public UpdateProjectLicenseMojo()

Method Detail

isSkip

public boolean isSkip()

When is sets to true, will skip execution. This will take effect in at the very begin of the AbstractLicenseMojo.execute() before any initialisation of goal.

Specified by:

isSkip in class AbstractLicenseMojo

Returns:

true if goal will not be executed

init

protected void init()
             throws Exception

Method to initialize the mojo before doing any concrete actions. Note: The method is invoked before the AbstractLicenseMojo.doAction() method.

Overrides:

init in class AbstractLicenseNameMojo

Throws:

Exception - if any

doAction

protected void doAction()
                 throws Exception

Do plugin action. The method AbstractLicenseMojo.execute() invoke this method only and only if :

• AbstractLicenseMojo.checkPackaging() returns true.
• method AbstractLicenseMojo.init() returns true.

Specified by:

doAction in class AbstractLicenseMojo

Throws:

Exception - if any