Server Smalltalk Guide : Remote object model : Space configurations
Space configurations
Like most components of SST, objects spaces are configured by specifing the following options:
exportSelector
The one argument selector to send to an object when it has been determined that it will be exported (see sstExportObjectIn:). This allows the object itself to influence is external/remote representation.
exportSize
Sets the initial size of the associated space's export set.
firstExportId
Specifies the first numeric ID to use when automatically generating export IDs for objects exported from the associated space.
handleClass
Sets the class of object handle to use when exporting objects.
importSize
Sets the initial size of the associated space's import set.
raiseExceptions
A boolean flag which is true if the invocation handler should raise exceptions when significant errors occur or false if it should simply return error codes.
remoteReferenceClass
Specifies the default class of remote reference to use when exporting remote references to objects. This option can be overridden for classes of objects by defining methods corresponding to the value set in the exportSelector option.
remoteSpaceClass
Specifies the class of remote space to use in relation to spaces configured by the receiver.
restartMode
A description of what to do with the space and its associated components on image startup. See Object space restart modes.
spaceClass
On instantiation, creates a space of the given class.
supportFinalization
A boolean flag indicating whether or not the associated space should support finalization of imported objects. If set to true, the spaces will automatically drop imports of remote objects when that remote object is no longer reachable by objects in the local space. The SstFinalizeImportCallback is fired if required.
Use the asProxyConfiguration and asFinalizedProxyConfiguration helper methods to mark object space configurations as supporting remote references and the discarding of unneeded remote references, respectively.
Space configurations are only valid on instances of SstLocalSpace. All other spaces are not configurable. SstSimpleObjectSpaces support object exporting (using keys from classes such as Number and Symbol which support the IuSstExportKey interface) but not object importing nor do they provide callbacks.
Last modified date: 01/29/2015