org.glassfish.jersey.jetty.connector

Class JettyConnectorProvider

java.lang.Object

org.glassfish.jersey.jetty.connector.JettyConnectorProvider

All Implemented Interfaces:

ConnectorProvider

public class JettyConnectorProvider
extends Object
implements ConnectorProvider

A ConnectorProvider for Jersey connector instances that utilize the Jetty HTTP Client to send and receive HTTP request and responses.

The following connector configuration properties are supported:

• ClientProperties.ASYNC_THREADPOOL_SIZE
• ClientProperties.CONNECT_TIMEOUT
• ClientProperties.FOLLOW_REDIRECTS
• ClientProperties.PROXY_URI
• ClientProperties.PROXY_USERNAME
• ClientProperties.PROXY_PASSWORD
• ClientProperties.PROXY_PASSWORD
• JettyClientProperties.SSL_CONFIG
• JettyClientProperties.PREEMPTIVE_BASIC_AUTHENTICATION
• JettyClientProperties.DISABLE_COOKIES

This transport supports both synchronous and asynchronous processing of client requests. The following methods are supported: GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE, CONNECT and MOVE.

Typical usage:

 ClientConfig config = new ClientConfig();
 config.connectorProvider(new JettyConnectorProvider());
 Client client = ClientBuilder.newClient(config);

 // async request
 WebTarget target = client.target("http://localhost:8080");
 Future<Response> future = target.path("resource").request().async().get();

 // wait for 3 seconds
 Response response = future.get(3, TimeUnit.SECONDS);
 String entity = response.readEntity(String.class);
 client.close();
 
 

Connector instances created via Jetty HTTP Client-based connector provider support only entity buffering. Defining the property ClientProperties.REQUEST_ENTITY_PROCESSING has no effect on Jetty HTTP Client-based connectors.

Since:

2.5

Author:

Arul Dhesiaseelan (aruld at acm.org), Marek Potociar (marek.potociar at oracle.com)

Constructor Summary

Constructors

Constructor and Description
JettyConnectorProvider()

Method Summary

Methods

Modifier and Type	Method and Description
Connector	getConnector(Client client, Configuration runtimeConfig) Get a Jersey client connector instance for a given client instance and Jersey client runtime configuration.
static org.eclipse.jetty.client.HttpClient	getHttpClient(Configurable<?> component) Retrieve the underlying Jetty HttpClient instance from JerseyClient or JerseyWebTarget configured to use JettyConnectorProvider.

Methods inherited from class java.lang.Object

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

Constructor Detail

JettyConnectorProvider

public JettyConnectorProvider()

Method Detail

getConnector

public Connector getConnector(Client client,
                     Configuration runtimeConfig)

Description copied from interface: ConnectorProvider

Get a Jersey client connector instance for a given client instance and Jersey client runtime configuration.

Note that the supplied runtime configuration can be different from the client instance configuration as a single client can be used to serve multiple differently configured runtimes. While the SSL context or hostname verifier are shared, other configuration properties may change in each runtime.

Based on the supplied client and runtime configuration data, it is up to each connector provider implementation to decide whether a new dedicated connector instance is required or if the existing, previously create connector instance can be reused.

Specified by:

getConnector in interface ConnectorProvider

Parameters:

client - Jersey client instance.

runtimeConfig - Jersey client runtime configuration.

Returns:

configured Connector instance to be used by the client.

getHttpClient

public static org.eclipse.jetty.client.HttpClient getHttpClient(Configurable<?> component)

Retrieve the underlying Jetty HttpClient instance from JerseyClient or JerseyWebTarget configured to use JettyConnectorProvider.

Parameters:

component - JerseyClient or JerseyWebTarget instance that is configured to use JettyConnectorProvider.

Returns:

underlying Jetty HttpClient instance.

Throws:

IllegalArgumentException - in case the component is neither JerseyClient nor JerseyWebTarget instance or in case the component is not configured to use a JettyConnectorProvider.

Since:

2.8