class Session

create() constructs and returns a new Session.

Sets how the Session handles invalid data.

onError() registers a error handler that will be called whenever a protocol

error is encountered.

Only one error handler can be bound at any given time, and later calls

will replace the existing error handler.

registerHandler() registers a request handler for a specific request type.

The function F must have one of the following signatures:

ResponseOrError

<ResponseType

>(const RequestType

&

)

ResponseType(const RequestType

&

)

Error(const RequestType

&

)

registerHandler() registers a request handler for a specific request type.

The handler has a response callback function for the second argument of the

handler function. This callback may be called after the handler has

returned.

The function F must have the following signature:

void(const RequestType

&

request,

std::function

<void

(ResponseType)> response)

registerHandler() registers a request handler for a specific request type.

The handler has a response callback function for the second argument of the

handler function. This callback may be called after the handler has

returned.

The function F must have the following signature:

void(const RequestType

&

request,

std::function

<void

(ResponseOrError

<ResponseType

>)> response)

registerHandler() registers a event handler for a specific event type.

The function F must have the following signature:

void(const EventType

&

)

registerSentHandler() registers the function F to be called when a response

of the specific type has been sent.

The function F must have the following signature:

void(const ResponseOrError

<ResponseType

>

&

)

send() sends the request to the connected endpoint and returns a

future that is assigned the request response or error.

send() sends the event to the connected endpoint.

bind() connects this Session to an endpoint using connect(), and then

starts processing incoming messages with startProcessingMessages().

onClose is the optional callback which will be called when the session

endpoint has been closed.

connect() connects this Session to an endpoint.

connect() can only be called once. Repeated calls will raise an error, but

otherwise will do nothing.

Note: This method is used for explicit control over message handling.

Most users will use bind() instead of calling this method directly.

startProcessingMessages() starts a new thread to receive and dispatch

incoming messages.

onClose is the optional callback which will be called when the session

endpoint has been closed.

Note: This method is used for explicit control over message handling.

Most users will use bind() instead of calling this method directly.

getPayload() blocks until the next incoming message is received, returning

the payload or an empty function if the connection was lost. The returned

payload is function that can be called on any thread to dispatch the

message to the Session handler.

Note: This method is used for explicit control over message handling.

Most users will use bind() instead of calling this method directly.

registerHandler() registers 'handler' as the request handler callback for

requests of the type 'typeinfo'.

registerHandler() registers 'handler' as the event handler callback for

events of the type 'typeinfo'.

registerHandler() registers 'handler' as the response-sent handler function

which is called whenever a response of the type 'typeinfo' is sent from

this session endpoint.

send() sends a request to the remote endpoint.

'requestTypeInfo' is the type info of the request data structure.

'requestTypeInfo' is the type info of the response data structure.

'request' is a pointer to the request data structure.

'responseHandler' is the handler function for the response.

send() sends an event to the remote endpoint.

'eventTypeInfo' is the type info for the event data structure.

'event' is a pointer to the event data structure.