HttpClient-4.0.1 官方教程.pdf

HttpClient-4.0.1 官方教程 HttpClient 不是一个浏览器，它是一个客户端 HTTP 传输类库。HttpClient 作用是传输和接收 HTTP 消息。 HttpClient 不尝试缓存内容，执行内嵌HTML 页面中的javascript 脚本，尝试猜测内容类型，重新定义请求/重定 向URI 位置，其他功能与HTTP 传输无关。 第一章 Fundamentals （基础） 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 Request (HTTP 请求) 所有的HTTP 请求有一个请求行包含一个方法名，请求URI 和HTTP 协议版本。 HttpClient 支持在HTTP/1.1 规范中定义的所有HTTP 方法：GET、HEAD、POST、PUT、 DELETE,、TRACE and OPTIONS，用一些特殊的类来表示每一个方法：HttpGet、HttpHead、HttpPost、HttpPut、HttpDelete 、HttpTrace 和HttpOptions。 HTTP 请求URI 的包括协议、主机名、可选的端口、资源的路径、可选的查询和可选的片段。 HttpGet httpget = new HttpGet( /search?hl=enq=httpclientbtnG=Google+Searchaq=foq=); HttpClient 提供了一个实用的方法来简化创建和修改请求的URIs，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= 查询字符串也可以从各个参数生成： ListNameValuePair qparams = new ArrayListNameValuePair(); qparams.add(new BasicNameValuePair(q, httpclient)); qparams.add(new BasicNameValuePair(btnG, Google Search)); qparams.add(new BasicNameValuePair(aq, f)); qparams.add(new BasicNameValuePair(oq, null)); URI uri = URIUtils.createURI (http