Class DelegatingCDORevisionManager

Method Details

• getCache

  public InternalCDORevisionCache getCache()

  Specified by:

  getCache in interface InternalCDORevisionManager

• setCache

  public void setCache(CDORevisionCache cache)

  Specified by:

  setCache in interface InternalCDORevisionManager

  Since:

  4.0

• setFactory

  public void setFactory(CDORevisionFactory factory)

  Specified by:

  setFactory in interface InternalCDORevisionManager

• getFactory

  public CDORevisionFactory getFactory()

  Specified by:

  getFactory in interface InternalCDORevisionManager

• getRevisionLoader

  public InternalCDORevisionManager.RevisionLoader getRevisionLoader()

  Specified by:

  getRevisionLoader in interface InternalCDORevisionManager

• setRevisionLoader

  public void setRevisionLoader(InternalCDORevisionManager.RevisionLoader revisionLoader)

  Specified by:

  setRevisionLoader in interface InternalCDORevisionManager

• getRevisionLocker

  public InternalCDORevisionManager.RevisionLocker getRevisionLocker()

  Specified by:

  getRevisionLocker in interface InternalCDORevisionManager

• setRevisionLocker

  public void setRevisionLocker(InternalCDORevisionManager.RevisionLocker revisionLocker)

  Specified by:

  setRevisionLocker in interface InternalCDORevisionManager

• isSupportingAudits

  public boolean isSupportingAudits()

  Specified by:

  isSupportingAudits in interface InternalCDORevisionManager

  Since:

  4.0

• setSupportingAudits

  public void setSupportingAudits(boolean on)

  Specified by:

  setSupportingAudits in interface InternalCDORevisionManager

  Since:

  4.0

• isSupportingBranches

  public boolean isSupportingBranches()

  Specified by:

  isSupportingBranches in interface InternalCDORevisionManager

• setSupportingBranches

  public void setSupportingBranches(boolean on)

  Specified by:

  setSupportingBranches in interface InternalCDORevisionManager

• addRevision

  @Deprecated public void addRevision(CDORevision revision)

  Deprecated.

  Description copied from interface: CDORevisionCacheAdder

  Adds the given revision to this cache.

  Specified by:

  addRevision in interface CDORevisionCacheAdder

  Specified by:

  addRevision in interface InternalCDORevisionManager

  Since:

  4.0

• internRevision

  public CDORevision internRevision(CDORevision revision)

  Description copied from interface: CDORevisionInterner

  Interns the given revision and returns either the given revision or a revision with the same key that was interned previously.

  The returned revision is only different from the passed revision if this interner contains a previously cached, different revision instance with an equal revision key.

  Specified by:

  internRevision in interface CDORevisionInterner

• containsRevision

  public boolean containsRevision(CDOID id, CDOBranchPoint branchPoint)

  Description copied from interface: CDORevisionManager

  Returns true if the revision cache contains a revision with the given ID at the given branch point (branch + timestamp), false otherwise.

  Specified by:

  containsRevision in interface CDORevisionManager

  See Also:

  • CDORevisionManager.getRevision(CDOID, CDOBranchPoint, int, int, boolean)
  • CDORevisionManager.getRevisions(List, CDOBranchPoint, int, int, boolean)

• containsRevisionByVersion

  public boolean containsRevisionByVersion(CDOID id, CDOBranchVersion branchVersion)

  Description copied from interface: CDORevisionManager

  Returns true if the revision cache contains a revision with the given ID at the given branch version (branch + version), false otherwise.

  Specified by:

  containsRevisionByVersion in interface CDORevisionManager

  See Also:

  • CDORevisionManager.getRevisionByVersion(CDOID, CDOBranchVersion, int, boolean)

• getObjectType

  public EClass getObjectType(CDOID id)

  Description copied from interface: CDORevisionManager

  Returns the type of an object if a revision for that object is in the revision cache, null otherwise.

  Same as calling getObjectType(id, null).

  Specified by:

  getObjectType in interface CDORevisionManager

  See Also:

  • EObject.eClass()
  • CDORevisionManager.getObjectType(CDOID, CDOBranchManager)

• getObjectType

  public EClass getObjectType(CDOID id, CDOBranchManager branchManagerForLoadOnDemand)

  Description copied from interface: CDORevisionManager

  Returns the type of an object.

  If no revision for that object is found in the revision cache the following is tried:

  1. If branchManagerForLoadOnDemand is not null the first revision of the object in the main branch is loaded from the server and its type is returned.
  2. Otherwise (i.e., if branchManagerForLoadOnDemand is null or the object does not exist) null is returned.

  A branch manager is required instead of just a boolean value to specify whether to demand-load or not because this revision manager must be able to access the main branch while demand-loading.

  Specified by:

  getObjectType in interface CDORevisionManager

  See Also:

  • EObject.eClass()
  • CDORevisionManager.getObjectType(CDOID)

• getObjectLifetime

  public CDOBranchPointRange getObjectLifetime(CDOID id, CDOBranchPoint branchPoint)

  Specified by:

  getObjectLifetime in interface CDORevisionManager

• getRevision

  public InternalCDORevision getRevision(CDOID id, CDOBranchPoint branchPoint, CDORevisionManager.Request.Config config)

  Description copied from interface: CDORevisionManager

  Loads revisions using the canonical request configuration.

  Specified by:

  getRevision in interface CDORevisionManager

  Specified by:

  getRevision in interface InternalCDORevisionManager

  Parameters:

  id - the ID of the requested object

  branchPoint - the branch point at which to load the revision

  config - the immutable loading configuration

  Returns:

  the revision, or null if it does not exist or lookup is cache-only and the cache misses

  See Also:

  • for a fluent request API

• getRevision

  public InternalCDORevision getRevision(CDOID id, CDOBranchPoint branchPoint, CDORevisionManager.Request.Config config, SyntheticCDORevision[] synthetics)

  Description copied from interface: InternalCDORevisionManager

  Loads one revision through the canonical configuration-based path.

  Specified by:

  getRevision in interface InternalCDORevisionManager

  Parameters:

  id - the ID of the requested object

  branchPoint - the branch point at which to load the revision

  config - the immutable loading options

  synthetics - an optional array through which a synthetic revision is supplied

  Returns:

  the revision, or null if it does not exist or lookup is cache-only and the cache misses

• getRevisions

  public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, CDORevisionManager.Request.Config config)

  Description copied from interface: CDORevisionManager

  Loads revisions using the canonical request configuration. Options that do not apply to this operation are ignored.

  Specified by:

  getRevisions in interface CDORevisionManager

  Parameters:

  ids - the IDs of the requested objects

  branchPoint - the branch point at which to load the revisions

  config - the immutable loading configuration

  Returns:

  the requested revisions, with null entries for revisions that could not be found

  See Also:

  • for a fluent request API

• getRevisions

  public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, CDORevisionManager.Request.Config config, SyntheticCDORevision[] synthetics)

  Description copied from interface: InternalCDORevisionManager

  Loads revisions through the canonical configuration-based path. Synthetic revisions are a result channel and are deliberately kept separate from the request configuration.

  Specified by:

  getRevisions in interface InternalCDORevisionManager

  Parameters:

  ids - the IDs of the requested objects

  branchPoint - the branch point at which to load the revisions

  config - the immutable loading options

  synthetics - an optional array through which synthetic revisions are supplied

  Returns:

  the requested revisions, with null entries for revisions that could not be found

• getRevisions

  public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, CDORevisionManager.Request.Config config, List<CDORevision> additionalRevisions)

  Description copied from interface: CDORevisionManager

  Loads revisions using the canonical request configuration and collects additionally prefetched revisions in the supplied result channel. Options that do not apply to this operation are ignored.

  Specified by:

  getRevisions in interface CDORevisionManager

  Parameters:

  ids - the IDs of the requested objects

  branchPoint - the branch point at which to load the revisions

  config - the immutable loading configuration

  additionalRevisions - the optional result channel for additionally prefetched revisions

  Returns:

  the requested revisions, with null entries for revisions that could not be found

  See Also:

  • for a fluent request API

• getRevisions

  public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, CDORevisionManager.Request.Config config, SyntheticCDORevision[] synthetics, List<CDORevision> additionalRevisions)

  Description copied from interface: InternalCDORevisionManager

  Loads revisions through the canonical configuration-based path, preserving both result channels separately from the request configuration.

  Specified by:

  getRevisions in interface InternalCDORevisionManager

  Parameters:

  ids - the IDs of the requested objects

  branchPoint - the branch point at which to load the revisions

  config - the immutable loading options

  synthetics - an optional array through which synthetic revisions are supplied

  additionalRevisions - an optional list for revisions prefetched in addition to the requested revisions

  Returns:

  the requested revisions, with null entries for revisions that could not be found

• getRevisionByVersion

  public InternalCDORevision getRevisionByVersion(CDOID id, CDOBranchVersion branchVersion, CDORevisionManager.Request.Config config)

  Description copied from interface: InternalCDORevisionManager

  Loads a revision by version through the canonical configuration-based path.

  Specified by:

  getRevisionByVersion in interface CDORevisionManager

  Specified by:

  getRevisionByVersion in interface InternalCDORevisionManager

  Parameters:

  id - the ID of the requested object

  branchVersion - the branch version at which to load the revision

  config - the immutable loading options

  Returns:

  the revision, or null if it does not exist or lookup is cache-only and the cache misses

  See Also:

  • for a fluent request API

• getBaseRevision

  public InternalCDORevision getBaseRevision(CDORevision revision, CDORevisionManager.Request.Config config)

  Description copied from interface: InternalCDORevisionManager

  Loads the base revision using the canonical configuration-based path.

  Specified by:

  getBaseRevision in interface InternalCDORevisionManager

  Parameters:

  revision - the revision whose base revision is requested

  config - the immutable loading options

  Returns:

  the base revision, or null if it does not exist or lookup is cache-only and the cache misses

• prefetchRevisions

  public void prefetchRevisions(CDOID id, CDOBranchPoint branchPoint, int prefetchDepth, boolean prefetchLockStates, Consumer<CDORevision> consumer)

  Specified by:

  prefetchRevisions in interface InternalCDORevisionManager

• handleRevisions

  public void handleRevisions(EClass eClass, CDOBranch branch, boolean exactBranch, long timeStamp, boolean exactTime, CDORevisionHandler handler)

  Specified by:

  handleRevisions in interface CDORevisionManager

• reviseLatest

  public void reviseLatest(CDOID id, CDOBranch branch)

  Description copied from interface: InternalCDORevisionManager

  Called on client via postCommit when there is no version of detached objects available.

  Specified by:

  reviseLatest in interface InternalCDORevisionManager

• reviseVersion

  public void reviseVersion(CDOID id, CDOBranchVersion branchVersion, long timeStamp)

  Specified by:

  reviseVersion in interface InternalCDORevisionManager

• doActivate

  protected void doActivate() throws Exception

  Overrides:

  doActivate in class org.eclipse.net4j.util.lifecycle.Lifecycle

  Throws:

  Exception

• doDeactivate

  protected void doDeactivate() throws Exception

  Overrides:

  doDeactivate in class org.eclipse.net4j.util.lifecycle.Lifecycle

  Throws:

  Exception

• isDelegatingLifecycle

  protected boolean isDelegatingLifecycle()

• getDelegate

  protected abstract InternalCDORevisionManager getDelegate()

• getBaseRevision

  @Deprecated public InternalCDORevision getBaseRevision(CDORevision revision, int referenceChunk, boolean loadOnDemand)

  Deprecated.

  Specified by:

  getBaseRevision in interface InternalCDORevisionManager

• getRevisionByVersion

  @Deprecated public InternalCDORevision getRevisionByVersion(CDOID id, CDOBranchVersion branchVersion, int referenceChunk, boolean loadOnDemand)

  Deprecated.

  Description copied from interface: CDORevisionManager

  Returns the revision with the given ID at the given branch version (branch + version), optionally demand loading it if it is not already in the cache.

  Prefetching of nested containment levels is not support by this method because the version of a particular revision can not serve as a reasonable baseline criterion for a consistent graph of multiple revisions.

  Specified by:

  getRevisionByVersion in interface CDORevisionManager

  Specified by:

  getRevisionByVersion in interface InternalCDORevisionManager

  Parameters:

  referenceChunk - The number of target IDs to load for each many-valued reference in the returned revision, or CDORevision.UNCHUNKED for all such list elements (IDs).

  loadOnDemand - If the requested revision is not contained in the revision cache it depends on this parameter's value whether the revision is loaded from the server or null is returned.

  See Also:

  • CDORevisionManager.getRevision(CDOID, CDOBranchPoint, int, int, boolean)

• getRevision

  @Deprecated public InternalCDORevision getRevision(CDOID id, CDOBranchPoint branchPoint, int referenceChunk, int prefetchDepth, boolean loadOnDemand)

  Deprecated.

  Description copied from interface: CDORevisionManager

  Returns the revision with the given ID at the given branch point (branch + timestamp), optionally demand loading it if it is not already in the cache.

  Specified by:

  getRevision in interface CDORevisionManager

  Specified by:

  getRevision in interface InternalCDORevisionManager

  Parameters:

  referenceChunk - The number of target IDs to load for each many-valued reference in the returned revision, or CDORevision.UNCHUNKED for all such list elements (IDs).

  prefetchDepth - The number of nested containment levels to load revisions for in one round trip. Use the symbolic constants CDORevision.DEPTH_INFINITE to prefetch all contained revisions or CDORevision.DEPTH_NONE to not prefetch anything. Only the explicitly requested revision is returned by this method. If additional revisions are prefetched they are placed in the revision cache to speed up subsequent calls to this method.

  loadOnDemand - If the requested revision is not contained in the revision cache it depends on this parameter's value whether the revision is loaded from the server or null is returned.

  See Also:

  • CDORevisionManager.getRevisions(List, CDOBranchPoint, int, int, boolean)
  • CDORevisionManager.getRevisionByVersion(CDOID, CDOBranchVersion, int, boolean)

• getRevision

  @Deprecated public InternalCDORevision getRevision(CDOID id, CDOBranchPoint branchPoint, int referenceChunk, int prefetchDepth, boolean loadOnDemand, SyntheticCDORevision[] synthetics)

  Deprecated.

  Specified by:

  getRevision in interface InternalCDORevisionManager

• getRevisions

  @Deprecated public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, int referenceChunk, int prefetchDepth, boolean loadOnDemand)

  Deprecated.

  Description copied from interface: CDORevisionManager

  Returns the revisions with the given IDs at the given branch point (branch + timestamp), optionally demand loading them if they are not already in the cache.

  Specified by:

  getRevisions in interface CDORevisionManager

  Parameters:

  referenceChunk - The number of target IDs to load for each many-valued reference in the returned revisions, or CDORevision.UNCHUNKED for all such list elements (IDs).

  prefetchDepth - The number of nested containment levels to load revisions for in one round trip. Use the symbolic constants CDORevision.DEPTH_INFINITE to prefetch all contained revisions or CDORevision.DEPTH_NONE to not prefetch anything. Only the explicitly requested revisions are returned by this method. If additional revisions are prefetched they are placed in the revision cache to speed up subsequent calls to this method.

  loadOnDemand - If one or more of the requested revisions is/are not contained in the revision cache it depends on this parameter's value whether the revision(s) is/are loaded from the server or null is placed in the list that is returned.

  See Also:

  • CDORevisionManager.getRevision(CDOID, CDOBranchPoint, int, int, boolean)

• getRevisions

  @Deprecated public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, int referenceChunk, int prefetchDepth, boolean loadOnDemand, SyntheticCDORevision[] synthetics)

  Deprecated.

  Specified by:

  getRevisions in interface InternalCDORevisionManager

• getRevisions

  @Deprecated public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, int referenceChunk, int prefetchDepth, boolean prefetchLockStates, boolean loadOnDemand, SyntheticCDORevision[] synthetics)

  Deprecated.

  Specified by:

  getRevisions in interface InternalCDORevisionManager

• getRevisions

  @Deprecated public List<CDORevision> getRevisions(List<CDOID> ids, CDOBranchPoint branchPoint, int referenceChunk, int prefetchDepth, boolean loadOnDemand, List<CDORevision> additionalRevisions)

  Deprecated.

  Description copied from interface: CDORevisionManager

  Returns the revisions with the given IDs at the given branch point (branch + timestamp), optionally demand loading them if they are not already in the cache.

  Specified by:

  getRevisions in interface CDORevisionManager

  Parameters:

  referenceChunk - The number of target IDs to load for each many-valued reference in the returned revisions, or CDORevision.UNCHUNKED for all such list elements (IDs).

  prefetchDepth - The number of nested containment levels to load revisions for in one round trip. Use the symbolic constants CDORevision.DEPTH_INFINITE to prefetch all contained revisions or CDORevision.DEPTH_NONE to not prefetch anything. Only the explicitly requested revisions are returned by this method. If additional revisions are prefetched they are placed in the revision cache to speed up subsequent calls to this method.

  loadOnDemand - If one or more of the requested revisions is/are not contained in the revision cache it depends on this parameter's value whether the revision(s) is/are loaded from the server or null is placed in the list that is returned.

  additionalRevisions - If non-null, a list to add additionally prefetched revisions to.

  Since:

  4.15

  See Also:

  • CDORevisionManager.getRevision(CDOID, CDOBranchPoint, int, int, boolean)