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 Deprecated. please use org.glassfish.tyrus.client.ClientProperties#INCOMING_BUFFER_SIZE.
static String	WLS_INCOMING_BUFFER_SIZE WLS version of INCOMING_BUFFER_SIZE.

Method Summary

Methods

Modifier and Type	Method and Description
void	openClientSocket(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

Deprecated. please use org.glassfish.tyrus.client.ClientProperties#INCOMING_BUFFER_SIZE.

Property name for maximal incoming buffer size.

Can be set in properties map (see openClientSocket(javax.websocket.ClientEndpointConfig, java.util.Map, ClientEngine)).

See Also:

Constant Field Values

WLS_INCOMING_BUFFER_SIZE

static final String WLS_INCOMING_BUFFER_SIZE

WLS version of INCOMING_BUFFER_SIZE.

See Also:

Constant Field Values

Method Detail

openClientSocket

void openClientSocket(ClientEndpointConfig cec,
                    Map<String,Object> properties,
                    ClientEngine clientEngine)
                      throws 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:

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(ClientEngine.TimeoutHandler) and ClientEngine.processResponse(UpgradeResponse, Writer, org.glassfish.tyrus.spi.Connection.CloseListener) (in that order).

Throws:

DeploymentException - when the client endpoint is invalid or when there is any other (not specified) connection problem.

IOException - when there is any I/O issue related to opening client socket or connecting to remote endpoint.