Class CDOPushTransaction
- All Implemented Interfaces:
IAdaptable
,CDOBranchPoint
,CDOBranchProvider
,CDOCommonTransaction
,CDOCommonView
,CDOChangeSetDataProvider
,CDOCommitHistory.Provider<CDOObject,
,CDOObjectHistory> CDORevisionProvider
,CDOTimeProvider
,CDOTransaction
,CDOUserTransaction
,CDOUpdatable
,CDOView
,org.eclipse.net4j.util.collection.Closeable
,org.eclipse.net4j.util.container.IContainer<CDOResourceNode>
,org.eclipse.net4j.util.event.INotifier
,org.eclipse.net4j.util.event.INotifier.INotifier2
,org.eclipse.net4j.util.options.IOptionsContainer
,org.eclipse.net4j.util.properties.IPropertiesContainer
transaction
that persists changes to the object graph locally on commit and can later load
these changes and push them to the repository
.- Since:
- 3.0
- Author:
- Eike Stepper
- No Extend
- This interface is not intended to be extended by clients.
- No Instantiate
- This class is not intended to be instantiated by clients.
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.eclipse.emf.cdo.transaction.CDOTransaction
CDOTransaction.CommitResult<T>, CDOTransaction.Options
Nested classes/interfaces inherited from interface org.eclipse.net4j.util.container.IContainer
org.eclipse.net4j.util.container.IContainer.Modifiable<E extends Object>, org.eclipse.net4j.util.container.IContainer.Persistable<E extends Object>, org.eclipse.net4j.util.container.IContainer.Persistence<E extends Object>
Nested classes/interfaces inherited from interface org.eclipse.net4j.util.event.INotifier
org.eclipse.net4j.util.event.INotifier.INotifier2
-
Field Summary
Fields inherited from interface org.eclipse.emf.cdo.common.branch.CDOBranchPoint
INVALID_DATE, UNSPECIFIED_DATE
Fields inherited from interface org.eclipse.emf.cdo.util.CDOUpdatable
NO_TIMEOUT
Fields inherited from interface org.eclipse.emf.cdo.view.CDOView
PROP_LIFECYCLE_EXCEPTION_HANDLER, PROP_TIME_MACHINE_DISABLED
-
Constructor Summary
ConstructorDescriptionCDOPushTransaction
(CDOTransaction delegate) CDOPushTransaction
(CDOTransaction delegate, File file) CDOPushTransaction
(CDOTransaction delegate, File file, boolean reconstructSavepoints) -
Method Summary
Modifier and TypeMethodDescriptionvoid
addListener
(org.eclipse.net4j.util.event.IListener listener) void
addObjectHandler
(CDOObjectHandler handler) void
void
void
close()
commit()
Same ascommit(null)
.commit
(Runnable runnable, int attempts, IProgressMonitor monitor) commit
(Runnable runnable, Predicate<Long> retry, IProgressMonitor monitor) commit
(Runnable runnable, org.eclipse.net4j.util.Predicate<Long> retry, IProgressMonitor monitor) Deprecated.<T> CDOTransaction.CommitResult<T>
commit
(Callable<T> callable, int attempts, IProgressMonitor monitor) <T> CDOTransaction.CommitResult<T>
commit
(Callable<T> callable, Predicate<Long> retry, IProgressMonitor monitor) <T> CDOTransaction.CommitResult<T>
commit
(Callable<T> callable, org.eclipse.net4j.util.Predicate<Long> retry, IProgressMonitor monitor) Deprecated.commit
(IProgressMonitor monitor) Commits the modifications of this transaction to the repository and returns acommit info
object if successful.commitAndClose
(IProgressMonitor monitor, boolean keepOpenAfterCommitProblem) compareRevisions
(CDOBranchPoint source) createBinaryResource
(String path) createQuery
(String language, String queryString) Same ascreateQuery(language, queryString, null)
.createQuery
(String language, String queryString, boolean considerDirtyState) createQuery
(String language, String queryString, Object context) createQuery
(String language, String queryString, Object context, boolean considerDirtyState) createResource
(String path) createResourceFolder
(String path) createResourceURI
(String path) Returns aURI
that can be used inResourceSet.getResource(URI, boolean)
to load the resource with the specified path.static File
createTempFile
(CDOTransaction transaction) createTextResource
(String path) void
disableDurableLocking
(boolean releaseLocks) Disables the storage of all information that's needed toreopen
this view at a later point in time.Enables the storage of all information that's needed toreopen
this view at a later point in time.enableDurableLocking
(boolean enable) Deprecated.getAdapter
(Class adapter) getBinaryResource
(String path) Returns the branch of this branch point, ornull
if this branch point is thebase
of themain branch
.Returns the comment to be used in the next commit operation.getCommitProperty
(String key) Returns the set of objects that are conflicting with remote modifications or an empty set ifCDOTransaction.hasConflict()
returnsfalse
.getFile()
getHistory
(CDOObject object) long
long
Returns the time stamp of the last commit operation.org.eclipse.net4j.util.event.IListener[]
getLockStates
(Collection<CDOID> ids) Get an array oflock states
corresponding to the specified collection ofids
.getLockStates
(Collection<CDOID> ids, boolean loadOnDemand) Get an array oflock states
corresponding to the specified collection ofids
.getLockStatesOfObjects
(Collection<? extends CDOObject> objects) Get an array oflock states
corresponding to the specified collection ofobjects
.Returns the object for the given CDOID.Returns the object for the given CDOID.<T extends EObject>
TgetObject
(T objectFromDifferentView) Takes an object from a (possibly) different view and contextifies it for the usage with this view.getObjects
(Collection<CDOID> ids) Returns the objects with the given CDOIDs.getOrCreateResource
(String path) Returns theprovider
that has opened this view.getResource
(String path) Same asgetResource(String, true)
.getResource
(String path, boolean loadOnDemand) getResourceFolder
(String path) getResourceNode
(String path) Returns the resource node with the given path.Returns theresource set
this view is associated with.getRevision
(CDOID id) Returns the root resource of the repository.Returns thesession
this view was opened by.int
getTextResource
(String path) long
Returns the time stamp of this branch point, or the fixed special time stampunspecified
if this branch point marks thehead
of a branch.getURI()
int
Returns theview set
this view is associated with.boolean
Returnstrue
if this transaction contains local modifications that are conflicting with remote modifications,false
otherwise.boolean
boolean
hasResource
(String path) Returnstrue
if a resource with the given path exists in the repository,false
.importChanges
(InputStream in, boolean reconstructSavepoints) boolean
isClosed()
boolean
isDirty()
Returnstrue
if this transaction is not closed and contains uncommitted changes,false
otherwise.boolean
boolean
isEmpty()
boolean
boolean
boolean
Deprecated.boolean
Deprecated.boolean
boolean
void
lockObjects
(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType, long timeout) Locks the given objects.void
lockObjects
(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType, long timeout, boolean recursive) merge
(CDOBranchPoint source, CDOBranchPoint sourceBase, CDOBranchPoint targetBase, CDOMerger merger) Merges the changes between the given source base point and the given source point into this transaction.merge
(CDOBranchPoint source, CDOBranchPoint sourceBase, CDOMerger merger) Merges the changes between the given source base point and the given source point into this transaction.merge
(CDOBranchPoint source, CDOMerger merger) Merges the changes from the given source point into this transaction and possibly considers previous merges from thatbranch
by inspecting themerge source
information of thecommit history
.Merges the changes from the given source branch into this transaction and possibly considers previous merges from that branch by inspecting themerge source
information of thecommit history
.options()
Returns theoptions
of this view.void
push()
void
push
(IProgressMonitor progressMonitor) queryInstances
(EClass type) Returns a list of the instances of the given type.<T extends EObject>
org.eclipse.net4j.util.collection.CloseableIterator<T>queryInstancesAsync
(EClass type) Returns an iterator over the instances of the given type.<T extends EObject>
org.eclipse.net4j.util.collection.CloseableIterator<T>queryInstancesAsync
(EClass type, boolean exact) Returns an iterator over the instances of the given type.queryResources
(CDOResourceFolder folder, String name, boolean exactMatch) Returns a list of the resources in the given folder with a name equal to or starting with the value of the name parameter.org.eclipse.net4j.util.collection.CloseableIterator<CDOResourceNode>
queryResourcesAsync
(CDOResourceFolder folder, String name, boolean exactMatch) Returns an iterator over the resources in the given folder with a name equal to or starting with the value of the name parameter.queryXRefs
(Set<CDOObject> targetObjects, EReference... sourceReferences) Returns a list ofobject references
that represent the cross references to the specified target objects.queryXRefs
(CDOObject targetObject, EReference... sourceReferences) Returns a list ofobject references
that represent the cross references to the specified target object.org.eclipse.net4j.util.collection.CloseableIterator<CDOObjectReference>
queryXRefsAsync
(Set<CDOObject> targetObjects, EReference... sourceReferences) Returns an iterator over theobject references
that represent the cross references to the specified target objects.void
refreshLockStates
(Consumer<CDOLockState> consumer) Deprecated.int
Deprecated.void
removeListener
(org.eclipse.net4j.util.event.IListener listener) void
removeObjectHandler
(CDOObjectHandler handler) void
void
revertTo
(CDOBranchPoint branchPoint) void
rollback()
boolean
runAfterUpdate
(long updateTime, Runnable runnable) boolean
Same as callingsetBranchPoint(branch, getTimeStamp())
.boolean
setBranch
(CDOBranch branch, IProgressMonitor monitor) Same asCDOView.setBranch(CDOBranch)
withIProgressMonitor
.boolean
setBranchPoint
(CDOBranch branch, long timeStamp) Sets thebranch
and the point in (repository) time this view should refer to.boolean
setBranchPoint
(CDOBranch branch, long timeStamp, IProgressMonitor monitor) Same asCDOView.setBranchPoint(CDOBranch, long)
with aIProgressMonitor
.boolean
setBranchPoint
(CDOBranchPoint branchPoint) Same as callingsetBranchPoint(branchPoint.getBranch(), branchPoint.getTimeStamp())
.boolean
setBranchPoint
(CDOBranchPoint branchPoint, IProgressMonitor monitor) Same as callingCDOView.setBranchPoint(CDOBranchPoint)
with aIProgressMonitor
.void
setCommitComment
(String comment) Sets the comment to be used in the next commit operation.setCommitProperty
(String key, String value) void
setCommittables
(Set<? extends EObject> committables) protected void
setDirty
(boolean dirty) void
setResourcePathCache
(Map<String, CDOID> resourcePathCache) Sets the newmap
to be used as a cache for variousget*Resource*(String path)
methods.Creates a save point in theCDOTransaction
that can be used to roll back a part of the transactionboolean
setTimeStamp
(long timeStamp) Same as callingsetBranchPoint(getBranch(), timeStamp)
.boolean
setTimeStamp
(long timeStamp, IProgressMonitor monitor) Same asCDOView.setTimeStamp(long)
withIProgressMonitor
.void
<V> V
toString()
void
Unlocks all locked objects of this view.void
unlockObjects
(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType) Unlocks the given locked objects of this view.void
unlockObjects
(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType, boolean recursive) void
waitForUpdate
(long updateTime) Blocks the calling thread until a commit operation with the given time stamp (or higher) has occurred.boolean
waitForUpdate
(long updateTime, long timeoutMillis) Blocks the calling thread until a commit operation with the given time stamp (or higher) has occurred or the given timeout has expired.Methods inherited from class org.eclipse.net4j.util.event.Notifier
addUniqueListener, fireEvent, fireEvent, fireEvent, fireThrowable, firstListenerAdded, getNotificationService, hasListener, lastListenerRemoved, listenerAdded, listenerRemoved
-
Constructor Details
-
CDOPushTransaction
- Throws:
IOException
-
CDOPushTransaction
- Throws:
IOException
-
CDOPushTransaction
public CDOPushTransaction(CDOTransaction delegate, File file, boolean reconstructSavepoints) throws IOException - Throws:
IOException
-
-
Method Details
-
getDelegate
-
getFile
-
properties
- Specified by:
properties
in interfaceorg.eclipse.net4j.util.properties.IPropertiesContainer
- Since:
- 4.4
-
isDirty
public boolean isDirty()Description copied from interface:CDOTransaction
Returnstrue
if this transaction is not closed and contains uncommitted changes,false
otherwise.- Specified by:
isDirty
in interfaceCDOTransaction
- Specified by:
isDirty
in interfaceCDOView
- See Also:
-
setDirty
protected void setDirty(boolean dirty) -
commit
Description copied from interface:CDOUserTransaction
Same ascommit(null)
.- Specified by:
commit
in interfaceCDOUserTransaction
- Throws:
CommitException
-
commit
Description copied from interface:CDOUserTransaction
Commits the modifications of this transaction to the repository and returns acommit info
object if successful.Various kinds of problems can cause the commit to fail and not all of them can be avoided by acquiring pessimistic
locks
on the modified objects. In particular you must expect and handlecontainment cycle exceptions
. The following example shows how write robust transactions:CDOTransaction transaction = null; try { transaction = session.openTransaction(); for (;;) { transaction.getViewLock().lock(); try { CDOResource resource = transaction.getResource("/stock/resource1"); // Modify the model here... transaction.commit(); break; } catch (ConcurrentAccessException ex) { transaction.rollback(); } catch (CommitException ex) { throw ex.wrap(); } finally { transaction.getViewLock().unlock(); } } } finally { if (transaction != null) { transaction.close(); } }
Note that the transaction stays functional after a any call to thecommit()
methods. If the transaction is not closed after a commit it can be used to apply additional modifications to the model.- Specified by:
commit
in interfaceCDOUserTransaction
- Throws:
CommitException
-
commit
@Deprecated public <T> CDOTransaction.CommitResult<T> commit(Callable<T> callable, org.eclipse.net4j.util.Predicate<Long> retry, IProgressMonitor monitor) throws ConcurrentAccessException, CommitException, Exception Deprecated.- Specified by:
commit
in interfaceCDOTransaction
- Throws:
ConcurrentAccessException
CommitException
Exception
-
commit
public <T> CDOTransaction.CommitResult<T> commit(Callable<T> callable, Predicate<Long> retry, IProgressMonitor monitor) throws ConcurrentAccessException, CommitException, Exception - Specified by:
commit
in interfaceCDOTransaction
- Throws:
ConcurrentAccessException
CommitException
Exception
-
commit
public <T> CDOTransaction.CommitResult<T> commit(Callable<T> callable, int attempts, IProgressMonitor monitor) throws ConcurrentAccessException, CommitException, Exception - Specified by:
commit
in interfaceCDOTransaction
- Throws:
ConcurrentAccessException
CommitException
Exception
-
commit
@Deprecated public CDOCommitInfo commit(Runnable runnable, org.eclipse.net4j.util.Predicate<Long> retry, IProgressMonitor monitor) throws ConcurrentAccessException, CommitException Deprecated.- Specified by:
commit
in interfaceCDOTransaction
- Throws:
ConcurrentAccessException
CommitException
-
commit
public CDOCommitInfo commit(Runnable runnable, Predicate<Long> retry, IProgressMonitor monitor) throws ConcurrentAccessException, CommitException - Specified by:
commit
in interfaceCDOTransaction
- Throws:
ConcurrentAccessException
CommitException
-
commit
public CDOCommitInfo commit(Runnable runnable, int attempts, IProgressMonitor monitor) throws ConcurrentAccessException, CommitException - Specified by:
commit
in interfaceCDOTransaction
- Throws:
ConcurrentAccessException
CommitException
-
commitAndClose
public CDOCommitInfo commitAndClose(IProgressMonitor monitor, boolean keepOpenAfterCommitProblem) throws CommitException - Specified by:
commitAndClose
in interfaceCDOTransaction
- Throws:
CommitException
-
rollback
public void rollback()- Specified by:
rollback
in interfaceCDOUserTransaction
-
push
- Throws:
CommitException
-
push
- Throws:
CommitException
-
exportChanges
- Specified by:
exportChanges
in interfaceCDOTransaction
- Throws:
IOException
-
importChanges
public CDOSavepoint[] importChanges(InputStream in, boolean reconstructSavepoints) throws IOException - Specified by:
importChanges
in interfaceCDOTransaction
- Throws:
IOException
-
getLastCommitTime
public long getLastCommitTime()- Specified by:
getLastCommitTime
in interfaceCDOTransaction
-
addListener
public void addListener(org.eclipse.net4j.util.event.IListener listener) - Specified by:
addListener
in interfaceorg.eclipse.net4j.util.event.INotifier
- Overrides:
addListener
in classorg.eclipse.net4j.util.event.Notifier
-
removeListener
public void removeListener(org.eclipse.net4j.util.event.IListener listener) - Specified by:
removeListener
in interfaceorg.eclipse.net4j.util.event.INotifier
- Overrides:
removeListener
in classorg.eclipse.net4j.util.event.Notifier
-
hasListeners
public boolean hasListeners()- Specified by:
hasListeners
in interfaceorg.eclipse.net4j.util.event.INotifier
- Overrides:
hasListeners
in classorg.eclipse.net4j.util.event.Notifier
-
getListeners
public org.eclipse.net4j.util.event.IListener[] getListeners()- Specified by:
getListeners
in interfaceorg.eclipse.net4j.util.event.INotifier
- Overrides:
getListeners
in classorg.eclipse.net4j.util.event.Notifier
-
addObjectHandler
- Specified by:
addObjectHandler
in interfaceCDOView
-
addRegistrationHandler
- Specified by:
addRegistrationHandler
in interfaceCDOView
- Since:
- 4.6
-
addTransactionHandler
- Specified by:
addTransactionHandler
in interfaceCDOTransaction
- Since:
- 4.0
-
close
public void close()- Specified by:
close
in interfaceorg.eclipse.net4j.util.collection.Closeable
-
createQuery
Description copied from interface:CDOView
Same ascreateQuery(language, queryString, null)
.- Specified by:
createQuery
in interfaceCDOView
- See Also:
-
createQuery
- Specified by:
createQuery
in interfaceCDOView
- Since:
- 4.0
-
createQuery
- Specified by:
createQuery
in interfaceCDOTransaction
- Since:
- 4.0
-
createQuery
public CDOQuery createQuery(String language, String queryString, Object context, boolean considerDirtyState) - Specified by:
createQuery
in interfaceCDOTransaction
- Since:
- 4.0
-
createResourceFolder
- Specified by:
createResourceFolder
in interfaceCDOTransaction
- Since:
- 4.0
-
createResource
- Specified by:
createResource
in interfaceCDOTransaction
- See Also:
-
isLegacyModeEnabled
Deprecated.- Specified by:
isLegacyModeEnabled
in interfaceCDOView
- See Also:
-
getLastUpdateTime
public long getLastUpdateTime()Description copied from interface:CDOUpdatable
Returns the time stamp of the last commit operation. May not be accurate ifpassive updates
are disabled.- Specified by:
getLastUpdateTime
in interfaceCDOUpdatable
-
waitForUpdate
public void waitForUpdate(long updateTime) Description copied from interface:CDOUpdatable
Blocks the calling thread until a commit operation with the given time stamp (or higher) has occurred.- Specified by:
waitForUpdate
in interfaceCDOUpdatable
- Parameters:
updateTime
- the time stamp of the update to wait for in milliseconds since Unix epoch.
-
waitForUpdate
public boolean waitForUpdate(long updateTime, long timeoutMillis) Description copied from interface:CDOUpdatable
Blocks the calling thread until a commit operation with the given time stamp (or higher) has occurred or the given timeout has expired.- Specified by:
waitForUpdate
in interfaceCDOUpdatable
- Parameters:
updateTime
- the time stamp of the update to wait for in milliseconds since Unix epoch.timeoutMillis
- the maximum number of milliseconds to wait for the update to occur, orCDOUpdatable.NO_TIMEOUT
to wait indefinitely.- Returns:
true
if the specified commit operation has occurred within the given timeout period,false
otherwise.
-
runAfterUpdate
- Specified by:
runAfterUpdate
in interfaceCDOUpdatable
- Since:
- 4.3
-
getConflicts
Description copied from interface:CDOTransaction
Returns the set of objects that are conflicting with remote modifications or an empty set ifCDOTransaction.hasConflict()
returnsfalse
.- Specified by:
getConflicts
in interfaceCDOTransaction
-
getChangeSetData
- Specified by:
getChangeSetData
in interfaceCDOChangeSetDataProvider
- Since:
- 4.0
-
getDetachedObjects
- Specified by:
getDetachedObjects
in interfaceCDOTransaction
-
getDirtyObjects
- Specified by:
getDirtyObjects
in interfaceCDOTransaction
-
getRevision
- Specified by:
getRevision
in interfaceCDORevisionProvider
- Since:
- 4.0
-
getFirstSavepoint
- Specified by:
getFirstSavepoint
in interfaceCDOTransaction
- Since:
- 4.1
-
getLastSavepoint
- Specified by:
getLastSavepoint
in interfaceCDOTransaction
- Specified by:
getLastSavepoint
in interfaceCDOUserTransaction
-
isInvalidationRunnerActive
Deprecated.- Specified by:
isInvalidationRunnerActive
in interfaceCDOView
- Since:
- 4.0
-
isInvalidating
public boolean isInvalidating()- Specified by:
isInvalidating
in interfaceCDOView
- Since:
- 4.7
-
getNewObjects
- Specified by:
getNewObjects
in interfaceCDOTransaction
-
getObjects
Description copied from interface:CDOView
Returns the objects with the given CDOIDs.If objects are missing from the local cache they are loaded from the server in one round-trip.
- Specified by:
getObjects
in interfaceCDOView
- Parameters:
ids
- the collection of CDOIDs that identify the CDOObjects to return.- Returns:
- a map that contains the CDOObjects with the given CDOIDs.
- Since:
- 4.13
-
getObject
Description copied from interface:CDOView
Returns the object for the given CDOID. -
getObject
Description copied from interface:CDOView
Returns the object for the given CDOID.Same as
getObject(id, true)
. -
getObject
Description copied from interface:CDOView
Takes an object from a (possibly) different view and contextifies it for the usage with this view.- If the given object is contained in this view it is returned unmodified.
- If the given object can not be cast to
CDOObject
it is returned unmodified. - If the view of the given object is contained in a different session an
IllegalArgumentException
is thrown. - If
null
is passednull
is returned.
-
getObjectHandlers
- Specified by:
getObjectHandlers
in interfaceCDOView
-
getRegistrationHandlers
- Specified by:
getRegistrationHandlers
in interfaceCDOView
- Since:
- 4.6
-
getOrCreateResource
- Specified by:
getOrCreateResource
in interfaceCDOTransaction
-
getOrCreateResourceFolder
- Specified by:
getOrCreateResourceFolder
in interfaceCDOTransaction
- Since:
- 4.0
-
getResource
public CDOResource getResource(String path, boolean loadOnDemand) throws CDOResourceNodeNotFoundException - Specified by:
getResource
in interfaceCDOView
- Throws:
CDOResourceNodeNotFoundException
- See Also:
-
getResource
Description copied from interface:CDOView
Same asgetResource(String, true)
.- Specified by:
getResource
in interfaceCDOView
- Throws:
CDOResourceNodeNotFoundException
- See Also:
-
getResourceNode
Description copied from interface:CDOView
Returns the resource node with the given path.- Specified by:
getResourceNode
in interfaceCDOView
- Returns:
- never
null
. - Throws:
CDOResourceNodeNotFoundException
-
createTextResource
- Specified by:
createTextResource
in interfaceCDOTransaction
- Since:
- 4.2
-
getOrCreateTextResource
- Specified by:
getOrCreateTextResource
in interfaceCDOTransaction
- Since:
- 4.2
-
createBinaryResource
- Specified by:
createBinaryResource
in interfaceCDOTransaction
- Since:
- 4.2
-
getOrCreateBinaryResource
- Specified by:
getOrCreateBinaryResource
in interfaceCDOTransaction
- Since:
- 4.2
-
getTextResource
- Specified by:
getTextResource
in interfaceCDOView
- Throws:
CDOResourceNodeNotFoundException
- Since:
- 4.2
-
getBinaryResource
- Specified by:
getBinaryResource
in interfaceCDOView
- Throws:
CDOResourceNodeNotFoundException
- Since:
- 4.2
-
getResourceFolder
- Specified by:
getResourceFolder
in interfaceCDOView
- Throws:
CDOResourceNodeNotFoundException
- Since:
- 4.2
-
setResourcePathCache
Description copied from interface:CDOView
Sets the newmap
to be used as a cache for variousget*Resource*(String path)
methods.Can be used to reset/clear the resource path cache by passing a
new HashMap<String, CDOID>()
. Smarter maps could implement a LRU eviction policy to limit the map capacity. Passingnull
disables resource path caching.The default value is
new HashMap<String, CDOID>()
.- Specified by:
setResourcePathCache
in interfaceCDOView
- Since:
- 4.2
- See Also:
-
getResourceSet
Description copied from interface:CDOView
Returns theresource set
this view is associated with.Same as calling getViewSet().getResourceSet().
- Specified by:
getResourceSet
in interfaceCDOView
- See Also:
-
getRevisionDeltas
- Specified by:
getRevisionDeltas
in interfaceCDOTransaction
-
getRootResource
Description copied from interface:CDOView
Returns the root resource of the repository.The root resource is a special resource with only
CDOResourceNodes
in its contents list. You can use it as the main entry into the new resource and folder structure.- Specified by:
getRootResource
in interfaceCDOView
-
getSession
Description copied from interface:CDOView
Returns thesession
this view was opened by.- Specified by:
getSession
in interfaceCDOCommonView
- Specified by:
getSession
in interfaceCDOView
- Returns:
- The session this view was opened by, or
null
if this view is closed. - See Also:
-
Closeable.close()
Closeable.isClosed()
CDOViewContainer.openView()
CDOTransactionContainer.openTransaction()
-
getProvider
Description copied from interface:CDOView
Returns theprovider
that has opened this view.- Specified by:
getProvider
in interfaceCDOView
- Since:
- 4.4
-
createResourceURI
Description copied from interface:CDOView
Returns aURI
that can be used inResourceSet.getResource(URI, boolean)
to load the resource with the specified path.- Specified by:
createResourceURI
in interfaceCDOView
- Since:
- 4.4
-
getTimeStamp
public long getTimeStamp()Description copied from interface:CDOBranchPoint
Returns the time stamp of this branch point, or the fixed special time stampunspecified
if this branch point marks thehead
of a branch.- Specified by:
getTimeStamp
in interfaceCDOBranchPoint
- Specified by:
getTimeStamp
in interfaceCDOTimeProvider
-
getDurableLockingID
- Specified by:
getDurableLockingID
in interfaceCDOCommonView
- Since:
- 4.0
-
getTransactionHandlers
- Specified by:
getTransactionHandlers
in interfaceCDOTransaction
-
getTransactionHandlers1
- Specified by:
getTransactionHandlers1
in interfaceCDOTransaction
- Since:
- 4.0
-
getTransactionHandlers2
- Specified by:
getTransactionHandlers2
in interfaceCDOTransaction
- Since:
- 4.0
-
getSessionID
public int getSessionID()- Specified by:
getSessionID
in interfaceCDOCommonView
- Since:
- 4.1
-
isDurableView
public boolean isDurableView()- Specified by:
isDurableView
in interfaceCDOCommonView
- Since:
- 4.1
-
getLockOwner
- Specified by:
getLockOwner
in interfaceCDOCommonView
- Since:
- 4.15
-
getURI
-
getViewID
public int getViewID()- Specified by:
getViewID
in interfaceCDOCommonView
-
getViewSet
Description copied from interface:CDOView
Returns theview set
this view is associated with.- Specified by:
getViewSet
in interfaceCDOView
- Returns:
- The view set this view is associated with, never
null
. - See Also:
-
getViewLock
- Specified by:
getViewLock
in interfaceCDOView
- Since:
- 4.5
-
syncExec
-
syncExec
-
hasConflict
public boolean hasConflict()Description copied from interface:CDOTransaction
Returnstrue
if this transaction contains local modifications that are conflicting with remote modifications,false
otherwise.- Specified by:
hasConflict
in interfaceCDOTransaction
- Specified by:
hasConflict
in interfaceCDOView
- See Also:
-
hasResource
Description copied from interface:CDOView
Returnstrue
if a resource with the given path exists in the repository,false
. Applies tofile resources
, as well.- Specified by:
hasResource
in interfaceCDOView
- See Also:
-
isClosed
public boolean isClosed()- Specified by:
isClosed
in interfaceorg.eclipse.net4j.util.collection.Closeable
-
isObjectRegistered
Description copied from interface:CDOView
- Specified by:
isObjectRegistered
in interfaceCDOView
-
refreshLockStates
Deprecated.Description copied from interface:CDOView
Refreshes thelock states
of thisview
with the latest states from the repository. If a lock state consumer is passed it is called for each resulting new lock state.- Specified by:
refreshLockStates
in interfaceCDOView
- Since:
- 4.12
-
getLockStates
Description copied from interface:CDOView
Get an array oflock states
corresponding to the specified collection ofids
. If the collection ofids
is empty,lock states
of all objects are returned.- Specified by:
getLockStates
in interfaceCDOView
- Since:
- 4.6
-
getLockStates
Description copied from interface:CDOView
Get an array oflock states
corresponding to the specified collection ofids
. If the collection ofids
is empty,lock states
of all objects are returned.- Specified by:
getLockStates
in interfaceCDOView
-
getLockStatesOfObjects
Description copied from interface:CDOView
Get an array oflock states
corresponding to the specified collection ofobjects
. If the collection ofobjects
is empty,lock states
of all locked objects are returned.- Specified by:
getLockStatesOfObjects
in interfaceCDOView
- Since:
- 4.6
-
lockObjects
public void lockObjects(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType, long timeout) throws InterruptedException Description copied from interface:CDOView
Locks the given objects. Once the objects are locked, they will not be changed remotely or go in conflict state.- Specified by:
lockObjects
in interfaceCDOView
- Throws:
InterruptedException
-
lockObjects
public void lockObjects(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType, long timeout, boolean recursive) throws InterruptedException - Specified by:
lockObjects
in interfaceCDOView
- Throws:
InterruptedException
-
options
Description copied from interface:CDOCommonView
Returns theoptions
of this view.- Specified by:
options
in interfaceCDOCommonView
- Specified by:
options
in interfaceCDOTransaction
- Specified by:
options
in interfaceCDOView
- Specified by:
options
in interfaceorg.eclipse.net4j.util.options.IOptionsContainer
-
queryResources
public List<CDOResourceNode> queryResources(CDOResourceFolder folder, String name, boolean exactMatch) Description copied from interface:CDOView
Returns a list of the resources in the given folder with a name equal to or starting with the value of the name parameter.- Specified by:
queryResources
in interfaceCDOView
- Parameters:
folder
- The folder to search in, ornull
for top level resource nodes.name
- the name or prefix of the resource nodes to return.exactMatch
-true
if the complete name of the resource must match,false
if only a common prefix of the name must match.
-
queryResourcesAsync
public org.eclipse.net4j.util.collection.CloseableIterator<CDOResourceNode> queryResourcesAsync(CDOResourceFolder folder, String name, boolean exactMatch) Description copied from interface:CDOView
Returns an iterator over the resources in the given folder with a name equal to or starting with the value of the name parameter. The underlying query will be executed asynchronously.- Specified by:
queryResourcesAsync
in interfaceCDOView
- Parameters:
folder
- The folder to search in, ornull
for top level resource nodes.name
- the name or prefix of the resource nodes to return.exactMatch
-true
if the complete name of the resource must match,false
if only a common prefix of the name must match.
-
queryInstances
Description copied from interface:CDOView
Returns a list of the instances of the given type.- Specified by:
queryInstances
in interfaceCDOView
- Since:
- 4.3
-
queryInstancesAsync
public <T extends EObject> org.eclipse.net4j.util.collection.CloseableIterator<T> queryInstancesAsync(EClass type) Description copied from interface:CDOView
Returns an iterator over the instances of the given type. The underlying query will be executed asynchronously.- Specified by:
queryInstancesAsync
in interfaceCDOView
- Since:
- 4.3
-
queryInstancesAsync
public <T extends EObject> org.eclipse.net4j.util.collection.CloseableIterator<T> queryInstancesAsync(EClass type, boolean exact) Description copied from interface:CDOView
Returns an iterator over the instances of the given type. The underlying query will be executed asynchronously.- Specified by:
queryInstancesAsync
in interfaceCDOView
- Since:
- 4.6
-
queryXRefs
Description copied from interface:CDOView
Returns a list ofobject references
that represent the cross references to the specified target object.- Specified by:
queryXRefs
in interfaceCDOView
- Parameters:
targetObject
- The target object that referencing objects are requested for. An external target object can be used with the help ofCDOUtil.wrapExternalObject()
.sourceReferences
- The reference features that referencing objects are requested for, or an empty array if all reference features are to be used in the request.- Since:
- 4.0
- See Also:
-
queryXRefs
public List<CDOObjectReference> queryXRefs(Set<CDOObject> targetObjects, EReference... sourceReferences) Description copied from interface:CDOView
Returns a list ofobject references
that represent the cross references to the specified target objects.- Specified by:
queryXRefs
in interfaceCDOView
- Parameters:
targetObjects
- The set of target objects that referencing objects are requested for. External target objects can be used with the help ofCDOUtil.wrapExternalObject()
.sourceReferences
- The reference features that referencing objects are requested for, or an empty array if all reference features are to be used in the request.- See Also:
-
queryXRefsAsync
public org.eclipse.net4j.util.collection.CloseableIterator<CDOObjectReference> queryXRefsAsync(Set<CDOObject> targetObjects, EReference... sourceReferences) Description copied from interface:CDOView
Returns an iterator over theobject references
that represent the cross references to the specified target objects. The underlying query will be executed asynchronously.- Specified by:
queryXRefsAsync
in interfaceCDOView
- Parameters:
targetObjects
- The set of target objects that referencing objects are requested for. External target objects can be used with the help ofCDOUtil.wrapExternalObject()
.sourceReferences
- The reference features that referencing objects are requested for, or an empty array if all reference features are to be used in the request.- See Also:
-
reload
Deprecated.Description copied from interface:CDOView
Reloads the givenobjects
from the repository. -
removeObjectHandler
- Specified by:
removeObjectHandler
in interfaceCDOView
-
removeRegistrationHandler
- Specified by:
removeRegistrationHandler
in interfaceCDOView
- Since:
- 4.6
-
removeTransactionHandler
- Specified by:
removeTransactionHandler
in interfaceCDOTransaction
- Since:
- 4.0
-
revertTo
- Specified by:
revertTo
in interfaceCDOTransaction
- Since:
- 4.15
-
merge
Description copied from interface:CDOTransaction
Merges the changes from the given source branch into this transaction and possibly considers previous merges from that branch by inspecting themerge source
information of thecommit history
.- Specified by:
merge
in interfaceCDOTransaction
- Since:
- 4.6
- See Also:
-
merge
Description copied from interface:CDOTransaction
Merges the changes from the given source point into this transaction and possibly considers previous merges from thatbranch
by inspecting themerge source
information of thecommit history
.- Specified by:
merge
in interfaceCDOTransaction
-
merge
Description copied from interface:CDOTransaction
Merges the changes between the given source base point and the given source point into this transaction.Warning: If the branch of this transaction already contains merges from the given source point range (i.e., if this merge is a "remerge") this method will likely fail. One of the following methods should be used instead:
- Specified by:
merge
in interfaceCDOTransaction
- Since:
- 4.0
-
merge
public CDOChangeSetData merge(CDOBranchPoint source, CDOBranchPoint sourceBase, CDOBranchPoint targetBase, CDOMerger merger) Description copied from interface:CDOTransaction
Merges the changes between the given source base point and the given source point into this transaction.When specifying an adequate target base point this method is able to perform a proper "remerge".
- Specified by:
merge
in interfaceCDOTransaction
- Since:
- 4.6
- See Also:
-
compareRevisions
- Specified by:
compareRevisions
in interfaceCDOView
- Since:
- 4.0
-
getHistory
- Specified by:
getHistory
in interfaceCDOCommitHistory.Provider<CDOObject,
CDOObjectHistory> - Since:
- 4.2
-
getHistory
- Specified by:
getHistory
in interfaceCDOCommitHistory.Provider<CDOObject,
CDOObjectHistory> - Since:
- 4.2
-
setSavepoint
Description copied from interface:CDOUserTransaction
Creates a save point in theCDOTransaction
that can be used to roll back a part of the transactionSave points do not involve the server side, everything is done on the client side.
- Specified by:
setSavepoint
in interfaceCDOTransaction
- Specified by:
setSavepoint
in interfaceCDOUserTransaction
-
unlockObjects
public void unlockObjects()Description copied from interface:CDOView
Unlocks all locked objects of this view.- Specified by:
unlockObjects
in interfaceCDOView
-
unlockObjects
public void unlockObjects(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType) Description copied from interface:CDOView
Unlocks the given locked objects of this view.- Specified by:
unlockObjects
in interfaceCDOView
-
unlockObjects
public void unlockObjects(Collection<? extends CDOObject> objects, org.eclipse.net4j.util.concurrent.IRWLockManager.LockType lockType, boolean recursive) - Specified by:
unlockObjects
in interfaceCDOView
-
enableDurableLocking
Deprecated.UseenableDurableLocking()
instead ordisableDurableLocking(boolean)
, respectively.- Specified by:
enableDurableLocking
in interfaceCDOView
- Since:
- 4.0
-
enableDurableLocking
Description copied from interface:CDOView
Enables the storage of all information that's needed toreopen
this view at a later point in time. This information includes thebranch point
, the user ID of thesession
, whether it's a read-only view or atransaction
and all the locks that are acquired or will be acquired while durable locking is enabled. -
disableDurableLocking
public void disableDurableLocking(boolean releaseLocks) Description copied from interface:CDOView
Disables the storage of all information that's needed toreopen
this view at a later point in time. If such information is stored when this method is called it is removed. Note that locks acquired by this view are only released iftrue
is passed to thereleaseLocks
parameter.- Specified by:
disableDurableLocking
in interfaceCDOView
- Since:
- 4.1
- See Also:
-
isReadOnly
public boolean isReadOnly()- Specified by:
isReadOnly
in interfaceCDOCommonView
-
isHistorical
public boolean isHistorical()- Specified by:
isHistorical
in interfaceCDOCommonView
- Since:
- 4.5
-
getBranch
Description copied from interface:CDOBranchPoint
Returns the branch of this branch point, ornull
if this branch point is thebase
of themain branch
.- Specified by:
getBranch
in interfaceCDOBranchPoint
- Specified by:
getBranch
in interfaceCDOBranchProvider
-
setBranchPoint
Description copied from interface:CDOView
Sets thebranch
and the point in (repository) time this view should refer to.Objects
provided by this view will bevalid
at this time. The special valueUNSPECIFIED_DATE
denotes a "floating view" that always shows the latest state of the repository.- Specified by:
setBranchPoint
in interfaceCDOView
- Returns:
true
if the branch point was changed,false
otherwise.
-
setBranchPoint
Description copied from interface:CDOView
Same asCDOView.setBranchPoint(CDOBranch, long)
with aIProgressMonitor
.- Specified by:
setBranchPoint
in interfaceCDOView
- Since:
- 4.4
-
setBranchPoint
Description copied from interface:CDOView
Same as callingsetBranchPoint(branchPoint.getBranch(), branchPoint.getTimeStamp())
.- Specified by:
setBranchPoint
in interfaceCDOView
-
setBranchPoint
Description copied from interface:CDOView
Same as callingCDOView.setBranchPoint(CDOBranchPoint)
with aIProgressMonitor
.- Specified by:
setBranchPoint
in interfaceCDOView
- Since:
- 4.4
-
setBranch
Description copied from interface:CDOView
Same as callingsetBranchPoint(branch, getTimeStamp())
. -
setBranch
Description copied from interface:CDOView
Same asCDOView.setBranch(CDOBranch)
withIProgressMonitor
. -
setTimeStamp
public boolean setTimeStamp(long timeStamp) Description copied from interface:CDOView
Same as callingsetBranchPoint(getBranch(), timeStamp)
.- Specified by:
setTimeStamp
in interfaceCDOView
-
setTimeStamp
Description copied from interface:CDOView
Same asCDOView.setTimeStamp(long)
withIProgressMonitor
.- Specified by:
setTimeStamp
in interfaceCDOView
- Since:
- 4.4
-
getURIHandler
- Specified by:
getURIHandler
in interfaceCDOView
-
getUnitManager
- Specified by:
getUnitManager
in interfaceCDOView
- Since:
- 4.5
-
getCommitComment
Description copied from interface:CDOTransaction
Returns the comment to be used in the next commit operation.- Specified by:
getCommitComment
in interfaceCDOTransaction
- See Also:
-
setCommitComment
Description copied from interface:CDOTransaction
Sets the comment to be used in the next commit operation.- Specified by:
setCommitComment
in interfaceCDOTransaction
- See Also:
-
getCommitProperty
- Specified by:
getCommitProperty
in interfaceCDOTransaction
-
setCommitProperty
- Specified by:
setCommitProperty
in interfaceCDOTransaction
-
setCommittables
- Specified by:
setCommittables
in interfaceCDOTransaction
- Since:
- 4.0
-
getCommittables
- Specified by:
getCommittables
in interfaceCDOTransaction
- Since:
- 4.0
-
isEmpty
public boolean isEmpty()- Specified by:
isEmpty
in interfaceorg.eclipse.net4j.util.container.IContainer<CDOResourceNode>
- Since:
- 4.2
-
getElements
- Specified by:
getElements
in interfaceorg.eclipse.net4j.util.container.IContainer<CDOResourceNode>
- Since:
- 4.2
-
toString
-
getAdapter
- Specified by:
getAdapter
in interfaceIAdaptable
- Since:
- 4.2
-
createTempFile
- Throws:
IOException
-
enableDurableLocking()
instead ordisableDurableLocking(boolean)
, respectively.