OSID - osid.transport.OutboundMessageSession Service Interface Definition

Interface	osid.transport.OutboundMessageSession
Implements	`osid.OsidSession`
Used By	`osid.transport.TransportManager`
Used By	`osid.transport.TransportProxyManager`
Description	This session provides access to a request/response protocol provider. The data and format of the requests and responses are identified through their respective `Types`. While this session is used for structured conversations, it doesn't preclude the use of byte streams as part of a `Request` or `Response`. A `Request` is retrieved via `getRequest()` and data is supplied to its corresponding record. The `Request` is then sent using `sendRequest()` along with an interface to be called when the `Response` arrives. The FSM of the protocol is indicated through the available `Request` `Types` that may change from one transaction to another. While multiple requests may be submitted before receiving a response, the requests may or may not be queued.
Method	getEndpointId
Description	Gets the `Endpoint` `Id` associated with this session.
Return	`osid.id.Id`		the `Endpoint` `Id` associated with this session
Compliance	`mandatory`		This method must be implemented.
Method	getEndpoint
Description	Gets the `Endpoint` associated with this session.
Return	`osid.transport.Endpoint`		the `Endpoint` associated with this session
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	getRequest
Description	Gets a `Request` for use with `sendRequest()`. This is not a receive call.
Return	`osid.transport.Request`		a request
Compliance	`mandatory`		This method must be implemented.
Method	makeRequest
Description	Sends a request to the remote transport endpoint and waits for a response.
Parameters	`osid.transport.Request`	`request`	the request
Parameters	`osid.transport.Response`	`response`	callback for the response
Errors	NULL_ARGUMENT		`request` or `receiver` is null
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`request` is not supported
Compliance	`mandatory`		This method must be implemented.
Method	sendRequest
Description	Sends data to the remote transport endpoint and sends the response to the callback.
Parameters	`osid.transport.Request`	`request`	the request
Parameters	`osid.transport.MessageReceiver`	`callback`	callback for the response
Errors	NULL_ARGUMENT		`request` or `callback` is null
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`request` is not supported
Compliance	`mandatory`		This method must be implemented.