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: