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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
/*******************************************************************************
* Copyright (c) 2006 Cerner Corporation 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:
* Brad Reynolds - initial API and implementation
******************************************************************************/
package org.eclipse.core.databinding.observable;
import java.util.List;
import java.util.Set;
import org.eclipse.core.databinding.observable.list.IListChangeListener;
import org.eclipse.core.databinding.observable.list.IObservableList;
import org.eclipse.core.databinding.observable.list.ObservableList;
import org.eclipse.core.databinding.observable.set.IObservableSet;
import org.eclipse.core.databinding.observable.set.ISetChangeListener;
import org.eclipse.core.databinding.observable.set.ObservableSet;
import org.eclipse.core.internal.databinding.observable.EmptyObservableList;
import org.eclipse.core.internal.databinding.observable.EmptyObservableSet;
import org.eclipse.core.internal.databinding.observable.ProxyObservableSet;
import org.eclipse.core.internal.databinding.observable.UnmodifiableObservableList;
/**
* Contains static methods to operate on or return
* {@link IObservable Observables}.
*
* @since 3.2
*/
public class Observables {
/**
* @param list
* @return list Returns an unmodifiable view of the provided
* <code>list</code>.
*/
public static IObservableList unmodifiableObservableList(
IObservableList list) {
if (list == null) {
throw new IllegalArgumentException(
"Parameter " + list + " was null."); //$NON-NLS-1$ //$NON-NLS-2$
}
return new UnmodifiableObservableList(list);
}
/**
* Returns an empty observable list. The returned list continues to work
* after it has been disposed of and can be disposed of multiple times.
*
* @return an empty observable list.
*/
public static IObservableList emptyObservableList() {
return new EmptyObservableList(Realm.getDefault());
}
/**
* Returns an empty observable list. The returned list continues to work
* after it has been disposed of and can be disposed of multiple times.
*
* @param realm
* @return an empty observable list.
*/
public static IObservableList emptyObservableList(Realm realm) {
return new EmptyObservableList(realm);
}
/**
* Returns an empty observable set. The returned set continues to work after
* it has been disposed of and can be disposed of multiple times.
*
* @param realm
* @return an empty observable set.
*/
public static IObservableSet emptyObservableSet() {
return new EmptyObservableSet(Realm.getDefault());
}
/**
* Returns an empty observable set. The returned set continues to work after
* it has been disposed of and can be disposed of multiple times.
*
* @param realm
* @return an empty observable set.
*/
public static IObservableSet emptyObservableSet(Realm realm) {
return new EmptyObservableSet(realm);
}
/**
* @param realm
* @param set
* @return Returns an observableSet backed by the given set
*/
public static IObservableSet staticObservableSet(Set set) {
return new ObservableSet(Realm.getDefault(), set, Object.class) {
public void addChangeListener(IChangeListener listener) {
}
public void addStaleListener(IStaleListener listener) {
}
public void addSetChangeListener(ISetChangeListener listener) {
}
};
}
/**
* @param realm
* @param set
* @return Returns an observableSet backed by the given set
*/
public static IObservableSet staticObservableSet(Realm realm, Set set) {
return new ObservableSet(realm, set, Object.class) {
public void addChangeListener(IChangeListener listener) {
}
public void addStaleListener(IStaleListener listener) {
}
public void addSetChangeListener(ISetChangeListener listener) {
}
};
}
/**
* Returns an observable set that contains the same elements as the given
* set, and fires the same events as the given set, but can be disposed of
* without disposing of the wrapped set.
*
* @param target
* the set to wrap
* @return a proxy observable set
*/
public static IObservableSet proxyObservableSet(IObservableSet target) {
return new ProxyObservableSet(target);
}
/**
* @param realm
* @param list
* @return an observable list that never fires events
*/
public static IObservableList staticObservableList(List list) {
return staticObservableList(Realm.getDefault(), list);
}
/**
* @param realm
* @param list
* @return an observable list that never fires events
*/
public static IObservableList staticObservableList(Realm realm, List list) {
return new ObservableList(realm, list, Object.class) {
public void addChangeListener(IChangeListener listener) {
}
public void addStaleListener(IStaleListener listener) {
}
public void addListChangeListener(IListChangeListener listener) {
}
};
}
}
|
