org.codehaus.mojo.build

Class CreateMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.codehaus.mojo.build.CreateMojo

All Implemented Interfaces:

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

public class CreateMojo
extends org.apache.maven.plugin.AbstractMojo

This mojo is designed to give you a build number. So when you might make 100 builds of version 1.0-SNAPSHOT, you can differentiate between them all. The build number is based on the revision number retrieved from scm. It only works with subversion, currently. This mojo can also check to make sure that you have checked everything into scm, before issuing the build number. That behaviour can be suppressed, and then the latest local build number is used. Build numbers are not reflected in your artifact's filename (automatically), but can be added to the metadata. You can access the build number in your pom with ${buildNumber}. You can also access ${timestamp} and the scm branch of the build (if applicable) in ${scmBranch}
Note that there are several do parameters. These parameters (doCheck, doUpdate, etc) are the first thing evaluated. If there is no matching expression, we get the default-value. If there is (ie -Dmaven.buildNumber.doUpdate=false), we get that value. So if the XML contains <doCheck>true</doCheck>, then normally that's the final value of the param in question. However, this mojo reverses that behaviour, such that the command line parameters get the last say.

Version:

$Id: CreateMojo.java 17661 2012-10-09 14:27:28Z bimargulies $

Author:

Julian Wood

Field Summary

Fields

Modifier and Type	Field and Description
String	DEFAULT_BRANCH_NAME
protected org.apache.maven.execution.MavenSession	session

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

ROLE

Constructor Summary

Constructors

Constructor and Description
CreateMojo()

Method Summary

Methods

Modifier and Type	Method and Description
void	execute()
protected String	filterBranchFromScmUrl(String scmUrl)
String	getRevision() Get the revision info from the repository.
String	getScmBranch() Get the branch info for this revision from the repository.
List<org.apache.maven.scm.ScmFile>	getStatus()
org.apache.maven.scm.command.info.InfoScmResult	info(org.apache.maven.scm.repository.ScmRepository repository, org.apache.maven.scm.ScmFileSet fileSet) Get info from scm.
void	setBuildNumberPropertiesFileLocation(File buildNumberPropertiesFileLocation)
void	setDoCheck(boolean doCheck)
void	setDoUpdate(boolean doUpdate)
void	setPassword(String password)
void	setRevisionOnScmFailure(String revisionOnScmFailure)
void	setScmDirectory(File scmDirectory)
void	setScmManager(org.apache.maven.scm.manager.ScmManager scmManager)
void	setShortRevisionLength(int shortRevision)
void	setUrlScm(String urlScm)
void	setUsername(String username)
List<org.apache.maven.scm.ScmFile>	update()

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

DEFAULT_BRANCH_NAME

public final String DEFAULT_BRANCH_NAME

See Also:

Constant Field Values

session

protected org.apache.maven.execution.MavenSession session

Constructor Detail

CreateMojo

public CreateMojo()

Method Detail

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException,
                    org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

update

public List<org.apache.maven.scm.ScmFile> update()
                                          throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

getStatus

public List<org.apache.maven.scm.ScmFile> getStatus()
                                             throws org.apache.maven.scm.ScmException

Throws:

org.apache.maven.scm.ScmException

getScmBranch

public String getScmBranch()
                    throws org.apache.maven.plugin.MojoExecutionException

Get the branch info for this revision from the repository. For svn, it is in svn info.

Returns:

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoExecutionException

filterBranchFromScmUrl

protected String filterBranchFromScmUrl(String scmUrl)

getRevision

public String getRevision()
                   throws org.apache.maven.plugin.MojoExecutionException

Get the revision info from the repository. For svn, it is svn info

Returns:

Throws:

org.apache.maven.plugin.MojoExecutionException

info

public org.apache.maven.scm.command.info.InfoScmResult info(org.apache.maven.scm.repository.ScmRepository repository,
                                                   org.apache.maven.scm.ScmFileSet fileSet)
                                                     throws org.apache.maven.scm.ScmException

Get info from scm.

Parameters:

repository -

fileSet -

Returns:

Throws:

org.apache.maven.scm.ScmException

setScmManager

public void setScmManager(org.apache.maven.scm.manager.ScmManager scmManager)

setUrlScm

public void setUrlScm(String urlScm)

setUsername

public void setUsername(String username)

setPassword

public void setPassword(String password)

setDoCheck

public void setDoCheck(boolean doCheck)

setDoUpdate

public void setDoUpdate(boolean doUpdate)

setBuildNumberPropertiesFileLocation

public void setBuildNumberPropertiesFileLocation(File buildNumberPropertiesFileLocation)

setScmDirectory

public void setScmDirectory(File scmDirectory)

setRevisionOnScmFailure

public void setRevisionOnScmFailure(String revisionOnScmFailure)

setShortRevisionLength

public void setShortRevisionLength(int shortRevision)