org.glassfish.tyrus.client

Class ClientProperties

java.lang.Object

org.glassfish.tyrus.client.ClientProperties

public final class ClientProperties
extends Object

Tyrus client configuration properties.

Author:

Petr Janouch (petr.janouch at oracle.com)

Field Summary

Fields

Modifier and Type	Field and Description
static String	AUTH_CONFIG Authentication configuration.
static String	CREDENTIALS Authentication credentials.
static String	HANDSHAKE_TIMEOUT Property usable in ClientManager.getProperties().
static String	INCOMING_BUFFER_SIZE Property name for maximal incoming buffer size.
static String	LOG_HTTP_UPGRADE User property to configure logging of HTTP upgrade messages.
static String	PROXY_HEADERS User property to set additional proxy headers.
static String	PROXY_URI User property to set proxy URI.
static String	RECONNECT_HANDLER Property usable in ClientManager.getProperties().
static String	REDIRECT_ENABLED HTTP Redirect support.
static String	REDIRECT_THRESHOLD The maximal number of redirects during single handshake.
static String	RETRY_AFTER_SERVICE_UNAVAILABLE HTTP Service Unavailable - reconnect support.
static String	SHARED_CONTAINER When set to true (boolean value), client runtime preserves used container and reuses it for outgoing connections.
static String	SHARED_CONTAINER_IDLE_TIMEOUT Container idle timeout in seconds (Integer value).
static String	SSL_ENGINE_CONFIGURATOR Property usable in ClientManager.getProperties() as a key for SSL configuration.
static String	WORKER_THREAD_POOL_CONFIG User property to set worker thread pool configuration.

Constructor Summary

Constructors

Constructor and Description
ClientProperties()

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

HANDSHAKE_TIMEOUT

public static final String HANDSHAKE_TIMEOUT

Property usable in ClientManager.getProperties().

Value must be int and represents handshake timeout in milliseconds. Default value is 30000 (30 seconds).

See Also:

Constant Field Values

RECONNECT_HANDLER

public static final String RECONNECT_HANDLER

Property usable in ClientManager.getProperties().

Value must be ClientManager.ReconnectHandler instance.

See Also:

RETRY_AFTER_SERVICE_UNAVAILABLE, Constant Field Values

PROXY_URI

public static final String PROXY_URI

User property to set proxy URI.

Value is expected to be String and represent proxy URI. Protocol part is currently ignored but must be present (URI.URI(String) is used for parsing).

     client.getProperties().put(ClientProperties.PROXY_URI, "http://my.proxy.com:80");
     client.connectToServer(...);
 

See Also:

EndpointConfig.getUserProperties(), Constant Field Values

PROXY_HEADERS

public static final String PROXY_HEADERS

User property to set additional proxy headers.

Value is expected to be Map<String, String> and represent raw http headers to be added to initial request which is sent to proxy. Key corresponds to header name, value is header value.

Sample below demonstrates use of this feature to set preemptive basic proxy authentication:

     final HashMap proxyHeaders = new HashMap();
     proxyHeaders.put("Proxy-Authorization", "Basic " + Base64Utils.encodeToString("username:password".getBytes(Charset.forName("UTF-8")), false));

     client.getProperties().put(ClientProperties.PROXY_HEADERS, proxyHeaders);
     client.connectToServer(...);
 

Please note that these headers will be used only when establishing proxy connection, for modifying WebSocket handshake headers, see ClientEndpointConfig.Configurator.beforeRequest(java.util.Map).

See Also:

EndpointConfig.getUserProperties(), Constant Field Values

SSL_ENGINE_CONFIGURATOR

public static final String SSL_ENGINE_CONFIGURATOR

Property usable in ClientManager.getProperties() as a key for SSL configuration.

Value is expected to be either org.glassfish.grizzly.ssl.SSLEngineConfigurator or SslEngineConfigurator when configuring Grizzly client or only SslEngineConfigurator when configuring JDK client.

The advantage of using SslEngineConfigurator with Grizzly client is that SslEngineConfigurator allows configuration of host name verification (which is turned on by default)

Example configuration for JDK client:

      SslContextConfigurator sslContextConfigurator = new SslContextConfigurator();
      sslContextConfigurator.setTrustStoreFile("...");
      sslContextConfigurator.setTrustStorePassword("...");
      sslContextConfigurator.setTrustStoreType("...");
      sslContextConfigurator.setKeyStoreFile("...");
      sslContextConfigurator.setKeyStorePassword("...");
      sslContextConfigurator.setKeyStoreType("...");
      SslEngineConfigurator sslEngineConfigurator = new SslEngineConfigurator(sslContextConfigurator, true, false, false);
      client.getProperties().put(ClientProperties.SSL_ENGINE_CONFIGURATOR, sslEngineConfigurator);
 

See Also:

Constant Field Values

INCOMING_BUFFER_SIZE

public static final String INCOMING_BUFFER_SIZE

Property name for maximal incoming buffer size.

Can be set in properties map (see ClientContainer.openClientSocket(ClientEndpointConfig, Map, ClientEngine)).

See Also:

Constant Field Values

SHARED_CONTAINER

public static final String SHARED_CONTAINER

When set to true (boolean value), client runtime preserves used container and reuses it for outgoing connections.

A single thread pool is reused by all clients with this property set to true. JDK client supports only shared container option, so setting this property has no effect.

See Also:

SHARED_CONTAINER_IDLE_TIMEOUT, Constant Field Values

SHARED_CONTAINER_IDLE_TIMEOUT

public static final String SHARED_CONTAINER_IDLE_TIMEOUT

Container idle timeout in seconds (Integer value).

When the timeout elapses, the shared thread pool will be destroyed.

See Also:

SHARED_CONTAINER, Constant Field Values

WORKER_THREAD_POOL_CONFIG

public static final String WORKER_THREAD_POOL_CONFIG

User property to set worker thread pool configuration.

An instance of ThreadPoolConfig is expected for both JDK and Grizzly client. Instance of org.glassfish.grizzly.threadpool.ThreadPoolConfig, can be used for Grizzly client.

Sample below demonstrates how to use this property:

     client.getProperties().put(ClientProperties.WORKER_THREAD_POOL_CONFIG, ThreadPoolConfig.defaultConfig());
 

See Also:

Constant Field Values

AUTH_CONFIG

public static final String AUTH_CONFIG

Authentication configuration. If no AuthConfig is specified then default configuration will be used, containing both Basic and Digest provided authenticators.

Value must be AuthConfig instance.

Sample below demonstrates how to use this property:

     client.getProperties().put(ClientProperties.AUTH_CONFIG, AuthConfig.builder().enableProvidedBasicAuth().build());
 

See Also:

AuthConfig, AuthConfig.Builder, Authenticator, Constant Field Values

CREDENTIALS

public static final String CREDENTIALS

Authentication credentials.

Value must be Credentials instance.

Provided authenticators (both Basic and Digest) require this property set, otherwise AuthenticationException will be thrown during a handshake. User defined authenticators may look up credentials in another sources.

Sample below demonstrates how to use this property:

     client.getProperties().put(ClientProperties.CREDENTIALS, new Credentials("websocket_user", "password");
 

See Also:

Credentials, AuthConfig, Authenticator, Constant Field Values

REDIRECT_ENABLED

public static final String REDIRECT_ENABLED

HTTP Redirect support.

Value is expected to be boolean. Default value is false.

When set to true and one of the following redirection HTTP response status code (3xx) is received during a handshake, client will attempt to connect to the URI contained in header from handshake response. Number of redirection is limited by property REDIRECT_THRESHOLD (integer value), while default value is .

List of supported HTTP status codes:

• 300 - Multiple Choices
• 301 - Moved permanently
• 302 - Found
• 303 - See Other (since HTTP/1.1)
• 307 - Temporary Redirect (since HTTP/1.1)
• 308 - Permanent Redirect (Experimental RFC; RFC 7238)

See Also:

REDIRECT_THRESHOLD, Constant Field Values

REDIRECT_THRESHOLD

public static final String REDIRECT_THRESHOLD

The maximal number of redirects during single handshake.

Value is expected to be positive Integer. Default value is .

HTTP redirection must be enabled by property REDIRECT_ENABLED, otherwise REDIRECT_THRESHOLD is not applied.

See Also:

REDIRECT_ENABLED, RedirectException, Constant Field Values

RETRY_AFTER_SERVICE_UNAVAILABLE

public static final String RETRY_AFTER_SERVICE_UNAVAILABLE

HTTP Service Unavailable - reconnect support.

Value is expected to be boolean. Default value is false.

When set to true and HTTP response code 503 - Service Unavailable is received, client will attempt to reconnect after delay specified in header from handshake response. According to RFC 2616 the value must be decimal integer (representing delay in seconds) or http-date.

Tyrus client will try to reconnect after this delay if:

• header is present and is not empty
• header can be parsed
• number of reconnection attempts does not exceed 5
• delay is not longer then 300 seconds

See Also:

RetryAfterException, RECONNECT_HANDLER, ClientManager.ReconnectHandler, ClientManager.ReconnectHandler.onConnectFailure(Exception), Constant Field Values

LOG_HTTP_UPGRADE

public static final String LOG_HTTP_UPGRADE

User property to configure logging of HTTP upgrade messages.

Value is expected to be boolean. Default value is false.

When set to true upgrade request and response messages will be logged regardless of the logging level configuration. When the logging is configured to Level.FINE or lower, this setting will have no effect as at this level HTTP upgrade messages will be logged anyway.

See Also:

Constant Field Values

Constructor Detail

ClientProperties

public ClientProperties()