HttpClient学习笔记（1）

HttpClient 是 Apache Jakarta Common 下的子项目，可以用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包，并且它支持 HTTP 协议最新的版本和建议。
我们先来看一看 HttpClient 最基本的用法。

例1：使用 httpclient4 发送 post 请求

gradle 依赖：

compile 'org.apache.httpcomponents:httpclient:4.5.1'

CloseableHttpClient httpClient = null;
HttpPost httpPost = null;
CloseableHttpResponse response = null;
try {
    // 1 、使用 HttpClients 创建 CloseableHttpClient 对象
    httpClient = HttpClients.createDefault();
    // 2、如果是发送 post 请求，就创建一个 HttpPost 对象
    httpPost = new HttpPost("http://localhost:8080/LoginAction.action?method=loginFromLyMis");
    // 3、将请求参数封装 NameValuePair 集合里
    List<NameValuePair> nvps = new ArrayList<>();
    nvps.add(new BasicNameValuePair("username",str));
    nvps.add(new BasicNameValuePair("source","3"));
    // 4、将请求参数放置在 httpPost 对象作为其中的实体属性
    // 设置表单提交编码为 UTF-8
    // httpost.setEntity(new UrlEncodedFormEntity(nvps, HTTP.UTF_8));
    httpPost.setEntity(new UrlEncodedFormEntity(nvps));

    // 5、使用第 1 步创建的 httpClient 对象执行 post 操作，获得响应对象 response
    response = httpClient.execute(httpPost);
    // 6、获得响应 response ，继而可以获得响应状态码
    int statusCode = response.getStatusLine().getStatusCode();
    System.out.println("statusCode " + statusCode );
    // 7、如果响应是 200，进而可以获得响应实体
    if(statusCode >= 200 && statusCode <300){
        // 获得响应实体
        HttpEntity entity = response.getEntity();
        // 使用 EntityUtils 工具将响应实体输出
        String result = EntityUtils.toString(entity,"utf-8");
        // System.out.println("result  " + result);
        // 使用 EntityUtils 消费实体
        EntityUtils.consume(entity);

    }
} catch (IOException e) {
    e.printStackTrace();
} finally {
    // 8、关闭响应
    try {
        response.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

例2： 使用 httpclient 发送 get 请求‘

public static void main(String[] args) {
    // 1、 使用 HttpClients 的 createDefault() 方法创建
    // CloseableHttpClient 对象
    CloseableHttpClient httpClient = HttpClients.createDefault();
    // 2、创建 HttpGet 对象，因此后面执行的就是get请求
    HttpGet httpGet = new HttpGet("https://www.baidu.com/") ;
    System.out.println("执行请求：" + httpGet.getURI());
    CloseableHttpResponse response = null;
    try {
        // 3、使用 httpClient 对象执行 httpGet 请求，得到 CloseableHttpResponse 对象
        response = httpClient.execute(httpGet);
        int statusCode =  response.getStatusLine().getStatusCode();
        System.out.println("statusCode => " + statusCode);

        // 4、获取响应实体
        HttpEntity entity = response.getEntity();
        System.out.println("------无聊的分割线------");
        System.out.println("获得响应的状态：" + response.getStatusLine());
        // 5、打印响应的状态
        if(entity!=null){
            // 打印响应内容的长度
            System.out.println("响应内容的长度：" + entity.getContentLength());
            // 打印响应的内容
            System.out.println("响应的内容是：" + EntityUtils.toString(entity));
            System.out.println("------忧伤的分割线------");
            //如果entity是流数据则关闭之
            EntityUtils.consume(entity);
        }
    } catch (ClientProtocolException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    } finally{
        // 关闭连接、释放资源
        try {
            response.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

下载地址：
Apache HttpComponents - HttpComponents Downloads
http://hc.apache.org/downloads.cgi

使用 HttpClient3 的基本步骤：
使用 HttpClient 发送请求、接收响应很简单，一般需要如下几步即可。
1、创建 HttpClient 对象；
2、创建请求方法的实例，并指定请求 URL 。如果需要发送 GET 请求，创建 HttpGet 对象；如果需要发送 POST 请求，创建 HttpPost 对象；
3、如果需要发送请求参数，可调用 HttpGet 、 HttpPost 共同的 setParams(HetpParams params) 方法来添加请求参数；对于 HttpPost 对象而言，也可调用 setEntity(HttpEntity entity) 方法来设置请求参数；
4、调用HttpClient对象的 execute(HttpUriRequest request) 发送请求，该方法返回一个HttpResponse；
5、调用 HttpResponse 的 getAllHeaders() 、 getHeaders(String name) 等方法可获取服务器的响应头；调用 HttpResponse 的 getEntity() 方法可获取 HttpEntity 对象，该对象包装了服务器的响应内容。程序可通过该对象获取服务器的响应内容。
6、释放连接。无论执行方法是否成功，都必须释放连接。

第 1 个简单的例子，通过 GET 或者 POST 方式访问某个页面并取得这个页面的 html 源代码。
1、新建一个 Java 项目，导入 HttpClient3 版本的 jar 包：

commons-codec-1.3.jar
commons-httpclient-3.1.jar
commons-logging.jar

把 jar 包添加到 类路径下。

2、编写测试代码

package com.liwei.httpclient3;

import java.io.IOException;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.HttpStatus;
import org.apache.commons.httpclient.methods.GetMethod;

public class TestHttpClient3 {
    public static void main(String[] args) {
        // 模拟了用户的操作 1 ：打开窗口
        HttpClient client = new HttpClient();
        // 模拟了用户的操作 2 ：输入网址
        GetMethod method = new GetMethod("http://www.baidu.com");
        try {
            // 模拟了用户的操作 3 ：按下回车键，返回一个 httpclient 状态码
            int statusCode = client.executeMethod(method);

            System.out.println(statusCode);

            if (statusCode != HttpStatus.SC_OK) { // 200
                System.err.println("Method failed: " + method.getStatusLine());
            }

            // 得到返回的内容
            byte[] responseBody = method.getResponseBody();
            // 处理内容
            System.out.println( new String(responseBody));

        } catch (HttpException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }

    }
}

我们看到，控制台打印出的是网页的源代码，如下图。

参考资料：
http://shmilyaw-hotmail-com.iteye.com/blog/1900146