oracle.ide.model

Class ProjectVersion

java.lang.Object

oracle.javatools.data.HashStructureAdapter

oracle.ide.model.ProjectVersion

public final class ProjectVersion
extends HashStructureAdapter

This class provides a standardized means of storing and retrieving version history information in the project file. This information is used when determining what migration, if any, an extension would need to perform to bring its part(s) of the project file up to date with the currently running extension version.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COMPONENT_VERSIONS_KEY
static java.lang.String	PROJECT_KEY

Fields inherited from class oracle.javatools.data.HashStructureAdapter

_hash

Constructor Summary

Constructors

Constructor and Description
ProjectVersion(HashStructure projectHash)
ProjectVersion(PropertyStorage project)

Method Summary

Modifier and Type	Method and Description
void	addVersion(java.lang.String componentName, VersionNumber version) Adds the specified version to the version history for the specified component.
VersionNumber	getCurrentVersion() Returns the current version of the Project format itself.
VersionNumber	getCurrentVersion(java.lang.String componentName) Returns the current version of the specified component, as stored in the project file.
VersionNumber[]	getVersionHistory() Returns the version history of the current project file format.
VersionNumber[]	getVersionHistory(java.lang.String componentName) Returns the version history of the specified component.
static void	initializeVersions(PropertyStorage project, java.lang.String nodeMigratorKey)
void	removeVersion(java.lang.String componentName, VersionNumber version) Removes the specified version from the version history for the specified component.
void	setVersionHistory(java.lang.String componentName, VersionNumber[] versionHistory) Associates the specified array of VersionNumbers as representing the total version history for the specified component.

Methods inherited from class oracle.javatools.data.HashStructureAdapter

addStructureChangeListener, containsKey, copyTo, copyToImpl, equals, equalsImpl, findOrCreate, forcedCopyTo, getHashStructure, removeStructureChangeListener, useObjectEquals

Methods inherited from class java.lang.Object

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

Field Detail

PROJECT_KEY

public static final java.lang.String PROJECT_KEY

See Also:

Constant Field Values

COMPONENT_VERSIONS_KEY

public static final java.lang.String COMPONENT_VERSIONS_KEY

See Also:

Constant Field Values

Constructor Detail

ProjectVersion

public ProjectVersion(PropertyStorage project)

ProjectVersion

public ProjectVersion(HashStructure projectHash)

Method Detail

initializeVersions

public static void initializeVersions(PropertyStorage project,
                                      java.lang.String nodeMigratorKey)

getCurrentVersion

public VersionNumber getCurrentVersion()

Returns the current version of the Project format itself.

getVersionHistory

public VersionNumber[] getVersionHistory()

Returns the version history of the current project file format. For example, if this project file had originally been created in 9.0.2, was subsequently migrated directly to 9.0.5, and then subsequently migrated from 9.0.5 directly to 10.1.3, the version history will contain "9.0.2", "9.0.5", and "10.1.3".

getCurrentVersion

public VersionNumber getCurrentVersion(java.lang.String componentName)

Returns the current version of the specified component, as stored in the project file. If no version information about the specified component is stored in the project file, this method returns null.

getVersionHistory

public VersionNumber[] getVersionHistory(java.lang.String componentName)

Returns the version history of the specified component.

See Also:

getVersionHistory()

setVersionHistory

public void setVersionHistory(java.lang.String componentName,
                              VersionNumber[] versionHistory)

Associates the specified array of VersionNumbers as representing the total version history for the specified component.

addVersion

public void addVersion(java.lang.String componentName,
                       VersionNumber version)

Adds the specified version to the version history for the specified component. If the version is already recorded in the component's version history, this method has no effect.

removeVersion

public void removeVersion(java.lang.String componentName,
                          VersionNumber version)

Removes the specified version from the version history for the specified component. If the version does not ocur in the component's version history, this method has no effect.