Package org.apache.wicket.protocol.ws.api

Interface IWebSocketConnection

All Known Implementing Classes:

AbstractWebSocketConnection

public interface IWebSocketConnection

Common interface for native WebSocket connections

Since:

6.0

Method Summary

Modifier and Type	Method	Description
void	close(int code, java.lang.String reason)	Closes the underlying web socket connection
org.apache.wicket.Application	getApplication()
IKey	getKey()
java.lang.String	getSessionId()
boolean	isOpen()
IWebSocketConnection	sendMessage(byte[] message, int offset, int length)	Sends a binary message to the client.
IWebSocketConnection	sendMessage(java.lang.String message)	Sends a text message to the client.
void	sendMessage(IWebSocketPushMessage message)	Broadcasts a push message to the wicket page (and it's components) associated with this connection.

Method Detail

isOpen

boolean isOpen()

Returns:

true when the underlying native web socket connection is still open.

close

void close(int code,
           java.lang.String reason)

Closes the underlying web socket connection

Parameters:

code - the status code

reason - the reason to close the connection

sendMessage

IWebSocketConnection sendMessage(java.lang.String message)
                          throws java.io.IOException

Sends a text message to the client.

Parameters:

message - the text message

Returns:

this object, for chaining methods

Throws:

java.io.IOException - when an IO error occurs during the write to the client

sendMessage

IWebSocketConnection sendMessage(byte[] message,
                                 int offset,
                                 int length)
                          throws java.io.IOException

Sends a binary message to the client.

Parameters:

message - the binary message

offset - the offset to read from

length - how much data to read

Returns:

this object, for chaining methods

Throws:

java.io.IOException - when an IO error occurs during the write to the client

sendMessage

void sendMessage(IWebSocketPushMessage message)

Broadcasts a push message to the wicket page (and it's components) associated with this connection. The components can then send messages or component updates to client by adding them to the target.

Parameters:

message - the push message to send

Since:

6.4

getApplication

org.apache.wicket.Application getApplication()

Returns:

The application for which this WebSocket connection is registered

getSessionId

java.lang.String getSessionId()

Returns:

The id of the session for which this WebSocket connection is registered

getKey

IKey getKey()

Returns:

The registry key for which this WebSocket connection is registered