Package org.eclipse.jetty.websocket.javax.client

Class JavaxWebSocketClientContainerProvider

java.lang.Object

javax.websocket.ContainerProvider

org.eclipse.jetty.websocket.javax.client.JavaxWebSocketClientContainerProvider

public class JavaxWebSocketClientContainerProvider
extends javax.websocket.ContainerProvider

Client ContainerProvider implementation.

Created by a ServiceLoader call in the ContainerProvider.getWebSocketContainer() call.

Constructor Summary

Constructors

Constructor	Description
JavaxWebSocketClientContainerProvider()

Method Summary

Modifier and Type	Method	Description
protected javax.websocket.WebSocketContainer	getContainer()	Used by ContainerProvider.getWebSocketContainer() to get a NEW INSTANCE of the Client WebSocketContainer.
static javax.websocket.WebSocketContainer	getContainer(HttpClient httpClient)	Get a new instance of a client WebSocketContainer which uses a supplied HttpClient.
static void	stop(javax.websocket.WebSocketContainer container)

Methods inherited from class javax.websocket.ContainerProvider

getWebSocketContainer

Methods inherited from class java.lang.Object

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

Constructor Details

JavaxWebSocketClientContainerProvider

public JavaxWebSocketClientContainerProvider()

Method Details

stop

public static void stop(javax.websocket.WebSocketContainer container)
                 throws Exception

Throws:

Exception

getContainer

protected javax.websocket.WebSocketContainer getContainer()

Used by ContainerProvider.getWebSocketContainer() to get a NEW INSTANCE of the Client WebSocketContainer.

NOTE: A WebSocket Client Container is a heavyweight object. It is dangerous to repeatedly request a new container, or to manage many containers. The existing javax.websocket API has no lifecycle for a ClientContainer, once started they exist for the duration of the JVM with no ability to stop them. See/Comment on javax.websocket Issue #212 if this is a big concern for you.

Specified by:

getContainer in class javax.websocket.ContainerProvider

getContainer

public static javax.websocket.WebSocketContainer getContainer(HttpClient httpClient)

Get a new instance of a client WebSocketContainer which uses a supplied HttpClient.

Parameters:

httpClient - a pre-configured HttpClient to be used by the implementation.

See Also:

• getContainer()