author | Claus Gittinger <cg@exept.de> |
Tue, 30 Apr 2019 20:07:57 +0200 | |
changeset 4258 | 5fc4985b0d74 |
parent 4177 | 871e7b63f408 |
child 4269 | f2ee0d19a7bc |
permissions | -rw-r--r-- |
4160 | 1 |
"{ Encoding: utf8 }" |
2 |
||
0 | 3 |
" |
6 | 4 |
COPYRIGHT (c) 1992 by Claus Gittinger |
35 | 5 |
All Rights Reserved |
0 | 6 |
|
7 |
This software is furnished under a license and may be used |
|
8 |
only in accordance with the terms of that license and with the |
|
9 |
inclusion of the above copyright notice. This software may not |
|
10 |
be provided or otherwise made available to, or used by, any |
|
11 |
other person. No title to or ownership of the software is |
|
12 |
hereby transferred. |
|
13 |
" |
|
1558
1ae43779327f
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
1366
diff
changeset
|
14 |
"{ Package: 'stx:libview2' }" |
1ae43779327f
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
1366
diff
changeset
|
15 |
|
3520 | 16 |
"{ NameSpace: Smalltalk }" |
17 |
||
0 | 18 |
Object subclass:#Model |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
19 |
instanceVariableNames:'dependents' |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
20 |
classVariableNames:'' |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
21 |
poolDictionaries:'' |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
22 |
category:'Interface-Support-Models' |
0 | 23 |
! |
24 |
||
4079 | 25 |
Query subclass:#ModelUpdateLockedQuery |
26 |
instanceVariableNames:'' |
|
27 |
classVariableNames:'' |
|
28 |
poolDictionaries:'' |
|
29 |
privateIn:Model |
|
30 |
! |
|
31 |
||
353
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
32 |
!Model class methodsFor:'documentation'! |
21 | 33 |
|
34 |
copyright |
|
35 |
" |
|
36 |
COPYRIGHT (c) 1992 by Claus Gittinger |
|
35 | 37 |
All Rights Reserved |
0 | 38 |
|
21 | 39 |
This software is furnished under a license and may be used |
40 |
only in accordance with the terms of that license and with the |
|
41 |
inclusion of the above copyright notice. This software may not |
|
42 |
be provided or otherwise made available to, or used by, any |
|
43 |
other person. No title to or ownership of the software is |
|
44 |
hereby transferred. |
|
45 |
" |
|
46 |
! |
|
0 | 47 |
|
21 | 48 |
documentation |
49 |
" |
|
238 | 50 |
Models are things which represent information models, i.e. something |
51 |
which holds the data for user interface components and on which these operate. |
|
52 |
Basically, instances keep track of which components depend on them and |
|
53 |
inform the dependents of any changes. |
|
54 |
||
55 |
The Model class itself is abstract and not too useful, see subclasses, |
|
56 |
especially, ValueHolder and SelectionInList. |
|
57 |
||
58 |
Notice: |
|
59 |
Actually the Model class is not really needed; since the dependency |
|
60 |
mechanism is inherited by Object, you can take any object as a model. |
|
61 |
However, instances of Model (and subclasses) keep the dependents locally |
|
62 |
in an instance variable; thus speeding up access a bit. |
|
35 | 63 |
|
4062 | 64 |
Model redefines the dependency methods to use non-weak dependencies |
65 |
(in contrast to weak dependencies used by Object). |
|
66 |
||
223 | 67 |
[Instance variables:] |
238 | 68 |
dependents <Collection> those objects which depend on me. |
69 |
To save some storage, a single dependent |
|
70 |
is kept directly here. |
|
71 |
Otherwise, if there are multiple dependents, |
|
72 |
a collection of dependents is held here. |
|
223 | 73 |
|
74 |
[author:] |
|
75 |
Claus Gittinger |
|
238 | 76 |
|
77 |
[see also:] |
|
78 |
ValueHolder SelectionInList |
|
79 |
( introduction to view programming :html: programming/viewintro.html#MVC ) |
|
21 | 80 |
" |
125 | 81 |
! ! |
82 |
||
3520 | 83 |
!Model class methodsFor:'queries'! |
84 |
||
85 |
isAbstract |
|
86 |
^ self == Model |
|
87 |
! ! |
|
88 |
||
1244 | 89 |
!Model methodsFor:'converting'! |
90 |
||
91 |
skippedInLiteralEncoding |
|
4160 | 92 |
"define the inst-slots which are skipped when generating a literalArrayEncoding; |
93 |
(to skip the ones with default values.)" |
|
2681 | 94 |
|
1244 | 95 |
^ OrderedCollection with:#dependents |
4160 | 96 |
|
97 |
"Modified (comment): / 09-08-2018 / 17:17:57 / Claus Gittinger" |
|
1244 | 98 |
! ! |
99 |
||
125 | 100 |
!Model methodsFor:'copying'! |
101 |
||
102 |
postCopy |
|
103 |
"release dependents after copying" |
|
104 |
||
105 |
self dependents:nil |
|
1236
bdd6c63288bd
deepCopy fix (do not copy dependents)
Claus Gittinger <cg@exept.de>
parents:
795
diff
changeset
|
106 |
! |
bdd6c63288bd
deepCopy fix (do not copy dependents)
Claus Gittinger <cg@exept.de>
parents:
795
diff
changeset
|
107 |
|
bdd6c63288bd
deepCopy fix (do not copy dependents)
Claus Gittinger <cg@exept.de>
parents:
795
diff
changeset
|
108 |
skipInstvarIndexInDeepCopy:index |
bdd6c63288bd
deepCopy fix (do not copy dependents)
Claus Gittinger <cg@exept.de>
parents:
795
diff
changeset
|
109 |
"a helper for deepCopy; only indices for which this method returns |
bdd6c63288bd
deepCopy fix (do not copy dependents)
Claus Gittinger <cg@exept.de>
parents:
795
diff
changeset
|
110 |
false are copied in a deep copy." |
bdd6c63288bd
deepCopy fix (do not copy dependents)
Claus Gittinger <cg@exept.de>
parents:
795
diff
changeset
|
111 |
|
3034 | 112 |
^ index == 1 "/ skip dependents |
21 | 113 |
! ! |
0 | 114 |
|
83 | 115 |
!Model methodsFor:'dependents access'! |
0 | 116 |
|
83 | 117 |
addDependent:anObject |
118 |
"make the argument, anObject be a dependent of the receiver" |
|
119 |
||
318
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
120 |
|wasBlocked| |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
121 |
|
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
122 |
wasBlocked := OperatingSystem blockInterrupts. |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
123 |
[ |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
124 |
|deps| |
83 | 125 |
|
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
126 |
deps := dependents. |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
127 |
"/ |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
128 |
"/ store the very first dependent directly in |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
129 |
"/ the dependents instVar |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
130 |
"/ |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
131 |
(deps isNil and:[anObject isCollection not]) ifTrue:[ |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
132 |
dependents := anObject |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
133 |
] ifFalse:[ |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
134 |
"/ |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
135 |
"/ store more dependents in the dependents collection |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
136 |
"/ |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
137 |
deps isCollection ifTrue:[ |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
138 |
deps add:anObject |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
139 |
] ifFalse:[ |
353
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
140 |
deps == anObject ifFalse:[ |
1366 | 141 |
deps isNil ifTrue:[ |
4062 | 142 |
dependents := IdentitySet with:anObject. |
1366 | 143 |
] ifFalse:[ |
4062 | 144 |
dependents := IdentitySet with:deps with:anObject. |
1366 | 145 |
] |
353
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
146 |
] |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
147 |
] |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
148 |
] |
1558
1ae43779327f
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
1366
diff
changeset
|
149 |
] ensure:[ |
318
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
150 |
wasBlocked ifFalse:[ |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
151 |
OperatingSystem unblockInterrupts |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
152 |
] |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
153 |
] |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
154 |
|
4062 | 155 |
"Modified: / 08-01-1997 / 23:40:30 / cg" |
156 |
"Modified (format): / 07-02-2018 / 11:27:16 / stefan" |
|
83 | 157 |
! |
158 |
||
3863 | 159 |
breakDependents |
160 |
"remove all dependencies from the receiver" |
|
161 |
||
162 |
dependents := nil |
|
163 |
||
164 |
"Created: / 08-02-2017 / 00:46:34 / cg" |
|
165 |
! |
|
166 |
||
125 | 167 |
dependents |
771 | 168 |
"return a Collection of dependents" |
125 | 169 |
|
720
b0e0977e1759
dependents now always returns a collection
Claus Gittinger <cg@exept.de>
parents:
353
diff
changeset
|
170 |
dependents isNil ifTrue:[^ #()]. |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
171 |
dependents isCollection ifTrue:[ |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
172 |
^ dependents |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
173 |
]. |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
174 |
^ IdentitySet with:dependents |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
175 |
|
771 | 176 |
"Modified: / 26.1.1998 / 11:18:24 / cg" |
125 | 177 |
! |
178 |
||
4062 | 179 |
dependents:aCollectionOrNil |
125 | 180 |
"set the collection of dependents" |
181 |
||
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
182 |
|dep| |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
183 |
|
4062 | 184 |
aCollectionOrNil size == 1 ifTrue:[ |
185 |
dep := aCollectionOrNil first. |
|
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
186 |
dep isCollection ifFalse:[ |
4062 | 187 |
dependents := dep. |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
188 |
^ self |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
189 |
] |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
190 |
]. |
4062 | 191 |
dependents := aCollectionOrNil |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
192 |
|
4062 | 193 |
"Modified: / 19-04-1996 / 12:23:05 / cg" |
194 |
"Modified: / 07-02-2018 / 12:00:33 / stefan" |
|
125 | 195 |
! |
196 |
||
83 | 197 |
dependentsDo:aBlock |
198 |
"evaluate aBlock for all of my dependents" |
|
199 |
||
200 |
|deps| |
|
201 |
||
202 |
deps := dependents. |
|
203 |
deps notNil ifTrue:[ |
|
2285
d41f74940633
enumerate a copy of the dependents in dependentsDo:
Claus Gittinger <cg@exept.de>
parents:
2052
diff
changeset
|
204 |
deps isCollection ifTrue:[ |
2385
f694c75f4e1a
tuned #dependentsDo: if there is a single dependent
Claus Gittinger <cg@exept.de>
parents:
2285
diff
changeset
|
205 |
deps size == 1 ifTrue:[ |
f694c75f4e1a
tuned #dependentsDo: if there is a single dependent
Claus Gittinger <cg@exept.de>
parents:
2285
diff
changeset
|
206 |
aBlock value:deps anElement |
f694c75f4e1a
tuned #dependentsDo: if there is a single dependent
Claus Gittinger <cg@exept.de>
parents:
2285
diff
changeset
|
207 |
] ifFalse:[ |
f694c75f4e1a
tuned #dependentsDo: if there is a single dependent
Claus Gittinger <cg@exept.de>
parents:
2285
diff
changeset
|
208 |
deps copy do:aBlock |
f694c75f4e1a
tuned #dependentsDo: if there is a single dependent
Claus Gittinger <cg@exept.de>
parents:
2285
diff
changeset
|
209 |
] |
2285
d41f74940633
enumerate a copy of the dependents in dependentsDo:
Claus Gittinger <cg@exept.de>
parents:
2052
diff
changeset
|
210 |
] ifFalse:[ |
d41f74940633
enumerate a copy of the dependents in dependentsDo:
Claus Gittinger <cg@exept.de>
parents:
2052
diff
changeset
|
211 |
aBlock value:deps |
d41f74940633
enumerate a copy of the dependents in dependentsDo:
Claus Gittinger <cg@exept.de>
parents:
2052
diff
changeset
|
212 |
] |
83 | 213 |
] |
214 |
! |
|
215 |
||
216 |
removeDependent:anObject |
|
217 |
"make the argument, anObject be independent of the receiver" |
|
218 |
||
318
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
219 |
|wasBlocked| |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
220 |
|
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
221 |
"/ must do this save from interrupts, since the dependents collection |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
222 |
"/ is possibly accessed from multiple threads. |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
223 |
"/ Used to use #valueUninterruptably here; inlined that code for slightly |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
224 |
"/ faster execution. |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
225 |
|
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
226 |
wasBlocked := OperatingSystem blockInterrupts. |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
227 |
[ |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
228 |
|deps sz dep| |
83 | 229 |
|
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
230 |
deps := dependents. |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
231 |
deps notNil ifTrue:[ |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
232 |
deps isCollection ifTrue:[ |
3781 | 233 |
dep := deps remove:anObject ifAbsent:[]. |
234 |
"if dep is nil, nothing has changed" |
|
235 |
dep notNil ifTrue:[ |
|
236 |
(sz := deps size) == 0 ifTrue:[ |
|
237 |
dependents := nil |
|
238 |
] ifFalse:[ |
|
239 |
sz == 1 ifTrue:[ |
|
240 |
(dep := deps first) isCollection ifFalse:[ |
|
241 |
dependents := dep |
|
242 |
] |
|
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
243 |
] |
3781 | 244 |
]. |
245 |
]. |
|
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
246 |
] ifFalse:[ |
353
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
247 |
deps == anObject ifTrue:[ |
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
248 |
dependents := nil |
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
249 |
] |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
250 |
] |
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
251 |
] |
1558
1ae43779327f
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
1366
diff
changeset
|
252 |
] ensure:[ |
318
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
253 |
wasBlocked ifFalse:[ |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
254 |
OperatingSystem unblockInterrupts |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
255 |
] |
097d70e8163f
use inline interrupt blocking in dependents acces methods.
Claus Gittinger <cg@exept.de>
parents:
238
diff
changeset
|
256 |
] |
163
80f4fe3bcc71
care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents:
153
diff
changeset
|
257 |
|
353
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
258 |
"Modified: 8.1.1997 / 23:41:39 / cg" |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
259 |
! ! |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
260 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
261 |
!Model methodsFor:'dependents access (non weak)'! |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
262 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
263 |
addNonWeakDependent:anObject |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
264 |
"make the argument, anObject be a dependent of the receiver. |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
265 |
Since all dependencies are nonWeak in Model, this is simply |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
266 |
forwarded to addDependent:" |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
267 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
268 |
^ self addDependent:anObject |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
269 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
270 |
"Created: 19.4.1996 / 10:28:53 / cg" |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
271 |
! |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
272 |
|
337
e6642ba7cca9
Rename misspelled "interrest" to "interest".
Stefan Vogel <sv@exept.de>
parents:
318
diff
changeset
|
273 |
interests |
795
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
274 |
"return a Collection of interests - empty if there is none. |
337
e6642ba7cca9
Rename misspelled "interrest" to "interest".
Stefan Vogel <sv@exept.de>
parents:
318
diff
changeset
|
275 |
Here, we use the normal dependents collection for interests." |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
276 |
|
189 | 277 |
^ self dependents |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
278 |
|
795
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
279 |
"Created: / 19.4.1996 / 12:28:23 / cg" |
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
280 |
"Modified: / 14.10.1996 / 22:19:58 / stefan" |
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
281 |
"Modified: / 30.1.1998 / 14:07:43 / cg" |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
282 |
! |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
283 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
284 |
nonWeakDependents |
795
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
285 |
"return a Collection of dependents - empty if there is none. |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
286 |
Since all dependencies are nonWeak in Model, this is a dummy." |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
287 |
|
190 | 288 |
^ self dependents |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
289 |
|
795
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
290 |
"Created: / 19.4.1996 / 10:29:43 / cg" |
f79766570dd7
#nonWeakDependents always returns a collection
Claus Gittinger <cg@exept.de>
parents:
771
diff
changeset
|
291 |
"Modified: / 30.1.1998 / 14:06:17 / cg" |
188
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
292 |
! |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
293 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
294 |
removeNonWeakDependent:anObject |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
295 |
"make the argument, anObject be independent of the receiver. |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
296 |
Since all dependencies are nonWeak in Model, this is simply |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
297 |
forwarded to removeDependent:" |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
298 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
299 |
^ self removeDependent:anObject |
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
300 |
|
38e92ed0e1b9
interrest changes in model (nonWeak stuff)
Claus Gittinger <cg@exept.de>
parents:
163
diff
changeset
|
301 |
"Created: 19.4.1996 / 12:19:40 / cg" |
0 | 302 |
! ! |
303 |
||
4079 | 304 |
!Model methodsFor:'suppressing updates'! |
305 |
||
306 |
isLocked |
|
307 |
"ask the updateLocked query." |
|
308 |
||
309 |
^ ModelUpdateLockedQuery isLocked:self |
|
310 |
! |
|
311 |
||
312 |
withUpdatesLockedDo:aBlock |
|
313 |
"execute aBlock with updates to myself temporarily suppressed, |
|
314 |
(i.e. by answering true to the updateLocked query) |
|
315 |
This is a cooperative interface - i.e. possible updaters MUST |
|
316 |
check me via isLocked, before sending #value" |
|
317 |
||
318 |
ModelUpdateLockedQuery answer:true for:self do:aBlock |
|
319 |
! |
|
320 |
||
321 |
withoutSendingUpdatesDo:aBlock |
|
322 |
"execute aBlock with updates to dependents temporarily suppressed |
|
323 |
(i.e. I will not notify the dependents during aBlock) |
|
324 |
Warning: |
|
325 |
do not change any dependencies inside the block, |
|
326 |
as the original dependencies from before will be restored and such changes |
|
327 |
are lost then." |
|
328 |
||
329 |
|previousDependents| |
|
330 |
||
4177 | 331 |
previousDependents := dependents. |
4079 | 332 |
[ |
333 |
dependents := nil. |
|
334 |
aBlock value |
|
335 |
] ensure:[ |
|
336 |
dependents := previousDependents |
|
337 |
]. |
|
4177 | 338 |
|
339 |
"Modified: / 14-09-2018 / 14:49:47 / Stefan Vogel" |
|
4079 | 340 |
! ! |
341 |
||
342 |
!Model::ModelUpdateLockedQuery class methodsFor:'documentation'! |
|
343 |
||
344 |
documentation |
|
345 |
" |
|
346 |
this query can answer true (ie. ''isLocked'') for a particular model, |
|
347 |
while inside a updating block. |
|
348 |
||
349 |
This is used for temporal blocking models to be changed |
|
350 |
(eg. to prevent cyclic updates). |
|
351 |
||
352 |
A particular application of this is found in input-field + tree selection |
|
353 |
combinations, where entering a new value into the field changes the treeselection, |
|
354 |
and also tree selection changes the input field's value. |
|
355 |
Concrete: take a look at the XMLInspector's xpath field, which triggers a tree |
|
356 |
selection change, but the selection change should not backfire on the field in this |
|
357 |
case, whereas a regular tree-selection will change the field. |
|
358 |
||
359 |
Notice: |
|
360 |
do NOT place the query into the general value: method of Model. |
|
361 |
This is too expensive to be done every time. |
|
362 |
Thus, the related models need to know about the interlocking and |
|
363 |
must do this individually. |
|
364 |
||
365 |
see example |
|
366 |
||
367 |
[author:] |
|
368 |
cg |
|
369 |
||
370 |
[instance variables:] |
|
371 |
||
372 |
[class variables:] |
|
373 |
||
374 |
[see also:] |
|
375 |
||
376 |
" |
|
377 |
! |
|
378 |
||
379 |
example |
|
380 |
" |
|
381 |
|vh1 vh2| |
|
382 |
||
383 |
vh1 := ValueHolder new. |
|
384 |
vh1 onChangeEvaluate:[ |
|
385 |
(vh2 isLocked) ifFalse:[ |
|
386 |
vh2 value: #newValue |
|
387 |
]. |
|
388 |
]. |
|
389 |
||
390 |
vh2 := ValueHolder new. |
|
391 |
vh2 value:#oldValue. |
|
392 |
||
393 |
vh2 withUpdatesLockedDo:[ |
|
394 |
vh1 value:123. |
|
395 |
]. |
|
396 |
||
397 |
because of the lock, the old value should still be there'. |
|
398 |
self assert:(vh2 value == #oldValue) |
|
399 |
" |
|
400 |
! ! |
|
401 |
||
402 |
!Model::ModelUpdateLockedQuery class methodsFor:'handling'! |
|
403 |
||
404 |
answer:aBoolean for:aModel do:aBlock |
|
405 |
"evaluate aBlock, answering aBoolean if asked for the locking status of aModel" |
|
406 |
||
407 |
aBlock |
|
408 |
on:self |
|
409 |
do:[:ex | |
|
410 |
ex proceedWith:(ex parameter == aModel) |
|
411 |
] |
|
412 |
! ! |
|
413 |
||
414 |
!Model::ModelUpdateLockedQuery class methodsFor:'queries'! |
|
415 |
||
416 |
isLocked:aModel |
|
417 |
"asking for the locking status of aModel" |
|
418 |
||
419 |
^ self raiseRequestWith:aModel |
|
420 |
! ! |
|
421 |
||
422 |
!Model::ModelUpdateLockedQuery methodsFor:'defaults'! |
|
423 |
||
424 |
defaultResumeValue |
|
425 |
^ false |
|
426 |
! ! |
|
427 |
||
353
e9071756b6a7
oops - removeDependent: removed the dependent, even if
Claus Gittinger <cg@exept.de>
parents:
337
diff
changeset
|
428 |
!Model class methodsFor:'documentation'! |
129 | 429 |
|
430 |
version |
|
3520 | 431 |
^ '$Header$' |
129 | 432 |
! ! |
3520 | 433 |