|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Workspace
A DevelopmentLine that controls changes to versioned resources. Workspaces contain some combination of:
A workspace creates a new asset and an initial version of that asset when a resource is put under version control.
A new editable working version is created by checking out an existing version, either the current head version of the asset, or some other arbitrary version (e.g. a deleted version that is not normally accessible as the current version). A workspace can only have one checked-out working version for each asset. The rest of the editing cycle is usually invoked through the working version, but the workspace contains some batch utilities for reverting or checking-in all the outstanding working versions.
A workspace can be deleted, if it does not have any any outstanding checked-out working versions. When a workspace is deleted, any references to it become invalid and can no longer be used.
Field Summary | |
---|---|
static java.lang.String |
CLASS_VERSION
|
Method Summary | |
---|---|
void |
addNewAsset(int type,
atg.adapter.version.RepositoryWorkingVersionItem item,
java.lang.String repositoryName,
java.lang.String itemDescriptor,
java.lang.Integer version)
This method is not for use by client code. |
void |
checkInAll(java.lang.String username,
java.lang.String comment)
Check-in all the checked-out working versions in the workspace. |
WorkingVersion |
checkOut(Asset asset)
Check-out an asset into this workspace. |
WorkingVersion |
checkOut(AssetVersion version)
Check-out a specific version into this workspace. |
WorkingVersion |
checkOut(VersionManagerURI uri)
Check-out a specific version into this workspace. |
void |
delete()
Delete a workspace. |
void |
generateDependencyCaches()
Generated caches that are useful in calculating one workspace's dependency on another workspace. |
java.util.Set |
getAssetsChanged()
Returns the assets changed by this Workspace. |
java.util.Set |
getAssetsChanged(int whichOnes)
|
java.util.Set |
getAssetsChanged(atg.versionmanager.impl.VersionContainerIncludeChecker containerIncludeChecker)
|
java.util.Set |
getChangedAssetURIs()
Returns the set of version manager URIs of assets changed by this Workspace. |
long |
getCheckInTime()
Workspaces have a check-in time |
java.lang.String |
getComment()
Workspaces have a comment. |
java.util.Set |
getPreloadedAssetsChanged(int whichOnes,
boolean filterDeleted,
boolean preloadItems)
Returns the items checked in with this Workspace. |
java.util.Set |
getReferencedAssetURIs()
Returns the set of URIs that assets changed in this URI reference. |
java.lang.String |
getUser()
Workspaces have a creator. |
WorkingVersion |
getWorkingVersion(Asset asset)
Get the currently checked-out working version for an asset in this workspace. |
WorkingVersion |
getWorkingVersion(AssetVersion asset)
|
WorkingVersion |
getWorkingVersion(VersionManagerURI assetURI)
|
java.util.Set |
getWorkingVersions()
Get all the currently checked-out working versions for this workspace. |
boolean |
isCheckedIn()
Returns true if the workspace has had all of its contents checked in. |
boolean |
isLocked()
Are all assets in this workspace locked |
boolean |
isUpToDate()
Check to see if a resolve() is needed before the versions can be checked in. |
boolean |
lockAllAssets()
Lock all assets in this workspace for deployment |
void |
resetParentVersionForAll()
Reset all working versions' predecessor version to the current head-of-branch version. |
void |
revert(java.util.Collection pWorkingVersions)
Revert given working versions |
void |
revert(WorkingVersion version)
Revert changes to the asset that have been made in this workspace. |
void |
revertAll()
Discard all the working versions in the workspace without saving any changes. |
void |
setChangedAssetURIs(java.util.Set pSet)
|
void |
setComment(java.lang.String comment)
Set the comment describing what this workspace is changing. |
void |
setReferencedAssetURIs(java.util.Set pSet)
|
void |
unlockAllAssets()
Unlock all assets in this workspace |
Methods inherited from interface atg.versionmanager.ManagedElement |
---|
getDisplayName, getName, getURI, getVersionManager |
Field Detail |
---|
static final java.lang.String CLASS_VERSION
Method Detail |
---|
java.util.Set getWorkingVersions()
WorkingVersion getWorkingVersion(Asset asset)
WorkingVersion getWorkingVersion(AssetVersion asset)
WorkingVersion getWorkingVersion(VersionManagerURI assetURI)
WorkingVersion checkOut(Asset asset) throws RepositoryException, VersionException
history
- to check-out
RepositoryException
VersionException
WorkingVersion checkOut(AssetVersion version) throws RepositoryException, VersionException
asset
- to check-out
RepositoryException
VersionException
WorkingVersion checkOut(VersionManagerURI uri) throws RepositoryException, VersionException
uri
- The uri of the asset to check-out
RepositoryException
VersionException
void revertAll() throws VersionException
VersionException
void revert(java.util.Collection pWorkingVersions) throws VersionException
pWorkingVersions
-
VersionException
void resetParentVersionForAll() throws VersionException
VersionException
void checkInAll(java.lang.String username, java.lang.String comment) throws VersionException
comment
- applied to check-ins
VersionVetoException
- if a checkin is vetoed
VersionException
void delete() throws VersionException
VersionException
boolean isCheckedIn()
java.lang.String getComment()
void setComment(java.lang.String comment)
comment
- java.lang.String getUser()
long getCheckInTime()
java.util.Set getAssetsChanged() throws VersionException
VersionException
java.util.Set getAssetsChanged(int whichOnes) throws VersionException
VersionException
java.util.Set getAssetsChanged(atg.versionmanager.impl.VersionContainerIncludeChecker containerIncludeChecker) throws VersionException
VersionException
java.util.Set getPreloadedAssetsChanged(int whichOnes, boolean filterDeleted, boolean preloadItems) throws VersionException
VersionException
void revert(WorkingVersion version) throws VersionException
version
- The asset version to revert.
VersionException
boolean lockAllAssets() throws VersionException
VersionException
- thrown if problem creating locksvoid unlockAllAssets() throws VersionException
VersionException
- thrown if problem remove locksboolean isLocked() throws VersionException
VersionException
- thrown if problem determining lock statusboolean isUpToDate() throws VersionException
VersionException
java.util.Set getChangedAssetURIs() throws VersionException
VersionException
void setChangedAssetURIs(java.util.Set pSet) throws VersionException
VersionException
java.util.Set getReferencedAssetURIs() throws VersionException
VersionException
void setReferencedAssetURIs(java.util.Set pSet) throws VersionException
VersionException
void generateDependencyCaches() throws VersionException
VersionException
- thrown if there is a problem generating this cachevoid addNewAsset(int type, atg.adapter.version.RepositoryWorkingVersionItem item, java.lang.String repositoryName, java.lang.String itemDescriptor, java.lang.Integer version) throws VersionException
type
- Is this a repository item or a fileversionItem
- working version of new assetrepositoryName
- repository adding this assetitemDescriptor
- asset's descriptorversion
- version of asset (should be 0)
VersionException
- thrown if problem adding asset
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |