org.glassfish.jersey.client

Interface HttpUrlConnectorProvider.ConnectionFactory

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
HttpURLConnection	getConnection(URL url) Get a HttpURLConnection for a given URL.
default HttpURLConnection	getConnection(URL url, Proxy proxy) Get a HttpURLConnection for a given URL.

Method Detail

getConnection

HttpURLConnection getConnection(URL url)
                         throws 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:

IOException - in case the connection cannot be provided.

getConnection

default HttpURLConnection getConnection(URL url,
                                        Proxy proxy)
                                 throws 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.

proxy - the configured proxy or null.

Returns:

the HttpURLConnection.

Throws:

IOException - in case the connection cannot be provided.