io.muserver

Interface MuWebSocketSession

public interface MuWebSocketSession

A web socket session used to send messages and events to a web socket client.

The simplest way to get a reference to a session is to extend BaseWebSocket and use the BaseWebSocket.session() method.

Method Summary

Modifier and Type	Method and Description
void	close() Initiates a graceful shutdown with the client.
void	close(int statusCode, String reason) Initiates a graceful shutdown with the client.
InetSocketAddress	remoteAddress()
void	sendBinary(ByteBuffer message, DoneCallback doneCallback) Sends a message to the client
void	sendPing(ByteBuffer payload, DoneCallback doneCallback) Sends a ping message to the client, which is used for keeping sockets alive.
void	sendPong(ByteBuffer payload, DoneCallback doneCallback) Sends a pong message to the client, generally in response to receiving a ping via MuWebSocket.onPing(ByteBuffer, DoneCallback)
void	sendText(String message, DoneCallback doneCallback) Sends a message to the client asynchronously
WebsocketSessionState	state()

Method Detail

sendText

void sendText(String message,
              DoneCallback doneCallback)

Sends a message to the client asynchronously

Parameters:

message - The message to be sent

doneCallback - The callback to call when the write succeeds or fails. To ignore the write result, you can use DoneCallback.NoOp. If using a buffer received from a MuWebSocket event, pass the onComplete received to this parameter.

sendBinary

void sendBinary(ByteBuffer message,
                DoneCallback doneCallback)

Sends a message to the client

Parameters:

message - The message to be sent

doneCallback - The callback to call when the write succeeds or fails. To ignore the write result, you can use DoneCallback.NoOp. If using a buffer received from a MuWebSocket event, pass the onComplete received to this parameter.

sendPing

void sendPing(ByteBuffer payload,
              DoneCallback doneCallback)

Sends a ping message to the client, which is used for keeping sockets alive.

Parameters:

payload - The message to send.

doneCallback - The callback to call when the write succeeds or fails. To ignore the write result, you can use DoneCallback.NoOp. If using a buffer received from a MuWebSocket event, pass the onComplete received to this parameter.

sendPong

void sendPong(ByteBuffer payload,
              DoneCallback doneCallback)

Sends a pong message to the client, generally in response to receiving a ping via MuWebSocket.onPing(ByteBuffer, DoneCallback)

Parameters:

payload - The payload to send back to the client.

doneCallback - The callback to call when the write succeeds or fails. To ignore the write result, you can use DoneCallback.NoOp. If using a buffer received from a MuWebSocket event, pass the onComplete received to this parameter.

close

void close()
    throws IOException

Initiates a graceful shutdown with the client.

Throws:

IOException - Thrown if there is an error writing to the client, for example if the user has closed their browser.

close

void close(int statusCode,
           String reason)
    throws IOException

Initiates a graceful shutdown with the client.

Parameters:

statusCode - The status code to send, such as 1000. See https://tools.ietf.org/html/rfc6455#section-7.4

reason - An optional reason for closing.

Throws:

IOException - Thrown if there is an error writing to the client, for example if the user has closed their browser.

remoteAddress

InetSocketAddress remoteAddress()

Returns:

The client's address

state

WebsocketSessionState state()

Returns:

The state of the current session