1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
/**
* Copyright (c) 2004 - 2010 Eike Stepper (Berlin, Germany) and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Eike Stepper - initial API and implementation
*/
package org.eclipse.emf.spi.cdo;
import org.eclipse.emf.cdo.CDOObject;
import org.eclipse.emf.cdo.CDOState;
import org.eclipse.emf.cdo.common.id.CDOID;
import org.eclipse.emf.cdo.common.id.CDOIDAndVersion;
import org.eclipse.emf.cdo.common.id.CDOIDProvider;
import org.eclipse.emf.cdo.common.revision.CDORevisionKey;
import org.eclipse.emf.cdo.eresource.impl.CDOResourceImpl;
import org.eclipse.emf.cdo.spi.common.revision.InternalCDORevision;
import org.eclipse.emf.cdo.view.CDOFeatureAnalyzer;
import org.eclipse.emf.cdo.view.CDOView;
import org.eclipse.emf.internal.cdo.CDOStore;
import org.eclipse.net4j.util.concurrent.IRWLockManager.LockType;
import org.eclipse.net4j.util.lifecycle.ILifecycle;
import org.eclipse.emf.common.notify.Adapter;
import org.eclipse.emf.ecore.EObject;
import java.util.List;
import java.util.Map;
import java.util.concurrent.locks.ReentrantLock;
/**
* @author Eike Stepper
* @since 2.0
*/
public interface InternalCDOView extends CDOView, CDOIDProvider, ILifecycle
{
public void setViewID(int viewId);
public InternalCDOSession getSession();
public void setSession(InternalCDOSession session);
public InternalCDOViewSet getViewSet();
public void setViewSet(InternalCDOViewSet viewSet);
public CDOFeatureAnalyzer getFeatureAnalyzer();
public void setFeatureAnalyzer(CDOFeatureAnalyzer featureAnalyzer);
public CDOStore getStore();
public InternalCDOTransaction toTransaction();
public void attachResource(CDOResourceImpl resource);
/**
* @since 3.0
*/
public void handleObjectStateChanged(InternalCDOObject object, CDOState oldState, CDOState newState);
/**
* @since 3.0
*/
public void invalidate(long lastUpdateTime, List<CDORevisionKey> allChangedObjects,
List<CDOIDAndVersion> allDetachedObjects, Map<CDOID, InternalCDORevision> oldRevisions);
/**
* @since 3.0
*/
public void collectViewedRevisions(Map<CDOID, InternalCDORevision> revisions);
public void remapObject(CDOID oldID);
public CDOID getResourceNodeID(String path);
public void registerProxyResource(CDOResourceImpl resource);
public void registerObject(InternalCDOObject object);
public void deregisterObject(InternalCDOObject object);
public InternalCDORevision getRevision(CDOID id, boolean loadOnDemand);
/**
* @since 3.0
*/
public void prefetchRevisions(CDOID id, int depth);
public Object convertObjectToID(Object potentialObject);
public Object convertObjectToID(Object potentialObject, boolean onlyPersistedID);
public Object convertIDToObject(Object potentialID);
/**
* @since 3.0
*/
public boolean isObjectLocked(CDOObject object, LockType lockType, boolean byOthers);
public void handleAddAdapter(InternalCDOObject eObject, Adapter adapter);
public void handleRemoveAdapter(InternalCDOObject eObject, Adapter adapter);
public void subscribe(EObject eObject, Adapter adapter);
public void unsubscribe(EObject eObject, Adapter adapter);
public boolean hasSubscription(CDOID id);
/**
* Each time CDORevision or CDOState of an CDOObject is modified, ensure that no concurrent access is modifying it at
* the same time. Uses {@link InternalCDOView#getStateLock()} to be thread safe.
* <p>
* In the case where {@link CDOObject#cdoRevision()} or {@link CDOObject#cdoState()} is called without using this
* lock, it is not guarantee that the state didn't change immediately after.
* <p>
* <code>
* if (cdoObject.cdoState() != CDOState.PROXY)
* {
* // At this point could be a proxy!
* cdoObject.cdoRevision();
* }
* </code>
* <p>
* The reason were we didn't use {@link CDOView#getLock()} is to not allow the access of that lock to the users since
* it is very critical. Instead of giving this API to the end-users, a better API should be given in the CDOObject to
* give them want they need.
*/
public ReentrantLock getStateLock();
}
|
