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]