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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class Apache5HttpTransport (2.0.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.0.0 (latest)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.47.1](/java/docs/reference/google-http-client/1.47.1/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.46.3](/java/docs/reference/google-http-client/1.46.3/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.45.3](/java/docs/reference/google-http-client/1.45.3/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.44.2](/java/docs/reference/google-http-client/1.44.2/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.43.2](/java/docs/reference/google-http-client/1.43.2/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.42.3](/java/docs/reference/google-http-client/1.42.3/com.google.api.client.http.apache.v5.Apache5HttpTransport)\n- [1.41.8](/java/docs/reference/google-http-client/1.41.8/com.google.api.client.http.apache.v5.Apache5HttpTransport) \n\n public final class Apache5HttpTransport extends HttpTransport\n\nThread-safe HTTP transport based on the Apache HTTP Client library.\n\nImplementation is thread-safe, as long as any parameter modification to the [Apache HTTP Client](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport#com_google_api_client_http_apache_v5_Apache5HttpTransport_getHttpClient__) is only done at initialization time. For maximum efficiency,\napplications should use a single globally-shared instance of the HTTP transport.\n\nDefault settings are specified in [#newDefaultHttpClient()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport#com_google_api_client_http_apache_v5_Apache5HttpTransport_newDefaultHttpClient__). Use the [#Apache5HttpTransport(HttpClient)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport#com_google_api_client_http_apache_v5_Apache5HttpTransport_Apache5HttpTransport_org_apache_hc_client5_http_classic_HttpClient_) constructor to override the Apache HTTP Client used. Please\nread the [Apache HTTP Client 5.x configuration example](https://github.com/apache/httpcomponents-client/blob/f898f1aca38f77f62a007856a674629cae5a02e6/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java) for more complex configuration options. \n\nInheritance\n-----------\n\n[java.lang.Object](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html) \\\u003e [HttpTransport](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport) \\\u003e Apache5HttpTransport \n\nInherited Members\n-----------------\n\n[HttpTransport.buildRequest(String,String)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_buildRequest_java_lang_String_java_lang_String_) \n[HttpTransport.createRequestFactory()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_createRequestFactory__) \n[HttpTransport.createRequestFactory(HttpRequestInitializer)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_createRequestFactory_com_google_api_client_http_HttpRequestInitializer_) \n[HttpTransport.isMtls()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_isMtls__) \n[HttpTransport.isShutdown()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_isShutdown__) \n[HttpTransport.shutdown()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_shutdown__) \n[HttpTransport.supportsMethod(String)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_supportsMethod_java_lang_String_) \n[Object.clone()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--) \n[Object.equals(Object)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-) \n[Object.finalize()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--) \n[Object.getClass()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--) \n[Object.hashCode()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--) \n[Object.notify()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--) \n[Object.notifyAll()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--) \n[Object.toString()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--) \n[Object.wait()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--) \n[Object.wait(long)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-) \n[Object.wait(long,int)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-)\n\nStatic Methods\n--------------\n\n### newDefaultHttpClient()\n\n public static HttpClient newDefaultHttpClient()\n\nCreates a new instance of the Apache HTTP client that is used by the [#Apache5HttpTransport()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport#com_google_api_client_http_apache_v5_Apache5HttpTransport_Apache5HttpTransport__) constructor.\n\nSettings:\n\n- The client connection manager is set to PoolingHttpClientConnectionManager.\n- The retry mechanism is turned off using HttpClientBuilder#disableAutomaticRetries().\n- Redirects are turned off using HttpClientBuilder#disableRedirectHandling.\n- The route planner uses SystemDefaultRoutePlanner with ProxySelector#getDefault(), which uses the proxy settings from [system\n properties](https://docs.oracle.com/javase/8/docs/api/java/net/doc-files/net-properties.html).\n\n### newDefaultHttpClientBuilder()\n\n public static HttpClientBuilder newDefaultHttpClientBuilder()\n\nCreates a new Apache HTTP client builder that is used by the [#Apache5HttpTransport()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport#com_google_api_client_http_apache_v5_Apache5HttpTransport_Apache5HttpTransport__)\nconstructor.\n\nSettings:\n\n- The client connection manager is set to PoolingHttpClientConnectionManager.\n- The retry mechanism is turned off using HttpClientBuilder#disableAutomaticRetries().\n- Redirects are turned off using HttpClientBuilder#disableRedirectHandling.\n- The route planner uses SystemDefaultRoutePlanner with ProxySelector#getDefault(), which uses the proxy settings from [system\n properties](http://docs.oracle.com/javase/8/docs/api/java/net/doc-files/net-properties.html).\n\nConstructors\n------------\n\n### Apache5HttpTransport()\n\n public Apache5HttpTransport()\n\nConstructor that uses [#newDefaultHttpClient()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.apache.v5.Apache5HttpTransport#com_google_api_client_http_apache_v5_Apache5HttpTransport_newDefaultHttpClient__) for the Apache HTTP client.\n\n### Apache5HttpTransport(HttpClient httpClient)\n\n public Apache5HttpTransport(HttpClient httpClient)\n\nConstructor that allows an alternative Apache HTTP client to be used.\n\nIf you choose to provide your own Apache HttpClient implementation, be sure that\n\n- HTTP version is set to 1.1.\n- Retries are disabled (google-http-client handles retries).\n\n### Apache5HttpTransport(HttpClient httpClient, boolean isMtls)\n\n public Apache5HttpTransport(HttpClient httpClient, boolean isMtls)\n\n[Beta](/java/docs/reference/google-http-client/latest/com.google.api.client.util.Beta) \n\nConstructor that allows an alternative CLoseable Apache HTTP client to be used.\n\nIf you choose to provide your own Apache HttpClient implementation, be sure that\n\n- HTTP version is set to 1.1.\n- Retries are disabled (google-http-client handles retries).\n- Redirects are disabled (google-http-client handles retries).\n\nMethods\n-------\n\n### buildRequest(String method, String url)\n\n protected Apache5HttpRequest buildRequest(String method, String url)\n\nBuilds a low level HTTP request for the given HTTP method.\n\n**Overrides** \n[HttpTransport.buildRequest(String method, String url)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_buildRequest_java_lang_String_java_lang_String_)\n\n### getHttpClient()\n\n public HttpClient getHttpClient()\n\nReturns the Apache HTTP client.\n\n### isMtls()\n\n public boolean isMtls()\n\nReturns if the underlying HTTP client is mTLS.\n\n**Overrides** \n[HttpTransport.isMtls()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_isMtls__)\n\n### shutdown()\n\n public void shutdown()\n\nGracefully shuts down the connection manager and releases allocated resources. This closes all\nconnections, whether they are currently used or not.\n**Overrides** \n[HttpTransport.shutdown()](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_shutdown__)\n\n### supportsMethod(String method)\n\n public boolean supportsMethod(String method)\n\nReturns whether a specified HTTP method is supported by this transport.\n\nDefault implementation returns true if and only if the request method is `\"DELETE\"`,\n`\"GET\"`, `\"POST\"`, or `\"PUT\"`. Subclasses should override.\n\n**Overrides** \n[HttpTransport.supportsMethod(String method)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport#com_google_api_client_http_HttpTransport_supportsMethod_java_lang_String_)"]]
