Public Instance Methods : IdSstDispatcher
basicCleanUp
"ACTION
Do the basic work of cleaning up the receiver on image start up.
See #cleanUpOnRestart for details on controling restart
behaviour.
NOTES
This method must be implemented but is not expected to be used
directly by programmers."
dispatchIncoming: request
"ACTION
Dispatch the incoming @request to its intended receiver according
to the policies of the receiver. It is expected that request processing
includes sending any required responses.
PARAMETERS
request : <IuSstRequest>
NOTES
The details of how @request is executed are deterimed by the
implementation of the receiver and not specified here.
CALLBACKS
SstFirstIncomingCallback : Fired @request contains data in its
SstFirstContactInfoKey info slot. @request is the callData for the
callback.
SstDispatchRequestCallback : Fired before processing each
@request with @request itself as the callData."
handler
"ACTION
Answer the invocation handler associated with the receiver.
RETURN VALUE
<IuSstInvocationHandler>"
instantiateFor: invocationHandler
"ACTION
Allow the recevier to act as though it were a configuration and
instantiate a new dispatcher (of the receiver's class) conforming
to settings of the receiver. Set the new instance up to be associated
with @invocationHandler. Return the new dispatcher.
PARAMETERS
invocationHandler : <IuSstInvocationHandler>
RETURN VALUE
<IdSstDispatcher>
NOTES
The receiver and the new instance may share some internal data
structures as a result of this operation. Therefore, it is essential that
the receiver never have been @startUp'd. This method is a shortcut
replacement for using a configuration. It is only required if instances
of the receiver's class will be installed as 'templates' in invocation
handler configurations."
sendEarlyReply: value to: request continuation: continuation
"ACTION
Send @value as an early reply to @request. An early reply
is defined as a reply done before the method invoked as a
result of dispatching @request has returned. @continuation
is a zero argument block containing the code which should
be executed after @value is replied. Return an error if one
should occur.
PARAMETERS
value : <Object>
request : <IuSstRequest>
continuation : <Block>
RETURN VALUE
<void> | <IuSstError>
NOTES
Typical developers should not use this method but rather see
<IuSstInvocationHandler>>>#earlyReply:inResponseTo:continuation:."
sendReply: value to: request
"ACTION
Send @value in reply to @request. If an error occurs, reply
an error value to the origin of @request (i.e., its sender) and
return the error from this method. In the event that an error
occurs while trying to send the error reply, simply return an
error from this method. If a reply of any sort is actually sent
then @request is marked as having been answered.
PARAMETERS
value : <Object>
request : <IuSstRequest>
RETURN VALUE
<void> | <IuSstError>
NOTES
Typical developers should not use this method but rather see
<IuSstInvocationHandler>>>#reply:inResponseTo:"
sendRequest: request to: endpoint
"ACTION
Send @request to @endpoint for processing and return the
result if one is required. It is assumed that @endpoint represents
some remote location. Return an error if one should occur.
PARAMETERS
request : <IuSstRequest>
endpoint : <IuSstRemoteEndpoint>
RETURN VALUE
<Object> | <IuSstError>
CALLBACKS
SstFirstOutgoingCallback : Fired the first time a request is sent to
@endpoint by the receiver. The definition of 'first time' is completely
transport dependent (see <IuSstRemoteEndpoint>>>#hasContacted:).
@request and @endpoint are passed as the callData.
SstSendRequestCallback : Fired before sending each @request
with @request and @endpoint as the callData."
[FIRST] [PREV] [NEXT] [LAST]