Apache HttpComponents HttpClient

Apache HttpComponents HttpClient

Apache HttpComponents HttpClient 是 Apache 提供的一个开源库,用于在 Java 应用程序中执行 HTTP 请求和响应处理。它支持同步和异步模式,提供了对常见 HTTP 操作的简单而强大的封装。

1.HTTP 请求

实体

实体可以理解为 HTTP 请求或响应的"数据负载"。它可以包含:

  • 字符串数据(如 JSON、XML)
  • 文件数据(如图片、PDF)
  • 表单数据 (如 x-www-form-urlencodedmultipart/form-data

通过 Entity 类封装的请求体或响应体可以承载任何格式的数据,传递给服务器或从服务器接收。

请求数据格式:

  • application/x-www-form-urlencoded

    • 格式 :键值对形式,key=value,多个键值对之间用 & 连接。

    • 编码 :特殊字符和空格使用 URL 编码(如空格为 +& 编码为 %26)。

    • 应用:传统 Web 表单提交的默认格式,常用于简单数据的传输。

    • 示例

      复制代码
      name=John+Doe&age=25&city=New+York
  • application/json

    • 格式 :JSON 格式,表示复杂的对象结构,用 {} 表示对象,键值对用 : 连接。
    • 编码:不需要 URL 编码,数据直接作为 JSON 字符串传输。
    • 应用:现代 RESTful API 常用的数据格式,适合复杂对象和嵌套结构。
    复制代码
      {
        "name": "John Doe",
        "age": 25,
        "city": "New York"
      }

超时配置:

  • 连接超时 (setConnectTimeout):设定客户端与服务器建立连接的最大等待时间。

  • 请求超时 (setConnectionRequestTimeout):从连接池获取连接的最大等待时间。

  • 读取超时 (setSocketTimeout):等待服务器返回数据的最大时间。

    private static RequestConfig builderRequestConfig() {
    return RequestConfig.custom()
    .setConnectTimeout(TIMEOUT_MSEC) // 连接超时
    .setConnectionRequestTimeout(TIMEOUT_MSEC) // 请求超时
    .setSocketTimeout(TIMEOUT_MSEC) // 读取超时
    .build(); // 构建配置
    }

2. 主要功能

  • HTTP 请求的发送:支持 GET、POST、PUT、DELETE 等各种 HTTP 请求方法。
  • 连接管理:包括持久连接、连接池和请求重试等机制,确保高效和可靠的 HTTP 连接管理。
  • 超时控制:支持连接超时、请求超时、套接字超时的配置。
  • SSL 支持:内置对 HTTPS(SSL/TLS)的支持,能够通过证书进行安全通信。
  • 重定向与代理支持:自动处理 HTTP 重定向以及通过代理服务器发送请求。

3.示例网络请求

复制代码
import org.apache.http.client.methods.*;
import org.apache.http.impl.client.*;
import org.apache.http.util.EntityUtils;
import org.apache.http.entity.StringEntity;

public class HttpClientExample {
    public static void main(String[] args) throws Exception {
        // 创建HttpClient
        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            
            // GET请求
            HttpGet getRequest = new HttpGet("http://www.example.com");
            try (CloseableHttpResponse response = httpClient.execute(getRequest)) {
                String getResult = EntityUtils.toString(response.getEntity());
                System.out.println("GET响应: " + getResult);
            }

            // POST请求
            HttpPost postRequest = new HttpPost("http://www.example.com/post");
            postRequest.setEntity(new StringEntity("{\"key\":\"value\"}", "UTF-8"));
            postRequest.setHeader("Content-Type", "application/json");
            try (CloseableHttpResponse response = httpClient.execute(postRequest)) {
                String postResult = EntityUtils.toString(response.getEntity());
                System.out.println("POST响应: " + postResult);
            }
        }
    }
}
  • GET 请求

    • 需要将返回的实体通过 EntityUtils.toString() 转为字符串,以方便处理响应内容。
  • POST 请求

    • 使用 setHeader() 设置请求头信息,例如 Content-Typeapplication/json,并指定编码方式。
    • 需要使用 StringEntity 封装请求数据为一个实体对象,方便发送带有请求体的数据。
相关推荐
朝新_8 分钟前
【EE初阶 - 网络原理】传输层协议
java·开发语言·网络·笔记·javaee
小吴-斌35 分钟前
本地请求接口报SSL错误解决办法(Could not verify * SSL certificate)
网络·网络协议·ssl
AORO20252 小时前
航运、应急、工业适用,AORO P1100三防平板引领行业数字化变革
运维·服务器·网络·智能手机·电脑·信息与通信
云飞云共享云桌面3 小时前
替代传统电脑的共享云服务器如何实现1拖8SolidWorks设计办公
linux·运维·服务器·网络·电脑·制造
RollingPin4 小时前
iOS八股文之 网络
网络·网络协议·ios·https·udp·tcp·ios面试
惘嘫、冋渞9 小时前
AWS同一账号下创建自定义VPC并配置不同区域的对等链接
网络·云计算·aws
云知谷11 小时前
【HTML】网络数据是如何渲染成HTML网页页面显示的
开发语言·网络·计算机网络·html
小毛驴85011 小时前
HTTP方法GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS,TRACE,RESTful API设计的核心详解
http·github·restful
呉師傅15 小时前
关于联想ThinkCentre M950t-N000 M大师电脑恢复预装系统镜像遇到的一点问题
运维·网络·windows·电脑
代码AI弗森16 小时前
无状态的智慧:从 HTTP 到大模型的系统进化论
网络·网络协议·http