httpclient4_中文版帮助文档.pdf

httpclient4 中文版帮助文档，必威体育精装版官方版翻译版 前言 超文本传输协议（HTTP）也许是当今互联网上使用的最重要的协议了。Web 服务，有网络 功能的设备和网络计算的发展，都持续扩展了HTTP 协议的角色，超越了用户使用的Web 浏览器范畴，同时，也增加了需要HTTP 协议支持的应用程序的数量。 尽管 包提供了基本通过HTTP 访问资源的功能，但它没有提供全面的灵活性和其它 很多应用程序需要的功能。HttpClient 就是寻求弥补这项空白的组件，通过提供一个有效的， 保持更新的，功能丰富的软件包来实现客户端必威体育精装版的HTTP 标准和建议。 为扩展而设计，同时为基本的HTTP 协议提供强大的支持，HttpClient 组件也许就是构建 HTTP 客户端应用程序，比如web 浏览器，web 服务端，利用或扩展HTTP 协议进行分布式 通信的系统的开发人员的关注点。 1. HttpClient 的范围 基于HttpCore[/httpcomponents-core/index.html]的客户端 HTTP 运输实现库 基于经典（阻塞）I/O 内容无关 2. 什么是HttpClient 不能做的 HttpClient 不是一个浏览器。它是一个客户端的HTTP 通信实现库。HttpClient 的目标是发 送和接收HTTP 报文。HttpClient 不会去缓存内容，执行 嵌入在HTML 页面中的javascript 代码，猜测内容类型，重新格式化请求/重定向URI，或者其它和HTTP 运输无关的功能。 第一章 基础 1.1 执行请求 HttpClient 最重要的功能是执行HTTP 方法。一个HTTP 方法的执行包含一个或多个 HTTP 请求/HTTP 响应交换，通常由HttpClient 的内部来处理。而期望用户提供一个要执行 的请求对象，而HttpClient 期望传输请求到目标服务器并返回对应的响应对象，或者当执行 不成功时抛出异常。 很自然地，HttpClient API 的主要切入点就是定义描述上述规约的HttpClient 接口。 这里有一个很简单的请求执行过程的示例： HttpClient httpclient = new DefaultHttpClient(); HttpGet httpget = new HttpGet(http://localhost/); HttpResponse response = httpclient.execute(httpget); HttpEntity entity = response.getEntity(); if (entity != null) { InputStream instream = entity.getContent(); int l; byte[] tmp = new byte[2048]; while ((l = instream.read(tmp)) != -1) { } } 1.1.1 HTTP 请求 所有HTTP 请求有一个组合了方法名，请求URI 和HTTP 协议版本的请求行。 HttpClient 支持所有定义在HTTP/1.1 版本中的HTTP 方法：GET，HEAD，POST，PUT， DELETE，TRACE 和OPTIONS 。对于每个方法类 型都有一个特殊的类：HttpGet，HttpHead， HttpPost，HttpPut，HttpDelete，HttpTrace 和 HttpOptions。 请求的URI 是统一资源定位符，它标识了应用于哪个请求之上的资源。HTTP 请求URI 包含 一个协议模式，主机名称，可选的端口，资源路径，可选的查询和可选的片段。 HttpGet httpget = new HttpGet( /search?hl=enq=httpclientbtnG=Google+Searchaq=foq= ); HttpClient 提供很多工具方法来简化创建和修改执行URI。 URI 也可以编程来拼装： URI uri = URIUtils.createURI(http, , -1, /search, q=httpclientbtnG=Google+Searchaq=foq=, null); HttpGet httpget = new HttpGet(uri); System.out.println(httpget.getURI()); 输出内容为： /search?q=httpclientbtnG=Google+Searchaq=foq= 查询字符串也可以从独立的参数中