httpClient使用总结

前记

      最近有个需求，需要根据商品id获取商品详情： 首先想到的是在浏览器里输入url按回车就可以了；或者在linux中使用curl+url来发起一个http请求; 但如果是要在java程序中发出http请求，该如何实现呢？  

一. httpClient初认识

      虽然JDK 的 java.net 包中已经提供了访问 HTTP 协议的基本功能，但是对于大部分应用程序来说，JDK 库本身提供的功能还不够丰富和灵活。

      HttpClient 是 Apache Jakarta Common 下的子项目，用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包。

二.  httpClient使用

 1. 引入maven依赖

    

<dependency>
  <groupId>org.apache.httpcomponents</groupId>
  <artifactId>httpcomponents-client</artifactId>
  <version>4.3</version>
</dependency>

<dependency>
  <groupId>org.apache.httpcomponents</groupId>
  <artifactId>httpcomponents-client</artifactId>
  <version>4.3</version>
</dependency>

 2. GET方法代码框架 

import java.io.IOException;
import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.GetMethod;
import org.apache.commons.httpclient.params.HttpMethodParams;
public class GetSample{
  public static void main(String[] args) {
  //step1： 构造HttpClient的实例,类似于打开浏览器
  HttpClient httpClient = new HttpClient();
  //step2： 创建GET方法的实例，类似于在浏览器地址栏输入url
  GetMethod getMethod = new GetMethod("http://www.ibm.com");
  // 使用系统提供的默认的恢复策略
  getMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,
    new DefaultHttpMethodRetryHandler());
  try {
   //step3: 执行getMethod 类似于点击enter，让浏览器发出请求
   int statusCode = httpClient.executeMethod(getMethod);
   if (statusCode != HttpStatus.SC_OK) {
    System.err.println("Method failed: "
      + getMethod.getStatusLine());
   }
   //step4: 读取内容,浏览器返回结果
   byte[] responseBody = getMethod.getResponseBody();
   //处理内容
   System.out.println(new String(responseBody));
  } catch (HttpException e) {
   //发生致命的异常，可能是协议不对或者返回的内容有问题
   System.out.println("Please check your provided http address!");
   e.printStackTrace();
  } catch (IOException e) {
   //发生网络异常
   e.printStackTrace();
  } finally {
   //释放连接 （一定要记住）
   getMethod.releaseConnection();
  }
 }
}

import java.io.IOException;
import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.GetMethod;
import org.apache.commons.httpclient.params.HttpMethodParams;
public class GetSample{
  public static void main(String[] args) {
  //step1： 构造HttpClient的实例,类似于打开浏览器
  HttpClient httpClient = new HttpClient();
  //step2： 创建GET方法的实例，类似于在浏览器地址栏输入url
  GetMethod getMethod = new GetMethod("http://www.ibm.com");
  // 使用系统提供的默认的恢复策略
  getMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,
    new DefaultHttpMethodRetryHandler());
  try {
   //step3: 执行getMethod 类似于点击enter，让浏览器发出请求
   int statusCode = httpClient.executeMethod(getMethod);
   if (statusCode != HttpStatus.SC_OK) {
    System.err.println("Method failed: "
      + getMethod.getStatusLine());
   }
   //step4: 读取内容,浏览器返回结果
   byte[] responseBody = getMethod.getResponseBody();
   //处理内容
   System.out.println(new String(responseBody));
  } catch (HttpException e) {
   //发生致命的异常，可能是协议不对或者返回的内容有问题
   System.out.println("Please check your provided http address!");
   e.printStackTrace();
  } catch (IOException e) {
   //发生网络异常
   e.printStackTrace();
  } finally {
   //释放连接 （一定要记住）
   getMethod.releaseConnection();
  }
 }
}

遇到的异常

   org.apache.commons.httpclient.ProtocolException：The server x.x.x.x failed to respond with a valid HTTP response
   java.net.SocketException：Connection reset
   java.lang.IllegalStateException：Connection is not open
   java.io.IOException: Stream closed

java.net包里定义的异常摘录

BindException：试图将套接字绑定到本地地址和端口时发生错误的情况下，抛出此异常。 

                                  例如，当web应用已经启动，8080端口已经占用，再打算启动时会报该异常

ConnectException：试图将套接字连接到远程地址和端口时发生错误的情况下，抛出此异常。

                                    远程地址和端口而上一个异常是本地地址和端口

HttpRetryException：抛出此异常指示 HTTP 请求需要重试，但由于启用了流模式而无法自动重试

ProtocolException：抛出此异常指示在底层协议中存在错误，如 TCP 错误

SocketException：抛出此异常指示在底层协议中存在错误，如 TCP 错误

SocketTimeoutException：如果在读取或接受套接字时发生超时，则抛出此异常

MalformedURLException：抛出这一异常指示出现了错误的 URL。

参考资料

 官方文档：http://hc.apache.org/httpcomponents-client-4.2.x/index.html
 http://www.ibm.com/developerworks/cn/opensource/os-httpclient/ 
 http://laohuang.iteye.com/blog/55613