HttpClient4.x基础与实战教程

4星 · 超过85%的资源需积分: 13 52 浏览量更新于2024-07-27 收藏 915KB PDF 举报

"Apache HttpClient4.x简明教程高清PDF版" Apache HttpClient是一个强大的Java库，专为执行HTTP请求而设计。本教程详细介绍了HttpClient的基本概念、功能和使用方法，适合初学者快速上手。以下是对教程内容的概述： 1. **HttpClient的范围**：HttpClient库提供了丰富的API，支持HTTP协议的各个层面，包括执行HTTP请求、处理响应、管理连接、处理认证和状态等。它允许开发者创建复杂的HTTP客户端应用，支持各种HTTP方法如GET、POST、PUT等。 2. **HTTP请求与响应**：HttpClient允许开发者构造HTTP请求，并发送到指定服务器。请求包括报文头和实体内容。收到响应时，可以解析响应状态码、头部信息和实体内容。HttpClient还提供了解析和释放资源的功能，以避免内存泄漏。 3. **处理报文头部和实体**：HttpClient允许设置和获取请求及响应的头部信息，用于传递元数据。HTTP实体则包含了请求或响应的主要数据，可以是文本、二进制或其他格式。HttpClient提供了读取和写入实体内容的机制。 4. **异常处理**：在执行HTTP请求时，HttpClient提供了异常处理机制，包括安全传输处理、幂等方法的概念，以及异常自动恢复和请求重试的策略。此外，还可以中断正在进行的请求。 5. **HTTP协议拦截器**：拦截器允许在请求发送前或响应接收后进行自定义处理，如添加额外的头部信息、修改请求内容或处理响应内容。 6. **连接管理**：HttpClient支持连接参数配置，包括持久连接、连接路由（考虑代理、重定向和安全连接）以及套接字工厂的定制。连接管理器负责创建、复用和关闭连接，确保高效使用网络资源。 7. **HTTP状态管理**：HttpClient处理HTTP状态，如管理Cookie，支持多种Cookie版本和策略。它可以存储和发送Cookie，以及根据策略决定哪些Cookie应被接受或拒绝。状态管理也涉及执行上下文，允许为每个用户或线程维护独立的状态。 8. **HTTP认证**：HttpClient支持多种认证模式，包括用户凭证的管理、认证参数的设置以及使用凭据提供器动态提供认证信息。它可以处理服务器的认证挑战，实现基本认证、摘要认证等。 9. **多线程执行**：HttpClient能够在多线程环境中安全地执行请求，支持连接的并发使用和回收策略。连接保持活动的策略确保了在长时间无操作后仍能保持连接有效性。通过这份教程，读者将能够深入理解HttpClient的工作原理，并熟练运用其特性来构建高效的HTTP客户端应用程序。无论是简单的GET请求还是复杂的POST操作，HttpClient都提供了灵活且强大的工具。

1.1.4.1 重复实体

实体可以重复，意味着它的内容可以被多次读取。这就仅仅是自我包含式的实体了（像

ByteArrayEntity 或 StringEntity）。

1.1.4.2 使用 HTTP 实体

因为一个实体既可以代表二进制内容又可以代表字符内容，它也支持字符编码（支持后

者也就是字符内容）。

实体是当使用封闭内容执行请求，或当请求已经成功执行，或当响应体结果发功到客户

端时创建的。

要从实体中读取内容，可以通过 HttpEntity#getContent()方法从输入流中获取，

这会返回一个 java.io.InputStream 对象，或者提供一个输出流到

HttpEntity#writeTo(OutputStream)方法中，这会一次返回所有写入到给定流中

的内容。

当实体通过一个收到的报文获取时，HttpEntity#getContentType()方法和

HttpEntity#getContentLength() 方法可以用来读取通用的元数据，如

Content-Type 和 Content-Length 头部信息（如果它们是可用的）。因为头部信息

Content-Type 可以包含对文本 MIME 类型的字符编码，比如 text/plain 或 text/html，

HttpEntity#getContentEncoding()方法用来读取这个信息。如果头部信息不可用，那么就

返回长度-1，而对于内容类型返回 NULL。如果头部信息 Content-Type 是可用的，那么

就会返回一个 Header 对象。

当为一个传出报文创建实体时，这个元数据不得不通过实体创建器来提供。

输出内容为

1.1.5 确保低级别资源释放

当完成一个响应实体，那么保证所有实体内容已经被完全消耗是很重要的，所以连接可

StringEntity myEntity = new StringEntity("important message",

"UTF-8");

System.out.println(myEntity.getContentType());

System.out.println(myEntity.getContentLength());

System.out.println(EntityUtils.getContentCharSet(myEntity));

System.out.println(EntityUtils.toString(myEntity));

System.out.println(EntityUtils.toByteArray(myEntity).length);

Content-Type: text/plain; charset=UTF-8

UTF-8

important message

以安全的放回到连接池中，而且可以通过连接管理器对后续的请求重用连接。处理这个操作

的最方便的方法是调用 HttpEntity#consumeContent()方法来消耗流中的任意可用

内容。HttpClient 探测到内容流尾部已经到达后，会立即会自动释放低层连接，并放回到连

接管理器。HttpEntity#consumeContent()方法调用多次也是安全的。

也可能会有特殊情况，当整个响应内容的一小部分需要获取，消耗剩余内容而损失性能，

还有重用连接的代价太高，则可以仅仅通过调用 HttpUriRequest#abort()方法来中

止请求。

连接不会被重用，但是由它持有的所有级别的资源将会被正确释放。

1.1.6 消耗实体内容

推荐消耗实体内容的方式是使用它的 HttpEntity#getContent() 或

HttpEntity#writeTo(OutputStream)方法。HttpClient 也自带 EntityUtils 类，

这会暴露出一些静态方法，这些方法可以更加容易地从实体中读取内容或信息。代替直接读

取 java.io.InputStream，也可以使用这个类中的方法以字符串/字节数组的形式获取

整个内容体。然而，EntityUtils 的使用是强烈不鼓励的，除非响应实体源自可靠的 HTTP

服务器和已知的长度限制。

在一些情况下可能会不止一次的读取实体。此时实体内容必须以某种方式在内存或磁盘

上被缓冲起来。最简单的方法是通过使用 BufferedHttpEntity 类来包装源实体完成。

这会引起源实体内容被读取到内存的缓冲区中。在其它所有方式中，实体包装器将会得到源

实体。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

InputStream instream = entity.getContent();

int byteOne = instream.read();

int byteTwo = instream.read();

// Do not need the rest

httpget.abort();

}

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

long len = entity.getContentLength();

if (len != -1 && len < 2048) {

System.out.println(EntityUtils.toString(entity));

} else {

// Stream content out

}

1.1.7 生成实体内容

HttpClient 提供一些类，它们可以用于生成通过 HTTP 连接获得内容的有效输出流。为了

封闭实体从 HTTP 请求中获得的输出内容，那些类的实例可以和封闭如 POST 和 PUT 请求

的实体相关联。HttpClient 为很多公用的数据容器，比如字符串，字节数组，输入流和文件

提供了一些类： StringEntity ， ByteArrayEntity， InputStreamEntity 和

FileEntity。

请注意 InputStreamEntity 是不可重复的，因为它仅仅能从低层数据流中读取一

次内容。通常来说，我们推荐实现一个定制的 HttpEntity 类，这是自我包含式的，用来

代替使用通用的 InputStreamEntity。FileEntity 也是一个很好的起点。

1.1.7.1 动态内容实体

通常来说， HTTP 实体需要基于特定的执行上下文来动态地生成。通过使用

EntityTemplate 实体类和 ContentProducer 接口，HttpClient 提供了动态实体的支

持。内容生成器是按照需求生成它们内容的对象，将它们写入到一个输出流中。它们是每次

被请求时来生成内容。所以用 EntityTemplate 创建的实体通常是自我包含而且可以重

复的。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

entity = new BufferedHttpEntity(entity);

}

File file = new File("somefile.txt");

FileEntity entity = new FileEntity(file, "text/plain;

charset=\"UTF-8\"");

HttpPost httppost = new HttpPost("http://localhost/action.do");

httppost.setEntity(entity);

ContentProducer cp = new ContentProducer() {

public void writeTo(OutputStream outstream) throws IOException {

Writer writer = new OutputStreamWriter(outstream, "UTF-8");

writer.write("<response>");

writer.write(" <content>");

writer.write(" important stuff");

writer.write(" </content>");

writer.write("</response>");

writer.flush();

}

};

剩余50页未读，继续阅读

xlwei920_163_com

粉丝: 0
资源: 5

HttpClient4.x基础与实战教程

HttpClient 3.x to HttpComponents HttpClient 4.x

Apache-HttpClient4.x详解 高清中文 pdf

apache_httpclient 高清 pdf

Apache HttpClient4.x 中文教程详解

Apache HttpClient 4.x实战教程：基础到高级连接管理

HttpClient4.x 教程 PDF

manticore:Manticore是基于Apache HttpClient 4.x组件构建的JRuby HTTP客户端

JAVA 人人网登陆实例代码(基于Apache httpclient 4.2.X)

JAVA_HttpClient.rar_Java编程_Java_

JAVA Apache HttpClient4.x 教程：基础与连接管理

最新资源

Apache-HttpClient4.x详解高清中文 pdf