Apache HttpClient for Java: Complete Guide with Examples

What is Apache HttpClient and why is it needed

Apache HttpClient is a powerful and flexible Java library designed for executing HTTP requests. It provides developers with full control over the process of sending and receiving data via the HTTP protocol. Unlike the built-in java.net.HttpURLConnection class, Apache HttpClient offers a higher-level API, support for modern standards (HTTP/1.1, HTTP/2), convenient work with cookies, authentication, connection pooling, and request interceptors.

The library is indispensable in the following scenarios:

• Interacting with REST APIs — sending GET, POST, PUT, DELETE requests to web services.
• Web scraping — downloading HTML content for further analysis.
• Testing web applications — simulating client requests.
• Microservice architecture — data exchange between services.
• File downloading — downloading binary data (images, archives).

Installing Apache HttpClient

Apache HttpClient is not installed via pip or npm, as it is a Java library. To include it, you use a dependency management system such as Maven or Gradle. Instructions for both options are provided below.

Installation via Maven (pom.xml)

Add the following dependencies to your pom.xml file:

<dependency>    <groupId>org.apache.httpcomponents</groupId>    <artifactId>httpclient</artifactId>    <version>4.5.14</version></dependency>

<dependency>    <groupId>org.apache.httpcomponents</groupId>    <artifactId>httpmime</artifactId>    <version>4.5.14</version></dependency>

Installation via Gradle (build.gradle)

Add to the dependencies section:

implementation 'org.apache.httpcomponents:httpclient:4.5.14'implementation 'org.apache.httpcomponents:httpmime:4.5.14'

For HTTP/2 support (version 5.x), use:

implementation 'org.apache.httpcomponents.client5:httpclient5:5.3.1'

Quick Start: Your First HTTP Request

Create a simple Java class and execute a GET request to a public API:

import org.apache.http.client.methods.CloseableHttpResponse;import org.apache.http.client.methods.HttpGet;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClients;import org.apache.http.util.EntityUtils;

public class QuickStart {    public static void main(String[] args) {        // 1. Create an HTTP client        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {                        // 2. Create a GET request            HttpGet request = new HttpGet("https://jsonplaceholder.typicode.com/posts/1");                        // 3. Execute the request and get the response            try (CloseableHttpResponse response = httpClient.execute(request)) {                                // 4. Extract the response body                String body = EntityUtils.toString(response.getEntity());                                // 5. Print the result                System.out.println("Status code: " + response.getStatusLine().getStatusCode());                System.out.println("Response body: " + body);            }        } catch (Exception e) {            e.printStackTrace();        }    }}

Main Methods and Functions of Apache HttpClient

1. HttpGet — Executing a GET Request

Description: Creates an HTTP GET request to retrieve data from the server.

Parameters:

• String uri — The request URL.

<