org.codehaus.mojo.versions

Class AbstractVersionsUpdaterMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.codehaus.mojo.versions.AbstractVersionsUpdaterMojo

All Implemented Interfaces:

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

Direct Known Subclasses:

AbstractVersionsDependencyUpdaterMojo, AbstractVersionsDisplayMojo, SetMojo, SetPropertyMojo, SetScmTagMojo, UpdateChildModulesMojo, UpdateParentMojo, UpdatePropertyMojo

public abstract class AbstractVersionsUpdaterMojo
extends org.apache.maven.plugin.AbstractMojo

Abstract base class for Versions Mojos.

Author:

Stephen Connolly

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowSnapshots Whether to allow snapshots when searching for the latest version of an artifact.
protected org.apache.maven.artifact.metadata.ArtifactMetadataSource	artifactMetadataSource The artifact metadata source to use.
protected org.apache.maven.artifact.resolver.ArtifactResolver	artifactResolver
protected Set<String>	ignoredVersions Allows specifying ignored versions directly as an alternative to providing the ruleSet parameter; mainly created for -D property usage.
protected org.apache.maven.artifact.repository.ArtifactRepository	localRepository
protected org.apache.maven.project.MavenProject	project The Maven Project.
protected org.apache.maven.project.MavenProjectBuilder	projectBuilder
protected List<org.apache.maven.project.MavenProject>	reactorProjects
protected List<org.apache.maven.artifact.repository.ArtifactRepository>	remoteArtifactRepositories
protected List<org.apache.maven.artifact.repository.ArtifactRepository>	remotePluginRepositories
protected org.apache.maven.repository.RepositorySystem	repositorySystem
protected org.codehaus.mojo.versions.model.RuleSet	ruleSet Allows specifying the RuleSet object describing rules on artifact versions to ignore when considering updates.
protected org.apache.maven.execution.MavenSession	session The Maven Session.
protected org.apache.maven.settings.Settings	settings

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

ROLE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractVersionsUpdaterMojo(org.apache.maven.repository.RepositorySystem repositorySystem, org.apache.maven.project.MavenProjectBuilder projectBuilder, org.apache.maven.artifact.metadata.ArtifactMetadataSource artifactMetadataSource, org.apache.maven.artifact.manager.WagonManager wagonManager, org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver)

Method Summary

Modifier and Type	Method and Description
void	execute()
protected org.apache.maven.artifact.versioning.ArtifactVersion	findLatestVersion(org.apache.maven.artifact.Artifact artifact, org.apache.maven.artifact.versioning.VersionRange versionRange, Boolean allowingSnapshots, boolean usePluginRepositories) Finds the latest version of the specified artifact that matches the version range.
protected ChangeRecorder	getChangeRecorder() Configure and return the change recorder.
VersionsHelper	getHelper()
org.apache.maven.project.MavenProject	getProject() Getter for property 'project'.
protected String	getPropertyValue(StringBuilder pom, String property) Gets the property value that is defined in the pom.
String	getVersion()
protected ModifiedPomXMLEventReader	newModifiedPomXER(StringBuilder input, String path) Creates a ModifiedPomXMLEventReader from a StringBuilder.
protected void	process(File outFile) Processes the specified file.
protected void	saveChangeRecorderResults() Save all of the changes recorded by the change recorder.
void	setProject(org.apache.maven.project.MavenProject project) Setter for property 'project'.
protected boolean	shouldApplyUpdate(org.apache.maven.artifact.Artifact artifact, String currentVersion, org.apache.maven.artifact.versioning.ArtifactVersion updateVersion) Deprecated. This method no longer supported. use shouldApplyUpdate( Artifact artifact, String currentVersion, ArtifactVersion updateVersion, Boolean forceUpdate ) Returns true if the update should be applied.
protected boolean	shouldApplyUpdate(org.apache.maven.artifact.Artifact artifact, String currentVersion, org.apache.maven.artifact.versioning.ArtifactVersion updateVersion, boolean forceUpdate) Returns true if the update should be applied.
protected abstract void	update(ModifiedPomXMLEventReader pom) Updates the pom.
protected org.apache.maven.artifact.versioning.ArtifactVersion	updatePropertyToNewestVersion(ModifiedPomXMLEventReader pom, Property property, PropertyVersions version, String currentVersion, boolean allowDowngrade, Optional<Segment> unchangedSegment)
protected void	writeFile(File outFile, StringBuilder input) Writes a StringBuilder into a file.

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

project

@Parameter(defaultValue="${project}",
           required=true,
           readonly=true)
protected org.apache.maven.project.MavenProject project

The Maven Project.

Since:

1.0-alpha-1

repositorySystem

protected org.apache.maven.repository.RepositorySystem repositorySystem

projectBuilder

protected org.apache.maven.project.MavenProjectBuilder projectBuilder

Since:

1.0-alpha-1

reactorProjects

@Parameter(defaultValue="${reactorProjects}",
           required=true,
           readonly=true)
protected List<org.apache.maven.project.MavenProject> reactorProjects

Since:

1.0-alpha-1

artifactMetadataSource

protected org.apache.maven.artifact.metadata.ArtifactMetadataSource artifactMetadataSource

The artifact metadata source to use.

Since:

1.0-alpha-1

remoteArtifactRepositories

@Parameter(defaultValue="${project.remoteArtifactRepositories}",
           readonly=true)
protected List<org.apache.maven.artifact.repository.ArtifactRepository> remoteArtifactRepositories

Since:

1.0-alpha-3

remotePluginRepositories

@Parameter(defaultValue="${project.pluginArtifactRepositories}",
           readonly=true)
protected List<org.apache.maven.artifact.repository.ArtifactRepository> remotePluginRepositories

Since:

1.0-alpha-3

localRepository

@Parameter(defaultValue="${localRepository}",
           readonly=true)
protected org.apache.maven.artifact.repository.ArtifactRepository localRepository

Since:

1.0-alpha-1

settings

@Parameter(defaultValue="${settings}",
           readonly=true)
protected org.apache.maven.settings.Settings settings

Since:

1.0-alpha-3

allowSnapshots

@Parameter(property="allowSnapshots",
           defaultValue="false")
protected boolean allowSnapshots

Whether to allow snapshots when searching for the latest version of an artifact.

Since:

1.0-alpha-1

session

@Parameter(defaultValue="${session}",
           required=true,
           readonly=true)
protected org.apache.maven.execution.MavenSession session

The Maven Session.

Since:

1.0-alpha-1

artifactResolver

protected org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver

ruleSet

@Parameter
protected org.codehaus.mojo.versions.model.RuleSet ruleSet

Allows specifying the RuleSet object describing rules on artifact versions to ignore when considering updates.

Since:

2.13.0

See Also:

Using the ruleSet element in the POM

ignoredVersions

@Parameter(property="maven.version.ignore")
protected Set<String> ignoredVersions

Allows specifying ignored versions directly as an alternative to providing the ruleSet parameter; mainly created for -D property usage.

Example: "1\.0\.1,.+-M.,.*-SNAPSHOT"

Currently, this parameter will override the defined ruleSet

Since:

2.13.0

Constructor Detail

AbstractVersionsUpdaterMojo

@Inject
protected AbstractVersionsUpdaterMojo(org.apache.maven.repository.RepositorySystem repositorySystem,
                                              org.apache.maven.project.MavenProjectBuilder projectBuilder,
                                              org.apache.maven.artifact.metadata.ArtifactMetadataSource artifactMetadataSource,
                                              org.apache.maven.artifact.manager.WagonManager wagonManager,
                                              org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver)

Method Detail

getHelper

public VersionsHelper getHelper()
                         throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

getProject

public org.apache.maven.project.MavenProject getProject()

Getter for property 'project'.

Returns:

Value for property 'project'.

Since:

1.0-alpha-1

setProject

public void setProject(org.apache.maven.project.MavenProject project)

Setter for property 'project'.

Parameters:

project - Value to set for property 'project'.

Since:

1.0-alpha-1

getVersion

public String getVersion()

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

Since:

1.0-alpha-1

findLatestVersion

protected org.apache.maven.artifact.versioning.ArtifactVersion findLatestVersion(org.apache.maven.artifact.Artifact artifact,
                                                                                 org.apache.maven.artifact.versioning.VersionRange versionRange,
                                                                                 Boolean allowingSnapshots,
                                                                                 boolean usePluginRepositories)
                                                                          throws org.apache.maven.artifact.metadata.ArtifactMetadataRetrievalException,
                                                                                 org.apache.maven.plugin.MojoExecutionException

Finds the latest version of the specified artifact that matches the version range.

Parameters:

artifact - The artifact.

versionRange - The version range.

allowingSnapshots - null for no override, otherwise the local override to apply.

usePluginRepositories - Use plugin repositories

Returns:

The latest version of the specified artifact that matches the specified version range or null if no matching version could be found.

Throws:

org.apache.maven.artifact.metadata.ArtifactMetadataRetrievalException - If the artifact metadata could not be found.

org.apache.maven.plugin.MojoExecutionException - if something goes wrong.

Since:

1.0-alpha-1

getPropertyValue

protected String getPropertyValue(StringBuilder pom,
                                  String property)

Gets the property value that is defined in the pom. This is an extension point to allow updating a file external to the reactor.

Parameters:

pom - The pom.

property - The property.

Returns:

The value as defined in the pom or null if not defined.

Since:

1.0-alpha-1

process

protected void process(File outFile)
                throws org.apache.maven.plugin.MojoExecutionException,
                       org.apache.maven.plugin.MojoFailureException

Processes the specified file. This is an extension point to allow updating a file external to the reactor.

Parameters:

outFile - The file to process.

Throws:

org.apache.maven.plugin.MojoExecutionException - If things go wrong.

org.apache.maven.plugin.MojoFailureException - If things go wrong.

Since:

1.0-alpha-1

newModifiedPomXER

protected final ModifiedPomXMLEventReader newModifiedPomXER(StringBuilder input,
                                                            String path)

Creates a ModifiedPomXMLEventReader from a StringBuilder.

Parameters:

input - The XML to read and modify.

path - Path pointing to the source of the XML

Returns:

The ModifiedPomXMLEventReader.

writeFile

protected final void writeFile(File outFile,
                               StringBuilder input)
                        throws IOException

Writes a StringBuilder into a file.

Parameters:

outFile - The file to read.

input - The contents of the file.

Throws:

IOException - when things go wrong.

update

protected abstract void update(ModifiedPomXMLEventReader pom)
                        throws org.apache.maven.plugin.MojoExecutionException,
                               org.apache.maven.plugin.MojoFailureException,
                               XMLStreamException,
                               org.apache.maven.artifact.metadata.ArtifactMetadataRetrievalException

Updates the pom.

Parameters:

pom - The pom to update.

Throws:

org.apache.maven.plugin.MojoExecutionException - If things go wrong.

org.apache.maven.plugin.MojoFailureException - If things go wrong.

XMLStreamException - If things go wrong.

org.apache.maven.artifact.metadata.ArtifactMetadataRetrievalException - if something goes wrong.

Since:

1.0-alpha-1

shouldApplyUpdate

@Deprecated
protected boolean shouldApplyUpdate(org.apache.maven.artifact.Artifact artifact,
                                                String currentVersion,
                                                org.apache.maven.artifact.versioning.ArtifactVersion updateVersion)

Deprecated. This method no longer supported. use shouldApplyUpdate( Artifact artifact, String currentVersion, ArtifactVersion updateVersion, Boolean forceUpdate )

Returns true if the update should be applied.

Parameters:

artifact - The artifact.

currentVersion - The current version of the artifact.

updateVersion - The proposed new version of the artifact.

Returns:

true if the update should be applied.

Since:

1.0-alpha-1

shouldApplyUpdate

protected boolean shouldApplyUpdate(org.apache.maven.artifact.Artifact artifact,
                                    String currentVersion,
                                    org.apache.maven.artifact.versioning.ArtifactVersion updateVersion,
                                    boolean forceUpdate)

Returns true if the update should be applied.

Parameters:

artifact - The artifact.

currentVersion - The current version of the artifact.

updateVersion - The proposed new version of the artifact.

forceUpdate - if true, LATEST and RELEASE versions will be overwritten with the real version

Returns:

true if the update should be applied to the pom.

Since:

2.9

updatePropertyToNewestVersion

protected org.apache.maven.artifact.versioning.ArtifactVersion updatePropertyToNewestVersion(ModifiedPomXMLEventReader pom,
                                                                                             Property property,
                                                                                             PropertyVersions version,
                                                                                             String currentVersion,
                                                                                             boolean allowDowngrade,
                                                                                             Optional<Segment> unchangedSegment)
                                                                                      throws XMLStreamException,
                                                                                             org.apache.maven.artifact.versioning.InvalidVersionSpecificationException,
                                                                                             InvalidSegmentException,
                                                                                             org.apache.maven.plugin.MojoExecutionException

Throws:

XMLStreamException

org.apache.maven.artifact.versioning.InvalidVersionSpecificationException

InvalidSegmentException

org.apache.maven.plugin.MojoExecutionException

getChangeRecorder

protected ChangeRecorder getChangeRecorder()
                                    throws org.apache.maven.plugin.MojoExecutionException

Configure and return the change recorder.

Returns:

The change recorder

Throws:

org.apache.maven.plugin.MojoExecutionException - If the provided change recorder format is not valid

saveChangeRecorderResults

protected void saveChangeRecorderResults()
                                  throws IOException

Save all of the changes recorded by the change recorder.

Throws:

IOException - On I/O errors