Package org.eclipse.emf.cdo.util
Class CDOUtil
- java.lang.Object
-
- org.eclipse.emf.cdo.util.CDOUtil
-
public final class CDOUtil extends java.lang.ObjectVarious static methods that may help in CDO client applications.- Author:
- Eike Stepper
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringCDO_ANNOTATION_URIstatic java.lang.StringDOCUMENTATION_KEYstatic java.lang.StringPROP_VIEW_CONFIGURATORstatic java.lang.StringPROP_VIEW_CONFIGURATOR_DESCRIPTIONstatic java.lang.StringPROP_VIEW_CONFIGURATOR_TYPE
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static voidcleanStaleReference(EObject eObject, EStructuralFeature eFeature)static voidcleanStaleReference(EObject eObject, EStructuralFeature eFeature, int index)static voidconfigureView(CDOView view)static CDOBranchcreateBranch(CDOBranchPoint base, java.lang.String name)static CDOCollectionLoadingPolicycreateCollectionLoadingPolicy(int initialChunkSize, int resolveChunkSize)static CDOFeatureAnalyzercreateModelBasedFeatureAnalyzer()static CDORevisionPrefetchingPolicycreateRevisionPrefetchingPolicy(int chunkSize)static CDOFetchRuleManagercreateThreadLocalFetchRuleManager()static CDOFeatureAnalyzercreateUIFeatureAnalyzer()static CDOFeatureAnalyzercreateUIFeatureAnalyzer(long maxTimeBetweenOperation)static CDOXATransactioncreateXATransaction(Notifier... notifiers)static <T extends EObject>
EList<T>filterReadables(java.util.Collection<T> collection)static java.lang.StringgetAnnotation(ModelElement modelElement, java.lang.String sourceURI, java.lang.String key)static CDOObjectgetCDOObject(EObject object)static CDOObjectgetCDOObject(EObject object, boolean adaptLegacy)static java.util.List<? extends CDOObject>getCDOObjects(java.util.Collection<? extends EObject> objects)static java.util.List<? extends CDOObject>getCDOObjects(EObject... objects)static java.lang.StringgetDocumentation(ModelElement modelElement)static EObjectgetEObject(EObject object)static java.util.Map<java.lang.String,EObject>getIntrinsicIDToEObjectMap(CDOResource resource)Returns the map used to cache the EObject that is identified by thevalueof its ID feature.static CDOBranchPointRangegetLifetime(CDOObject object)static EList<Resource>getResources(ResourceSet resourceSet)static CDORevisiongetRevisionByVersion(CDOObject object, int version)static CDORevisiongetRevisionByVersion(CDOObject object, CDOBranch branch, int version)static CDOSessiongetSession(java.lang.Object object)static CDOViewgetView(Notifier notifier)static CDOViewgetView(ResourceSet resourceSet, URI uri)static CDOViewSetgetViewSet(Notifier notifier)static CDOXATransactiongetXATransaction(CDOViewSet viewSet)static booleanisCDOObject(EObject object)static booleanisInvalidationRunnerActive()Deprecated.As of 4.0 use CDOView.isInvalidationRunnerActive()static booleanisLegacyModeDefault()Deprecated.As of 4.2 the legacy mode is always enabled.static booleanisLegacyObject(EObject object)static booleanisSessionDirty(CDOSession session)static booleanisStaleObject(java.lang.Object object)static booleanisWritableObject(EObject eObject)Queries whether an object is writable (is permitted to be modified in the current view context).static voidload(EObject eObject, CDOView view)static java.io.InputStreamopenInputStream(CDOLob<?> lob, java.lang.String encoding)static java.io.InputStreamopenInputStream(CDOResourceLeaf leaf)static booleanprepareDynamicEPackage(EPackage startPackage)static booleanregisterResourceFactory(Resource.Factory.Registry registry)static AnnotationsetAnnotation(ModelElement modelElement, java.lang.String sourceURI, java.lang.String key, java.lang.String value)static voidsetCredentialsProvider(URI uri, org.eclipse.net4j.util.security.IPasswordCredentialsProvider provider)static AnnotationsetDocumentation(ModelElement modelElement, java.lang.String value)static voidsetIntrinsicIDToEObjectMap(CDOResource resource, java.util.Map<java.lang.String,EObject> intrinsicIDToEObjectMap)Sets the map used to cache the EObject identified by the value of its ID feature.static voidsetLegacyModeDefault(boolean on)Deprecated.As of 4.2 the legacy mode is always enabled.static voidsetNextViewLock(java.util.concurrent.locks.Lock viewLock)Sets thelockto be used for the next view that is opened in the context of the current thread.static CDOObjectwrapExternalObject(EObject object, CDOView view)
-
-
-
Field Detail
-
PROP_VIEW_CONFIGURATOR
public static final java.lang.String PROP_VIEW_CONFIGURATOR
- Since:
- 4.14
- See Also:
- Constant Field Values
-
PROP_VIEW_CONFIGURATOR_TYPE
public static final java.lang.String PROP_VIEW_CONFIGURATOR_TYPE
- Since:
- 4.14
- See Also:
- Constant Field Values
-
PROP_VIEW_CONFIGURATOR_DESCRIPTION
public static final java.lang.String PROP_VIEW_CONFIGURATOR_DESCRIPTION
- Since:
- 4.14
- See Also:
- Constant Field Values
-
CDO_ANNOTATION_URI
public static final java.lang.String CDO_ANNOTATION_URI
- Since:
- 4.3
- See Also:
- Constant Field Values
-
DOCUMENTATION_KEY
public static final java.lang.String DOCUMENTATION_KEY
- Since:
- 4.3
- See Also:
- Constant Field Values
-
-
Method Detail
-
registerResourceFactory
public static boolean registerResourceFactory(Resource.Factory.Registry registry)
- Since:
- 4.0
-
getIntrinsicIDToEObjectMap
public static java.util.Map<java.lang.String,EObject> getIntrinsicIDToEObjectMap(CDOResource resource)
Returns the map used to cache the EObject that is identified by thevalueof its ID feature.- Returns:
- the map used to cache the EObject that is identified by the value of its ID feature.
- Since:
- 4.2
- See Also:
setIntrinsicIDToEObjectMap(org.eclipse.emf.cdo.eresource.CDOResource, java.util.Map<java.lang.String, org.eclipse.emf.ecore.EObject>)
-
setIntrinsicIDToEObjectMap
public static void setIntrinsicIDToEObjectMap(CDOResource resource, java.util.Map<java.lang.String,EObject> intrinsicIDToEObjectMap)
Sets the map used to cache the EObject identified by the value of its ID feature. This cache is only activated if the map is notnull. The map will be lazily loaded by thegetEObjectByIDmethod. It is up to the client to clear the cache when it becomes invalid, e.g., when the ID of a previously mapped EObject is changed.- Parameters:
intrinsicIDToEObjectMap- the new map ornull.- Since:
- 4.2
- See Also:
getIntrinsicIDToEObjectMap(org.eclipse.emf.cdo.eresource.CDOResource)
-
getSession
public static CDOSession getSession(java.lang.Object object)
- Since:
- 3.0
-
setNextViewLock
public static void setNextViewLock(java.util.concurrent.locks.Lock viewLock)
Sets thelockto be used for the next view that is opened in the context of the current thread.This method is useful, for example, if EMF
adapterscallDisplay.syncExec()in response to CDO notifications. In these cases aDelegableReentrantLockcan be injected into the newview, which does not deadlock when both CDO's invalidation thread and the display thread acquire the view lock.This method involves a
ThreadLocalvariable to avoid method explosion inCDOViewContainerandCDOTransactionContainer. After calling this method make sure to either open a newviewfrom the current thread or callsetNextViewLock(null)to clear theThreadLocalvariable.- Since:
- 4.5
- See Also:
CDOSession.Options.setDelegableViewLockEnabled(boolean)
-
configureView
public static void configureView(CDOView view)
- Since:
- 4.4
-
prepareDynamicEPackage
public static boolean prepareDynamicEPackage(EPackage startPackage)
- Since:
- 2.0
-
createCollectionLoadingPolicy
public static CDOCollectionLoadingPolicy createCollectionLoadingPolicy(int initialChunkSize, int resolveChunkSize)
- Since:
- 2.0
-
createRevisionPrefetchingPolicy
public static CDORevisionPrefetchingPolicy createRevisionPrefetchingPolicy(int chunkSize)
- Since:
- 2.0
-
createThreadLocalFetchRuleManager
public static CDOFetchRuleManager createThreadLocalFetchRuleManager()
- Since:
- 4.1
-
createModelBasedFeatureAnalyzer
public static CDOFeatureAnalyzer createModelBasedFeatureAnalyzer()
- Since:
- 4.1
-
createUIFeatureAnalyzer
public static CDOFeatureAnalyzer createUIFeatureAnalyzer()
- Since:
- 4.1
-
createUIFeatureAnalyzer
public static CDOFeatureAnalyzer createUIFeatureAnalyzer(long maxTimeBetweenOperation)
- Since:
- 4.1
-
createXATransaction
public static CDOXATransaction createXATransaction(Notifier... notifiers)
- Since:
- 4.0
-
getXATransaction
public static CDOXATransaction getXATransaction(CDOViewSet viewSet)
- Since:
- 2.0
-
getViewSet
public static CDOViewSet getViewSet(Notifier notifier)
- Since:
- 4.0
-
getView
public static CDOView getView(ResourceSet resourceSet, URI uri)
- Since:
- 4.4
-
isStaleObject
public static boolean isStaleObject(java.lang.Object object)
- Since:
- 3.0
-
cleanStaleReference
public static void cleanStaleReference(EObject eObject, EStructuralFeature eFeature)
- Since:
- 3.0
-
cleanStaleReference
public static void cleanStaleReference(EObject eObject, EStructuralFeature eFeature, int index)
- Since:
- 3.0
-
wrapExternalObject
public static CDOObject wrapExternalObject(EObject object, CDOView view)
- Since:
- 4.2
-
getCDOObjects
public static java.util.List<? extends CDOObject> getCDOObjects(EObject... objects)
- Since:
- 4.6
-
getCDOObjects
public static java.util.List<? extends CDOObject> getCDOObjects(java.util.Collection<? extends EObject> objects)
- Since:
- 4.6
-
isCDOObject
public static boolean isCDOObject(EObject object)
- Since:
- 4.4
-
createBranch
public static CDOBranch createBranch(CDOBranchPoint base, java.lang.String name)
- Since:
- 4.6
-
filterReadables
public static <T extends EObject> EList<T> filterReadables(java.util.Collection<T> collection)
- Since:
- 4.3
-
getLifetime
public static CDOBranchPointRange getLifetime(CDOObject object)
- Since:
- 4.4
-
getRevisionByVersion
public static CDORevision getRevisionByVersion(CDOObject object, int version)
- Since:
- 2.0
-
getRevisionByVersion
public static CDORevision getRevisionByVersion(CDOObject object, CDOBranch branch, int version)
- Since:
- 3.0
-
getResources
public static EList<Resource> getResources(ResourceSet resourceSet)
- Since:
- 2.0
-
isSessionDirty
public static boolean isSessionDirty(CDOSession session)
- Since:
- 2.0
- See Also:
CDOTransaction
-
isInvalidationRunnerActive
@Deprecated public static boolean isInvalidationRunnerActive()
Deprecated.As of 4.0 use CDOView.isInvalidationRunnerActive()- Since:
- 3.0
-
isWritableObject
public static boolean isWritableObject(EObject eObject)
Queries whether an object is writable (is permitted to be modified in the current view context).- Parameters:
eObject- an object- Returns:
falseif theeObjectis managed by CDO and does not have write permission;true, otherwise- Since:
- 4.3
-
isLegacyObject
public static boolean isLegacyObject(EObject object)
- Since:
- 3.0
-
isLegacyModeDefault
@Deprecated public static boolean isLegacyModeDefault()
Deprecated.As of 4.2 the legacy mode is always enabled.- Since:
- 3.0
-
setLegacyModeDefault
@Deprecated public static void setLegacyModeDefault(boolean on)
Deprecated.As of 4.2 the legacy mode is always enabled.- Since:
- 3.0
-
setCredentialsProvider
public static void setCredentialsProvider(URI uri, org.eclipse.net4j.util.security.IPasswordCredentialsProvider provider)
- Since:
- 4.0
-
getAnnotation
public static java.lang.String getAnnotation(ModelElement modelElement, java.lang.String sourceURI, java.lang.String key)
- Since:
- 4.3
-
setAnnotation
public static Annotation setAnnotation(ModelElement modelElement, java.lang.String sourceURI, java.lang.String key, java.lang.String value)
- Since:
- 4.3
-
getDocumentation
public static java.lang.String getDocumentation(ModelElement modelElement)
- Since:
- 4.3
-
setDocumentation
public static Annotation setDocumentation(ModelElement modelElement, java.lang.String value)
- Since:
- 4.3
-
openInputStream
public static java.io.InputStream openInputStream(CDOResourceLeaf leaf) throws java.io.IOException
- Throws:
java.io.IOException- Since:
- 4.13
-
openInputStream
public static java.io.InputStream openInputStream(CDOLob<?> lob, java.lang.String encoding) throws java.io.IOException
- Throws:
java.io.IOException- Since:
- 4.13
-
-