HttpURLConnection与HttpClient学习

转载HttpURLConnection与HttpClient浅析

一、HttpURLConnection的使用

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;

public class HttpURLConnectionUtil {
    private static final Logger logger = LoggerFactory.getLogger(HttpURLConnection.class);

    /**
     * get请求
     * @param urlStr 请求地址
     * @param param 请求参数
     */
    public static void Get(String urlStr,String param) {
        try {
            urlStr = urlStr + "?"+param;
            // 1.获取访问地址
            URL url = new URL(urlStr);
            // 2.获取网络访问对象
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            /* 3.设置请求参数（过期时间、输入/输出流、访问方式），以流的形式进行连接 */
            // 设置是否向HttpURLConnection输出
            connection.setDoOutput(false);
            // 设置是否向HttpURLConnection读入
            connection.setDoInput(true);
            // 设置请求方式
            connection.setRequestMethod("GET");
            // 设置是否使用缓存
            connection.setUseCaches(true);
            // 设置HttpURLConnection实例是否自动执行HTTP重定向
            connection.setInstanceFollowRedirects(true);
            // 设置超时时间
            connection.setConnectTimeout(3000);
            // 连接
            connection.connect();
            // 4.得到相应状态码的返回值
            int responseCode = connection.getResponseCode();
            logger.info("Get-responseCode："+responseCode);
            // 5.如果返回值正常，数据在网络中是以流的形式得到服务器返回的数据
            String msg = "";
            // 正常响应
            if(responseCode == 200) {
                // 从流中读取数据
                BufferedReader reader = new BufferedReader(
                        new InputStreamReader(connection.getInputStream())
                );
                String line = null;
                // 循环从流中读取
                while ((line = reader.readLine()) != null) {
                    msg += line + "
";
                }
                reader.close();
            }
            // 6.断开连接，释放资源
            connection.disconnect();

            // 响应数据
            System.out.println(msg);
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * post请求
     * @param urlStr 请求地址
     * @param param 请求参数
     */
    public static void Post(String urlStr, String param) {
        try {
            // 1.获取访问地址
            URL url = new URL(urlStr);
            // 2.获取网络访问对象
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            /* 3.设置请求参数（过期时间、输入/输出流、访问方式），以流的形式进行连接 */
            // 设置请求方式
            connection.setRequestMethod("POST");
            // 设置超时时间
            connection.setConnectTimeout(3000);
            // 设置是否向HttpURLConnection输出
            connection.setDoOutput(true);
            // 设置是否向HttpURLConnection读入
            connection.setDoInput(true);
            // 设置是否使用缓存
            connection.setUseCaches(false);
            // 设置HttpURLConnection实例是否自动执行HTTP重定向
            connection.setInstanceFollowRedirects(true);
            // 设置使用标准编码格式编码参数的名-值对
            connection.setRequestProperty("Content-Type","application/x-www-form-urlencoded");
            // 连接
            connection.connect();
            /* 4. 处理输入输出 */
            // 写入参数到请求中
            OutputStream out = connection.getOutputStream();
            out.write(param.getBytes());
            out.flush();
            out.close();
            // 从连接中读取响应数据
            String msg = "";
            int responseCode = connection.getResponseCode();
            logger.info("Post-reponseCode："+responseCode);
            if(responseCode == 200) {
                BufferedReader reader = new BufferedReader(
                        new InputStreamReader(connection.getInputStream())
                );
                String line = "";
                while ((line = reader.readLine()) != null) {
                    msg += line + "
";
                }
                reader.close();
            }
            connection.disconnect();

            System.out.println(msg);
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        String urlStr = "http://localhost:8080/aa";
        String param = "name=nana";
        Get(urlStr,param);
        Post(urlStr,param);
    }
}

说明：

1. HttpURLConnection对象不能直接构造，需要通过URL类中的openConnection()方法来获得。
2. HttpURLConnection的connect()函数，实际上只是建立了一个与服务器的TCP连接，并没有实际发送HTTP请求。HTTP请求实际上直到我们获取服务器响应数据（如调用getInputStream()、getResponseCode()等方法）时才正式发送出去。
3. 对HttpURLConnection对象的配置都需要在connect()方法执行之前完成。
4. HttpURLConnection是基于HTTP协议的，其底层通过socket通信实现。如果不设置超时（timeout），在网络异常的情况下，可能会导致程序僵死而不继续往下执行。
5. HTTP正文的内容是通过OutputStream流写入的， 向流中写入的数据不会立即发送到网络，而是存在于内存缓冲区中，待流关闭时，根据写入的内容生成HTTP正文。
6. 调用getInputStream()方法时，返回一个输入流，用于从中读取服务器对于HTTP请求的返回信息。
7. 我们可以使用HttpURLConnection.connect()方法手动的发送一个HTTP请求，但是如果要获取HTTP响应的时候，请求就会自动的发起，比如我们使用HttpURLConnection.getInputStream()方法的时候，所以完全没有必要调用connect()方法。

二、HttpURLConnection的使用

1.HttpClient简介：

　　在一般情况下，如果只是需要向Web站点的某个简单页面提交请求并获取服务器响应，HttpURLConnection完全可以胜任。但在绝大部分情况下，Web站点的网页可能没这么简单，这些页面并不是通过一个简单的URL就可访问的，可能需要用户登录而且具有相应的权限才可访问该页面。在这种情况下，就需要涉及Session、Cookie的处理了，如果打算使用HttpURLConnection来处理这些细节，当然也是可能实现的，只是处理起来难度就大了。
　　为了更好地处理向Web站点请求，包括处理Session、Cookie等细节问题，Apache开源组织提供了一个HttpClient项目，看它的名称就知道，它是一个简单的HTTP客户端（并不是浏览器），可以用于发送HTTP请求，接收HTTP响应。但不会缓存服务器的响应，不能执行HTML页面中嵌入的Javascript代码；也不会对页面内容进行任何解析、处理。
　　简单来说，HttpClient就是一个增强版的HttpURLConnection，HttpURLConnection可以做的事情HttpClient全部可以做；HttpURLConnection没有提供的有些功能，HttpClient也提供了，但它只是关注于如何发送请求、接收响应，以及管理HTTP连接。

2. HttpClient的使用：

• 创建HttpClient对象。
• 如果需要发送GET请求，创建HttpGet对象；如果需要发送POST请求，创建HttpPost对象。
• 如果需要发送请求参数，可调用HttpGet、HttpPost共同的setParams(HttpParams params)方法来添加请求参数；对于HttpPost对象而言，也可调用setEntity(HttpEntity entity)方法来设置请求参数。
• 调用HttpClient对象的execute(HttpUriRequest request)发送请求，执行该方法返回一个HttpResponse。
• 调用HttpResponse的getAllHeaders()、getHeaders(String name)等方法可获取服务器的响应头；调用HttpResponse的getEntity()方法可获取HttpEntity对象，该对象包装了服务器的响应内容。程序可通过该对象获取服务器的响应内容。

3. HttpClient的使用例子：

import org.apache.http.HttpEntity;
import org.apache.http.NameValuePair;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.util.ArrayList;
import java.util.List;

public class HttpClientUtil {

    private static final Logger logger = LoggerFactory.getLogger(HttpClientUtil.class);

    public static void Get(String urlStr,String param) {
        // 1.创建HttpClient对象
        CloseableHttpClient httpClient = HttpClientBuilder.create().build();
        // 2.创建HttpGet对象
        HttpGet httpGet = new HttpGet(urlStr);
        CloseableHttpResponse response= null;
        try {
            // 3.创建GET请求
            response = httpClient.execute(httpGet);
            System.out.println(response.getStatusLine());
            // 4.获取响应实体
            HttpEntity entity = response.getEntity();
            // 5.处理响应实体
            if (entity != null) {
                logger.info("长度：" + entity.getContentLength());
                logger.info("内容：" + EntityUtils.toString(entity));
            }
        }  catch (IOException e) {
            e.printStackTrace();
        } finally {
            // 6.释放资源
            try {
                response.close();
                httpClient.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }

    public static void Post(String urlStr, String param) {
        // 1.创建HttpClient对象
        CloseableHttpClient httpClient = HttpClientBuilder.create().build();
        // 2.创建HttpPost对象
        HttpPost post = new HttpPost(urlStr);
        // 3.设置POST请求传递参数
        List<NameValuePair> params = new ArrayList<NameValuePair>();
        params.add(new BasicNameValuePair("name","wln"));
        try {
            UrlEncodedFormEntity entity = new UrlEncodedFormEntity(params);
            post.setEntity(entity);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        // 4.执行请求并处理相应
        try {
            CloseableHttpResponse response = httpClient.execute(post);
            HttpEntity entity = response.getEntity();
            if (entity != null) {
                logger.info("响应内容："+EntityUtils.toString(entity));
            }
            response.close();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            // 释放资源
            try {
                httpClient.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        String urlStr = "http://localhost:8080/bb";
        String param = "";
        Get(urlStr,param);
        Post(urlStr,param);
    }
}

注：使用时要导入下面的jar包

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.1</version>
</dependency>

4.说明

　　HttpClient相比传统JDK自带的URLConnection，增加了易用性和灵活性，它不仅使客户端发送HTTP请求变得容易，而且也方便了开发人员测试接口（基于Http协议的），即提高了开发的效率，也方便提高代码的健壮性。