Server Smalltalk Guide
Object spaces also support a number of callbacks dealing with the importing
and exporting of objects.
- SstAddHandlerCallback
- Sent when a new handler is added to a local space. The
callData is the handler that has just been added.
- SstDifferentSpaceActivationCallback
- Sent when an incoming marshaled representation of a space has a different
activation from the local representation's activation. The
callData for the callback is a three-element array containing the
local representation (from which the current activation can be obtained), the
incoming activation and a block. Sending value to the block
will cause a marshaling error to be returned to the sender.
- SstExportCallback
- Sent when an object is exported for the first time (either explicitly by
the developer or automatically by the SST system when messages contain objects
not previously exported). The callData for the callback is a
two-element array containing the key under which the object was exported and
object itself.
- SstFinalizeImportCallback
- Sent whenever an imported remote reference object in a local image is
about to be collected by the local object space's normal garbage
collector. This callback is only generated if the space supports
finalization (i.e., the supportFinalization option is
set to true). The callData for the callback is a two-element
array containing the handle under which the object was imported and the local
remote reference object.
- SstImportCallback
- Sent when a new remote reference is imported (either the first time or the
first time since it was last finalized). The callData for
the callback is a three-element array containing the handle under which the
object was imported, the local remote reference object, and the root of the
message which contained the newly imported object (or nil if no
message was involved).
- SstRemoveHandlerCallback
- Sent when an existing handler is removed from a local space. The
callData is the handler being removed.
- SstUnexportCallback
- Sent when a previously exported object is removed from the export
table. The callData for the callback is a two-element array
containing the key under which the object was exported and the object
itself.
- SstUnimportCallback
- Sent when a previously imported object is explicitly removed from the
import table (as opposed to just being garbage collected). The
callData for the callback is a two-element array containing the
handle under which the object was imported and the local remote reference
object.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]