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