Project: stp

com.ibm.rational.wvcm.stp.cc
Interface CcVersion

All Superinterfaces:
CcResource, CcVobResource, Resource, StpResource, Version
All Known Subinterfaces:
CcDirectoryVersion

public interface CcVersion
extends Version, CcVobResource

A proxy for a version of a ClearCase element.

Each time a new revision of a version-controlled file or directory is checked in, a new version of that element is created. Versions are created, in sequence, on the branch of an element selected by the view's config spec.

For more information about version, see the ClearCase "Guide to Developing Software" manual.

See Also:
CcBranch, CcElement, CcConfigSpec, CcBranchType

Nested Class Summary
static class CcVersion.CcMergeFlag
          Flags for the doMerge method
 
Nested classes/interfaces inherited from interface javax.wvcm.Version
Version.Fork
 
Nested classes/interfaces inherited from interface CcVobResource
CcVobResource.ApplyAttributeFlag
 
Nested classes/interfaces inherited from interface com.ibm.rational.wvcm.stp.StpResource
StpResource.UnsupportedProperty
 
Nested classes/interfaces inherited from interface javax.wvcm.Resource
Resource.CopyFlag
 
Field Summary
static PropertyNameList.PropertyName<CcBranch> BRANCH
          This version's branch.
static PropertyNameList.PropertyName<CcElement> ELEMENT
          This version's element.
static PropertyNameList.PropertyName<ResourceList<CcVersion>> MERGE_CONTRIBUTOR_LIST
           The list of versions that were merged to create this version.
static PropertyNameList.PropertyName<CcVersion> PREDECESSOR
           The immediate predecessor of this version on this version's branch, or if this is the first version on the branch, the version from which the branch emanates.
static PropertyNameList.PropertyName<ResourceList<Task>> TASK_LIST
          The list of tasks associated with this version.
static PropertyNameList.PropertyName<String> VIEW_RELATIVE_PATH
           The view-relative path for this version, possibly including the version extension.
 
Fields inherited from interface javax.wvcm.Version
ACTIVITY, CHECKIN_FORK, CHECKOUT_FORK, CHECKOUT_LIST, IN_BASELINE_LIST, IN_WORKSPACE_LIST, LABEL_NAME_LIST, PREDECESSOR_LIST, SUCCESSOR_LIST, VERSION_HISTORY, VERSION_NAME
 
Fields inherited from interface CcVobResource
ATTRIBUTE_LIST, CC_MASTER_REPLICA, CURRENT_REPLICA, EFFECTIVE_ACL, HAS_LOCAL_MASTERSHIP, HYPERLINK_LIST, LOCK_INFO, MY_EFFECTIVE_ACCESS, MY_EFFECTIVE_ACL, PERMISSIONS, ROLEMAP, VOB
 
Fields inherited from interface com.ibm.rational.wvcm.stp.StpResource
ALL_PROPERTIES, AUTHENTICATION_REALM, CREATOR_GROUP_NAME, CREATOR_LOGIN_NAME, EFFICIENT_LOCATION, INVALID_PROPERTIES, REPOSITORY, STABLE_LOCATION, USER_FRIENDLY_LOCATION
 
Fields inherited from interface javax.wvcm.Resource
ALL_CUSTOM_PROPERTIES, COMMENT, CONTENT_CHARACTER_SET, CONTENT_IDENTIFIER, CONTENT_LANGUAGE, CONTENT_LENGTH, CONTENT_TYPE, CREATION_DATE, CREATOR_DISPLAY_NAME, DISPLAY_NAME, IS_EXECUTABLE, LAST_MODIFIED, PARENT_LIST, PATHNAME_LOCATION, PROVIDER_LIST, RESOURCE_IDENTIFIER, WORKSPACE_FOLDER_LIST
 
Method Summary
 Version doAddLabel(String label, CcView view, Feedback feedback)
          Add the specified label to the version.
 Version doAddLabel(String comment, String label, CcView view, Feedback feedback)
          Add the specified label to the version.
 CcVersion doCreateMergeArrow(CcVersion toVersion, CcView view, Feedback feedback)
          Create a Merge hyperlink pointing from this version to the specified destination version.
 CcVersion doCreateMergeArrow(CcVersion toVersion, Feedback feedback)
          Create a Merge hyperlink pointing from this version to the specified destination version.
 Version doRemoveLabel(String label, CcView view, Feedback feedback)
          Remove the specified label from the version.
 Version doSetLabel(String label, CcView view, Feedback feedback)
          Set the specified label on the version.
 Version doSetLabel(String comment, String label, CcView view, Feedback feedback)
          Set the specified label on the version.
 CcBranch getBranch()
          Get the value of this version's BRANCH property.
 CcElement getElement()
          Get the value of this version's ELEMENT property.
 ResourceList<CcVersion> getMergeContributorList()
          Get the value of this version's MERGE_CONTRIBUTOR_LIST property.
 CcVersion getPredecessor()
          Get the value of this version's PREDECESSOR property.
 ResourceList<Task> getTaskList()
          Get the value of this versions's (@link #TASK_LIST) property.
 String getViewRelativePath()
          Get the value of this version's VIEW_RELATIVE_PATH property.
 void setTaskList(ResourceList<Task> tasks)
          Set the specified list of tasks as being associated with this version.
 void setTaskList(ResourceList<Task> taskAdditions, ResourceList<Task> taskRemovals)
          Modify the list of tasks associated with this version by adding and removing the items from the specified lists.
 
Methods inherited from interface javax.wvcm.Version
doAddLabel, doRemoveLabel, doSetLabel, getActivity, getCheckinFork, getCheckoutFork, getCheckoutList, getInBaselineList, getInWorkspaceList, getLabelNameList, getPredecessorList, getSuccessorList, getVersionHistory, getVersionName, setActivity, setCheckinFork, setCheckoutFork, workspaceProvider
 
Methods inherited from interface CcVobResource
doApplyAttribute, doApplyRolemap, doRemoveAttribute, doRequestForMastership, getAttributeList, getCurrentReplica, getEffectiveAcl, getHasLocalMastership, getHyperlinkList, getLockInfo, getMasterReplica, getMyEffectiveAccess, getMyEffectiveAcl, getPermissions, getRolemap, getVob, setLockInfo, setPermissions
 
Methods inherited from interface CcResource
ccProvider, doResolve, doWriteProperties, hasSupportedProperties, isResolved, readProperties, readProperties, resolve, writeProperties, writeProperties
 
Methods inherited from interface com.ibm.rational.wvcm.stp.StpResource
doReadProperties, equals, getAllProperties, getAuthenticationRealm, getCreatorGroupName, getCreatorLoginName, getCustomProperties, getEfficientLocation, getInvalidProperties, getMetaProperties, getPropertyException, getRepository, getResourceError, getStableLocation, getUserFriendlyLocation, hashCode, hasProperties, initMetaProperty, proxyType, setPropertyClean, stpLocation, stpProvider
 
Methods inherited from interface javax.wvcm.Resource
doCopy, doFind, doFindAll, doGetPropertyNameList, doGetPropertyNameList, doReadContent, doReadProperties, doUnbindAll, doWriteContent, doWriteProperties, forgetProperty, getComment, getContentCharacterSet, getContentIdentifier, getContentLanguage, getContentLength, getContentType, getCreationDate, getCreatorDisplayName, getDisplayName, getIsExecutable, getLastModified, getParentList, getPathnameLocation, getProperty, getProviderList, getWorkspaceFolderList, initProperty, location, lookupProperty, modifyLocation, propertyNameList, provider, removeProperty, setComment, setContentCharacterSet, setContentLanguage, setContentType, setCreatorDisplayName, setDisplayName, setIsExecutable, setProperty, setProperty, updatedPropertyNameList
 

Field Detail

BRANCH

static final PropertyNameList.PropertyName<CcBranch> BRANCH
This version's branch.


ELEMENT

static final PropertyNameList.PropertyName<CcElement> ELEMENT
This version's element.

See Also:
Version.VERSION_HISTORY

MERGE_CONTRIBUTOR_LIST

static final PropertyNameList.PropertyName<ResourceList<CcVersion>> MERGE_CONTRIBUTOR_LIST

The list of versions that were merged to create this version. This will be empty if this version was not created by a merge operation.


PREDECESSOR

static final PropertyNameList.PropertyName<CcVersion> PREDECESSOR

The immediate predecessor of this version on this version's branch, or if this is the first version on the branch, the version from which the branch emanates. Will be null if this version is the /main/0 version of its element.


TASK_LIST

static final PropertyNameList.PropertyName<ResourceList<Task>> TASK_LIST
The list of tasks associated with this version.


VIEW_RELATIVE_PATH

static final PropertyNameList.PropertyName<String> VIEW_RELATIVE_PATH

The view-relative path for this version, possibly including the version extension.

NOTE: This property is only available if it is retrieved using a method with a view context, such as Resource.doReadProperties(CcView, PropertyRequest). ClearCase needs a view context to resolve version paths.

Method Detail

doAddLabel

Version doAddLabel(String label,
                   CcView view,
                   Feedback feedback)
                   throws WvcmException
Add the specified label to the version.

Parameters:
label - Label to be applied
view - View context
Throws:
WvcmException
See Also:
Version.doAddLabel(java.lang.String, javax.wvcm.Feedback)

doAddLabel

Version doAddLabel(String comment,
                   String label,
                   CcView view,
                   Feedback feedback)
                   throws WvcmException
Add the specified label to the version.

Parameters:
comment - The comment for this operation, or null for no comment
label - Label to be applied
view - View context
Throws:
WvcmException
See Also:
Version.doAddLabel(java.lang.String, javax.wvcm.Feedback)

doCreateMergeArrow

CcVersion doCreateMergeArrow(CcVersion toVersion,
                             CcView view,
                             Feedback feedback)
                             throws WvcmException
Create a Merge hyperlink pointing from this version to the specified destination version.

Parameters:
toVersion - Destination version for the hyperlink
view - View context (ensures path EVs set for mkhlink when a merge is being made).
Returns:
A new proxy for this version, whose properties are specified by feedback.
Throws:
WvcmException

doCreateMergeArrow

CcVersion doCreateMergeArrow(CcVersion toVersion,
                             Feedback feedback)
                             throws WvcmException
Create a Merge hyperlink pointing from this version to the specified destination version.

Parameters:
toVersion - Destination version for the hyperlink
Returns:
A new proxy for this version, whose properties are specified by feedback.
Throws:
WvcmException

doRemoveLabel

Version doRemoveLabel(String label,
                      CcView view,
                      Feedback feedback)
                      throws WvcmException
Remove the specified label from the version.

Parameters:
label - Label to be removed
view - View context
Throws:
WvcmException
See Also:
Version.doRemoveLabel(java.lang.String, javax.wvcm.Feedback)

doSetLabel

Version doSetLabel(String label,
                   CcView view,
                   Feedback feedback)
                   throws WvcmException
Set the specified label on the version.

Parameters:
label - Label to be applied
view - View context
Throws:
WvcmException
See Also:
Version.doSetLabel(java.lang.String, javax.wvcm.Feedback)

doSetLabel

Version doSetLabel(String comment,
                   String label,
                   CcView view,
                   Feedback feedback)
                   throws WvcmException
Set the specified label on the version.

Parameters:
comment - The comment for this operation, or null for no comment
label - Label to be applied
view - View context
Throws:
WvcmException
See Also:
Version.doSetLabel(java.lang.String, javax.wvcm.Feedback)

getBranch

CcBranch getBranch()
                   throws WvcmException
Get the value of this version's BRANCH property.

Returns:
a proxy for this version's branch
Throws:
WvcmException - if property was not requested

getElement

CcElement getElement()
                     throws WvcmException
Get the value of this version's ELEMENT property.

Returns:
a proxy for this version's element
Throws:
WvcmException - if property was not requested

getMergeContributorList

ResourceList<CcVersion> getMergeContributorList()
                                                throws WvcmException
Get the value of this version's MERGE_CONTRIBUTOR_LIST property.

Returns:
a list of the CcVersion proxies which represent merge contributors for this version.
Throws:
WvcmException - if property was not requested.

getPredecessor

CcVersion getPredecessor()
                         throws WvcmException
Get the value of this version's PREDECESSOR property.

Returns:
a CcVersion proxy for this version's predecessor.
Throws:
WvcmException - if property was not requested.

getTaskList

ResourceList<Task> getTaskList()
                               throws WvcmException
Get the value of this versions's (@link #TASK_LIST) property.

Returns:
a list of the tasks associated with this version.
Throws:
WvcmException - if property was not requested.

getViewRelativePath

String getViewRelativePath()
                           throws WvcmException
Get the value of this version's VIEW_RELATIVE_PATH property.

Returns:
view-relative path
Throws:
WvcmException - if property was not requested, or if the view context was not provided

setTaskList

void setTaskList(ResourceList<Task> tasks)
                 throws WvcmException
Set the specified list of tasks as being associated with this version. Overwrites any existing associations. Can be used to clear all associations by setting an empty list.

Parameters:
tasks - List of tasks to be associated with this version.
Throws:
WvcmException

setTaskList

void setTaskList(ResourceList<Task> taskAdditions,
                 ResourceList<Task> taskRemovals)
                 throws WvcmException
Modify the list of tasks associated with this version by adding and removing the items from the specified lists. An intersection between the addition and removal lists is considered an error.

Parameters:
taskAdditions - List of tasks to be added to the list of associations for this version. Items in this list which are already associated with the version are ignored.
taskRemovals - List of tasks to be removed from the list of associations for this version. Items in this list which are not associated with the version are ignored.
Throws:
WvcmException

Generated Wed 21-Oct-2015 10:58 PM

Copyright © IBM 2015. All rights reserved.