ObsoleteObject.st
author claus
Mon, 21 Nov 1994 18:05:13 +0100
changeset 210 2138d09a96ff
parent 90 94259bf1f459
child 294 21e9123719d4
permissions -rw-r--r--
*** empty log message ***
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
     1
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1994 by Claus Gittinger
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
     3
	      All Rights Reserved
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
     4
94259bf1f459 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
94259bf1f459 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
94259bf1f459 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
94259bf1f459 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
94259bf1f459 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
94259bf1f459 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
94259bf1f459 Initial revision
claus
parents:
diff changeset
    11
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
    12
94259bf1f459 Initial revision
claus
parents:
diff changeset
    13
Object subclass:#ObsoleteObject
94259bf1f459 Initial revision
claus
parents:
diff changeset
    14
       instanceVariableNames:''
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    15
       classVariableNames:'ObsoleteObjectSignal'
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    16
       poolDictionaries:''
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    17
       category:'System-BinaryStorage'
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    18
!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    19
94259bf1f459 Initial revision
claus
parents:
diff changeset
    20
ObsoleteObject comment:'
94259bf1f459 Initial revision
claus
parents:
diff changeset
    21
COPYRIGHT (c) 1994 by Claus Gittinger
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    22
	      All Rights Reserved
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    23
'!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    24
94259bf1f459 Initial revision
claus
parents:
diff changeset
    25
!ObsoleteObject class methodsFor:'documentation'!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    26
94259bf1f459 Initial revision
claus
parents:
diff changeset
    27
copyright
94259bf1f459 Initial revision
claus
parents:
diff changeset
    28
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
    29
 COPYRIGHT (c) 1994 by Claus Gittinger
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    30
	      All Rights Reserved
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    31
94259bf1f459 Initial revision
claus
parents:
diff changeset
    32
 This software is furnished under a license and may be used
94259bf1f459 Initial revision
claus
parents:
diff changeset
    33
 only in accordance with the terms of that license and with the
94259bf1f459 Initial revision
claus
parents:
diff changeset
    34
 inclusion of the above copyright notice.   This software may not
94259bf1f459 Initial revision
claus
parents:
diff changeset
    35
 be provided or otherwise made available to, or used by, any
94259bf1f459 Initial revision
claus
parents:
diff changeset
    36
 other person.  No title to or ownership of the software is
94259bf1f459 Initial revision
claus
parents:
diff changeset
    37
 hereby transferred.
94259bf1f459 Initial revision
claus
parents:
diff changeset
    38
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
    39
!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    40
94259bf1f459 Initial revision
claus
parents:
diff changeset
    41
version
94259bf1f459 Initial revision
claus
parents:
diff changeset
    42
"
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    43
$Header: /cvs/stx/stx/libbasic/Attic/ObsoleteObject.st,v 1.2 1994-11-21 17:05:13 claus Exp $
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    44
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
    45
!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    46
94259bf1f459 Initial revision
claus
parents:
diff changeset
    47
documentation
94259bf1f459 Initial revision
claus
parents:
diff changeset
    48
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
    49
    This class is used for error handling during binary object restoration. 
94259bf1f459 Initial revision
claus
parents:
diff changeset
    50
    Whenever an object whose class has changed (i.e. it was stored with a 
94259bf1f459 Initial revision
claus
parents:
diff changeset
    51
    different layout/size) is about to be restored, it cannot be made an 
94259bf1f459 Initial revision
claus
parents:
diff changeset
    52
    instance of the now existing class.
94259bf1f459 Initial revision
claus
parents:
diff changeset
    53
    In this case, the BinaryInputManager will create a dummy class for the 
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    54
    old (obsolete) object. This dummy class will be a subclass of ObsoleteObject.
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    55
94259bf1f459 Initial revision
claus
parents:
diff changeset
    56
    After the creation of the obsolete object, a signal will be raised (in 
94259bf1f459 Initial revision
claus
parents:
diff changeset
    57
    BinaryInputManager), which can be cought by the application to try some 
94259bf1f459 Initial revision
claus
parents:
diff changeset
    58
    automatic or semi-automatic object conversion.
94259bf1f459 Initial revision
claus
parents:
diff changeset
    59
    The signal gets the obsolete object and the new class as parameters.
94259bf1f459 Initial revision
claus
parents:
diff changeset
    60
94259bf1f459 Initial revision
claus
parents:
diff changeset
    61
    ObsoleteObject itself catches all messages, to avoid any use of the restored
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    62
    object (in case conversion failed or the signal was ignored).
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    63
"
94259bf1f459 Initial revision
claus
parents:
diff changeset
    64
! !
94259bf1f459 Initial revision
claus
parents:
diff changeset
    65
94259bf1f459 Initial revision
claus
parents:
diff changeset
    66
!ObsoleteObject class methodsFor:'initialization'!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    67
94259bf1f459 Initial revision
claus
parents:
diff changeset
    68
initialize
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    69
    ObsoleteObjectSignal isNil ifTrue:[
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    70
	ObsoleteObjectSignal := (Signal new) mayProceed:false.
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    71
	ObsoleteObjectSignal nameClass:self message:#obsoleteObjectSignal.
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    72
	ObsoleteObjectSignal notifierString:'use of obsolete object'.
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    73
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    74
	self setSuperclass:nil
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    75
    ]
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    76
! !
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    77
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    78
!ObsoleteObject class methodsFor:'signal access'!
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    79
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    80
obsoleteObjectSignal
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    81
    "return the signal raised when a message is sent to an Obsolete
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    82
     signal"
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    83
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    84
    ^ ObsoleteObjectSignal
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    85
! !
94259bf1f459 Initial revision
claus
parents:
diff changeset
    86
94259bf1f459 Initial revision
claus
parents:
diff changeset
    87
!ObsoleteObject methodsFor:'message catching'!
94259bf1f459 Initial revision
claus
parents:
diff changeset
    88
94259bf1f459 Initial revision
claus
parents:
diff changeset
    89
doesNotUnderstand: aMessage
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    90
	"the only thing obsolete objects understand is that they dont understand
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    91
	 anything."
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    92
210
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    93
	^ ObsoleteObjectSignal 
2138d09a96ff *** empty log message ***
claus
parents: 90
diff changeset
    94
		 raiseRequestWith:aMessage
90
94259bf1f459 Initial revision
claus
parents:
diff changeset
    95
! !
94259bf1f459 Initial revision
claus
parents:
diff changeset
    96
94259bf1f459 Initial revision
claus
parents:
diff changeset
    97
ObsoleteObject initialize!