org.glassfish.tyrus.core

Class TyrusWebSocketEngine

java.lang.Object

org.glassfish.tyrus.core.TyrusWebSocketEngine

All Implemented Interfaces:

WebSocketEngine

public class TyrusWebSocketEngine
extends Object
implements WebSocketEngine

WebSocketEngine implementation, which handles server-side handshake, validation and data processing.

Author:

Alexey Stashok, Pavel Bucek (pavel.bucek at oracle.com)

See Also:

TyrusWebSocket, TyrusEndpointWrapper

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TyrusWebSocketEngine.TyrusWebSocketEngineBuilder TyrusWebSocketEngine builder.

Nested classes/interfaces inherited from interface org.glassfish.tyrus.spi.WebSocketEngine

WebSocketEngine.UpgradeInfo, WebSocketEngine.UpgradeStatus

Field Summary

Fields

Modifier and Type	Field and Description
static String	INCOMING_BUFFER_SIZE Maximum size of incoming buffer in bytes.
static String	MAX_SESSIONS_PER_APP Maximum number of open sessions per server application.
static String	MAX_SESSIONS_PER_REMOTE_ADDR Maximum number of open sessions per unique remote address.
static String	WSADL_SUPPORT Wsadl support.

Method Summary

Methods

Modifier and Type	Method and Description
static TyrusWebSocketEngine.TyrusWebSocketEngineBuilder	builder(WebSocketContainer webSocketContainer) Create TyrusWebSocketEngine.TyrusWebSocketEngineBuilder instance based on passed WebSocketContainer.
ApplicationEventListener	getApplicationEventListener() Get ApplicationEventListener related to current TyrusWebSocketEngine instance.
Application	getWsadlApplication() Get Application representing current set of deployed endpoints.
void	register(Class<?> endpointClass, String contextPath)
void	register(ServerEndpointConfig serverConfig, String contextPath)
void	setIncomingBufferSize(int incomingBufferSize) Deprecated. Please use TyrusWebSocketEngine.TyrusWebSocketEngineBuilder.incomingBufferSize(Integer) instead.
void	unregister(TyrusEndpointWrapper endpointWrapper) Un-registers the specified TyrusEndpointWrapper with the WebSocketEngine.
WebSocketEngine.UpgradeInfo	upgrade(UpgradeRequest request, UpgradeResponse response) A transport calls this method to upgrade a HTTP request.

Methods inherited from class java.lang.Object

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

Field Detail

INCOMING_BUFFER_SIZE

public static final String INCOMING_BUFFER_SIZE

Maximum size of incoming buffer in bytes.

The value must be Integer or its primitive alternative.

Default value is 4194315, which means that TyrusWebSocketEngine is by default capable of processing messages up to 4 MB.

See Also:

Constant Field Values

MAX_SESSIONS_PER_APP

public static final String MAX_SESSIONS_PER_APP

Maximum number of open sessions per server application.

The value must be positive Integer or its primitive alternative. Negative values and zero are ignored.

The number of open sessions per application is not limited by default.

See Also:

Constant Field Values

MAX_SESSIONS_PER_REMOTE_ADDR

public static final String MAX_SESSIONS_PER_REMOTE_ADDR

Maximum number of open sessions per unique remote address.

The value must be positive Integer or its primitive alternative. Negative values and zero are ignored.

The number of open sessions per remote address is not limited by default.

See Also:

Constant Field Values

WSADL_SUPPORT

@Beta
public static final String WSADL_SUPPORT

Wsadl support.

Wsadl is experimental feature which exposes endpoint configuration in form of XML file, similarly as Wadl for REST services. Currently generated Wsadl contains only set of endpoints and their endpoint paths. Wsadl is exposed on URI ending by "application.wsadl".

The value must be string, "true" means that the feature is enable, "false" that the feature is disabled.

Default value is "false";

See Also:

Constant Field Values

Method Detail

builder

public static TyrusWebSocketEngine.TyrusWebSocketEngineBuilder builder(WebSocketContainer webSocketContainer)

Create TyrusWebSocketEngine.TyrusWebSocketEngineBuilder instance based on passed WebSocketContainer.

Parameters:

webSocketContainer - WebSocketContainer instance. Cannot be null.

Returns:

new builder.

upgrade

public WebSocketEngine.UpgradeInfo upgrade(UpgradeRequest request,
                                  UpgradeResponse response)

Description copied from interface: WebSocketEngine

A transport calls this method to upgrade a HTTP request.

Specified by:

upgrade in interface WebSocketEngine

Returns:

info about upgrade status and connection details.

setIncomingBufferSize

public void setIncomingBufferSize(int incomingBufferSize)

Deprecated. Please use TyrusWebSocketEngine.TyrusWebSocketEngineBuilder.incomingBufferSize(Integer) instead.

Set incoming buffer size.

Parameters:

incomingBufferSize - buffer size in bytes.

register

public void register(Class<?> endpointClass,
            String contextPath)
              throws DeploymentException

Specified by:

register in interface WebSocketEngine

Throws:

DeploymentException

register

public void register(ServerEndpointConfig serverConfig,
            String contextPath)
              throws DeploymentException

Specified by:

register in interface WebSocketEngine

Throws:

DeploymentException

unregister

public void unregister(TyrusEndpointWrapper endpointWrapper)

Un-registers the specified TyrusEndpointWrapper with the WebSocketEngine.

Parameters:

endpointWrapper - the TyrusEndpointWrapper to un-register.

getApplicationEventListener

public ApplicationEventListener getApplicationEventListener()

Get ApplicationEventListener related to current TyrusWebSocketEngine instance.

Returns:

listener instance.

getWsadlApplication

@Beta
public Application getWsadlApplication()

Get Application representing current set of deployed endpoints.

Returns:

application representing current set of deployed endpoints.