Interface CDOBranch
- 
- All Superinterfaces:
- CDOBranchPoint,- CDOBranchProvider,- CDONameProvider,- CDOTimeProvider,- java.lang.Comparable<CDOBranch>,- IAdaptable,- org.eclipse.net4j.util.container.IContainer<CDOBranch>,- org.eclipse.net4j.util.event.INotifier
 - All Known Subinterfaces:
- InternalCDOBranch
 
 public interface CDOBranch extends CDOBranchPoint, CDONameProvider, org.eclipse.net4j.util.container.IContainer<CDOBranch>, java.lang.Comparable<CDOBranch>, IAdaptable Represents a stream of changes that is isolated from other streams of changes.A branch starts at a fixed basepoint and ends at a floatingheadpoint. Between these two points there can be a number of otherbranch points:-  Commit infosare points in a branch that represent commit operations.
-  Branch tagsare named points in a branch.
-  Base pointsof sub branches of a branch.
 - Since:
- 3.0
- Author:
- Eike Stepper
- No Implement
- This interface is not intended to be implemented by clients.
- No Extend
- This interface is not intended to be extended by clients.
 
- 
- 
Nested Class SummaryNested Classes Modifier and Type Interface Description static interfaceCDOBranch.BranchDeletedEventAneventfired from abranchwhen it gets deleted.- 
Nested classes/interfaces inherited from interface org.eclipse.net4j.util.container.IContainerorg.eclipse.net4j.util.container.IContainer.Modifiable<E extends java.lang.Object>, org.eclipse.net4j.util.container.IContainer.Persistable<E extends java.lang.Object>, org.eclipse.net4j.util.container.IContainer.Persistence<E extends java.lang.Object>
 
- 
 - 
Field SummaryFields Modifier and Type Field Description static intMAIN_BRANCH_IDThe fixed ID of themain branch.static java.lang.StringMAIN_BRANCH_NAMEThe fixed name of themain branch.static java.lang.StringPATH_SEPARATORThe string used to separate the segments of branch paths.- 
Fields inherited from interface org.eclipse.emf.cdo.common.branch.CDOBranchPointINVALID_DATE, UNSPECIFIED_DATE
 
- 
 - 
Method SummaryAll Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description CDOBranchcreateBranch(java.lang.String name)Creates a sub branch of this branch with the given name,basedat thecurrent time.CDOBranchcreateBranch(java.lang.String name, long timeStamp)Creates a sub branch of this branch with the given name,basedat thebranch pointin this branch with the given time stamp.CDOBranch[]delete(org.eclipse.net4j.util.om.monitor.OMMonitor monitor)Deletes this branch and all its sub branches.voidfireDeletedEvent()CDOBranchPointgetBase()Returns the immutable base branch point of this branch, the point in the parent branch that marks the creation of this branch.CDOBranchPoint[]getBasePath()Returns an array of thebasebranch points starting from the base of themain branchdown to and including the base of this branch.CDOBranchgetBranch(java.lang.String path)Returns the sub branch of this branch with the given relative path, ornullif no sub branch with this path exists in this branch.CDOBranch[]getBranches()Returns an array of the sub branches of this branch, nevernull.CDOBranchManagergetBranchManager()Returns the branch manager that manages this branch, nevernull.CDOBranchPointgetHead()Returns the floating end point of this branch, a pair of this branch and the fixed special time stampunspecified.intgetID()Returns the ID of this branch.java.lang.StringgetName()Returns the name of this branch as specified when it was created withcreateBranch()orMAIN_BRANCH_NAMEif this branch is themain branch.java.lang.StringgetPathName()Returns the fully qualified path name of this branch, a concatenation of the names of all branches from themain branchto this branch, separated byslashes("/" characters).CDOBranchPointgetPoint(long timeStamp)Returns the branch point in this branch with the given time stamp.CDOBranchVersiongetVersion(int version)Returns the branch version in this branch with the given version number.booleanisDeleted()Returnstrueif this branch has is deleted,falseotherwise.booleanisLocal()Returnstrueif this branch is a local branch,falseotherwise.booleanisMainBranch()voidrename(java.lang.String newName)Deprecated.As of 4.4 usesetName(String).voidsetName(java.lang.String name)- 
Methods inherited from interface org.eclipse.emf.cdo.common.branch.CDOBranchPointgetBranch, getTimeStamp
 - 
Methods inherited from interface org.eclipse.core.runtime.IAdaptablegetAdapter
 
- 
 
- 
- 
- 
Field Detail- 
MAIN_BRANCH_IDstatic final int MAIN_BRANCH_ID The fixed ID of themain branch.- See Also:
- Constant Field Values
 
 - 
MAIN_BRANCH_NAMEstatic final java.lang.String MAIN_BRANCH_NAME The fixed name of themain branch.- See Also:
- Constant Field Values
 
 - 
PATH_SEPARATORstatic final java.lang.String PATH_SEPARATOR The string used to separate the segments of branch paths.
 
- 
 - 
Method Detail- 
isMainBranchboolean isMainBranch() 
 - 
isLocalboolean isLocal() 
 - 
isDeletedboolean isDeleted() Returnstrueif this branch has is deleted,falseotherwise.- Since:
- 4.15
 
 - 
getIDint getID() Returns the ID of this branch.The main branchhas the fixed ID 0 (zero),Local brancheshave negative IDs and normal branches have positive IDs.
 - 
getNamejava.lang.String getName() Returns the name of this branch as specified when it was created withcreateBranch()orMAIN_BRANCH_NAMEif this branch is themain branch.- Specified by:
- getNamein interface- CDONameProvider
 
 - 
setNamevoid setName(java.lang.String name) - Since:
- 4.4
 
 - 
getPathNamejava.lang.String getPathName() Returns the fully qualified path name of this branch, a concatenation of the names of all branches from themain branchto this branch, separated byslashes("/" characters). Example: "MAIN/team1/smith".
 - 
getBasePathCDOBranchPoint[] getBasePath() Returns an array of thebasebranch points starting from the base of themain branchdown to and including the base of this branch.
 - 
getBaseCDOBranchPoint getBase() Returns the immutable base branch point of this branch, the point in the parent branch that marks the creation of this branch.The base of the main branchmarks the creation of therepository.- See Also:
- getHead(),- getPoint(long)
 
 - 
getHeadCDOBranchPoint getHead() Returns the floating end point of this branch, a pair of this branch and the fixed special time stampunspecified.- See Also:
- getBase(),- getPoint(long)
 
 - 
getPointCDOBranchPoint getPoint(long timeStamp) Returns the branch point in this branch with the given time stamp.This factory method never returns null.- See Also:
- getBase(),- getHead(),- getVersion(int)
 
 - 
getVersionCDOBranchVersion getVersion(int version) Returns the branch version in this branch with the given version number.This factory method never returns null.- See Also:
- getPoint(long)
 
 - 
getBranchManagerCDOBranchManager getBranchManager() Returns the branch manager that manages this branch, nevernull.
 - 
getBranchesCDOBranch[] getBranches() Returns an array of the sub branches of this branch, nevernull.
 - 
getBranchCDOBranch getBranch(java.lang.String path) Returns the sub branch of this branch with the given relative path, ornullif no sub branch with this path exists in this branch.The path name is the concatenation of the names of all branches from a direct sub branch of this branch, separated by slashes("/" characters). Example: "team1/smith".
 - 
createBranchCDOBranch createBranch(java.lang.String name, long timeStamp) Creates a sub branch of this branch with the given name,basedat thebranch pointin this branch with the given time stamp.- Parameters:
- name- The name of the sub branch to be created. It must not contain the- path separatorcharacter (slash).
- timeStamp- The time stamp in this branch that the sub branch to be created is supposed to be- based at. It must not be before the base time stamp of this branch and it must be different from the fixed special time stamp- unspecified
- See Also:
- createBranch(String)
 
 - 
createBranchCDOBranch createBranch(java.lang.String name) Creates a sub branch of this branch with the given name,basedat thecurrent time.
 - 
deleteCDOBranch[] delete(org.eclipse.net4j.util.om.monitor.OMMonitor monitor) Deletes this branch and all its sub branches.- Returns:
- an array of the ids of all deleted branches in top-down order.
- Since:
- 4.15
 
 - 
fireDeletedEventvoid fireDeletedEvent() - Since:
- 4.15
 
 - 
rename@Deprecated void rename(java.lang.String newName) Deprecated.As of 4.4 usesetName(String).Renames this branch with the given new name.- Since:
- 4.3
 
 
- 
 
-