net.oneandone.maven.plugins.prerelease

Class Promote

java.lang.Object

org.apache.maven.plugin.AbstractMojo

net.oneandone.maven.plugins.prerelease.Base

net.oneandone.maven.plugins.prerelease.ProjectBase

net.oneandone.maven.plugins.prerelease.Promote

All Implemented Interfaces:

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

Direct Known Subclasses:

UpdatePromote

@Mojo(name="promote")
public class Promote
extends ProjectBase

Promotes a prerelease by commiting the tag and deploying its artifact(s). Execute this goal in the svn working directory of the project you want to release and make sure you have created a prerelease. This goal commits the tag of the current prerelease and deploys the respective artifact(s). It also updates (in your svn trunk or branch on the svn server) the project version in pom.xml to the next development version, and it updates your changes file (if you have one). In your svn working directory, it runs "svn up" to get the adjusted pom and changes files. Artifacts are deployed by invoking all plugin goals tied to the deploy phase. The first goal is mandatory, because it's configured by the packaging. If it fails, promotion fails. All other goals (e.g. email notifications) are optional: they may fail (yielding the respective warning), but they don't cause the promote goal to fail. Error handling. In contrast to Maven's Release Plugin there's no need for a rollback goal: when promote fails, artifacts and tags will be properly removed. (If Tag creation fails, this goal fails with an error. If artifact deployment fails, the svn tag will be deleted from the repository and the goal fails with an error. If optional promote goal fail, the plugins succeeds, but it issues a warning.) Note that the deployment date of artifacts in the repository may be later that the release date in the changes.xml.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	createTagMessage Message for svn commit of the new tag.
protected String	nextIterationMessage Message for svn commit to start new development iteration.
protected String	revertTagMessage Svn commit message when reverting the tag.

Fields inherited from class net.oneandone.maven.plugins.prerelease.ProjectBase

allowPrereleaseSnapshots, allowSnapshots, project, snapshots, target

Fields inherited from class net.oneandone.maven.plugins.prerelease.Base

keep, lockTimeout, session, svnCredentials, world

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

ROLE

Constructor Summary

Constructors

Constructor and Description
Promote()

Method Summary

Modifier and Type	Method and Description
void	doExecute(Archive archive)

Methods inherited from class net.oneandone.maven.plugins.prerelease.ProjectBase

basedir, checkedDescriptor, checkedWorkingCopy, definesTarget, doExecute, setTarget

Methods inherited from class net.oneandone.maven.plugins.prerelease.Base

execute, maven, propertyArgs, storages, version

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

createTagMessage

@Parameter(property="prerelease.createTagMessage",
           defaultValue="Prerelease ${revision} promoted to release ${release}.")
protected String createTagMessage

Message for svn commit of the new tag.

revertTagMessage

@Parameter(property="prerelease.revertTagMessage",
           defaultValue="Reverting tag for release ${release} because the deployment failed.")
protected String revertTagMessage

Svn commit message when reverting the tag.

nextIterationMessage

@Parameter(property="prerelease.nextIterationMessage",
           defaultValue="Prerelease ${revision} promoted to release ${release}, starting next development iteration.")
protected String nextIterationMessage

Message for svn commit to start new development iteration.

Constructor Detail

Promote

public Promote()

Method Detail

doExecute

public void doExecute(Archive archive)
               throws Exception

Specified by:

doExecute in class ProjectBase

Throws:

Exception