"{ Encoding: utf8 }"

"

 COPYRIGHT (c) 2006 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:libbasic2' }"

"{ NameSpace: Smalltalk }"

Collection subclass:#SharedCollection

	instanceVariableNames:'accessLock realCollection'

	classVariableNames:''

	poolDictionaries:''

	category:'Collections-Support'

!

!SharedCollection class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 2006 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

"

    Instances of this class provide synchronized access (of multiple processes) 

    to a collection.

    Notice: 

        the message-forwarding is done by catching subclassResponsibility and

        doesNotUnderstand errors.

    For performance, and for more complex operation-atomicy, more messages might need

    an explicit handling. 

    See the implementation of #at: / #at:put: and #size for examples.

    [auhor:]

        Claus Gittinger

    [see also:]

        Semaphore RecursionLock

        SharedQueue

        #synchronized: method in Object.

"

!

examples

"

                                        [exBegin]

        |c|

        c := SharedCollection for:(OrderedCollection new).

        c add:1.

        c add:2.

        c add:3.

        c addAll:#(4 5 6).

        c removeFirst.

        c removeLast.

        c inspect.

                                        [exEnd]

                                        [exBegin]

        |c|

        c := SharedCollection for:(Array new:10).

        c at:1 put:5.

        c replaceFrom:2 to:5 with:#(20 30 40 50).

        c inspect.

                                        [exEnd]

"

! !

!SharedCollection class methodsFor:'instance creation'!

for:aCollection

    "create and return a new shareCollection which protects

     access to aCollection.

     I.e. to return a threadSave accessor on it."

    ^ self new initializeFor:aCollection

    "Modified (comment): / 18-02-2017 / 10:49:03 / cg"

! !

!SharedCollection methodsFor:'accessing'!

synchronizationSemaphore

    ^ accessLock

! !

!SharedCollection methodsFor:'converting'!

asSharedCollection

    ^ self.

! !

!SharedCollection methodsFor:'copying'!

shallowCopy

    "analog to species - copy the real collection"

    ^ accessLock critical:[

        "get a consistent copy"

        realCollection shallowCopy

    ].

    "Modified: / 02-02-2017 / 17:03:55 / stefan"

! !

!SharedCollection methodsFor:'initialization'!

initializeFor:aCollection

    accessLock := RecursionLock name:'SharedCollection'.

    realCollection := aCollection.

    "Modified: / 23-02-2017 / 12:41:45 / stefan"

    "Modified: / 09-08-2017 / 11:59:29 / cg"

! !

!SharedCollection methodsFor:'message forwarding'!

add:anElement

    "add the argument, anObject to the receiver.

     Return the added element."

    ^ accessLock critical:[

        realCollection add:anElement

    ].

    "Modified: / 02-02-2017 / 17:01:08 / stefan"

!

at:index

    ^ accessLock critical:[

        realCollection at:index

    ].

    "Modified: / 02-02-2017 / 17:01:23 / stefan"

!

at:index put:value

    ^ accessLock critical:[

        realCollection at:index put:value

    ].

    "Modified: / 02-02-2017 / 17:01:35 / stefan"

!

do:aBlock

    ^ accessLock critical:[

        realCollection do:aBlock

    ].

    "Created: / 22-11-2010 / 21:01:21 / cg"

    "Modified: / 02-02-2017 / 17:02:00 / stefan"

!

doesNotUnderstand:aMessage

    "catches everything not understood by the collection protocol"

    ^ accessLock critical:[

        aMessage sendTo:realCollection

    ].

    "Modified: / 07-12-2006 / 17:38:30 / cg"

    "Modified: / 02-02-2017 / 17:02:18 / stefan"

!

isEmpty

    ^ accessLock critical:[

        realCollection isEmpty

    ].

    "Created: / 22-11-2010 / 20:59:01 / cg"

    "Modified: / 02-02-2017 / 11:40:56 / stefan"

!

notEmpty

    ^ accessLock critical:[

        realCollection notEmpty

    ].

    "Created: / 22-11-2010 / 20:59:06 / cg"

    "Modified: / 02-02-2017 / 17:00:36 / stefan"

!

remove:someElement ifAbsent:aBlock

    ^ accessLock critical:[

        realCollection remove:someElement ifAbsent:aBlock

    ].

    "Created: / 25-01-2017 / 22:57:32 / stefan"

    "Modified: / 02-02-2017 / 17:00:54 / stefan"

!

removeAllSuchThat:aBlock

    ^ accessLock critical:[

        realCollection removeAllSuchThat:aBlock

    ].

    "Created: / 22-11-2010 / 20:59:27 / cg"

    "Modified: / 02-02-2017 / 17:02:38 / stefan"

!

removeIdentical:someElement ifAbsent:aBlock

    ^ accessLock critical:[

       realCollection removeIdentical:someElement ifAbsent:aBlock

    ].

    "Created: / 22-11-2010 / 21:00:33 / cg"

    "Modified: / 02-02-2017 / 17:02:52 / stefan"

!

size

    ^ accessLock critical:[

        realCollection size

    ].

    "Modified: / 02-02-2017 / 17:03:06 / stefan"

!

subclassResponsibility

    "catches every required message of the collection protocol"

    |msg|

    msg := thisContext sender message.

    ^ accessLock critical:[

        msg sendTo:realCollection

    ].

    "Modified: / 02-02-2017 / 17:03:25 / stefan"

! !

!SharedCollection methodsFor:'queries'!

species

    "returns non shared collection's species"

    ^ realCollection species

! !

!SharedCollection methodsFor:'testing'!

isFixedSize

    "return true if the receiver cannot grow"

    ^ realCollection isFixedSize

! !

!SharedCollection class methodsFor:'documentation'!

version

    ^ '$Header$'

!

version_CVS

    ^ '$Header$'

! !