httpclient 4.5 api文档

### httpclient 4.5 API文档知识点概览 #### 一、基础知识 ##### 1.1 请求执行 **1.1.1 HTTP请求** - **定义**：HTTP客户端通过发送HTTP请求来与服务器进行交互。 - **组成**： - 方法（GET、POST等）； - URI（统一资源标识符）； - 协议版本（如HTTP/1.1）； - 请求头（例如Content-Type、User-Agent等）； - 请求体（对于GET请求通常为空）。 **1.1.2 HTTP响应** - **定义**：服务器对HTTP请求的回应。 - **组成**： - 状态码（如200、404等）； - 响应消息（如OK、Not Found等）； - 响应头（例如Content-Type、Content-Length等）； - 响应体（具体数据内容）。 **1.1.3 处理消息头** - **概念**：消息头用于提供有关请求或响应的附加信息。 - **示例**： - 设置`Accept-Language`来指定客户端接受的语言。 - 使用`Content-Type`来指定发送的数据类型。 **1.1.4 HTTP实体** - **定义**：HTTP实体由头部和主体组成，用于传输数据。 - **特性**： - 可以包含任意形式的数据，如文本、图像等。 - 实体头部可以包含元数据，如内容长度、内容类型等。 - 主体部分即为实际传输的数据。 **1.1.5 确保低级资源释放** - **重要性**：在处理完HTTP请求后，及时释放连接等资源是非常重要的，以避免资源泄露。 - **实现方法**：使用try-with-resources语句或显式调用close()方法。 **1.1.6 消费实体内容** - **操作**：获取并处理HTTP响应中的实体内容。 - **方式**： - 使用InputStream读取二进制数据。 - 使用String获取文本内容。 **1.1.7 生产实体内容** - **操作**：构建HTTP请求时设置请求实体。 - **方式**： - 将字符串转换为ByteEntity。 - 将文件转换为FileEntity。 **1.1.8 响应处理器** - **定义**：用于处理HTTP响应的接口。 - **作用**：可以根据业务需求自定义处理逻辑，如只关注状态码、提取特定头信息等。 ##### 1.2 HttpClient接口 **1.2.1 HttpClient线程安全** - **定义**：HttpClient实例可以在多个线程间共享。 - **注意事项**：虽然HttpClient实例本身是线程安全的，但其配置对象（如RequestConfig）不是。 **1.2.2 HttpClient资源释放** - **重要性**：确保所有连接和资源被正确关闭。 - **实现方法**： - 使用CloseableHttpClient替代HttpClient。 - 调用close()方法关闭连接。 ##### 1.3 HTTP执行上下文 - **定义**：执行HTTP请求时使用的上下文，用于存储各种状态信息。 - **作用**：允许开发者在请求过程中注入自定义逻辑。 ##### 1.4 HTTP协议拦截器 - **定义**：允许在请求/响应的处理过程中添加额外的逻辑。 - **用途**： - 添加或修改请求头。 - 自定义错误处理。 ##### 1.5 异常处理 **1.5.1 HTTP传输安全性** - **重要性**：确保数据传输的安全性和完整性。 - **实现方法**： - 使用HTTPS协议。 - 配置SSL/TLS连接。 **1.5.2 不可重复的方法** - **定义**：某些HTTP方法（如PUT、DELETE）如果失败，重试可能会导致不一致的状态。 - **解决方案**：使用预检查条件（If-Match, If-Unmodified-Since等）。 **1.5.3 自动异常恢复** - **定义**：在发生某些类型的异常时，自动尝试重新执行请求。 - **机制**：RequestRetryHandler接口。 **1.5.4 RequestRetryHandler** - **定义**：控制何时以及如何重试失败的请求。 - **实现**：根据特定条件（如HTTP状态码、异常类型等）决定是否重试。 ##### 1.6 中断请求 - **操作**：允许在执行请求的过程中中断。 - **实现方法**：使用AbortableHttpRequest接口。 ##### 1.7 重定向处理 - **定义**：处理来自服务器的HTTP重定向响应。 - **实现**：HttpClient支持自动处理常见的HTTP重定向状态码（如301, 302等）。 #### 二、连接管理 ##### 2.1 连接持久化 - **定义**：保持连接在一定时间内不关闭，以便后续请求使用。 - **优势**：提高性能，减少建立新连接的开销。 ##### 2.2 HTTP连接路由 **2.2.1 路由计算** - **定义**：确定到达目标主机的最佳路径。 - **考虑因素**：主机地址、端口等。 **2.2.2 安全HTTP连接** - **定义**：使用HTTPS协议建立加密连接。 - **实现方法**：配置SSLContext和SSLSocketFactory。 ##### 2.3 HTTP连接管理器 **2.3.1 管理的连接和连接管理器** - **定义**：负责管理连接池、创建和销毁连接的组件。 - **作用**：提高性能和资源利用率。 **2.3.2 简单连接管理器** - **定义**：简单的连接管理策略。 - **特点**：每次请求分配一个连接，请求结束后关闭连接。 **2.3.3 连接池管理器** - **定义**：维护一个连接池，管理连接的生命周期。 - **优点**：复用连接，提高性能。 **2.3.4 连接管理器关闭** - **定义**：关闭连接管理器，释放所有资源。 - **实现方法**：调用shutdown()方法。 ##### 2.4 多线程请求执行 - **定义**：在多线程环境中执行HTTP请求。 - **挑战**：确保线程安全，防止资源竞争。 ##### 2.5 连接驱逐策略 - **定义**：定期检查连接池中的连接，关闭闲置时间过长的连接。 - **目的**：防止资源浪费。 ##### 2.6 连接保活策略 - **定义**：维护连接活动状态，防止服务器端关闭空闲连接。 - **实现方法**：定期发送空闲探测包。 ##### 2.7 连接套接字工厂 **2.7.1 安全套接字层** - **定义**：提供加密通信的机制。 - **实现方法**：使用SSLContext和SSLSocketFactory。 **2.7.2 与连接管理器集成** - **定义**：将SSL配置应用于连接管理器。 - **实现方法**：通过设置SocketConfig实现。 **2.7.3 SSL/TLS定制** - **定义**：根据需求调整SSL/TLS配置。 - **示例**：禁用弱加密算法、启用特定密码套件等。 **2.7.4 主机名验证** - **定义**：验证SSL证书中的主机名与实际访问的主机名是否匹配。 - **实现方法**：使用HostnameVerifier接口。 ##### 2.8 HttpClient代理配置 - **定义**：配置代理服务器以转发HTTP请求。 - **实现方法**：设置HttpHost对象作为代理配置。 #### 三、HTTP状态管理 ##### 3.1 HTTP Cookie - **定义**：用于在客户端和服务器之间传递状态信息的小型文本文件。 - **作用**：实现会话跟踪等功能。 ##### 3.2 Cookie规范 - **定义**：定义了Cookie的工作原理和规则。 - **示例**：RFC 6265标准。 ##### 3.3 选择Cookie策略 - **定义**：根据应用需求选择合适的Cookie处理策略。 - **选项**：Strict、Lax等。 ##### 3.4 自定义Cookie策略 - **定义**：允许用户根据特定需求自定义Cookie处理逻辑。 - **实现方法**：实现CookieSpec接口。 ##### 3.5 Cookie持久化 - **定义**：将Cookie保存到磁盘上，以便下次会话继续使用。 - **实现方法**：使用CookieStore接口。 ##### 3.6 HTTP状态管理和执行上下文 - **定义**：在HTTP执行上下文中管理状态信息。 - **作用**：确保跨请求的状态一致性。 #### 四、HTTP认证 ##### 4.1 用户凭证 - **定义**：用于验证用户身份的信息，如用户名和密码。 - **存储方式**：使用CredentialsProvider接口。 ##### 4.2 认证方案 - **定义**：用于认证用户的协议。 - **示例**：Basic、Digest、NTLM等。 ##### 4.3 凭证提供者 - **定义**：管理用户凭证的对象。 - **实现方法**：使用DefaultCredentialsProvider类。 ##### 4.4 HTTP认证和执行上下文 - **定义**：在执行上下文中管理认证信息。 - **作用**：简化认证过程。 ##### 4.5 认证数据缓存 - **定义**：缓存认证数据，以减少认证请求次数。 - **实现方法**：使用AuthCache接口。 ##### 4.6 预先认证 - **定义**：在发送请求之前就提供认证信息。 - **优势**：避免往返延迟，提高效率。 ##### 4.7 NTLM认证 **4.7.1 NTLM连接持久化** - **定义**：在NTLM认证场景下保持连接活动状态。 - **实现方法**：使用NtlmScheme类。 ##### 4.8 SPNEGO/Kerberos认证 **4.8.1 SPNEGO支持** - **定义**：支持SPNEGO协议进行Kerberos认证。 - **实现方法**：使用SpnegoScheme类。 **4.8.2 GSS/Java Kerberos Setup** - **定义**：配置Java环境以支持Kerberos认证。 - **实现方法**：设置系统属性，如java.security.auth.login.config等。 **4.8.3 login.conf文件** - **定义**：定义认证模块及其配置的文件。 - **作用**：指定Kerberos认证的具体配置。 **4.8.4 krb5.conf文件** - **定义**：配置Kerberos服务的文件。 - **作用**：指定Kerberos服务的位置和其他设置。 以上总结了httpclient 4.5 API文档中关于HTTP客户端的基本使用、连接管理、状态管理以及认证等方面的核心知识点。通过对这些知识点的理解，可以帮助开发者更好地利用httpclient库进行高效、可靠的HTTP通信开发。