使用Apache HttpClient发起一个GET HTTP请求

Apache HttpClient 是一个强大且灵活的Java库，用于处理HTTP请求。

它提供了广泛的功能，包括对不同HTTP方法的支持、连接管理、Cookie处理等。

无论是与RESTful API交互、下载网页内容还是自动化网页任务，Apache HttpClient 都能通过其简洁而强大的API简化这些操作。

本教程将演示如何使用Apache HttpClient发起一个GET HTTP请求，展示它的易用性和多功能性。

了解HTTP GET方法

HTTP GET方法用于从指定资源请求数据。GET请求通常用于从服务器检索数据，如网页、图片或来自RESTful API的数据。GET请求的主要特征包括：

只读：GET请求用于获取数据而不对资源进行任何更改。
安全：执行GET请求不应在服务器上产生副作用。
幂等性：多个相同的GET请求应具有与单个请求相同的效果。
可缓存：GET请求的响应可以被浏览器或代理缓存以提高性能。

示例场景

我们将创建一个简单的Java类，向JSONPlaceholder API发送GET请求并打印响应。

JSONPlaceholder API提供了一个免费的在线REST API，可用于测试和原型设计。

我们将使用/posts/1端点来检索一条帖子，该端点的URL为：https://jsonplaceholder.typicode.com/posts/1

Maven依赖

要使用Apache HttpClient，请在你的pom.xml文件中添加如下依赖：

xml 复制代码

<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.3</version>
</dependency>

Java类 - 发送GET请求

创建名为HttpClientExample的类，并使用以下代码：

java 复制代码

import org.apache.hc.client5.http.classic.methods.HttpGet;
import org.apache.hc.client5.http.classic.methods.CloseableHttpResponse;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.core5.http.io.entity.EntityUtils;

public class HttpClientExample {
    public static void main(String[] args) {
        String url = "https://jsonplaceholder.typicode.com/posts/1";
        
        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpGet request = new HttpGet(url);
            
            try (CloseableHttpResponse response = httpClient.execute(request)) {
                System.out.println("响应码: " + response.getCode());
                
                String content = EntityUtils.toString(response.getEntity());
                System.out.println("响应内容: \n" + content);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行示例

运行HttpClientExample类，你将在控制台看到状态码和响应内容。

输出示例

响应码: 200
响应内容: 
{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "body": "quia et suscipit\nsuscipit...
}

额外配置

设置自定义头 ：你可以通过调用HttpGet对象上的setHeader方法来设置GET请求的自定义头部信息。
处理重定向 ：默认情况下，Apache HttpClient会自动处理重定向。你可以通过使用自定义的HttpClientBuilder来调整此行为。
设置超时 ：可以通过RequestConfig设置连接和套接字超时。

总结

使用Apache HttpClient发起GET HTTP请求既直接又灵活。

按照本教程，你现在应该能够创建和执行GET请求、处理响应以及定制HTTP请求和响应过程中的各种方面了。

Apache HttpClient提供了一整套功能，使其成为处理Java应用程序中HTTP操作的优秀选择。

JSONPlaceholder API作为测试和原型化HTTP请求的实际而方便的来源。