org.glassfish.tyrus.spi

Interface ClientContainer

public interface ClientContainer

Entry point for client implementation.

Author:

Pavel Bucek (pavel.bucek at oracle.com)

Field Summary

Fields

Modifier and Type	Field and Description
static String	INCOMING_BUFFER_SIZE Property name for maximal incoming buffer size.

Method Summary

Methods

Modifier and Type	Method and Description
void	openClientSocket(String url, javax.websocket.ClientEndpointConfig cec, Map<String,Object> properties, ClientEngine clientEngine) Open client socket - connect to endpoint specified with url parameter.

Field Detail

INCOMING_BUFFER_SIZE

static final String INCOMING_BUFFER_SIZE

Property name for maximal incoming buffer size. Can be set in properties map (see openClientSocket(String, javax.websocket.ClientEndpointConfig, java.util.Map, ClientEngine)).

See Also:

Constant Field Values

Method Detail

openClientSocket

void openClientSocket(String url,
                    javax.websocket.ClientEndpointConfig cec,
                    Map<String,Object> properties,
                    ClientEngine clientEngine)
                      throws javax.websocket.DeploymentException,
                             IOException

Open client socket - connect to endpoint specified with url parameter.

Called from ClientManager when WebSocketContainer.connectToServer(Class, javax.websocket.ClientEndpointConfig, java.net.URI) is invoked.

Parameters:

url - address where remote service is deployed.

cec - endpoint configuration. SPI consumer can access user properties, ClientEndpointConfig.Configurator, extensions and subprotocol configuration, etc..

properties - properties passed from client container. Don't mix up this with EndpointConfig.getUserProperties(), these are Tyrus proprietary.

clientEngine - one instance equals to one connection, cannot be reused. Implementation is expected to call ClientEngine.createUpgradeRequest(java.net.URI, org.glassfish.tyrus.spi.ClientEngine.TimeoutHandler) and ClientEngine.processResponse(UpgradeResponse, Writer, org.glassfish.tyrus.spi.Connection.CloseListener) (in that order).

Throws:

javax.websocket.DeploymentException

IOException