Cherry-picked OrderedCollection.st from 0b286fd51da7:
* d4c86d7c0bfc: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* 692b6497a669: #DOCUMENTATION by stefan, Stefan Vogel <sv@exept.de>
* d47bb2912953: #DOCUMENTATION by stefan, Stefan Vogel <sv@exept.de>
* abb4316c6bff: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 3a8fce0e8d11: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* 03d29bf8c5bb: #REFACTORING by stefan, Stefan Vogel <sv@exept.de>
* cccc6c4abcfc: #REFACTORING by stefan, Stefan Vogel <sv@exept.de>
* 35d957c7a840: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 6b11890f5f2c: #OTHER by cg, Claus Gittinger <cg@exept.de>
* abb6108fb06b: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 2c4768bb2e89: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 4029e964d0f1: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* ddcab3a9c2df: #OTHER by cg, Claus Gittinger <cg@exept.de>
* 2213eb56e0c7: #REFACTORING by exept, Claus Gittinger <cg@exept.de>
* 09ca874a6160: #REFACTORING by exept, Claus Gittinger <cg@exept.de>
* 30b332af1f33: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* 779764ba117b: #REFACTORING by cg, Claus Gittinger <cg@exept.de>
* b3d232a613c9: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* c417f7edaec1: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* 904b6538f379: #FEATURE by exept, Claus Gittinger <cg@exept.de>
* c5887f03e01f: #REFACTORING by stefan, Stefan Vogel <sv@exept.de>
* 8912d03aff48: #BUGFIX by exept, Claus Gittinger <cg@exept.de>
* de5cd1dab4c3: #DOCUMENTATION by exept, Claus Gittinger <cg@exept.de>
* 9bbd26603378: #OTHER by exept, Claus Gittinger <cg@exept.de>
* c2c9dc110f42: #FEATURE by stefan, Stefan Vogel <sv@exept.de>
* 81d123c6703d: #DOCUMENTATION by stefan, Stefan Vogel <sv@exept.de>
* 8aadbb21458a: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* f210dbb8b2f6: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* c2c774fc53c0: #FEATURE by exept, Claus Gittinger <cg@exept.de>
* b6f462670875: #DOCUMENTATION by exept, Claus Gittinger <cg@exept.de>
* 27ae4021d5d6: #FEATURE by stefan, Stefan Vogel <sv@exept.de>
* 10d9e9d85594: #TUNING by exept, Claus Gittinger <cg@exept.de>
* 2653d855dcc7: #DOCUMENTATION by exept, Claus Gittinger <cg@exept.de>
* 6ea1698a1a34: #FEATURE by stefan, Stefan Vogel <sv@exept.de>
* 28762315e664: #OTHER by exept, Claus Gittinger <cg@exept.de>
* 7142ea786f3e: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* 7875acb42b53: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* 163a0eebc97e: #BUGFIX by Maren, matilk
"
COPYRIGHT (c) 2013 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' }"
Notification subclass:#ProceedingNotification
instanceVariableNames:''
classVariableNames:''
poolDictionaries:''
category:'Kernel-Exceptions'
!
!ProceedingNotification class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 2013 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 ProceedingNotification behaves much like a regular notification,
in that if no handler is present, execution proceeds after the raise.
However, iff a handler simply falls through, the exception is proceeded.
The handler is still free to choose for an explicit action (return/reject).
[author:]
Claus Gittinger
[see also:]
Exception Query Notification
"
!
examples
"
an up-notification from a deeply nested operation to a higher level.
Notice, that in contrast to a regular Notification, all outer handlers are called:
[exBegin]
|zero|
zero := 0.
CascadingNotification handle:[:n |
Transcript showCR:'h1: ' , n description.
n proceedWith:1.
] do:[
CascadingNotification handle:[:n |
Transcript showCR:'h2: ' , n description.
] do:[
CascadingNotification handle:[:n |
Transcript showCR:'h3: ' , n description.
] do:[
'nesting'.
[
[
Error handle:[:ex |
Transcript showCR:'some error: ' , ex errorString.
ex proceed
] do:[
[
|answer|
1 // zero. 'an error which is caught in the handler'.
answer := CascadingNotification notify:'hello world'.
Transcript show:'after notification 1: '; showCR:answer.
] value
]
] value
] value.
Transcript showCR:'after notification 2'.
].
Transcript showCR:'after notification 3'.
].
Transcript showCR:'after notification 4'.
].
Transcript showCR:'after notification 5'.
[exEnd]
however, if any handler proceeds or returns, this is not the case:
[exBegin]
|zero|
zero := 0.
CascadingNotification handle:[:n |
Transcript showCR:'h1: ' , n description.
] do:[
CascadingNotification handle:[:n |
Transcript showCR:'h2: ' , n description.
n proceedWith:2.
] do:[
CascadingNotification handle:[:n |
Transcript showCR:'h3: ' , n description.
] do:[
'nesting'.
[
[
Error handle:[:ex |
Transcript showCR:'some error: ' , ex errorString.
ex proceed
] do:[
[
|answer|
1 // zero. 'an error which is caught in the handler'.
answer := CascadingNotification notify:'hello world'.
Transcript show:'after notification 1: '; showCR:answer.
] value
]
] value
] value.
Transcript showCR:'after notification 2'.
].
Transcript showCR:'after notification 3'.
].
Transcript showCR:'after notification 4'.
].
Transcript showCR:'after notification 5'.
[exEnd]
however, if any handler proceeds or returns, this is not the case:
[exBegin]
|zero|
zero := 0.
CascadingNotification handle:[:n |
Transcript showCR:'h1: ' , n description.
] do:[
CascadingNotification handle:[:n |
Transcript showCR:'h2: ' , n description.
n return.
] do:[
CascadingNotification handle:[:n |
Transcript showCR:'h3: ' , n description.
] do:[
'nesting'.
[
[
Error handle:[:ex |
Transcript showCR:'some error: ' , ex errorString.
ex proceed
] do:[
[
|answer|
1 // zero. 'an error which is caught in the handler'.
answer := CascadingNotification notify:'hello world'.
Transcript show:'after notification 1: '; showCR:answer.
] value
]
] value
] value.
Transcript showCR:'after notification 2'.
].
Transcript showCR:'after notification 3'.
].
Transcript showCR:'after notification 4'.
].
Transcript showCR:'after notification 5'.
[exEnd]
"
! !
!ProceedingNotification class methodsFor:'initialization'!
initialize
NotifierString := 'Notification:'
! !
!ProceedingNotification methodsFor:'default actions'!
doCallHandler:aHandlerBlock
"call the handler proper - if the handler falls through, proceed with the handler's value.
- an extra method is needed to have a raise-marked context around.
(see implementation of #reject and #proceed)."
<context: #return>
<exception: #raise>
|val|
aHandlerBlock argumentCount == 0 ifTrue:[
"0-arg handler or any object - not interested in the exception argument"
val := aHandlerBlock value
] ifFalse:[
"1-arg handler - pass myself as exception argument"
val := aHandlerBlock value:self.
].
"handler fall through - this is different here!!"
self proceedWith:val
! !
!ProceedingNotification class methodsFor:'documentation'!
version
^ '$Header: /cvs/stx/stx/libbasic/ProceedingNotification.st,v 1.1 2013-08-24 12:25:37 cg Exp $'
!
version_CVS
^ '$Header: /cvs/stx/stx/libbasic/ProceedingNotification.st,v 1.1 2013-08-24 12:25:37 cg Exp $'
! !
ProceedingNotification initialize!