Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/common/revision/CDORevisionManager.html')
-rw-r--r--plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/common/revision/CDORevisionManager.html127
1 files changed, 115 insertions, 12 deletions
diff --git a/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/common/revision/CDORevisionManager.html b/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/common/revision/CDORevisionManager.html
index 2e98809b9f..9136786d2b 100644
--- a/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/common/revision/CDORevisionManager.html
+++ b/plugins/org.eclipse.emf.cdo.doc/javadoc/org/eclipse/emf/cdo/common/revision/CDORevisionManager.html
@@ -112,6 +112,21 @@ Interface CDORevisionManager</H2>
<P>
Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revisions</CODE></A> in a CDO <A HREF="../../../../../../org/eclipse/emf/cdo/common/CDOCommonRepository.html" title="interface in org.eclipse.emf.cdo.common"><CODE>repository</CODE></A> by demand loading
and caching them.
+ <p>
+ Revisions are generally queried by:
+ <p>
+ <ul>
+ <li>their object <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> <b>and</b>
+ <li>their <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranch.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch</CODE></A> plus <b>either</b>:
+ <ul>
+ <li>a timestamp <b>or</b>
+ <li>a version
+ </ul>
+ </ul>
+ <p>
+ If querying by timestamp it's also possible to ask for multiple revisions (identified by a list of object IDs) in one
+ round trip (to the server if this revision manager is contained by a <A HREF="../../../../../../org/eclipse/emf/cdo/common/CDOCommonSession.html" title="interface in org.eclipse.emf.cdo.common"><CODE>session</CODE></A> or to the
+ backend store if it is contained by a <A HREF="../../../../../../org/eclipse/emf/cdo/common/CDOCommonRepository.html" title="interface in org.eclipse.emf.cdo.common"><CODE>repository</CODE></A>.
<P>
<P>
@@ -142,7 +157,9 @@ Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revisio
<A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch">CDOBranchPoint</A>&nbsp;branchPoint)</CODE>
<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns <code>true</code> if the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision cache</CODE></A> contains a <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A>
+ with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch point</CODE></A> (branch + timestamp),
+ <code>false</code> otherwise.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -151,7 +168,9 @@ Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revisio
<A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchVersion.html" title="interface in org.eclipse.emf.cdo.common.branch">CDOBranchVersion</A>&nbsp;branchVersion)</CODE>
<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns <code>true</code> if the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision cache</CODE></A> contains a <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A>
+ with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchVersion.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch version</CODE></A> (branch + version),
+ <code>false</code> otherwise.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -159,7 +178,17 @@ Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revisio
<TD><CODE><B><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getObjectType(org.eclipse.emf.cdo.common.id.CDOID)">getObjectType</A></B>(<A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id">CDOID</A>&nbsp;id)</CODE>
<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#getEClass()"><CODE>type</CODE></A> of an object if a revision for that object is in the revision
+ cache, <code>null</code> otherwise.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>&nbsp;<A HREF="http://download.eclipse.org/modeling/emf/emf/javadoc/2.7.0/org/eclipse/emf/ecore/EClass.html?is-external=true" title="class or interface in org.eclipse.emf.ecore">EClass</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getObjectType(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchManager)">getObjectType</A></B>(<A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id">CDOID</A>&nbsp;id,
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchManager.html" title="interface in org.eclipse.emf.cdo.common.branch">CDOBranchManager</A>&nbsp;branchManagerForLoadOnDemand)</CODE>
+
+<BR>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#getEClass()"><CODE>type</CODE></A> of an object.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -171,7 +200,8 @@ Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revisio
boolean&nbsp;loadOnDemand)</CODE>
<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A> with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch
+ point</CODE></A> (branch + timestamp), optionally demand loading it if it is not already in the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>cache</CODE></A>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -182,7 +212,8 @@ Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revisio
boolean&nbsp;loadOnDemand)</CODE>
<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A> with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchVersion.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch version</CODE></A> (branch + version), optionally demand loading it if it is not already in the
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>cache</CODE></A>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -194,7 +225,8 @@ Provides access to <A HREF="../../../../../../org/eclipse/emf/cdo/common/revisio
boolean&nbsp;loadOnDemand)</CODE>
<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revisions</CODE></A> with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>IDs</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch point</CODE></A> (branch + timestamp), optionally demand loading them if they are not already in the
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>cache</CODE></A>.</TD>
</TR>
</TABLE>
&nbsp;
@@ -215,9 +247,43 @@ getObjectType</H3>
<PRE>
<A HREF="http://download.eclipse.org/modeling/emf/emf/javadoc/2.7.0/org/eclipse/emf/ecore/EClass.html?is-external=true" title="class or interface in org.eclipse.emf.ecore">EClass</A> <B>getObjectType</B>(<A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id">CDOID</A>&nbsp;id)</PRE>
<DL>
+<DD>Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#getEClass()"><CODE>type</CODE></A> of an object if a revision for that object is in the revision
+ cache, <code>null</code> otherwise.
+ <p>
+ Same as calling <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getObjectType(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchManager)"><CODE>getObjectType(id, null)</CODE></A>.
+<P>
<DD><DL>
+<DT><B>See Also:</B><DD><A HREF="http://download.eclipse.org/modeling/emf/emf/javadoc/2.7.0/org/eclipse/emf/ecore/EObject.html?is-external=true#eClass()" title="class or interface in org.eclipse.emf.ecore"><CODE>EObject.eClass()</CODE></A>,
+<A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getObjectType(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchManager)"><CODE>getObjectType(CDOID, CDOBranchManager)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
-<DT><B>Returns:</B><DD>The type of an object if a revision for that object is in the revision cache, <code>null</code> otherwise.</DL>
+<A NAME="getObjectType(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchManager)"><!-- --></A><H3>
+getObjectType</H3>
+<PRE>
+<A HREF="http://download.eclipse.org/modeling/emf/emf/javadoc/2.7.0/org/eclipse/emf/ecore/EClass.html?is-external=true" title="class or interface in org.eclipse.emf.ecore">EClass</A> <B>getObjectType</B>(<A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id">CDOID</A>&nbsp;id,
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchManager.html" title="interface in org.eclipse.emf.cdo.common.branch">CDOBranchManager</A>&nbsp;branchManagerForLoadOnDemand)</PRE>
+<DL>
+<DD>Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#getEClass()"><CODE>type</CODE></A> of an object.
+ <p>
+ If no revision for that object is found in the revision cache the following is tried:
+ <ol>
+ <li>If <code>branchManagerForLoadOnDemand</code> is not <code>null</code> the first revision of the object in the
+ main branch is loaded from the server and its type is returned.
+ <li>Otherwise (i.e., if <code>branchManagerForLoadOnDemand</code> is <code>null</code> or the object does not
+ exist) <code>null</code> is returned.
+ </ol>
+ <p>
+ A <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchManager.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch manager</CODE></A> 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
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchManager.html#getMainBranch()"><CODE>main branch</CODE></A> while demand-loading.
+<P>
+<DD><DL>
+<DT><B>Since:</B></DT>
+ <DD>4.1</DD>
+<DT><B>See Also:</B><DD><A HREF="http://download.eclipse.org/modeling/emf/emf/javadoc/2.7.0/org/eclipse/emf/ecore/EObject.html?is-external=true#eClass()" title="class or interface in org.eclipse.emf.ecore"><CODE>EObject.eClass()</CODE></A>,
+<A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getObjectType(org.eclipse.emf.cdo.common.id.CDOID)"><CODE>getObjectType(CDOID)</CODE></A></DL>
</DD>
</DL>
<HR>
@@ -228,8 +294,13 @@ containsRevision</H3>
boolean <B>containsRevision</B>(<A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id">CDOID</A>&nbsp;id,
<A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch">CDOBranchPoint</A>&nbsp;branchPoint)</PRE>
<DL>
+<DD>Returns <code>true</code> if the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision cache</CODE></A> contains a <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A>
+ with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch point</CODE></A> (branch + timestamp),
+ <code>false</code> otherwise.
+<P>
<DD><DL>
-</DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevision(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchPoint, int, int, boolean)"><CODE>getRevision(CDOID, CDOBranchPoint, int, int, boolean)</CODE></A>,
+<A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevisions(java.util.List, org.eclipse.emf.cdo.common.branch.CDOBranchPoint, int, int, boolean)"><CODE>getRevisions(List, CDOBranchPoint, int, int, boolean)</CODE></A></DL>
</DD>
</DL>
<HR>
@@ -243,8 +314,18 @@ getRevision</H3>
int&nbsp;prefetchDepth,
boolean&nbsp;loadOnDemand)</PRE>
<DL>
+<DD>Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A> with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch
+ point</CODE></A> (branch + timestamp), optionally demand loading it if it is not already in the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>cache</CODE></A>.
+<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>referenceChunk</CODE> - The number of target <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>IDs</CODE></A> to load for each many-valued reference in the returned revision, or
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#UNCHUNKED"><CODE>CDORevision.UNCHUNKED</CODE></A> for all such list elements (IDs).<DD><CODE>prefetchDepth</CODE> - The number of nested containment levels to load revisions for in one round trip. Use the symbolic
+ constants <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#DEPTH_INFINITE"><CODE>CDORevision.DEPTH_INFINITE</CODE></A> to prefetch all contained revisions or
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#DEPTH_NONE"><CODE>CDORevision.DEPTH_NONE</CODE></A> to not prefetch anything. Only the explicitely 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.<DD><CODE>loadOnDemand</CODE> - 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 <code>null</code> is returned.<DT><B>See Also:</B><DD><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevisions(java.util.List, org.eclipse.emf.cdo.common.branch.CDOBranchPoint, int, int, boolean)"><CODE>getRevisions(List, CDOBranchPoint, int, int, boolean)</CODE></A>,
+<A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevisionByVersion(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchVersion, int, boolean)"><CODE>getRevisionByVersion(CDOID, CDOBranchVersion, int, boolean)</CODE></A></DL>
</DD>
</DL>
<HR>
@@ -258,8 +339,18 @@ getRevisions</H3>
int&nbsp;prefetchDepth,
boolean&nbsp;loadOnDemand)</PRE>
<DL>
+<DD>Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revisions</CODE></A> with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>IDs</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchPoint.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch point</CODE></A> (branch + timestamp), optionally demand loading them if they are not already in the
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>cache</CODE></A>.
+<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>referenceChunk</CODE> - The number of target <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>IDs</CODE></A> to load for each many-valued reference in the returned revisions,
+ or <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#UNCHUNKED"><CODE>CDORevision.UNCHUNKED</CODE></A> for all such list elements (IDs).<DD><CODE>prefetchDepth</CODE> - The number of nested containment levels to load revisions for in one round trip. Use the symbolic
+ constants <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#DEPTH_INFINITE"><CODE>CDORevision.DEPTH_INFINITE</CODE></A> to prefetch all contained revisions or
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#DEPTH_NONE"><CODE>CDORevision.DEPTH_NONE</CODE></A> to not prefetch anything. Only the explicitely 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.<DD><CODE>loadOnDemand</CODE> - 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 <code>null</code> is placed in
+ the list that is returned.<DT><B>See Also:</B><DD><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevision(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchPoint, int, int, boolean)"><CODE>getRevision(CDOID, CDOBranchPoint, int, int, boolean)</CODE></A></DL>
</DD>
</DL>
<HR>
@@ -270,8 +361,12 @@ containsRevisionByVersion</H3>
boolean <B>containsRevisionByVersion</B>(<A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id">CDOID</A>&nbsp;id,
<A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchVersion.html" title="interface in org.eclipse.emf.cdo.common.branch">CDOBranchVersion</A>&nbsp;branchVersion)</PRE>
<DL>
+<DD>Returns <code>true</code> if the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision cache</CODE></A> contains a <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A>
+ with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchVersion.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch version</CODE></A> (branch + version),
+ <code>false</code> otherwise.
+<P>
<DD><DL>
-</DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevisionByVersion(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchVersion, int, boolean)"><CODE>getRevisionByVersion(CDOID, CDOBranchVersion, int, boolean)</CODE></A></DL>
</DD>
</DL>
<HR>
@@ -284,8 +379,16 @@ getRevisionByVersion</H3>
int&nbsp;referenceChunk,
boolean&nbsp;loadOnDemand)</PRE>
<DL>
+<DD>Returns the <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>revision</CODE></A> with the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>ID</CODE></A> at the given <A HREF="../../../../../../org/eclipse/emf/cdo/common/branch/CDOBranchVersion.html" title="interface in org.eclipse.emf.cdo.common.branch"><CODE>branch version</CODE></A> (branch + version), optionally demand loading it if it is not already in the
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionCache.html" title="interface in org.eclipse.emf.cdo.common.revision"><CODE>cache</CODE></A>.
+ <p>
+ 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 criterium for a consistent graph of multiple revisions.
+<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>referenceChunk</CODE> - The number of target <A HREF="../../../../../../org/eclipse/emf/cdo/common/id/CDOID.html" title="interface in org.eclipse.emf.cdo.common.id"><CODE>IDs</CODE></A> to load for each many-valued reference in the returned revision, or
+ <A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevision.html#UNCHUNKED"><CODE>CDORevision.UNCHUNKED</CODE></A> for all such list elements (IDs).<DD><CODE>loadOnDemand</CODE> - 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 <code>null</code> is returned.<DT><B>See Also:</B><DD><A HREF="../../../../../../org/eclipse/emf/cdo/common/revision/CDORevisionManager.html#getRevision(org.eclipse.emf.cdo.common.id.CDOID, org.eclipse.emf.cdo.common.branch.CDOBranchPoint, int, int, boolean)"><CODE>getRevision(CDOID, CDOBranchPoint, int, int, boolean)</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->

Back to the top