Package org.eclipse.jetty.websocket.jsr356

Class ClientContainer

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.websocket.jsr356.ClientContainer

All Implemented Interfaces:

javax.websocket.WebSocketContainer, Container, Destroyable, Dumpable, LifeCycle, WebSocketContainerScope

@ManagedObject("JSR356 Client Container")
public class ClientContainer
extends ContainerLifeCycle
implements javax.websocket.WebSocketContainer, WebSocketContainerScope

Container for Client use of the javax.websocket API.

This should be specific to a JVM if run in a standalone mode. or specific to a WebAppContext if running on the Jetty server.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOP_ON_FAILURE, STOPPED, STOPPING

Constructor Summary

Constructors

Modifier	Constructor	Description
	ClientContainer()	This is the entry point for ContainerProvider.getWebSocketContainer()
	ClientContainer(WebSocketClient client)	Build a ClientContainer with a specific WebSocketClient in mind.
	ClientContainer(WebSocketContainerScope scope)	This is the entry point for ServerContainer, via ServletContext.getAttribute(ServerContainer.class.getName())
protected	ClientContainer(WebSocketContainerScope scope, HttpClient httpClient)	This is the entry point for ServerContainer, via ServletContext.getAttribute(ServerContainer.class.getName())

Method Summary

Modifier and Type	Method	Description
javax.websocket.Session	connectToServer(java.lang.Class<?> annotatedEndpointClass, java.net.URI path)
javax.websocket.Session	connectToServer(java.lang.Class<? extends javax.websocket.Endpoint> endpointClass, javax.websocket.ClientEndpointConfig config, java.net.URI path)
javax.websocket.Session	connectToServer(java.lang.Object endpoint, java.net.URI path)
javax.websocket.Session	connectToServer(javax.websocket.Endpoint endpoint, javax.websocket.ClientEndpointConfig config, java.net.URI path)
protected void	doStart()
protected void	doStop()
ByteBufferPool	getBufferPool()
WebSocketClient	getClient()
EndpointMetadata	getClientEndpointMetadata(java.lang.Class<?> endpoint, javax.websocket.EndpointConfig config)
DecoderFactory	getDecoderFactory()
long	getDefaultAsyncSendTimeout()
int	getDefaultMaxBinaryMessageBufferSize()
long	getDefaultMaxSessionIdleTimeout()
int	getDefaultMaxTextMessageBufferSize()
EncoderFactory	getEncoderFactory()
java.util.concurrent.Executor	getExecutor()
java.util.Set<javax.websocket.Extension>	getInstalledExtensions()
DecoratedObjectFactory	getObjectFactory()
java.util.Set<javax.websocket.Session>	getOpenSessions()	Used in Session.getOpenSessions()
WebSocketPolicy	getPolicy()
SslContextFactory	getSslContextFactory()
EndpointInstance	newClientEndpointInstance(java.lang.Object endpoint, javax.websocket.ClientEndpointConfig config)
void	onSessionClosed(WebSocketSession session)
void	onSessionOpened(WebSocketSession session)
void	setAsyncSendTimeout(long ms)
void	setDefaultMaxBinaryMessageBufferSize(int max)
void	setDefaultMaxSessionIdleTimeout(long ms)
void	setDefaultMaxTextMessageBufferSize(int max)

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, destroy, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, dumpThis, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.websocket.common.scopes.WebSocketContainerScope

isRunning

Constructor Detail

ClientContainer

public ClientContainer()

This is the entry point for ContainerProvider.getWebSocketContainer()

ClientContainer

public ClientContainer(WebSocketContainerScope scope)

This is the entry point for ServerContainer, via ServletContext.getAttribute(ServerContainer.class.getName())

Parameters:

scope - the scope of the ServerContainer

ClientContainer

protected ClientContainer(WebSocketContainerScope scope,
                          HttpClient httpClient)

This is the entry point for ServerContainer, via ServletContext.getAttribute(ServerContainer.class.getName())

Parameters:

scope - the scope of the ServerContainer

httpClient - the HttpClient instance to use

ClientContainer

public ClientContainer(WebSocketClient client)

Build a ClientContainer with a specific WebSocketClient in mind.

Parameters:

client - the WebSocketClient to use.

Method Detail

connectToServer

public javax.websocket.Session connectToServer(java.lang.Class<? extends javax.websocket.Endpoint> endpointClass,
                                               javax.websocket.ClientEndpointConfig config,
                                               java.net.URI path)
                                        throws javax.websocket.DeploymentException,
                                               java.io.IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

java.io.IOException

connectToServer

public javax.websocket.Session connectToServer(java.lang.Class<?> annotatedEndpointClass,
                                               java.net.URI path)
                                        throws javax.websocket.DeploymentException,
                                               java.io.IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

java.io.IOException

connectToServer

public javax.websocket.Session connectToServer(javax.websocket.Endpoint endpoint,
                                               javax.websocket.ClientEndpointConfig config,
                                               java.net.URI path)
                                        throws javax.websocket.DeploymentException,
                                               java.io.IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

java.io.IOException

connectToServer

public javax.websocket.Session connectToServer(java.lang.Object endpoint,
                                               java.net.URI path)
                                        throws javax.websocket.DeploymentException,
                                               java.io.IOException

Specified by:

connectToServer in interface javax.websocket.WebSocketContainer

Throws:

javax.websocket.DeploymentException

java.io.IOException

doStart

protected void doStart()
                throws java.lang.Exception

Overrides:

doStart in class ContainerLifeCycle

Throws:

java.lang.Exception

doStop

protected void doStop()
               throws java.lang.Exception

Overrides:

doStop in class ContainerLifeCycle

Throws:

java.lang.Exception

getBufferPool

public ByteBufferPool getBufferPool()

Specified by:

getBufferPool in interface WebSocketContainerScope

getClient

public WebSocketClient getClient()

getClientEndpointMetadata

public EndpointMetadata getClientEndpointMetadata(java.lang.Class<?> endpoint,
                                                  javax.websocket.EndpointConfig config)

getDecoderFactory

public DecoderFactory getDecoderFactory()

getDefaultAsyncSendTimeout

public long getDefaultAsyncSendTimeout()

Specified by:

getDefaultAsyncSendTimeout in interface javax.websocket.WebSocketContainer

getDefaultMaxBinaryMessageBufferSize

public int getDefaultMaxBinaryMessageBufferSize()

Specified by:

getDefaultMaxBinaryMessageBufferSize in interface javax.websocket.WebSocketContainer

getDefaultMaxSessionIdleTimeout

public long getDefaultMaxSessionIdleTimeout()

Specified by:

getDefaultMaxSessionIdleTimeout in interface javax.websocket.WebSocketContainer

getDefaultMaxTextMessageBufferSize

public int getDefaultMaxTextMessageBufferSize()

Specified by:

getDefaultMaxTextMessageBufferSize in interface javax.websocket.WebSocketContainer

getEncoderFactory

public EncoderFactory getEncoderFactory()

getExecutor

public java.util.concurrent.Executor getExecutor()

Specified by:

getExecutor in interface WebSocketContainerScope

getInstalledExtensions

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

Specified by:

getInstalledExtensions in interface javax.websocket.WebSocketContainer

getObjectFactory

public DecoratedObjectFactory getObjectFactory()

Specified by:

getObjectFactory in interface WebSocketContainerScope

getOpenSessions

public java.util.Set<javax.websocket.Session> getOpenSessions()

Used in Session.getOpenSessions()

Returns:

the set of open sessions

getPolicy

public WebSocketPolicy getPolicy()

Specified by:

getPolicy in interface WebSocketContainerScope

getSslContextFactory

public SslContextFactory getSslContextFactory()

Specified by:

getSslContextFactory in interface WebSocketContainerScope

newClientEndpointInstance

public EndpointInstance newClientEndpointInstance(java.lang.Object endpoint,
                                                  javax.websocket.ClientEndpointConfig config)

onSessionClosed

public void onSessionClosed(WebSocketSession session)

Specified by:

onSessionClosed in interface WebSocketContainerScope

onSessionOpened

public void onSessionOpened(WebSocketSession session)

Specified by:

onSessionOpened in interface WebSocketContainerScope

setAsyncSendTimeout

public void setAsyncSendTimeout(long ms)

Specified by:

setAsyncSendTimeout in interface javax.websocket.WebSocketContainer

setDefaultMaxBinaryMessageBufferSize

public void setDefaultMaxBinaryMessageBufferSize(int max)

Specified by:

setDefaultMaxBinaryMessageBufferSize in interface javax.websocket.WebSocketContainer

setDefaultMaxSessionIdleTimeout

public void setDefaultMaxSessionIdleTimeout(long ms)

Specified by:

setDefaultMaxSessionIdleTimeout in interface javax.websocket.WebSocketContainer

setDefaultMaxTextMessageBufferSize

public void setDefaultMaxTextMessageBufferSize(int max)

Specified by:

setDefaultMaxTextMessageBufferSize in interface javax.websocket.WebSocketContainer