#REFACTORING by stefan
class: CachingRegistry
comment/format in: #cacheSize:
changed:
#detect:ifNone:
#register:as:
"{ Encoding: utf8 }"
"
COPYRIGHT (c) 1999 by eXept Software AG
All Rights Reserved
This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.
"
"{ Package: 'stx:libbasic' }"
"{ NameSpace: Smalltalk }"
Registry subclass:#CachingRegistry
instanceVariableNames:'keptReferences cacheSize'
classVariableNames:''
poolDictionaries:''
category:'System-Support'
!
!CachingRegistry class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 1999 by eXept Software AG
All Rights Reserved
This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.
"
!
documentation
"
A CachingRegistry behaves generally like a registry;
However, it keeps hard references to the last n registered objects,
preventing them from being garbage collected (and finalized).
This is useful for resources, which do not cost too much memory,
but are expensive to allocate - a special candidate of this kind are
XFonts. With a CachingRegistry, fonts are kept a bit longer alive
and can therefore often be reused - even if temporarily unreferenced.
This is kind of experimental.
[author:]
Claus Gittinger (cg@exept)
[see also:]
[instance variables:]
keptObjects Collection hard referenced objects
cacheSize Integer number of hard references
[class variables:]
"
! !
!CachingRegistry class methodsFor:'instance creation'!
new:cacheSize
^ (super new:cacheSize) cacheSize:cacheSize
! !
!CachingRegistry methodsFor:'enumerating'!
detect:aBlock ifNone:exceptionValue
"... additionaly move it to the front of the LRU chain"
keyArray validElementsDo:[:obj |
(obj ~~ DeletedEntry and:[aBlock value:obj]) ifTrue:[
keptReferences removeIdentical:obj ifAbsent:[].
keptReferences size >= cacheSize ifTrue:[
keptReferences removeFirst.
].
keptReferences addLast:obj.
^ obj
].
].
^ exceptionValue value
! !
!CachingRegistry methodsFor:'private'!
cacheSize:aNumber
keptReferences := OrderedCollection new:aNumber.
cacheSize := aNumber.
! !
!CachingRegistry methodsFor:'registering objects'!
register:anObject as:aHandle
keptReferences removeIdentical:anObject ifAbsent:nil.
aHandle notNil ifTrue:[
keptReferences size >= cacheSize ifTrue:[
keptReferences removeFirst.
].
keptReferences addLast:anObject.
].
super register:anObject as:aHandle.
!
removeKey:anObject ifAbsent:absentBlock
keptReferences removeIdentical:anObject ifAbsent:nil.
super removeKey:anObject ifAbsent:absentBlock.
!
safeRemoveKey:anObject
keptReferences removeIdentical:anObject ifAbsent:nil.
super safeRemoveKey:anObject.
! !
!CachingRegistry class methodsFor:'documentation'!
version
^ '$Header$'
!
version_CVS
^ '$Header$'
! !