2.2.2 Messages
SSE defines a set of SOAP headers that can be attached to DSML SOAP request messages by a client. SSE headers can be used for the following:
To initiate a session.
To perform an operation within the context of a previously-initiated session.
To terminate a session.
When a client uses these headers in a request message, the server MUST respond by including corresponding headers in the DSML SOAP response message, which indicates that the session has been initiated or that the operation has been performed within the requested session.
The headers that are supported by SSE are specified in the following table.
|
Header |
Description |
|---|---|
|
Used by a client request to instruct the server to begin a session. The SOAP body to which this header is attached MUST be processed in the context of the session. That is, it MUST be processed as if the session were initiated prior to processing the request message. |
|
|
Used by a client request to instruct the server to process a SOAP request message inside a session that was previously created with a BeginSession operation. Used by a server response to inform the client that the operation was performed within the requested session. |
|
|
Used by a client request to instruct the server to terminate a session that was previously created with a BeginSession operation. The SOAP body to which this header is attached MUST be processed in the context of the session. That is, it MUST be processed as if the session were terminated after the request message completed processing. |