author | Claus Gittinger <cg@exept.de> |
Tue, 18 Jun 1996 17:14:55 +0200 | |
changeset 1479 | 396c633aee65 |
parent 1471 | a85f3257ae88 |
child 1484 | 3f4a4e5c5eb7 |
permissions | -rw-r--r-- |
1 | 1 |
" |
2 |
COPYRIGHT (c) 1993 by Claus Gittinger |
|
217 | 3 |
All Rights Reserved |
1 | 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 |
" |
|
12 |
||
13 |
Object subclass:#Registry |
|
1286 | 14 |
instanceVariableNames:'registeredObjects handleArray cleanState' |
15 |
classVariableNames:'' |
|
16 |
poolDictionaries:'' |
|
17 |
category:'System-Support' |
|
1 | 18 |
! |
19 |
||
20 |
!Registry class methodsFor:'documentation'! |
|
21 |
||
88 | 22 |
copyright |
23 |
" |
|
24 |
COPYRIGHT (c) 1993 by Claus Gittinger |
|
217 | 25 |
All Rights Reserved |
88 | 26 |
|
27 |
This software is furnished under a license and may be used |
|
28 |
only in accordance with the terms of that license and with the |
|
29 |
inclusion of the above copyright notice. This software may not |
|
30 |
be provided or otherwise made available to, or used by, any |
|
31 |
other person. No title to or ownership of the software is |
|
32 |
hereby transferred. |
|
33 |
" |
|
34 |
! |
|
35 |
||
1 | 36 |
documentation |
37 |
" |
|
69 | 38 |
Registries provide an easy interface to using WeakArrays. |
39 |
A class, which wants to be informed of instance-death, can put a created object |
|
159 | 40 |
into a registry. The registry will create a (shallow-)copy of the object, and |
41 |
watch out for death of the original object. When it dies, the copy will |
|
42 |
be sent the #disposed-message. |
|
69 | 43 |
The trick with the shallow copy is especially nice, you can think of it as |
44 |
being the original object which died. |
|
1 | 45 |
|
69 | 46 |
All objects, which keep external resources (such as fileDescriptors, fonts, |
47 |
colormap-entries etc.) should be registered, so that the underlying resource |
|
48 |
can be freed when the object goes away. |
|
1 | 49 |
|
69 | 50 |
Of course, you too can use it to do whatever you need to do in case of the |
51 |
death of an object. |
|
159 | 52 |
|
53 |
Registries use #shallowCopyForFinalization to aquire the copy of the original, |
|
54 |
this can be redefined in registered classes for faster copying |
|
55 |
(typically, not all internal state but only some device handles are needed for |
|
317 | 56 |
finalization). I if the to-be-registered object is large, this method may also |
57 |
return a stub (placeHolder) object. (i.e. there is no need for the copy to be |
|
58 |
of the same class as the original, as long as it implements disposed and frees |
|
59 |
the relevant OS resources ...) |
|
1286 | 60 |
Example uses are found in Form, Color, ExternalStream and Font |
159 | 61 |
|
1286 | 62 |
[author:] |
63 |
Claus Gittinger |
|
64 |
||
65 |
[see also:] |
|
66 |
WeakArray WeakIdentityDictionary WeakIdentitySet |
|
67 |
Font Form Color Cursor ExternalStream |
|
68 |
||
1 | 69 |
" |
70 |
! ! |
|
71 |
||
72 |
!Registry methodsFor:'accessing'! |
|
73 |
||
74 |
contents |
|
75 |
"return the collection of registered objects" |
|
76 |
||
77 |
^ registeredObjects |
|
78 |
! |
|
79 |
||
80 |
register:anObject |
|
81 |
"register anObject, so that a copy of it gets the disposed message |
|
2 | 82 |
when anObject dies (some time in the future)" |
1 | 83 |
|
375 | 84 |
^ self register:anObject as:(anObject shallowCopyForFinalization) |
85 |
! |
|
86 |
||
87 |
register:anObject as:aHandle |
|
88 |
"register anObject, so that I later receive informDispose: with aHandle |
|
89 |
(some time in the future)" |
|
90 |
||
91 |
|newColl newPhantoms |
|
159 | 92 |
size "{ Class: SmallInteger }" |
93 |
index "{ Class: SmallInteger }" |
|
94 |
p| |
|
1 | 95 |
|
96 |
registeredObjects isNil ifTrue:[ |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
97 |
registeredObjects := WeakArray new:10. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
98 |
registeredObjects watcher:self. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
99 |
handleArray := Array basicNew:10. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
100 |
registeredObjects at:1 put:anObject. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
101 |
handleArray at:1 put:aHandle. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
102 |
ObjectMemory addDependent:self. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
103 |
^ self |
1 | 104 |
]. |
105 |
||
1145
a094d90e11bf
dont use [0] blocks - use 0 constant instead
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
106 |
index := registeredObjects identityIndexOf:anObject ifAbsent:0. |
1 | 107 |
index ~~ 0 ifTrue:[ |
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
108 |
"already registered" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
109 |
handleArray at:index put:aHandle. |
1479
396c633aee65
allow registering some object twice (handle as registerChange:)
Claus Gittinger <cg@exept.de>
parents:
1471
diff
changeset
|
110 |
('REGISTRY: object (' , (registeredObjects at:index) printString , ' is already registered') infoPrintCR. |
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
111 |
^ self |
1 | 112 |
]. |
113 |
||
114 |
"search for a free slot, on the fly look for leftovers" |
|
159 | 115 |
index := registeredObjects identityIndexOf:nil startingAt:1. |
116 |
index ~~ 0 ifTrue:[ |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
117 |
"is there a leftover ?" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
118 |
p := handleArray at:index. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
119 |
p notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
120 |
"tell the phantom" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
121 |
handleArray at:index put:nil. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
122 |
self informDispose:p. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
123 |
p := nil. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
124 |
]. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
125 |
registeredObjects at:index put:anObject. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
126 |
handleArray at:index put:aHandle. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
127 |
^ self |
1 | 128 |
]. |
129 |
||
130 |
"no free slot, add at the end" |
|
131 |
||
159 | 132 |
size := registeredObjects size. |
133 |
index := size + 1. |
|
134 |
newColl := WeakArray new:(size * 2). |
|
135 |
newColl replaceFrom:1 to:size with:registeredObjects. |
|
1 | 136 |
registeredObjects := newColl. |
137 |
registeredObjects watcher:self. |
|
159 | 138 |
registeredObjects at:index put:anObject. |
1 | 139 |
|
359 | 140 |
newPhantoms := Array basicNew:(size * 2). |
375 | 141 |
newPhantoms replaceFrom:1 to:size with:handleArray. |
142 |
handleArray := newPhantoms. |
|
143 |
handleArray at:index put:aHandle. |
|
1479
396c633aee65
allow registering some object twice (handle as registerChange:)
Claus Gittinger <cg@exept.de>
parents:
1471
diff
changeset
|
144 |
|
396c633aee65
allow registering some object twice (handle as registerChange:)
Claus Gittinger <cg@exept.de>
parents:
1471
diff
changeset
|
145 |
"Modified: 18.6.1996 / 13:22:13 / cg" |
1 | 146 |
! |
147 |
||
617 | 148 |
registerChange:anObject |
149 |
"a registered object has changed, create a new phantom" |
|
150 |
||
151 |
|index| |
|
152 |
||
1467 | 153 |
registeredObjects isNil ifTrue:[ |
154 |
index := 0 |
|
155 |
] ifFalse:[ |
|
156 |
index := registeredObjects identityIndexOf:anObject ifAbsent:0. |
|
157 |
]. |
|
617 | 158 |
index ~~ 0 ifTrue:[ |
1467 | 159 |
handleArray at:index put:anObject shallowCopyForFinalization. |
160 |
] ifFalse:[ |
|
161 |
self register:anObject |
|
617 | 162 |
] |
1467 | 163 |
|
164 |
"Modified: 14.6.1996 / 15:06:07 / cg" |
|
617 | 165 |
! |
166 |
||
1 | 167 |
unregister:anObject |
168 |
"remove registration of anObject, without telling the phantom; |
|
759
908363ce8a32
interest is written with one 'r' (shame on me)
Claus Gittinger <cg@exept.de>
parents:
630
diff
changeset
|
169 |
should be sent, if we are no more interested in destruction of |
1 | 170 |
anObject (i.e. it no longer holds external resources)." |
171 |
||
172 |
|index| |
|
173 |
||
1338 | 174 |
registeredObjects notNil ifTrue:[ |
175 |
index := registeredObjects identityIndexOf:anObject ifAbsent:0. |
|
176 |
index ~~ 0 ifTrue:[ |
|
177 |
handleArray at:index put:nil. |
|
178 |
registeredObjects at:index put:nil |
|
179 |
] |
|
1 | 180 |
] |
1338 | 181 |
|
182 |
"Modified: 7.5.1996 / 10:45:32 / cg" |
|
1 | 183 |
! ! |
2 | 184 |
|
617 | 185 |
!Registry methodsFor:'dispose handling'! |
186 |
||
187 |
informDispose |
|
188 |
"an instance has been destroyed - look which one it was" |
|
189 |
||
190 |
|phantom |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
191 |
dstIdx "{ Class: SmallInteger }" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
192 |
sz "{ Class: SmallInteger }" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
193 |
tally "{ Class: SmallInteger }" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
194 |
newObjects newHandles| |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
195 |
|
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
196 |
sz := handleArray size. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
197 |
tally := 0. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
198 |
1 to:sz do:[:index | |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
199 |
(registeredObjects at:index) isNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
200 |
phantom := handleArray at:index. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
201 |
phantom notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
202 |
handleArray at:index put:nil. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
203 |
self informDispose:phantom |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
204 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
205 |
] ifFalse:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
206 |
tally := tally + 1 |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
207 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
208 |
]. |
617 | 209 |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
210 |
sz > 50 ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
211 |
tally < (sz // 2) ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
212 |
"/ shrink |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
213 |
newObjects := WeakArray new:(tally * 3 // 2). |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
214 |
newHandles := Array new:(newObjects size). |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
215 |
|
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
216 |
dstIdx := 1. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
217 |
1 to:sz do:[:index | |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
218 |
(phantom := registeredObjects at:index) notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
219 |
newObjects at:dstIdx put:phantom. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
220 |
newHandles at:dstIdx put:(handleArray at:index). |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
221 |
dstIdx := dstIdx + 1 |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
222 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
223 |
]. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
224 |
|
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
225 |
newObjects watcher:self. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
226 |
registeredObjects := newObjects. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
227 |
handleArray := newHandles. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
228 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
229 |
]. |
617 | 230 |
! |
231 |
||
232 |
informDispose:someHandle |
|
233 |
someHandle disposed |
|
234 |
! ! |
|
235 |
||
236 |
!Registry methodsFor:'enumerating'! |
|
237 |
||
238 |
do:aBlock |
|
239 |
"evaluate aBlock for each registered object" |
|
240 |
||
241 |
registeredObjects notNil ifTrue:[ |
|
242 |
registeredObjects nonNilElementsDo:aBlock |
|
243 |
] |
|
244 |
! ! |
|
245 |
||
2 | 246 |
!Registry methodsFor:'restart handling'! |
247 |
||
1471 | 248 |
update:something with:aParameter from:changedObject |
249 |
something == #earlyRestart ifTrue:[ |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
250 |
handleArray notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
251 |
handleArray atAllPut:nil |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
252 |
] |
10 | 253 |
]. |
1471 | 254 |
"/ something == #returnFromSnapshot ifTrue:[ |
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
255 |
"/ cleanState := true |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
256 |
"/ ] |
1471 | 257 |
|
258 |
"Created: 15.6.1996 / 15:24:41 / cg" |
|
2 | 259 |
! ! |
617 | 260 |
|
630 | 261 |
!Registry class methodsFor:'documentation'! |
262 |
||
263 |
version |
|
1479
396c633aee65
allow registering some object twice (handle as registerChange:)
Claus Gittinger <cg@exept.de>
parents:
1471
diff
changeset
|
264 |
^ '$Header: /cvs/stx/stx/libbasic/Registry.st,v 1.29 1996-06-18 15:14:55 cg Exp $' |
630 | 265 |
! ! |