Model.st
author Claus Gittinger <cg@exept.de>
Tue, 20 Feb 1996 19:24:36 +0100
changeset 163 80f4fe3bcc71
parent 153 0a44627e1712
child 188 38e92ed0e1b9
permissions -rw-r--r--
care for interrupts while adding/removing dependents
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
3f9277473954 Initial revision
claus
parents:
diff changeset
     1
"
6
4ac87e6bf82f *** empty log message ***
claus
parents: 5
diff changeset
     2
 COPYRIGHT (c) 1992 by Claus Gittinger
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
     3
	      All Rights Reserved
0
3f9277473954 Initial revision
claus
parents:
diff changeset
     4
3f9277473954 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
3f9277473954 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
3f9277473954 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
3f9277473954 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
3f9277473954 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
3f9277473954 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
3f9277473954 Initial revision
claus
parents:
diff changeset
    11
"
3f9277473954 Initial revision
claus
parents:
diff changeset
    12
3f9277473954 Initial revision
claus
parents:
diff changeset
    13
Object subclass:#Model
163
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    14
	instanceVariableNames:'dependents'
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    15
	classVariableNames:''
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    16
	poolDictionaries:''
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    17
	category:'Interface-Support-Models'
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    18
!
3f9277473954 Initial revision
claus
parents:
diff changeset
    19
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    20
!Model class methodsFor:'documentation'!
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    22
copyright
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    23
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    24
 COPYRIGHT (c) 1992 by Claus Gittinger
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    25
	      All Rights Reserved
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    26
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    27
 This software is furnished under a license and may be used
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    28
 only in accordance with the terms of that license and with the
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    30
 be provided or otherwise made available to, or used by, any
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    31
 other person.  No title to or ownership of the software is
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    32
 hereby transferred.
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    33
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    34
!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    35
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    36
documentation
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    37
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    38
    Models are things that are presented in views. Instances keep track of 
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    39
    which views are dependent of them and inform them of any changes.
87
claus
parents: 83
diff changeset
    40
    Actually the Model class is not really needed; since the dependency
claus
parents: 83
diff changeset
    41
    mechanism is inherited by Object, you can take any object as a model.
claus
parents: 83
diff changeset
    42
    However, instances of Model (and subclasses) keep the dependents locally
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    43
    in an instance variable; thus speeding up access a bit.
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    44
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    45
    Instance variables:
87
claus
parents: 83
diff changeset
    46
	dependents      Collection      those objects which depend on me.
claus
parents: 83
diff changeset
    47
					To save some storage, the dependent is
claus
parents: 83
diff changeset
    48
					kept directly here, IFF there os only one.
claus
parents: 83
diff changeset
    49
					Otherwise, a collection of dependents is
claus
parents: 83
diff changeset
    50
					held here.
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    51
"
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    52
! !
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    53
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    54
!Model methodsFor:'copying'!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    55
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    56
postCopy
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    57
    "release dependents after copying"
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    58
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    59
    self dependents:nil
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    60
! !
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    61
83
claus
parents: 71
diff changeset
    62
!Model methodsFor:'dependents access'!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    63
83
claus
parents: 71
diff changeset
    64
addDependent:anObject
claus
parents: 71
diff changeset
    65
    "make the argument, anObject be a dependent of the receiver"
claus
parents: 71
diff changeset
    66
claus
parents: 71
diff changeset
    67
    |deps|
claus
parents: 71
diff changeset
    68
163
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    69
    [
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    70
        deps := dependents.
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    71
        (deps isNil and:[anObject isCollection not]) ifTrue:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    72
            dependents := anObject
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    73
        ] ifFalse:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    74
            deps isCollection ifTrue:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    75
                deps add:anObject
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    76
            ] ifFalse:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    77
                dependents := IdentitySet with:dependents with:anObject
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    78
            ]
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    79
        ]
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    80
    ] valueUninterruptably
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    81
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
    82
    "Modified: 20.2.1996 / 19:22:53 / cg"
83
claus
parents: 71
diff changeset
    83
!
claus
parents: 71
diff changeset
    84
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    85
dependents
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    86
    "return a Collection of dependents - nil if there is none"
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    87
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    88
    ^ dependents
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    89
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    90
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    91
dependents:aCollection
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    92
    "set the collection of dependents"
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    93
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    94
    dependents := aCollection
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    95
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    96
83
claus
parents: 71
diff changeset
    97
dependentsDo:aBlock
claus
parents: 71
diff changeset
    98
    "evaluate aBlock for all of my dependents"
claus
parents: 71
diff changeset
    99
claus
parents: 71
diff changeset
   100
    |deps|
claus
parents: 71
diff changeset
   101
claus
parents: 71
diff changeset
   102
    deps := dependents.
claus
parents: 71
diff changeset
   103
    deps notNil ifTrue:[
153
0a44627e1712 oops - did not like Id'Dicts as dependents ...
Claus Gittinger <cg@exept.de>
parents: 129
diff changeset
   104
	deps isCollection ifTrue:[
83
claus
parents: 71
diff changeset
   105
	    deps do:aBlock
claus
parents: 71
diff changeset
   106
	] ifFalse:[
claus
parents: 71
diff changeset
   107
	    aBlock value:deps
claus
parents: 71
diff changeset
   108
	]
claus
parents: 71
diff changeset
   109
    ]
claus
parents: 71
diff changeset
   110
!
claus
parents: 71
diff changeset
   111
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   112
release
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   113
    dependents := nil
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   114
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   115
83
claus
parents: 71
diff changeset
   116
removeDependent:anObject
claus
parents: 71
diff changeset
   117
    "make the argument, anObject be independent of the receiver"
claus
parents: 71
diff changeset
   118
claus
parents: 71
diff changeset
   119
    |deps sz|
claus
parents: 71
diff changeset
   120
163
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   121
    [
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   122
        deps := dependents.
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   123
        deps notNil ifTrue:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   124
            deps isCollection ifTrue:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   125
                deps remove:anObject ifAbsent:[].
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   126
                (sz := deps size) == 0 ifTrue:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   127
                    dependents := nil
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   128
                ]
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   129
            ] ifFalse:[
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   130
                dependents := nil
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   131
            ]
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   132
        ]
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   133
    ] valueUninterruptably
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   134
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   135
    "Modified: 20.2.1996 / 19:23:26 / cg"
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   136
! !
3f9277473954 Initial revision
claus
parents:
diff changeset
   137
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   138
!Model methodsFor:'drawing'!
28
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   139
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   140
displayOn:aGraphicsContext
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   141
    "display myself in aGraphicsContext"
28
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   142
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   143
    ^ self subclassResponsibility
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   144
!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   145
3f9277473954 Initial revision
claus
parents:
diff changeset
   146
displayOn:aGraphicsContext clippingBox:aRectangle
3f9277473954 Initial revision
claus
parents:
diff changeset
   147
    "display a part of me in aGraphicsContext"
3f9277473954 Initial revision
claus
parents:
diff changeset
   148
3f9277473954 Initial revision
claus
parents:
diff changeset
   149
    ^ self subclassResponsibility
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   150
! !
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   151
129
f890eaabc487 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 125
diff changeset
   152
!Model class methodsFor:'documentation'!
f890eaabc487 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 125
diff changeset
   153
f890eaabc487 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 125
diff changeset
   154
version
163
80f4fe3bcc71 care for interrupts while adding/removing dependents
Claus Gittinger <cg@exept.de>
parents: 153
diff changeset
   155
    ^ '$Header: /cvs/stx/stx/libview2/Model.st,v 1.19 1996-02-20 18:24:36 cg Exp $'
129
f890eaabc487 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 125
diff changeset
   156
! !