Package org.glassfish.jersey.jetty.connector

Class JettyConnector

java.lang.Object

org.glassfish.jersey.jetty.connector.JettyConnector

All Implemented Interfaces:

Connector, Inflector<ClientRequest,ClientResponse>

public class JettyConnector
extends Object
implements Connector

A Connector that utilizes the Jetty HTTP Client to send and receive HTTP request and responses.

The following properties are only supported at construction of this class:

• ClientProperties.ASYNC_THREADPOOL_SIZE
• ClientProperties.CONNECT_TIMEOUT
• ClientProperties.FOLLOW_REDIRECTS
• ClientProperties.PROXY_URI
• ClientProperties.PROXY_USERNAME
• ClientProperties.PROXY_PASSWORD
• ClientProperties.PROXY_PASSWORD
• JettyClientProperties.DISABLE_COOKIES
*
• JettyClientProperties.ENABLE_SSL_HOSTNAME_VERIFICATION
• JettyClientProperties.PREEMPTIVE_BASIC_AUTHENTICATION
• JettyClientProperties.SYNC_LISTENER_RESPONSE_MAX_SIZE

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();
 Connector connector = new Jetty11Connector(config);
 config.connector(connector);
 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();
 
 

This connector supports only entity buffering. Defining the property ClientProperties.REQUEST_ENTITY_PROCESSING has no effect on this connector.

Author:

Arul Dhesiaseelan (aruld at acm.org), Marek Potociar

Constructor Summary

Constructors

Constructor	Description
JettyConnector(Client jaxrsClient, Configuration config)	Create the new Jetty client connector.

Method Summary

Modifier and Type	Method	Description
ClientResponse	apply(ClientRequest jerseyRequest)
Future<?>	apply(ClientRequest jerseyRequest, AsyncConnectorCallback callback)
void	close()
CookieStore	getCookieStore()	Get the CookieStore.
org.eclipse.jetty.client.HttpClient	getHttpClient()	Get the HttpClient.
String	getName()
protected org.eclipse.jetty.client.HttpClient	getRegisteredHttpClient(Configuration config)	provides custom registered HttpClient if any (or NULL)
protected org.eclipse.jetty.client.HttpClientTransport	initClientTransport(org.eclipse.jetty.io.ClientConnector clientConnector)	provides required HTTP client transport for client the default transport is HttpClientTransportOverHTTP

Methods inherited from class java.lang.Object

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

Constructor Detail

JettyConnector

public JettyConnector(Client jaxrsClient,
                      Configuration config)

Create the new Jetty client connector.

Parameters:

jaxrsClient - JAX-RS client instance, for which the connector is created.

config - client configuration.

Method Detail

initClientTransport

protected org.eclipse.jetty.client.HttpClientTransport initClientTransport(org.eclipse.jetty.io.ClientConnector clientConnector)

provides required HTTP client transport for client the default transport is HttpClientTransportOverHTTP

Returns:

instance of HttpClientTransport

Since:

2.41

getRegisteredHttpClient

protected org.eclipse.jetty.client.HttpClient getRegisteredHttpClient(Configuration config)

provides custom registered HttpClient if any (or NULL)

Parameters:

config - configuration where HttpClient could be registered

Returns:

HttpClient instance if any was previously registered or NULL

Since:

2.41

getHttpClient

public org.eclipse.jetty.client.HttpClient getHttpClient()

Get the HttpClient.

Returns:

the HttpClient.

getCookieStore

public CookieStore getCookieStore()

Get the CookieStore.

Returns:

the CookieStore instance or null when Jetty11ClientProperties.DISABLE_COOKIES set to true.

apply

public ClientResponse apply(ClientRequest jerseyRequest)
                     throws ProcessingException

Specified by:

apply in interface Connector

Specified by:

apply in interface Inflector<ClientRequest,ClientResponse>

Throws:

ProcessingException

apply

public Future<?> apply(ClientRequest jerseyRequest,
                       AsyncConnectorCallback callback)

Specified by:

apply in interface Connector

getName

public String getName()

Specified by:

getName in interface Connector

close

public void close()

Specified by:

close in interface Connector