【JAVA】HTTP协议结构以及Java实现GET和POST方法

1 HTTP协议8种方法

是基于请求-响应的模式TCP/IP协议的应用层协议。HTTP/1.1协议中共定义了八种方法来以不同方式操作指定的资源。

方法名称	说明
GET	一般用于查询信息。数据由URL进行传递，最大支持2K个字节
POST	提交表单或者上传文件。数据被包含在请求体Body中。理论上数据不受限，不过不同Web服务器对post提交数据有限制
PUT	向指定资源位置上传其最新内容
DELETE	请求服务器删除Request-URL所标识的资源
HEAD	与GET请求类似，仅返回消息头。
OPTIONS	查询服务器对应url所支持的方法
TRACE	回显服务器收到的请求，主要用于测试或诊断
CONNECT	HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器

2 HTTP协议报文结构

2.1 请求报文

下面是一个POST请求例子

POST /form/entry HTTP/1.1
Host: hackr.jp
Connection: keep-alive
Content-Type: application/x-www-form-urlencoded
Content-Length: 16

可以将其划分为如下结构:

可大致将请求报文分为三部分：

1. 请求行，包括方法、URL、协议版本号。
2. 请求头（Headers），包括主机（Host）以及一些头部字段等。
3. 实体内容（Body），根据（Content-Type）属性，内容格式也有所不同。

其中请求头常用的属性如下表所示

属性名称	说明
Accept	用于告诉服务器，客户机支持的数据类型 （例如：Accept:text/html,image/*）
Accept-Charset	用于告诉服务器，客户机采用的编码格式
Accept-Encoding	用于告诉服务器，客户机支持的数据压缩格式
Content-Type	发送给接收者的实体正文的媒体类型（原生表单格式、json格式、多文件上传格式等）

比如设置Content-Type位json格式

Content-type: application/json; enconding=utf-8

则对应body中数据格式应该符合json格式

{
    "username": "Louis Lee",
    "password": "123456"
}

2.2 应答报文

下面是一个应答报文例子

HTTP/1.1 200 OK
Date: Tue, 10 Jul 2012 06:50:15 GMT
Content-Length: 362
Content-Type: text/html

可以将其划分为如下结构:

应答报文也分三部分

1. 状态行，主要包括协议版本、状态码等信息
2. 响应头部，一些属性信息，用于说明服务器所返回的消息
3. 响应正文，根据响应头部中的媒体类型，该正文可以有不同的格式。

3 Java实现GET和POST方法

3.1 使用JAVA原生代码

3.1.1 GET请求

public String getRequest(String requestUrl){
    HttpURLConnection connection = null;
    InputStream is = null;
    BufferedReader br = null;
    String result = null;// 返回结果字符串
    try {
        // 创建远程url连接对象
        URL url = new URL(requestUrl);
        // 通过远程url连接对象打开一个连接，强转成httpURLConnection类
        connection = (HttpURLConnection) url.openConnection();
        // 设置连接方式：get
        connection.setRequestMethod("GET");
        // 设置连接主机服务器的超时时间：15000毫秒
        connection.setConnectTimeout(15000);
        // 设置读取远程返回的数据时间：60000毫秒
        connection.setReadTimeout(60000);
        // 发送请求
        connection.connect();
        // 通过connection连接，获取输入流
        if (connection.getResponseCode() == 200) {
            is = connection.getInputStream();
            // 封装输入流is，并指定字符集
            br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
            // 存放数据
            StringBuffer sbf = new StringBuffer();
            String temp = null;
            while ((temp = br.readLine()) != null) {
                sbf.append(temp);
                sbf.append("\r\n");
            }
            result = sbf.toString();
        }
    } catch (Exception e) {
        log.error("出错了：", e);
    } finally {
        // 关闭资源
        if (null != br) {
            try {
                br.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        if (null != is) {
            try {
                is.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        connection.disconnect();// 关闭远程连接
    }
    return result;
}

3.1.2 POST请求

public String postRequest(String requestUrl, String param){
    HttpURLConnection connection = null;
    InputStream is = null;
    OutputStream os = null;
    BufferedReader br = null;
    String result = null;
    try {
        URL url = new URL(requestUrl);
        // 通过远程url连接对象打开连接
        connection = (HttpURLConnection) url.openConnection();
        // 设置连接请求方式
        connection.setRequestMethod("POST");
        // 设置连接主机服务器超时时间：15000毫秒
        connection.setConnectTimeout(15000);
        // 设置读取主机服务器返回数据超时时间：60000毫秒
        connection.setReadTimeout(60000);

        // 默认值为：false，当向远程服务器传送数据/写数据时，需要设置为true
        connection.setDoOutput(true);
        // 默认值为：true，当前向远程服务读取数据时，设置为true，该参数可有可无
        connection.setDoInput(true);
        // 设置传入参数的格式:请求参数应该是 name1=value1&name2=value2 的形式。
        connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
        // 设置鉴权信息：Authorization: Bearer da3efcbf-0845-4fe3-8aba-ee040be542c0
        connection.setRequestProperty("Authorization", "Bearer da3efcbf-0845-4fe3-8aba-ee040be542c0");
        // 通过连接对象获取一个输出流
        os = connection.getOutputStream();
        // 通过输出流对象将参数写出去/传输出去,它是通过字节数组写出的
        os.write(param.getBytes());
        // 通过连接对象获取一个输入流，向远程读取
        if (connection.getResponseCode() == 200) {

            is = connection.getInputStream();
            // 对输入流对象进行包装:charset根据工作项目组的要求来设置
            br = new BufferedReader(new InputStreamReader(is, "UTF-8"));

            StringBuffer sbf = new StringBuffer();
            String temp = null;
            // 循环遍历一行一行读取数据
            while ((temp = br.readLine()) != null) {
                sbf.append(temp);
                sbf.append("\r\n");
            }
            result = sbf.toString();
        }
    } catch (MalformedURLException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        // 关闭资源
        if (null != br) {
            try {
                br.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        if (null != os) {
            try {
                os.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        if (null != is) {
            try {
                is.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        // 断开与远程地址url的连接
        connection.disconnect();
    }
    return result;
}

3.2 使用HttpClient工具

Maven依赖

<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient -->
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.6</version>
</dependency>

3.2.1 GET请求

public static String doGet(String url) {
	CloseableHttpClient httpClient = null;
	CloseableHttpResponse response = null;
	String result = "";
	try {
	    // 通过址默认配置创建一个httpClient实例
	    httpClient = HttpClients.createDefault();
	    // 创建httpGet远程连接实例
	    HttpGet httpGet = new HttpGet(url);
	    // 设置配置请求参数
	    RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(35000)// 连接主机服务超时时间
	            .setConnectionRequestTimeout(35000)// 请求超时时间
	            .setSocketTimeout(60000)// 数据读取超时时间
	            .build();
	    // 为httpGet实例设置配置
	    httpGet.setConfig(requestConfig);
	    // 执行get请求得到返回对象
	    response = httpClient.execute(httpGet);
	    // 通过返回对象获取返回数据
	    HttpEntity entity = response.getEntity();
	    // 通过EntityUtils中的toString方法将结果转换为字符串
	    result = EntityUtils.toString(entity);
	    System.out.println(result);
	} catch (ClientProtocolException e) {
	    e.printStackTrace();
	} catch (IOException e) {
	    e.printStackTrace();
	} finally {
	    // 关闭资源
	    if (null != response) {
	        try {
	            response.close();
	        } catch (IOException e) {
	            e.printStackTrace();
	        }
	    }
	    if (null != httpClient) {
	        try {
	            httpClient.close();
	        } catch (IOException e) {
	            e.printStackTrace();
	        }
	    }
	}
	return result;
}

3.2.2 POST请求

public static String doPost(String url, Map<String, Object> paramMap) {
    CloseableHttpClient httpClient = null;
    CloseableHttpResponse httpResponse = null;
    String result = "";
    // 创建httpClient实例
    httpClient = HttpClients.createDefault();
    // 创建httpPost远程连接实例
    HttpPost httpPost = new HttpPost(url);
    // 配置请求参数实例
    RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(35000)// 设置连接主机服务超时时间
            .setConnectionRequestTimeout(35000)// 设置连接请求超时时间
            .setSocketTimeout(60000)// 设置读取数据连接超时时间
            .build();
    // 为httpPost实例设置配置
    httpPost.setConfig(requestConfig);
    // 设置请求头
    httpPost.addHeader("Content-Type", "application/x-www-form-urlencoded");
    // 封装post请求参数
    if (null != paramMap && paramMap.size() > 0) {
        List<NameValuePair> nvps = new ArrayList<NameValuePair>();
        // 通过map集成entrySet方法获取entity
        Set<Map.Entry<String, Object>> entrySet = paramMap.entrySet();
        // 循环遍历，获取迭代器
        Iterator<Map.Entry<String, Object>> iterator = entrySet.iterator();
        while (iterator.hasNext()) {
            Map.Entry<String, Object> mapEntry = iterator.next();
            nvps.add(new BasicNameValuePair(mapEntry.getKey(), mapEntry.getValue().toString()));
        }

        // 为httpPost设置封装好的请求参数
        try {
            httpPost.setEntity(new UrlEncodedFormEntity(nvps, "UTF-8"));
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
    }
    try {
        // httpClient对象执行post请求,并返回响应参数对象
        httpResponse = httpClient.execute(httpPost);
        // 从响应对象中获取响应内容
        HttpEntity entity = httpResponse.getEntity();
        result = EntityUtils.toString(entity);
        System.out.println(result);
    } catch (ClientProtocolException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        // 关闭资源
        if (null != httpResponse) {
            try {
                httpResponse.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        if (null != httpClient) {
            try {
                httpClient.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
    return result;
}