org.glassfish.tyrus.client

Class ClientManager

java.lang.Object

org.glassfish.tyrus.core.ExecutorServiceProvider

org.glassfish.tyrus.core.BaseContainer

org.glassfish.tyrus.client.ClientManager

All Implemented Interfaces:

javax.websocket.WebSocketContainer

public class ClientManager
extends BaseContainer
implements javax.websocket.WebSocketContainer

ClientManager implementation.

Author:

Stepan Kopriva (stepan.kopriva at oracle.com), Pavel Bucek (pavel.bucek at oracle.com)

Field Summary

Fields

Modifier and Type	Field and Description
static String	HANDSHAKE_TIMEOUT Property usable in getProperties().

Constructor Summary

Constructors

Constructor and Description
ClientManager() Create new ClientManager instance.

Method Summary

Methods

Modifier and Type	Method and Description
Future<javax.websocket.Session>	asyncConnectToServer(Class<?> annotatedEndpointClass, URI path) Non-blocking version of WebSocketContainer.connectToServer(Class, java.net.URI).
Future<javax.websocket.Session>	asyncConnectToServer(Class<? extends javax.websocket.Endpoint> endpointClass, javax.websocket.ClientEndpointConfig cec, URI path) Non-blocking version of WebSocketContainer.connectToServer(Class, javax.websocket.ClientEndpointConfig, java.net.URI).
Future<javax.websocket.Session>	asyncConnectToServer(javax.websocket.Endpoint endpointInstance, javax.websocket.ClientEndpointConfig cec, URI path) Non-blocking version of WebSocketContainer.connectToServer(javax.websocket.Endpoint, javax.websocket.ClientEndpointConfig, java.net.URI).
Future<javax.websocket.Session>	asyncConnectToServer(Object obj, URI path) Non-blocking version of WebSocketContainer.connectToServer(Object, java.net.URI).
javax.websocket.Session	connectToServer(Class<? extends javax.websocket.Endpoint> endpointClass, javax.websocket.ClientEndpointConfig cec, URI path)
javax.websocket.Session	connectToServer(Class annotatedEndpointClass, URI path)
javax.websocket.Session	connectToServer(javax.websocket.Endpoint endpointInstance, javax.websocket.ClientEndpointConfig cec, URI path)
javax.websocket.Session	connectToServer(Object obj, URI path)
static ClientManager	createClient() Create new ClientManager instance.
static ClientManager	createClient(String containerProviderClassName) Create new ClientManager instance.
static ClientManager	createClient(String containerProviderClassName, javax.websocket.WebSocketContainer webSocketContainer) Create new ClientManager instance on top of provided WebSocketContainer instance.
static ClientManager	createClient(javax.websocket.WebSocketContainer webSocketContainer) Create new ClientManager instance on top of provided WebSocketContainer instance.
long	getDefaultAsyncSendTimeout()
int	getDefaultMaxBinaryMessageBufferSize()
long	getDefaultMaxSessionIdleTimeout()
int	getDefaultMaxTextMessageBufferSize()
Set<javax.websocket.Extension>	getInstalledExtensions()
Map<String,Object>	getProperties() Container properties.
void	setAsyncSendTimeout(long timeoutmillis)
void	setDefaultMaxBinaryMessageBufferSize(int i)
void	setDefaultMaxSessionIdleTimeout(long defaultMaxSessionIdleTimeout)
void	setDefaultMaxTextMessageBufferSize(int i)

Methods inherited from class org.glassfish.tyrus.core.BaseContainer

getExecutorService, getScheduledExecutorService

Methods inherited from class java.lang.Object

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

Field Detail

HANDSHAKE_TIMEOUT

public static final String HANDSHAKE_TIMEOUT

Property usable in getProperties().

Value must be int and represents handshake timeout in milliseconds. Default value is 30000 (30 seconds).

See Also:

Constant Field Values

Constructor Detail

ClientManager

public ClientManager()

Create new ClientManager instance.

Uses CONTAINER_PROVIDER_CLASSNAME as container implementation, thus relevant module needs to be on classpath. Setting different container is possible via createClient(String)}.

See Also:

createClient(String)

Method Detail

createClient

public static ClientManager createClient()

Create new ClientManager instance.

Uses CONTAINER_PROVIDER_CLASSNAME as container implementation, thus relevant module needs to be on classpath. Setting different container is possible via createClient(String).

See Also:

createClient(String)

createClient

public static ClientManager createClient(javax.websocket.WebSocketContainer webSocketContainer)

Create new ClientManager instance on top of provided WebSocketContainer instance.

Uses CONTAINER_PROVIDER_CLASSNAME as container implementation, thus relevant module needs to be on classpath. Setting different container is possible via createClient(String).

See Also:

createClient(String)

createClient

public static ClientManager createClient(String containerProviderClassName)

Create new ClientManager instance.

Returns:

new ClientManager instance.

createClient

public static ClientManager createClient(String containerProviderClassName,
                         javax.websocket.WebSocketContainer webSocketContainer)

Create new ClientManager instance on top of provided WebSocketContainer instance.

Returns:

new ClientManager instance.

connectToServer

public javax.websocket.Session connectToServer(Class annotatedEndpointClass,
                                      URI path)
                                        throws javax.websocket.DeploymentException,
                                               IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

IOException

connectToServer

public javax.websocket.Session connectToServer(Class<? extends javax.websocket.Endpoint> endpointClass,
                                      javax.websocket.ClientEndpointConfig cec,
                                      URI path)
                                        throws javax.websocket.DeploymentException,
                                               IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

IOException

connectToServer

public javax.websocket.Session connectToServer(javax.websocket.Endpoint endpointInstance,
                                      javax.websocket.ClientEndpointConfig cec,
                                      URI path)
                                        throws javax.websocket.DeploymentException,
                                               IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

IOException

connectToServer

public javax.websocket.Session connectToServer(Object obj,
                                      URI path)
                                        throws javax.websocket.DeploymentException,
                                               IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

IOException

asyncConnectToServer

public Future<javax.websocket.Session> asyncConnectToServer(Class<?> annotatedEndpointClass,
                                                   URI path)
                                                     throws javax.websocket.DeploymentException

Non-blocking version of WebSocketContainer.connectToServer(Class, java.net.URI).

Only simple checks are performed in the main thread; client container is created in different thread, same applies to connecting etc.

Parameters:

annotatedEndpointClass - the annotated websocket client endpoint.

path - the complete path to the server endpoint.

Returns:

Future for the Session created if the connection is successful.

Throws:

javax.websocket.DeploymentException - if the class is not a valid annotated endpoint class.

asyncConnectToServer

public Future<javax.websocket.Session> asyncConnectToServer(Class<? extends javax.websocket.Endpoint> endpointClass,
                                                   javax.websocket.ClientEndpointConfig cec,
                                                   URI path)
                                                     throws javax.websocket.DeploymentException

Non-blocking version of WebSocketContainer.connectToServer(Class, javax.websocket.ClientEndpointConfig, java.net.URI).

Only simple checks are performed in the main thread; client container is created in different thread, same applies to connecting etc.

Parameters:

endpointClass - the programmatic client endpoint class Endpoint.

path - the complete path to the server endpoint.

cec - the configuration used to configure the programmatic endpoint.

Returns:

the Session created if the connection is successful.

Throws:

javax.websocket.DeploymentException - if the configuration is not valid

See Also:

WebSocketContainer.connectToServer(Class, javax.websocket.ClientEndpointConfig, java.net.URI)

asyncConnectToServer

public Future<javax.websocket.Session> asyncConnectToServer(javax.websocket.Endpoint endpointInstance,
                                                   javax.websocket.ClientEndpointConfig cec,
                                                   URI path)
                                                     throws javax.websocket.DeploymentException

Non-blocking version of WebSocketContainer.connectToServer(javax.websocket.Endpoint, javax.websocket.ClientEndpointConfig, java.net.URI).

Only simple checks are performed in the main thread; client container is created in different thread, same applies to connecting etc.

Parameters:

endpointInstance - the programmatic client endpoint instance Endpoint.

path - the complete path to the server endpoint.

cec - the configuration used to configure the programmatic endpoint.

Returns:

the Session created if the connection is successful.

Throws:

javax.websocket.DeploymentException - if the configuration is not valid

See Also:

WebSocketContainer.connectToServer(javax.websocket.Endpoint, javax.websocket.ClientEndpointConfig, java.net.URI)

asyncConnectToServer

public Future<javax.websocket.Session> asyncConnectToServer(Object obj,
                                                   URI path)
                                                     throws javax.websocket.DeploymentException

Non-blocking version of WebSocketContainer.connectToServer(Object, java.net.URI).

Only simple checks are performed in the main thread; client container is created in different thread, same applies to connecting etc.

Parameters:

obj - the annotated websocket client endpoint instance.

path - the complete path to the server endpoint.

Returns:

the Session created if the connection is successful.

Throws:

javax.websocket.DeploymentException - if the annotated endpoint instance is not valid.

See Also:

WebSocketContainer.connectToServer(Object, java.net.URI)

getDefaultMaxBinaryMessageBufferSize

public int getDefaultMaxBinaryMessageBufferSize()

Specified by:

getDefaultMaxBinaryMessageBufferSize in interface javax.websocket.WebSocketContainer

setDefaultMaxBinaryMessageBufferSize

public void setDefaultMaxBinaryMessageBufferSize(int i)

Specified by:

setDefaultMaxBinaryMessageBufferSize in interface javax.websocket.WebSocketContainer

getDefaultMaxTextMessageBufferSize

public int getDefaultMaxTextMessageBufferSize()

Specified by:

getDefaultMaxTextMessageBufferSize in interface javax.websocket.WebSocketContainer

setDefaultMaxTextMessageBufferSize

public void setDefaultMaxTextMessageBufferSize(int i)

Specified by:

setDefaultMaxTextMessageBufferSize in interface javax.websocket.WebSocketContainer

getInstalledExtensions

public Set<javax.websocket.Extension> getInstalledExtensions()

Specified by:

getInstalledExtensions in interface javax.websocket.WebSocketContainer

getDefaultAsyncSendTimeout

public long getDefaultAsyncSendTimeout()

Specified by:

getDefaultAsyncSendTimeout in interface javax.websocket.WebSocketContainer

setAsyncSendTimeout

public void setAsyncSendTimeout(long timeoutmillis)

Specified by:

setAsyncSendTimeout in interface javax.websocket.WebSocketContainer

getDefaultMaxSessionIdleTimeout

public long getDefaultMaxSessionIdleTimeout()

Specified by:

getDefaultMaxSessionIdleTimeout in interface javax.websocket.WebSocketContainer

setDefaultMaxSessionIdleTimeout

public void setDefaultMaxSessionIdleTimeout(long defaultMaxSessionIdleTimeout)

Specified by:

setDefaultMaxSessionIdleTimeout in interface javax.websocket.WebSocketContainer

getProperties

public Map<String,Object> getProperties()

Container properties.

Used to set container specific configuration as SSL truststore and keystore, HTTP Proxy configuration and maximum incoming buffer size. These properties cannot be shared among various containers due to constraints in WebSocket API, so if you need to have multiple configurations, you will need to create multiple ClientManager instances or synchronize connectToServer method invocations.

Returns:

map containing container properties.