blob: 533044166aadcb95a3fea53085a08b0c26bcbfe7 (
plain) (
blame)
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
|
/**
* Copyright (c) 2004 - 2011 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.cdo.common;
import org.eclipse.net4j.util.collection.Closeable;
import org.eclipse.net4j.util.options.IOptions;
import org.eclipse.net4j.util.options.IOptionsContainer;
import org.eclipse.net4j.util.options.IOptionsEvent;
import org.eclipse.net4j.util.security.IUserAware;
/**
* Abstracts the information about CDO sessions that is common to both client and server side.
*
* @author Eike Stepper
* @since 2.0
* @noextend This interface is not intended to be extended by clients.
* @noimplement This interface is not intended to be implemented by clients.
*/
public interface CDOCommonSession extends IUserAware, IOptionsContainer, Closeable
{
public int getSessionID();
public CDOCommonView[] getViews();
public CDOCommonView getView(int viewID);
/**
* Returns the {@link Options options} of this session.
*/
public Options options();
/**
* Encapsulates the configuration options of CDO sessions that are common to both client and server side.
*
* @author Simon McDuff
* @noextend This interface is not intended to be extended by clients.
* @noimplement This interface is not intended to be implemented by clients.
*/
public interface Options extends IOptions
{
/**
* Returns the {@link CDOCommonSession session} of this options object.
*
* @since 4.0
*/
public CDOCommonSession getContainer();
public boolean isPassiveUpdateEnabled();
/**
* Specifies whether objects will be invalidated due by other users changes.
* <p>
* Example:
* <p>
* <code>session.setPassiveUpdateEnabled(false);</code>
* <p>
* By default this property is enabled. If this property is disabled the latest versions of objects can still be
* obtained by calling refresh().
* <p>
* Passive update can be disabled in cases where more performance is needed and/or more control over when objects
* will be refreshed.
* <p>
* When enabled again, a refresh will be automatically performed to be in sync with the server.
*
* @since 3.0
*/
public void setPassiveUpdateEnabled(boolean enabled);
/**
* @since 3.0
*/
public PassiveUpdateMode getPassiveUpdateMode();
/**
* @since 3.0
*/
public void setPassiveUpdateMode(PassiveUpdateMode mode);
/**
* Enumerates the possible {@link CDOCommonSession.Options#getPassiveUpdateMode() passive update modes} of a CDO
* session.
*
* @author Eike Stepper
* @since 3.0
*/
public enum PassiveUpdateMode
{
/**
* This mode delivers change deltas only for change subscriptions, invalidation information for all other objects.
*/
INVALIDATIONS,
/**
* This mode delivers change deltas for all changed objects, whether they have change subscriptions or not.
* Revisions for new objects are not delivered.
*/
CHANGES,
/**
* This mode delivers change deltas for all changed objects, whether they have change subscriptions or not. In
* addition full revisions for new objects are delivered.
*/
ADDITIONS
}
/**
* An {@link IOptionsEvent options event} fired when the {@link PassiveUpdateMode passive update mode} of a CDO
* session has changed.
*
* @author Eike Stepper
* @since 3.0
*/
public interface PassiveUpdateEvent extends IOptionsEvent
{
public boolean getOldEnabled();
public boolean getNewEnabled();
public PassiveUpdateMode getOldMode();
public PassiveUpdateMode getNewMode();
}
}
}
|
