输出内容为：

c1 = a

path=/

domain=localhost

c2 = b

path=/

c3 = c

domain=localhost

1.1.4 HTTP实体

HTTP报文能够携带和请求或响应相关的内容实体。实体能够在一些请求和响应中找到，由于它们也是可选的。使用了实体的请求被称为封闭实体请求。

HTTP规范定义了两种封闭实体的方法：POST和PUT。

响应通常期望包括一个内容实体。

这个规则也有特例，比方HEAD方法的响应和204 No Content，304 Not Modified和205 Reset Content响应。

HttpClient依据其内容出自何处区分三种类型的实体：

• streamed流式：内容从流中获得，或者在执行中产生。

  特别是这样的分类包括从HTTP响应中获取的实体。

  流式实体是不可反复生成的。

• self-contained自我包括式：内容在内存中或通过独立的连接或其他实体中获得。自我包括式的实体是能够反复生成的。这样的类型的实体会经经常使用于封闭HTTP请求的实体。
• wrapping包装式：内容从另外一个实体中获得。

当从一个HTTP响应中获取流式内容时。这个差别对于连接管理非常重要。对于由应用程序创建并且仅仅使用HttpClient发送的请求实体。流式和自我包括式的不同就不那么重要了。这样的情况下，建议考虑如流式这样的不能反复的实体，和能够反复的自我包括式实体。

1.1.4.1 反复实体

实体能够反复。意味着它的内容能够被多次读取。这就不过自我包括式的实体了（像ByteArrayEntity或StringEntity）。

1.1.4.2 使用HTTP实体

由于一个实体既能够代表二进制内容又能够代表字符内容。它也支持字符编码（支持后者也就是字符内容）。

实体是当使用封闭内容运行请求。或当请求已经成功运行。或当响应体结果发功到client时创建的。

要从实体中读取内容，能够通过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对象。

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

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);

输出内容为

1.1.5 确保低级别资源释放

当完毕一个响应实体，那么保证全部实体内容已经被全然消耗是非常重要的。所以连接能够安全的放回到连接池中，并且能够通过连接管理器对兴许的请求重用连接。处理这个操作的最方便的方法是调用HttpEntity#consumeContent()方法来消耗流中的随意可用内容。

HttpClient探測到内容流尾部已经到达后，会马上会自己主动释放低层连接，并放回到连接管理器。HttpEntity#consumeContent()方法调用多次也是安全的。

也可能会有特殊情况。当整个响应内容的一小部分须要获取，消耗剩余内容而损失性能。还有重用连接的代价太高，则能够只通过调用HttpUriRequest#abort()方法来中止请求。

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();

}

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

1.1.6 消耗实体内容

推荐消耗实体内容的方式是使用它的HttpEntity#getContent()或HttpEntity#writeTo(OutputStream)方法。HttpClient也自带EntityUtils类，这会暴露出一些静态方法。这些方法能够更加easy地从实体中读取内容或信息。

取代直接读取java.io.InputStream。也能够使用这个类中的方法以字符串/字节数组的形式获取整个内容体。然而。EntityUtils的使用是强烈不鼓舞的，除非响应实体源自可靠的HTTPserver和已知的长度限制。

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

}

}

在一些情况下可能会不止一次的读取实体。此时实体内容必须以某种方式在内存或磁盘上被缓冲起来。最简单的方法是通过使用BufferedHttpEntity类来包装源实体完毕。这会引起源实体内容被读取到内存的缓冲区中。在其他全部方式中。实体包装器将会得到源实体。

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

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

entity = new BufferedHttpEntity(entity);

}

1.1.7 生成实体内容

HttpClient提供一些类，它们能够用于生成通过HTTP连接获得内容的有效输出流。为了封闭实体从HTTP请求中获得的输出内容，那些类的实例能够和封闭如POST和PUT请求的实体相关联。

HttpClient为非常多公用的数据容器。比方字符串。字节数组，输入流和文件提供了一些类：StringEntity，ByteArrayEntity。InputStreamEntity和FileEntity。

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);

请注意InputStreamEntity是不可反复的。由于它只能从低层数据流中读取一次内容。通常来说，我们推荐实现一个定制的HttpEntity类，这是自我包括式的，用来取代使用通用的InputStreamEntity。FileEntity也是一个非常好的起点。

1.1.7.1 动态内容实体

通常来说，HTTP实体须要基于特定的运行上下文来动态地生成。通过使用EntityTemplate实体类和ContentProducer接口。HttpClient提供了动态实体的支持。内容生成器是依照需求生成它们内容的对象，将它们写入到一个输出流中。它们是每次被请求时来生成内容。所以用EntityTemplate创建的实体一般是自我包括并且能够反复的。

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();

}

};

HttpEntity entity = new EntityTemplate(cp);

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

httppost.setEntity(entity);

1.1.7.2 HTML表单

很多应用程序须要频繁模拟提交一个HTML表单的过程。比方。为了来记录一个Web应用程序或提交输出数据。HttpClient提供了特殊的实体类UrlEncodedFormEntity来这个满足过程。

List<NameValuePair> formparams = new ArrayList<NameValuePair>();

formparams.add(new BasicNameValuePair("param1", "value1"));

formparams.add(new BasicNameValuePair("param2", "value2"));

UrlEncodedFormEntity entity = new UrlEncodedFormEntity(formparams, "UTF-8");

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

httppost.setEntity(entity);

UrlEncodedFormEntity实例将会使用URL编码来编码參数。生成例如以下的内容：

param1=value1&param2=value2

1.1.7.3 内容分块

通常。我们推荐让HttpClient选择基于被传递的HTTP报文属性的最适合的编码转换。这是可能的，可是，设置HttpEntity#setChunked()方法为true是通知HttpClient分块编码的首选。请注意HttpClient将会使用标识作为提示。

当使用的HTTP协议版本号，如HTTP/1.0版本号。不支持分块编码时。这个值会被忽略。

1.1.8 响应控制器

控制响应的最简便和最方便的方式是使用ResponseHandler接口。

这个放完全然减轻了用户关于连接管理的操心。当使用ResponseHandler时，HttpClient将会自己主动关注并保证释放连接到连接管理器中去，而无论请求运行是否成功或引发了异常。