org.azyva.dragom.model.plugin.impl

Class SelectStaticVersionPluginBaseImpl

java.lang.Object

org.azyva.dragom.model.plugin.impl.NodePluginAbstractImpl

org.azyva.dragom.model.plugin.impl.ModulePluginAbstractImpl

org.azyva.dragom.model.plugin.impl.SelectStaticVersionPluginBaseImpl

All Implemented Interfaces:

org.azyva.dragom.model.plugin.ModulePlugin, org.azyva.dragom.model.plugin.NodePlugin, org.azyva.dragom.model.plugin.SelectStaticVersionPlugin

Direct Known Subclasses:

ContinuousReleaseSelectStaticVersionPluginImpl, PhaseSelectStaticVersionPluginImpl, SemanticSelectStaticVersionPluginImpl, UniformSelectStaticVersionPluginImpl

public abstract class SelectStaticVersionPluginBaseImpl
extends ModulePluginAbstractImpl
implements org.azyva.dragom.model.plugin.SelectStaticVersionPlugin

Base class for SelectStaticVersionPlugin that provide useful helper methods that are common to many such plugins.

Author:

David Raymond

Constructor Summary

Constructors

Constructor and Description
SelectStaticVersionPluginBaseImpl(org.azyva.dragom.model.Module module)

Method Summary

Modifier and Type	Method and Description
protected List<org.azyva.dragom.model.Version>	getListVersionStaticForDynamicVersion(org.azyva.dragom.model.Version versionDynamic) Gets the List of static Version's created on a dynamic Version, ordered latest first.
protected List<org.azyva.dragom.model.Version>	getListVersionStaticGlobal() Gets the List of static Version's globally, ordered latest first.
protected org.azyva.dragom.model.Version	getNewStaticVersionFromPrefix(org.azyva.dragom.model.Version versionLatestStatic, org.azyva.dragom.model.Version versionStaticPrefix) Gets a new static Version based on a prefix and a latest static Version.
protected org.azyva.dragom.model.Version	getVersionLatestMatchingVersionStaticPrefix(List<org.azyva.dragom.model.Version> listVersionStatic, org.azyva.dragom.model.Version versionStaticPrefix) Gets the latest static Version matching a static Version prefix among a List of static Version's.
protected org.azyva.dragom.model.Version	handleExistingEquivalentStaticVersion(org.azyva.dragom.model.Version versionDynamic) Handles the case where an existing equivalent static Version exists that is equivalent to the dynamic Version.
protected org.azyva.dragom.model.Version	handleSpecificStaticVersion(org.azyva.dragom.model.Version versionDynamic) Handles the case where a specific static version is specified for the module.
protected org.azyva.dragom.model.Version	handleSpecificStaticVersionPrefix(org.azyva.dragom.model.Version versionDynamic) Handles the case where a specific static version prefix is specified for the module.
protected void	setDefaultInitialRevision(int defaultInitialRevision)
protected void	setDefaultRevisionDecimalPositionCount(int defaultRevisionDecimalPositionCount)
protected void	validateVersionDynamic(org.azyva.dragom.model.Version versionDynamic) Validates that a Version is dynamic.

Methods inherited from class org.azyva.dragom.model.plugin.impl.ModulePluginAbstractImpl

getModule, toString

Methods inherited from class org.azyva.dragom.model.plugin.impl.NodePluginAbstractImpl

getNode

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.azyva.dragom.model.plugin.SelectStaticVersionPlugin

selectStaticVersion

Methods inherited from interface org.azyva.dragom.model.plugin.ModulePlugin

getModule

Methods inherited from interface org.azyva.dragom.model.plugin.NodePlugin

getNode

Constructor Detail

SelectStaticVersionPluginBaseImpl

public SelectStaticVersionPluginBaseImpl(org.azyva.dragom.model.Module module)

Method Detail

setDefaultInitialRevision

protected void setDefaultInitialRevision(int defaultInitialRevision)

setDefaultRevisionDecimalPositionCount

protected void setDefaultRevisionDecimalPositionCount(int defaultRevisionDecimalPositionCount)

validateVersionDynamic

protected void validateVersionDynamic(org.azyva.dragom.model.Version versionDynamic)

Validates that a Version is dynamic.

Parameters:

versionDynamic - Version that is supposed to be dynamic.

handleSpecificStaticVersion

protected org.azyva.dragom.model.Version handleSpecificStaticVersion(org.azyva.dragom.model.Version versionDynamic)

Handles the case where a specific static version is specified for the module.

Parameters:

versionDynamic - Dynamic version.

Returns:

Specific static Version. null if none specified.

handleExistingEquivalentStaticVersion

protected org.azyva.dragom.model.Version handleExistingEquivalentStaticVersion(org.azyva.dragom.model.Version versionDynamic)

Handles the case where an existing equivalent static Version exists that is equivalent to the dynamic Version.

When getting a new static version for the current dynamic version, it may be pertinent to verify if there is already a static Version corresponding to the current dynamic Version. This is important since if the process is restarted by the user after having been aborted after some Version creations have been performed, we need to make it as if we were continuing from where we left off, and reusing existing static Version that may have been created during the previous execution does the trick.

Also, even ignoring the case where the process is restarted, if the user ran this job once, used SwitchToDynamicVersion with the intent of performing additional changes and runs the process again without having actually performed any work, it is expected that the static Version that was created in the first execution gets reused.

Parameters:

versionDynamic - Dynamic Version.

Returns:

Existing equivalent static Version. null if none.

handleSpecificStaticVersionPrefix

protected org.azyva.dragom.model.Version handleSpecificStaticVersionPrefix(org.azyva.dragom.model.Version versionDynamic)

Handles the case where a specific static version prefix is specified for the module.

Parameters:

versionDynamic - Dynamic Version.

Returns:

Specific static Version prefix.

getNewStaticVersionFromPrefix

protected org.azyva.dragom.model.Version getNewStaticVersionFromPrefix(org.azyva.dragom.model.Version versionLatestStatic,
                                                                       org.azyva.dragom.model.Version versionStaticPrefix)

Gets a new static Version based on a prefix and a latest static Version.

The caller is responsible for providing a latest static Version which matches the static Version prefix.

This class provides methods to help the caller in obtaining this latest static Version depending on the context. It could be the latest static Version created on a given dynamic Version. It could also be the latest static Version globally.

Parameters:

versionLatestStatic - Latest static Version. Can be null, indicating there is no latest static Version.

versionStaticPrefix - Static version prefix.

Returns:

New static Version.

getVersionLatestMatchingVersionStaticPrefix

protected org.azyva.dragom.model.Version getVersionLatestMatchingVersionStaticPrefix(List<org.azyva.dragom.model.Version> listVersionStatic,
                                                                                     org.azyva.dragom.model.Version versionStaticPrefix)

Gets the latest static Version matching a static Version prefix among a List of static Version's.

Parameters:

listVersionStatic - List of static Version's, ordered latest first.

versionStaticPrefix - Static Version prefix.

Returns:

Latest matching static Version or null if none.

getListVersionStaticForDynamicVersion

protected List<org.azyva.dragom.model.Version> getListVersionStaticForDynamicVersion(org.azyva.dragom.model.Version versionDynamic)

Gets the List of static Version's created on a dynamic Version, ordered latest first.

Parameters:

versionDynamic - Dynamic Version.

Returns:

List of static Version.

getListVersionStaticGlobal

protected List<org.azyva.dragom.model.Version> getListVersionStaticGlobal()

Gets the List of static Version's globally, ordered latest first.

Returns:

See description.