Class ApacheHttpTransport (1.45.0)

public final class ApacheHttpTransport extends HttpTransport

Thread-safe HTTP transport based on the Apache HTTP Client library.

Implementation is thread-safe, as long as any parameter modification to the Apache HTTP Client is only done at initialization time. For maximum efficiency, applications should use a single globally-shared instance of the HTTP transport.

Default settings are specified in #newDefaultHttpClient(). Use the #ApacheHttpTransport(HttpClient) constructor to override the Apache HTTP Client used. Please read the Apache HTTP Client connection management tutorial for more complex configuration options.

Inheritance

java.lang.Object > HttpTransport > ApacheHttpTransport

Inherited Members

HttpTransport.buildRequest(String,String)

HttpTransport.createRequestFactory()

HttpTransport.createRequestFactory(HttpRequestInitializer)

HttpTransport.isMtls()

HttpTransport.isShutdown()

HttpTransport.shutdown()

HttpTransport.supportsMethod(String)

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Methods

newDefaultHttpClient()

public static HttpClient newDefaultHttpClient()

Creates a new instance of the Apache HTTP client that is used by the #ApacheHttpTransport() constructor.

Settings:

The client connection manager is set to PoolingHttpClientConnectionManager.
<The retry mechanism is turned off using HttpClientBuilder#disableRedirectHandling.
The route planner uses SystemDefaultRoutePlanner with ProxySelector#getDefault(), which uses the proxy settings from system properties.

Returns
Type	Description
`org.apache.http.client.HttpClient`	new instance of the Apache HTTP client

newDefaultHttpClientBuilder()

public static HttpClientBuilder newDefaultHttpClientBuilder()

Creates a new Apache HTTP client builder that is used by the #ApacheHttpTransport() constructor.

Settings:

The client connection manager is set to PoolingHttpClientConnectionManager.
<The retry mechanism is turned off using HttpClientBuilder#disableRedirectHandling.
The route planner uses SystemDefaultRoutePlanner with ProxySelector#getDefault(), which uses the proxy settings from system properties.

Returns
Type	Description
`org.apache.http.impl.client.HttpClientBuilder`	new instance of the Apache HTTP client

Constructors

ApacheHttpTransport()

public ApacheHttpTransport()

Constructor that uses #newDefaultHttpClient() for the Apache HTTP client.

ApacheHttpTransport(HttpClient httpClient)

public ApacheHttpTransport(HttpClient httpClient)

Constructor that allows an alternative Apache HTTP client to be used.

Note that in the previous version, we overrode several settings. However, we are no longer able to do so.

If you choose to provide your own Apache HttpClient implementation, be sure that

HTTP version is set to 1.1.
Redirects are disabled (google-http-client handles redirects).
Retries are disabled (google-http-client handles retries).

Parameter
Name	Description
`httpClient`	`org.apache.http.client.HttpClient` Apache HTTP client to use

ApacheHttpTransport(HttpClient httpClient, boolean isMtls)

public ApacheHttpTransport(HttpClient httpClient, boolean isMtls)

Beta
Constructor that allows an alternative Apache HTTP client to be used.

Note that in the previous version, we overrode several settings. However, we are no longer able to do so.

If you choose to provide your own Apache HttpClient implementation, be sure that

HTTP version is set to 1.1.
Redirects are disabled (google-http-client handles redirects).
Retries are disabled (google-http-client handles retries).

Parameters
Name	Description
`httpClient`	`org.apache.http.client.HttpClient` Apache HTTP client to use
`isMtls`	`boolean` If the HTTP client is mutual TLS

Methods

buildRequest(String method, String url)

protected ApacheHttpRequest buildRequest(String method, String url)

Builds a low level HTTP request for the given HTTP method.

Parameters
Name	Description
`method`	`String`
`url`	`String`

Returns
Type	Description
`com.google.api.client.http.apache.v2.ApacheHttpRequest`

Overrides

HttpTransport.buildRequest(String method, String url)

getHttpClient()

public HttpClient getHttpClient()

Returns the Apache HTTP client.

Returns
Type	Description
`org.apache.http.client.HttpClient`

isMtls()

public boolean isMtls()

Returns if the underlying HTTP client is mTLS.

Returns
Type	Description
`boolean`

Overrides

HttpTransport.isMtls()

shutdown()

public void shutdown()

Shuts down the connection manager and releases allocated resources. This closes all connections, whether they are currently used or not.

Overrides

HttpTransport.shutdown()

Exceptions
Type	Description
`IOException`

supportsMethod(String method)

public boolean supportsMethod(String method)

Returns whether a specified HTTP method is supported by this transport.

Default implementation returns true if and only if the request method is "DELETE", "GET", "POST", or "PUT". Subclasses should override.

Parameter
Name	Description
`method`	`String`

Returns
Type	Description
`boolean`

Overrides

HttpTransport.supportsMethod(String method)