Public Instance Methods : IuSstApplicationContext
addRemoteSpace: spaceName at: urlList
"ACTION
Add a remote space named @spaceName to the receiver. The
space is created so it is contactable at the URLs given by @urlList.
If the space already exists then it is modified to ensure that
its location is the machine named @machineName. Answer the
newly added space.
PARAMETERS
spaceName : <IuSstComponentName>
urlList : <Collection of <String> | <IuSstUrl>>
RETURN VALUE
<IuSstRemoteSpace>
NOTES
This method is intended to be used to add new spaces to a context
which has already been #setupFor:using:'d. Use #addSpace:at: to
add a space to the context before it has been setup.
EXCEPTIONS
ExSstSetupError : Thrown if a machine called @machineName cannot
be found or the receiver has not been setup."
addSpace: spaceName at: urlList
"ACTION
Add to the receiver a specification for a space named @spaceName.
The space's location is described by @urlList.
PARAMETERS
spaceName : <IuSstComponentName>
urlList : <Collection of <String> | <IuSstUrl>>
NOTES
This method is intended to be used when before setting up the
receiver (#setupFor:using:) and should not be used after the
receiver has been started. Use #addRemoteSpace:at: to add
new remote spaces."
name
"ACTION
Answer the name of the receiver.
RETURN VALUE
<String>"
properties
"ACTION
Answer the <Dictionary> of keys and values associated with the
receiver. The contents and semantics of the return value are defined
by the user. Users are expected to directly manipulate this collection
to effect changes in the receiver's property settings.
RETURN VALUE
<Dictionary>
NOTES
Certain SST subsystems require that the user to set context properties
(e.g, the type repository in RMI). Specific API is provided for setting these
values."
removeSpace: oldSpace
"ACTION
Remove space @oldSpace from the receiver's list of available
spaces. Note that requests to remove the receiver's %space (i.e.,
the local space) are ignored. All transient references to objects in
@oldSpace are invalidated and @oldSpace's machine is also
removed.
PARAMETERS
oldSpace : <IuSstRemoteSpace>"
reset
"ACTION
Reset the receiver to its initial state (i.e., that when it was
instantiated). Related processes, state and resources will be
released or emptied as required. From this state the receiver
can be sent #startUp.
NOTES
This method assumes that the receiver has been #shutDown."
restartMode
"ACTION
Return the receiver's current restart configuration setting. See
#restartMode: for details.
RETURN VALUE
{SstClearMode, SstCleanUpMode, SstRestartMode}"
restartMode: value
"ACTION
Configure what is done with any SST components related to the
receiver when the image is restarted (i.e. image load time).
The choices here are:
SstClearMode - Clear out the whole system using #clear. This
overrides the settings of the receiver's components.
SstCleanUpMode - Clean up the receiver according to the
configuration of its components.
SstRestartMode - SstCleanUpMode then restart the system
using #startUp.
PARAMETERS
value : {SstClearMode, SstCleanUpMode, SstRestartMode}"
setupFor: spaceName using: config
"ACTION
Setup the receiver to run in the object space named @spaceName
configured according to @config. This method can only be called once
and should be done after all statically known space/machine
specifications have been added (see #addSpace:*). Once this
method has completed the receiver may be #startUp'd. Note that
further remote spaces can be added using #addRemoteSpace:*.
PARAMETERS
spaceName : <IuSstComponentName>
config : <SstSpaceConfiguration>
EXCEPTIONS
ExSstSetupError : Thrown if the receiver (or its constituents) are not
properly configured to be setup."
space
"ACTION
Answer the space in which the receiver is running.
RETURN VALUE
<IuSstLocalSpace>"
spaceFor: id
"ACTION
Answer the space registered under the name @id. If is none,
answer nil.
PARAMETERS
id : <IuSstComponentName>
RETURN VALUE
<IuSstObjectSpace> | nil"
spaceFor: id ifNone: absentHandler
"ACTION
Answer the space registered under the name @id. If there is
none, answer the result of evaluating @absentHandler with no
arguments.
PARAMETERS
id : <IuSstComponentName>
RETURN VALUE
<IuSstObjectlSpace> | <Object>"
spaces
"ACTION
Answer a collection of all spaces managed by the receiver.
RETURN VALUE
<Collection of <IuSstObjectSpace>>"
[FIRST] [PREV] [NEXT] [LAST]