WeakInterestConverter.st
author ca
Fri, 04 Jun 2004 15:22:43 +0200
changeset 8371 4493f5ac7405
parent 5273 7fc2109a0ed0
child 9280 0daef192f1af
permissions -rw-r--r--
*** empty log message ***
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5273
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     1
"
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     2
 COPYRIGHT (c) 1997 eXept Software AG
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     3
              All Rights Reserved
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     4
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     5
 This software is furnished under a license and may be used
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     6
 only in accordance with the terms of that license and with the
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     8
 be provided or otherwise made available to, or used by, any
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
     9
 other person.  No title to or ownership of the software is
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    10
 hereby transferred.
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    11
"
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    12
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    13
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    14
2656
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    15
Object subclass:#WeakInterestConverter
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    16
	instanceVariableNames:'destinationHolder selector aspect'
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    17
	classVariableNames:''
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
	poolDictionaries:''
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    19
	category:'Interface-Support-Models'
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    20
!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    21
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    22
!WeakInterestConverter class methodsFor:'documentation'!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    23
5273
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    24
copyright
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    25
"
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    26
 COPYRIGHT (c) 1997 eXept Software AG
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    27
              All Rights Reserved
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    28
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    29
 This software is furnished under a license and may be used
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    30
 only in accordance with the terms of that license and with the
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    32
 be provided or otherwise made available to, or used by, any
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    33
 other person.  No title to or ownership of the software is
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    34
 hereby transferred.
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    35
"
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    36
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    37
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    38
!
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
    39
2656
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    40
documentation
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    41
"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    42
    these are much like InterestConverters; however, the reference to
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    43
    the destination is weak, which allows for them to be garbage collected.
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    44
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    45
    [author:]
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    46
        Claus Gittinger
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    47
"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    48
! !
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    49
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    50
!WeakInterestConverter class methodsFor:'instance creation'!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    51
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    52
destination:anObject selector:aSelector
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    53
    "create & return an interestConverter, which sends aSelector
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    54
     to anObject when a change notification arrives"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    55
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    56
    ^ self basicNew destination:anObject selector:aSelector
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    57
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    58
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    59
!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    60
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    61
destination:anObject selector:aSelector aspect:aspect
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    62
    "create & return an interestConverter, which sends aSelector
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    63
     to anObject when a change notification for aspect arrives"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    64
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    65
    ^ self basicNew destination:anObject selector:aSelector aspect:aspect
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    66
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    67
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    68
! !
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    69
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    70
!WeakInterestConverter methodsFor:'accessing'!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    71
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    72
aspect
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    73
    "return my aspect (if any)"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    74
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    75
    ^ aspect
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    76
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    77
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    78
!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    79
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    80
destination
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    81
    "return my destination"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    82
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    83
    ^ destinationHolder at:1
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    84
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    85
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    86
!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    87
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    88
destination:dest selector:sel
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    89
    "set destination and selector"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    90
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    91
    destinationHolder := WeakArray with:dest.
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    92
    selector := sel
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    93
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    94
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    95
!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    96
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    97
destination:dest selector:sel aspect:a
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    98
    "set destination, selector and aspect"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    99
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   100
    destinationHolder := WeakArray with:dest.
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   101
    selector := sel.
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   102
    aspect := a
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   103
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   104
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   105
! !
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   106
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   107
!WeakInterestConverter methodsFor:'change & update'!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   108
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   109
update:something with:aParameter from:someObject
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   110
    |destination|
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   111
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   112
    (aspect isNil or:[aspect == something]) ifTrue:[
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   113
        destination := destinationHolder at:1.
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   114
        destination notNil ifTrue:[
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   115
            destination perform:selector
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   116
        ]
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   117
    ]
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   118
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   119
    "Modified: 8.3.1996 / 22:41:53 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   120
    "Created: 21.5.1997 / 14:08:49 / cg"
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   121
! !
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   122
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   123
!WeakInterestConverter class methodsFor:'documentation'!
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   124
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   125
version
5273
7fc2109a0ed0 copyrights
Claus Gittinger <cg@exept.de>
parents: 2656
diff changeset
   126
    ^ '$Header: /cvs/stx/stx/libbasic/WeakInterestConverter.st,v 1.2 2000-02-18 14:42:13 cg Exp $'
2656
c71176e82d85 intitial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   127
! !