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.
CcBranch
,
CcElement
,
CcConfigSpec
,
CcBranchType
Modifier and Type | Interface and Description |
---|---|
static class |
CcVersion.CcCheckoutFlag
Flags for the
doCcCheckout method. |
static class |
CcVersion.CcMergeFlag
Flags for the doMerge method
|
Version.Fork
CcVobResource.ApplyAttributeFlag
StpResource.UnsupportedProperty
Resource.CopyFlag
Modifier and Type | Field and Description |
---|---|
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.
|
ACTIVITY, CHECKIN_FORK, CHECKOUT_FORK, CHECKOUT_LIST, IN_BASELINE_LIST, IN_WORKSPACE_LIST, LABEL_NAME_LIST, PREDECESSOR_LIST, SUCCESSOR_LIST, VERSION_HISTORY, VERSION_NAME
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
ALL_PROPERTIES, AUTHENTICATION_REALM, CREATOR_GROUP_NAME, CREATOR_LOGIN_NAME, EFFICIENT_LOCATION, INVALID_PROPERTIES, REPOSITORY, STABLE_LOCATION, USER_FRIENDLY_LOCATION
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
Modifier and Type | Method and Description |
---|---|
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.
|
CcFile |
doCcCheckout(CcVersion.CcCheckoutFlag[] flags,
CcView view,
Feedback feedback)
Check out the specific version of a file or directory specified
by this proxy.
|
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.
|
doAddLabel, doRemoveLabel, doSetLabel, getActivity, getCheckinFork, getCheckoutFork, getCheckoutList, getInBaselineList, getInWorkspaceList, getLabelNameList, getPredecessorList, getSuccessorList, getVersionHistory, getVersionName, setActivity, setCheckinFork, setCheckoutFork, workspaceProvider
doApplyAttribute, doApplyRolemap, doRemoveAttribute, doRequestForMastership, getAttributeList, getCurrentReplica, getEffectiveAcl, getHasLocalMastership, getHyperlinkList, getLockInfo, getMasterReplica, getMyEffectiveAccess, getMyEffectiveAcl, getPermissions, getRolemap, getVob, setLockInfo, setPermissions
ccProvider, doReadContent, doResolve, doWriteProperties, hasSupportedProperties, isResolved, readProperties, readProperties, resolve, writeProperties, writeProperties
doReadProperties, equals, getAllProperties, getAuthenticationRealm, getCreatorGroupName, getCreatorLoginName, getCustomProperties, getEfficientLocation, getInvalidProperties, getMetaProperties, getPropertyException, getRepository, getResourceError, getStableLocation, getUserFriendlyLocation, hashCode, hasProperties, initMetaProperty, proxyType, setPropertyClean, stpLocation, stpProvider
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
static final PropertyNameList.PropertyName<CcBranch> BRANCH
static final PropertyNameList.PropertyName<CcElement> ELEMENT
Version.VERSION_HISTORY
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.
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.
static final PropertyNameList.PropertyName<ResourceList<Task>> TASK_LIST
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.
Version doAddLabel(String label, CcView view, Feedback feedback) throws WvcmException
label
- Label to be appliedview
- View contextWvcmException
Version.doAddLabel(java.lang.String, javax.wvcm.Feedback)
Version doAddLabel(String comment, String label, CcView view, Feedback feedback) throws WvcmException
comment
- The comment for this operation, or null for no commentlabel
- Label to be appliedview
- View contextWvcmException
Version.doAddLabel(java.lang.String, javax.wvcm.Feedback)
CcFile doCcCheckout(CcVersion.CcCheckoutFlag[] flags, CcView view, Feedback feedback) throws WvcmException
Check out the specific version of a file or directory specified by this proxy. The resource is checked out to the specified ClearCase view. Note that directory version checkout is only supported for dynamic views.
If the view is a UCM view, the caller must insure there is a
Workspace.CURRENT_ACTIVITY
for this operation.
The checked out file will be added to the current activity's change set.
The caller may explicitly specify an activity using this resource's
ControllableResource.setActivity(javax.wvcm.Activity)
method. In that case,
the specified activity will become the new current activity.
Otherwise, the existing current activity will be used.
If the view is a UCM view and there is no current activity, the operation
will fail.
The caller may optionally specify a checkout comment using this
resource's Resource.setComment(java.lang.String)
method.
flags
- array of flags which specify the behavior of the operationview
- View contextfeedback
- WvcmException
CcVersion doCreateMergeArrow(CcVersion toVersion, CcView view, Feedback feedback) throws WvcmException
toVersion
- Destination version for the hyperlinkview
- View context (ensures path EVs set for mkhlink when a merge is being made).WvcmException
CcVersion doCreateMergeArrow(CcVersion toVersion, Feedback feedback) throws WvcmException
toVersion
- Destination version for the hyperlinkWvcmException
Version doRemoveLabel(String label, CcView view, Feedback feedback) throws WvcmException
label
- Label to be removedview
- View contextWvcmException
Version.doRemoveLabel(java.lang.String, javax.wvcm.Feedback)
Version doSetLabel(String label, CcView view, Feedback feedback) throws WvcmException
label
- Label to be appliedview
- View contextWvcmException
Version.doSetLabel(java.lang.String, javax.wvcm.Feedback)
Version doSetLabel(String comment, String label, CcView view, Feedback feedback) throws WvcmException
comment
- The comment for this operation, or null for no commentlabel
- Label to be appliedview
- View contextWvcmException
Version.doSetLabel(java.lang.String, javax.wvcm.Feedback)
CcBranch getBranch() throws WvcmException
BRANCH
property.WvcmException
- if property was not requestedCcElement getElement() throws WvcmException
ELEMENT
property.WvcmException
- if property was not requestedResourceList<CcVersion> getMergeContributorList() throws WvcmException
MERGE_CONTRIBUTOR_LIST
property.WvcmException
- if property was not requested.CcVersion getPredecessor() throws WvcmException
PREDECESSOR
property.WvcmException
- if property was not requested.ResourceList<Task> getTaskList() throws WvcmException
WvcmException
- if property was not requested.String getViewRelativePath() throws WvcmException
VIEW_RELATIVE_PATH
property.WvcmException
- if property was not requested, or if the view context
was not providedvoid setTaskList(ResourceList<Task> tasks) throws WvcmException
tasks
- List of tasks to be associated with this version.WvcmException
void setTaskList(ResourceList<Task> taskAdditions, ResourceList<Task> taskRemovals) throws WvcmException
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.WvcmException
Copyright © IBM 2017. All rights reserved.