author | Claus Gittinger <cg@exept.de> |
Fri, 14 Jun 1996 13:13:01 +0200 | |
changeset 1466 | dc55982da0b8 |
parent 1338 | 72dc10fbe8fd |
child 1467 | 564c8b54aa98 |
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. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
110 |
self error:'object is already registered'. |
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. |
|
1 | 144 |
! |
145 |
||
617 | 146 |
registerChange:anObject |
147 |
"a registered object has changed, create a new phantom" |
|
148 |
||
149 |
|index| |
|
150 |
||
1145
a094d90e11bf
dont use [0] blocks - use 0 constant instead
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
151 |
index := registeredObjects identityIndexOf:anObject ifAbsent:0. |
617 | 152 |
index ~~ 0 ifTrue:[ |
153 |
handleArray at:index put:anObject shallowCopyForFinalization. |
|
154 |
] |
|
155 |
! |
|
156 |
||
1 | 157 |
unregister:anObject |
158 |
"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
|
159 |
should be sent, if we are no more interested in destruction of |
1 | 160 |
anObject (i.e. it no longer holds external resources)." |
161 |
||
162 |
|index| |
|
163 |
||
1338 | 164 |
registeredObjects notNil ifTrue:[ |
165 |
index := registeredObjects identityIndexOf:anObject ifAbsent:0. |
|
166 |
index ~~ 0 ifTrue:[ |
|
167 |
handleArray at:index put:nil. |
|
168 |
registeredObjects at:index put:nil |
|
169 |
] |
|
1 | 170 |
] |
1338 | 171 |
|
172 |
"Modified: 7.5.1996 / 10:45:32 / cg" |
|
1 | 173 |
! ! |
2 | 174 |
|
617 | 175 |
!Registry methodsFor:'dispose handling'! |
176 |
||
177 |
informDispose |
|
178 |
"an instance has been destroyed - look which one it was" |
|
179 |
||
180 |
|phantom |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
181 |
dstIdx "{ Class: SmallInteger }" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
182 |
sz "{ Class: SmallInteger }" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
183 |
tally "{ Class: SmallInteger }" |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
184 |
newObjects newHandles| |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
185 |
|
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
186 |
sz := handleArray size. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
187 |
tally := 0. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
188 |
1 to:sz do:[:index | |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
189 |
(registeredObjects at:index) isNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
190 |
phantom := handleArray at:index. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
191 |
phantom notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
192 |
handleArray at:index put:nil. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
193 |
self informDispose:phantom |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
194 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
195 |
] ifFalse:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
196 |
tally := tally + 1 |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
197 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
198 |
]. |
617 | 199 |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
200 |
sz > 50 ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
201 |
tally < (sz // 2) ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
202 |
"/ shrink |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
203 |
newObjects := WeakArray new:(tally * 3 // 2). |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
204 |
newHandles := Array new:(newObjects size). |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
205 |
|
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
206 |
dstIdx := 1. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
207 |
1 to:sz do:[:index | |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
208 |
(phantom := registeredObjects at:index) notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
209 |
newObjects at:dstIdx put:phantom. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
210 |
newHandles at:dstIdx put:(handleArray at:index). |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
211 |
dstIdx := dstIdx + 1 |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
212 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
213 |
]. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
214 |
|
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
215 |
newObjects watcher:self. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
216 |
registeredObjects := newObjects. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
217 |
handleArray := newHandles. |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
218 |
] |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
219 |
]. |
617 | 220 |
! |
221 |
||
222 |
informDispose:someHandle |
|
223 |
someHandle disposed |
|
224 |
! ! |
|
225 |
||
226 |
!Registry methodsFor:'enumerating'! |
|
227 |
||
228 |
do:aBlock |
|
229 |
"evaluate aBlock for each registered object" |
|
230 |
||
231 |
registeredObjects notNil ifTrue:[ |
|
232 |
registeredObjects nonNilElementsDo:aBlock |
|
233 |
] |
|
234 |
! ! |
|
235 |
||
2 | 236 |
!Registry methodsFor:'restart handling'! |
237 |
||
238 |
update:aParameter |
|
10 | 239 |
aParameter == #earlyRestart ifTrue:[ |
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
240 |
handleArray notNil ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
241 |
handleArray atAllPut:nil |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
242 |
] |
10 | 243 |
]. |
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
244 |
"/ aParameter == #returnFromSnapshot ifTrue:[ |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
245 |
"/ cleanState := true |
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
246 |
"/ ] |
2 | 247 |
! ! |
617 | 248 |
|
630 | 249 |
!Registry class methodsFor:'documentation'! |
250 |
||
251 |
version |
|
1466
dc55982da0b8
shrink weakArray when too sparsely filled
Claus Gittinger <cg@exept.de>
parents:
1338
diff
changeset
|
252 |
^ '$Header: /cvs/stx/stx/libbasic/Registry.st,v 1.26 1996-06-14 11:13:01 cg Exp $' |
630 | 253 |
! ! |