org.glassfish.jersey.client

Interface HttpUrlConnectorProvider.ConnectionFactory

All Known Implementing Classes:

HttpUrlConnectorProvider.DefaultConnectionFactory

Enclosing class:

HttpUrlConnectorProvider

public static interface HttpUrlConnectorProvider.ConnectionFactory

A factory for HttpURLConnection instances.

A factory may be used to create a HttpURLConnection and configure it in a custom manner that is not possible using the Client API.

A custom factory instance may be registered in the HttpUrlConnectorProvider instance via HttpUrlConnectorProvider.connectionFactory(ConnectionFactory) method.

Method Summary

Modifier and Type	Method and Description
java.net.HttpURLConnection	getConnection(java.net.URL url) Get a HttpURLConnection for a given URL.

Method Detail

getConnection

java.net.HttpURLConnection getConnection(java.net.URL url)
                                  throws java.io.IOException

Get a HttpURLConnection for a given URL.

Implementation of the method MUST be thread-safe and MUST ensure that a dedicated HttpURLConnection instance is returned for concurrent requests.

Parameters:

url - the endpoint URL.

Returns:

the HttpURLConnection.

Throws:

java.io.IOException - in case the connection cannot be provided.