org.glassfish.tyrus.core.cluster

Class ClusterContext

java.lang.Object

org.glassfish.tyrus.core.cluster.ClusterContext

public abstract class ClusterContext
extends Object

Cluster related context.

There is exactly one instance per cluster node and all communication is realized using this instance.

Author:

Pavel Bucek (pavel.bucek at oracle.com)

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLUSTER_CONTEXT ClusterContext registration property.

Constructor Summary

Constructors

Constructor and Description
ClusterContext()

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	broadcastBinary(String endpointPath, byte[] data) Broadcast binary message.
abstract void	broadcastText(String endpointPath, String text) Broadcast text message.
abstract Future<Void>	close(String sessionId) Close remote session.
abstract Future<Void>	close(String sessionId, CloseReason closeReason) Close remote session with custom CloseReason.
abstract String	createConnectionId() Create connection id.
abstract String	createSessionId() Create session id.
abstract void	destroyDistributedUserProperties(String connectionId) Destroy map which holds distributed user properties.
abstract Map<RemoteSession.DistributedMapKey,Object>	getDistributedSessionProperties(String sessionId) Get the map containing session properties to be shared among nodes.
abstract Map<String,Object>	getDistributedUserProperties(String connectionId) Get the map containing session user properties to be shared among nodes.
abstract Set<String>	getRemoteSessionIds(String endpointPath) Get set containing session ids of all remote sessions registered to given endpoint path.
abstract boolean	isSessionOpen(String sessionId, String endpointPath) Get information about session state.
abstract void	registerBroadcastListener(String endpointPath, BroadcastListener listener) Register broadcast listener.
abstract void	registerSession(String sessionId, String endpointPath, SessionEventListener listener) Register local session.
abstract void	registerSessionListener(String endpointPath, SessionListener listener) Register session listener.
abstract void	removeSession(String sessionId, String endpointPath) Remove session from this Cluster context.
abstract Future<Void>	sendBinary(String sessionId, byte[] data) Send binary message.
abstract Future<Void>	sendBinary(String sessionId, byte[] data, boolean isLast) Send partial binary message.
abstract void	sendBinary(String sessionId, byte[] data, SendHandler sendHandler) Send binary message with SendHandler.
abstract Future<Void>	sendPing(String sessionId, byte[] data) Send ping message.
abstract Future<Void>	sendPong(String sessionId, byte[] data) Send pong message.
abstract Future<Void>	sendText(String sessionId, String text) Send text message.
abstract Future<Void>	sendText(String sessionId, String text, boolean isLast) Send partial text message.
abstract void	sendText(String sessionId, String text, SendHandler sendHandler) Send text message with SendHandler.
abstract void	shutdown() Shutdown this ClusterContext.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CLUSTER_CONTEXT

public static final String CLUSTER_CONTEXT

ClusterContext registration property.

ClusterContext is registered to the Server container via properties passed to ServerContainerFactory.createServerContainer(java.util.Map).

See Also:

Constant Field Values

Constructor Detail

ClusterContext

public ClusterContext()

Method Detail

sendText

public abstract Future<Void> sendText(String sessionId,
                    String text)

Send text message.

Parameters:

sessionId - remote session id.

text - text to be sent.

Returns:

future representing the send event. Future.get() returns when there is an acknowledge from the other node that the message has been successfully sent. If there is any exception, it will be wrapped into ExecutionException and thrown.

sendText

public abstract Future<Void> sendText(String sessionId,
                    String text,
                    boolean isLast)

Send partial text message.

Parameters:

sessionId - remote session id.

text - text to be sent.

isLast - true when the partial message being sent is the last part of the message.

Returns:

future representing the send event. Future.get() returns when there is an acknowledge from the other node that the message has been successfully sent. If there is any exception, it will be wrapped into ExecutionException and thrown.

sendBinary

public abstract Future<Void> sendBinary(String sessionId,
                      byte[] data)

Send binary message.

Parameters:

sessionId - remote session id.

data - data to be sent.

Returns:

future representing the send event. Future.get() returns when there is an acknowledge from the other node that the message has been successfully sent. If there is any exception, it will be wrapped into ExecutionException and thrown.

sendBinary

public abstract Future<Void> sendBinary(String sessionId,
                      byte[] data,
                      boolean isLast)

Send partial binary message.

Parameters:

sessionId - remote session id.

data - data to be sent.

isLast - true when the partial message being sent is the last part of the message.

Returns:

future representing the send event. Future.get() returns when there is an acknowledge from the other node that the message has been successfully sent. If there is any exception, it will be wrapped into ExecutionException and thrown.

sendPing

public abstract Future<Void> sendPing(String sessionId,
                    byte[] data)

Send ping message.

Parameters:

sessionId - remote session id.

data - data to be sent as ping message payload.

Returns:

future representing the send event. Future.get() returns when there is an acknowledge from the other node that the message has been successfully sent. If there is any exception, it will be wrapped into ExecutionException and thrown.

sendPong

public abstract Future<Void> sendPong(String sessionId,
                    byte[] data)

Send pong message.

Parameters:

sessionId - remote session id.

data - data to be sent as pong message payload.

Returns:

future representing the send event. Future.get() returns when there is an acknowledge from the other node that the message has been successfully sent. If there is any exception, it will be wrapped into ExecutionException and thrown.

sendText

public abstract void sendText(String sessionId,
            String text,
            SendHandler sendHandler)

Send text message with SendHandler.

Parameters:

sessionId - remote session id.

text - text to be sent.

sendHandler - sendhandler instance on which SendHandler.onResult(javax.websocket.SendResult) will be invoked.

See Also:

SendHandler

sendBinary

public abstract void sendBinary(String sessionId,
              byte[] data,
              SendHandler sendHandler)

Send binary message with SendHandler.

Parameters:

sessionId - remote session id.

data - data to be sent.

sendHandler - sendhandler instance on which SendHandler.onResult(javax.websocket.SendResult) will be invoked.

See Also:

SendHandler

broadcastText

public abstract void broadcastText(String endpointPath,
                 String text)

Broadcast text message.

Parameters:

endpointPath - endpoint path identifying sessions alignment to the endpoint.

text - message to be broadcasted.

broadcastBinary

public abstract void broadcastBinary(String endpointPath,
                   byte[] data)

Broadcast binary message.

Parameters:

endpointPath - endpoint path identifying sessions alignment to the endpoint.

data - data to be broadcasted.

isSessionOpen

public abstract boolean isSessionOpen(String sessionId,
                    String endpointPath)

Get information about session state.

Parameters:

sessionId - remote session id.

endpointPath - endpoint path identifying sessions alignment to the endpoint.

Returns:

true when session is opened, false otherwise.

See Also:

Session.isOpen()

close

public abstract Future<Void> close(String sessionId)

Close remote session.

Parameters:

sessionId - remote session id.

Returns:

future representing the event. Future.get() returns when there is an acknowledge from the other node that the command was successfully executed. If there is any exception, it will be wrapped into ExecutionException and thrown.

close

public abstract Future<Void> close(String sessionId,
                 CloseReason closeReason)

Close remote session with custom CloseReason.

Parameters:

sessionId - remote session id.

closeReason - custom close reason.

Returns:

future representing the event. Future.get() returns when there is an acknowledge from the other node that the command was successfully executed. If there is any exception, it will be wrapped into ExecutionException and thrown.

getRemoteSessionIds

public abstract Set<String> getRemoteSessionIds(String endpointPath)

Get set containing session ids of all remote sessions registered to given endpoint path.

Parameters:

endpointPath - endpoint path identifying endpoint within the cluster.

Returns:

set of sessions ids.

createSessionId

public abstract String createSessionId()

Create session id. It has to be unique among all cluster nodes.

Returns:

session id.

createConnectionId

public abstract String createConnectionId()

Create connection id. It has to be unique among all cluster nodes.

Returns:

connection id.

registerSession

public abstract void registerSession(String sessionId,
                   String endpointPath,
                   SessionEventListener listener)

Register local session.

Session id will be broadcasted to other nodes which will call getDistributedSessionProperties(String) and process its values. The map must be ready before this method is invoked.

Parameters:

sessionId - session id to be registered.

endpointPath - endpoint path identifying sessions alignment to the endpoint.

listener - session event listener. When remote node sends a message to this session, it will be invoked.

See Also:

SessionEventListener

registerSessionListener

public abstract void registerSessionListener(String endpointPath,
                           SessionListener listener)

Register session listener.

Gets notification about session creation .SessionListener#onSessionOpened(String) and destruction .SessionListener#onSessionClosed(String).

Parameters:

endpointPath - endpoint path identifying sessions alignment to the endpoint.

listener - listener instance.

See Also:

SessionListener

registerBroadcastListener

public abstract void registerBroadcastListener(String endpointPath,
                             BroadcastListener listener)

Register broadcast listener.

Gets notification about broadcasted messages. Used as an optimized variant of standard websocket broadcast pattern. In this case, only one message is sent to all cluster nodes (instead n when n represent number of clients connected to remote nodes).

Parameters:

endpointPath - endpoint path identifying sessions alignment to the endpoint.

listener - listener instance.

See Also:

BroadcastListener

getDistributedSessionProperties

public abstract Map<RemoteSession.DistributedMapKey,Object> getDistributedSessionProperties(String sessionId)

Get the map containing session properties to be shared among nodes.

Changes must be propagated to remote instances.

Parameters:

sessionId - remote session id.

Returns:

distributed map containing session properties.

getDistributedUserProperties

public abstract Map<String,Object> getDistributedUserProperties(String connectionId)

Get the map containing session user properties to be shared among nodes.

Changes must be propagated to remote instances.

Parameters:

connectionId - connection id. Connection id may be shared among subsequent TCP connection - represents logical connection.

Returns:

distributed map containing session properties.

destroyDistributedUserProperties

public abstract void destroyDistributedUserProperties(String connectionId)

Destroy map which holds distributed user properties.

This method should be invoked only when session is properly closed.

Parameters:

connectionId - connection id. Connection id may be shared among subsequent TCP connection - represents logical connection.

removeSession

public abstract void removeSession(String sessionId,
                 String endpointPath)

Remove session from this Cluster context.

Parameters:

sessionId - session id.

endpointPath - endpoint path identifying sessions alignment to the endpoint.

shutdown

public abstract void shutdown()

Shutdown this ClusterContext.

This will stop whole clustered node, any operation related to this cluster context will fail after this method is invoked.