1.Apache HttpClient 简介
HttpClient 是 Apache Jakarta Common 下的子项目,是一个用来跨项目访问的中间件 ,用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包,并且它支持 HTTP 协议最新的版本和建议。HttpClient 已经应用在很多的项目中,比如 Apache Jakarta 上很著名的另外两个开源项目 Cactus 和 HTMLUnit 都使用了 HttpClient。
HttpClient 相比传统 JDK 自带的 URLConnection(URLConnection是一个抽象类,表示指向URL指定资源的活动连接。),增加了易用性和灵活性,它不仅使客户端发送 HTTP 请求变得容易,而且也方便了开发人员测试接口(基于 HTTP 协议的),即提高了开发的效率,也方便提高代码的实用性。
2. Apache HttpClient 特性
1.基于标准、纯净的 Java 语言。实现了 HTTP 1.0 和 HTTP 1.1
2.以可扩展的面向对象的结构实现了 HTTP 全部的方法
3.支持 HTTPS 协议。
4.通过 HTTP 代理建立透明的连接。
5.利用 CONNECT 方法通过 HTTP 代理建立隧道的 HTTPS 连接。
6.插件式的自定义认证方案。
7.连接管理器支持多线程应用。(支持设置最大连接数,同时支持设置每个主机的最大连接数,发现并关闭过期的连接。)
8.自动处理 Set-Cookie 中的 Cookie。
9.插件式的自定义 Cookie 策略。
10.Response 的输入流可以有效的从 Socket 服务器直接读取相应内容
11.Request 的输出流可以避免流中内容直接缓冲到 Socket 服务器。
12.直接获取服务器发送的 response code 和 headers。
13.设置连接超时的能力。
3. Apache HttpClient 使用流程
1.创建 HttpClient 对象。
2.创建请求方法的实例,并指定请求 URL。如果需要发送 GET 请求,创建 HttpGet 对象;如果需要发送 POST 请求,创建 HttpPost 对象。
3.如果需要发送请求参数,可调用 HttpGet、HttpPost 共同的 setParams(HttpParams params) 方法来添加请求参数;对于 HttpPost 对象而言,也可调用 setEntity(HttpEntity entity) 方法来设置请求参数。
4.调用 HttpClient 对象的 execute(HttpUriRequest request) 发送请求,该方法返回一个 HttpResponse。
5.调用 HttpResponse 的 getAllHeaders()、getHeaders(String name) 等方法可获取服务器的响应头;调用 HttpResponse 的 getEntity() 方法可获取 HttpEntity 对象,该对象包装了服务器的响应内容。程序可通过该对象获取服务器的响应内容。
6.释放连接。无论执行方法是否成功,都必须释放连接
4.HTTP 请求的 GET 与 POST 方式的区别
- get是从服务器上获取数据,post是向服务器传送数据。
- get是把参数数据队列加到提交表单的ACTION属性所指的URL中,值和表单内各个字段一一对应,在URL中可以看到。post是通过HTTP post机制,将表单内各个字段与其内容放置在HTML HEADER内一起传送到ACTION属性所指的URL地址。用户看不到这个过程。
- 对于get方式,服务器端用Request.QueryString获取变量的值,对于post方式,服务器端用Request.Form获取提交的数据。
- get传送的数据量较小,不能大于2KB。post传送的数据量较大,一般被默认为不受限制。但理论上,IIS4中最大量为80KB,IIS5中为100KB。
- get安全性非常低,post安全性较高。但是执行效率却比Post方法好。
5.方法
5.1:EntityUtils()
在httpclient 请求的时候,使用EntityUtils 对返回的结果进行字符串的转换
5.2:NameValuePair()
一个集合来存放待提交的参数 并将这个参数集合传入到一个UrlEncodedFormEntity中,然后调用HttpPost的setEntity()方法将构建好的UrlEncodedFormEntity传入
5.3:getStatusLine().getStatusCode()
获取响应的状态 状态码
5.4:getEntity()
获取数据 包装了服务器的响应内容
5.5:setParams(HttpParams params)
添加请求参数
5.6: setEntity(HttpEntity entity)
设置请求参数
5.7:execute(HttpUriRequest request)
执行请求
6.使用介绍
HttpClient:是一个接口
首先需要先创建一个DefaultHttpClient的实例
HttpClient httpClient=new DefaultHttpClient();
发送GET请求:
先创建一个HttpGet对象,传入目标的网络地址,然后调用HttpClient的execute()方法即可:
HttpGet HttpGet=new HttpGet(“http://www.baidu.com”);
httpClient.execute(httpGet);
发送POST请求:
创建一个HttpPost对象,传入目标的网络地址:
HttpPost httpPost=new HttpPost(“http://www.baidu.com”);
通过一个NameValuePair集合来存放待提交的参数,并将这个参数集合传入到一个UrlEncodedFormEntity中,然后调用HttpPost的setEntity()方法将构建好的UrlEncodedFormEntity传入:
Listparams=newArrayList();
Params.add(new BasicNameValuePair(“username”,”admin”));
Params.add(new BasicNameValuePair(“password”,”123456”));
UrlEncodedFormEntity entity=newUrlEncodedFormEntity(params,”utf-8”);
httpPost.setEntity(entity);
调用HttpClient的execute()方法,并将HttpPost对象传入即可:
HttpClient.execute(HttpPost);
执行execute()方法之后会返回一个HttpResponse对象,服务器所返回的所有信息就保护在HttpResponse里面.
先取出服务器返回的状态码,如果等于200就说明请求和响应都成功了:
If(httpResponse.getStatusLine().getStatusCode()==200){
//请求和响应都成功了
HttpEntityentity=HttpResponse.getEntity();//调用getEntity()方法获取到一个HttpEntity实例
Stringresponse=EntityUtils.toString(entity,”utf-8”);//用EntityUtils.toString()这个静态方法将HttpEntity转换成字符串,防止服务器返回的数据带有中文,所以在转换的时候将字符集指定成utf-8就可以了
7.Apache HttpClient 使用实例
思路
1.创建一个httpClient对象实例
2.创建一个get或post请求 url里传入目标的地址
3.调用excute方法调用这个get或post请求
4.执行excute方法 会返回一个httpresponse对象 服务器返回到的信息就在这个里面
5.返回内容和相应结果 200代表访问成功
6.调用getEntity方法获取到一个HttpEntity实例 里面是返回的数据
7.调用EntityUtils.toString 是将返回的数据进行字符串的转换
8.最后无论访问是否成功 都要关流
引入相关坐标 POM
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.2</version>
</dependency>
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.2</version>
</dependency>
实例一:创建HttpGet 无参请求
public class Http {
@Test
public void doGet() throws Exception{
//创建一个Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//创建一个get对象
HttpGet get = new HttpGet("url");
//执行请求
CloseableHttpResponse response = httpClient.execute(get);
//response 返回的内容 取得响应的结果 200代表访问成功
int statusCode = response.getStatusLine().getStatusCode();
System.out.println(statusCode);
//entity返回的数据
HttpEntity entity = response.getEntity();
//调用EntityUtils工具类 转toStrig方法
String s = EntityUtils.toString(entity);
System.out.println(s);
//关闭Httpclient对象
response.close();
//关闭response
httpClient.close();
}
实例二:创建HttpGet 有参请求
@Test
public void doGetWithParam()throws Exception{
//创建一个Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//创建一个url对象
URIBuilder urlBuilder = new URIBuilder("url");
urlBuilder.addParameter("query","奔跑吧兄弟");
HttpGet get = new HttpGet(urlBuilder.build());
//执行请求
CloseableHttpResponse response = httpClient.execute(get);
//取得相应的结果
int statusCode = response.getStatusLine().getStatusCode();
System.out.println(statusCode);
HttpEntity entity = response.getEntity();
String string = EntityUtils.toString(entity,"utf-8");
System.out.println(string);
//关闭http
response.close();
httpClient.close();
}
实例三:创建Httppost 无参请求
//post请求
@Test
public void doPost()throws Exception{
//创建一个Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//创建一个post对象
HttpPost post =new HttpPost("url");
//执行post请求 和get无参一样
CloseableHttpResponse response = httpClient.execute(post);
String string = EntityUtils.toString(response.getEntity());
System.out.println(string);
//关闭http
response.close();
httpClient.close();
}
实例四:创建Httppost 有参请求
//post有参
@Test
public void doPostWithParam() throws Exception{
//创建一个Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//创建一个post对象
HttpPost post =new HttpPost("url");
//创建一个Entity 模拟表单
List<NameValuePair>kvList = new ArrayList<>();
//给表单赋值
kvList.add(new BasicNameValuePair("name","xxx"));
kvList.add(new BasicNameValuePair("age","xxx"));
//包装成一个对象
StringEntity entity = new UrlEncodedFormEntity(kvList,"utf-8");
//设置请求的内容
post.setEntity(entity);
//执行post请求
CloseableHttpResponse response = httpClient.execute(post);
String string = EntityUtils.toString(response.getEntity());
System.out.println(string);
//关闭httpclient
response.close();
httpClient.close();
}
9.封装的工具类:
package com.mr.utils;
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.client.utils.URIBuilder;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.jdbc.Null;
import java.io.IOException;
import java.net.URISyntaxException;
import java.security.Key;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
/**
* Created by on 2019/1/18.
*/
public class HttpClientUtil {
//返回状态
public static class ClientResult{
//状态码
private Integer status;
//内容
private String html;
//提供get set toString 方法
public Integer getStatus() {
return status;
}
public void setStatus(Integer status) {
this.status = status;
}
public String getHtml() {
return html;
}
public void setHtml(String html) {
this.html = html;
}
@Override
public String toString() {
return "ClientResult{" +
"status=" + status +
", html='" + html + '\'' +
'}';
}
}
//get有参请求
public static ClientResult doGet(String url, Map<String,String> param) throws URISyntaxException, IOException {
//用来返回状态码的内部类
ClientResult cr = new ClientResult();
//创建一个Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//创建一个url对象
URIBuilder urlBuilder =new URIBuilder(url);
if (param != null&& param.size()!=0){
//遍历map中的参数
for (String key : param.keySet()) {
urlBuilder.addParameter(key,param.get(key));
}
}
HttpGet get = new HttpGet(urlBuilder.build());
//执行请求
CloseableHttpResponse response = httpClient.execute(get);
//取得相应的结果
int statusCode = response.getStatusLine().getStatusCode();
//返回状态码
cr.setStatus(statusCode);
HttpEntity entity = response.getEntity();
//返回内容
String string = EntityUtils.toString(entity,"utf-8");
cr.setHtml(string);
//关闭http
response.close();
httpClient.close();
return cr;
}
//get无参请求
public static ClientResult doGet(String url) throws IOException, URISyntaxException {
return doGet(url,null);
}
//post有参请求
public static ClientResult doPost(String url,Map<String,String> param) throws IOException {
ClientResult cr = new ClientResult();
//创建一个Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//创建一个post对象
HttpPost post =new HttpPost(url );
//创建一个Entity 模拟表单
List<NameValuePair> kvList = new ArrayList<>();
if (param!=null&¶m.size()!=0){
//遍历map中的参数
for (String key : param.keySet()) {
//给表单赋值
kvList.add(new BasicNameValuePair(key,param.get(key)));
}
}
//包装成一个对象
StringEntity entity = new UrlEncodedFormEntity(kvList,"utf-8");
//设置请求的内容
post.setEntity(entity);
//执行post请求
CloseableHttpResponse response = httpClient.execute(post);
//返回状态码
int statusCode = response.getStatusLine().getStatusCode();
cr.setStatus(statusCode);
//返回内容
String string = EntityUtils.toString(response.getEntity());
cr.setHtml(string);
//关闭httpclient
response.close();
//关闭请求
httpClient.close();
return cr;
}
//post 无参
public static ClientResult doPost(String url) throws IOException {
return doPost(url,null);
}
}
测试工具类
import com.mr.utils.HttpClientUtil;
import org.junit.Test;
import java.io.IOException;
import java.net.URISyntaxException;
import java.util.HashMap;
import java.util.Map;
/**
* Created by LI WAN on 2019/1/22.
*/
public class HttpDemo2 {
@Test//get有参
public void test1(){
Map<String,String> map = new HashMap<>();
map.put("name","sss");
map.put("age","11");
try {
HttpClientUtil.ClientResult cr = HttpClientUtil.doGet("url",map);
System.out.println(cr);//状态码 内容
// System.out.println(cr.getStatus());//输出状态码
// System.out.println(cr.getHtml());//输出内容
} catch (URISyntaxException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
@Test//get无参
public void test2(){
try {
HttpClientUtil.ClientResult cr = HttpClientUtil.doGet("url");
System.out.println(cr.getStatus());//输出状态码
System.out.println(cr.getHtml());//输出内容
} catch (IOException e) {
e.printStackTrace();
} catch (URISyntaxException e) {
e.printStackTrace();
}
}
@Test//post有参
public void test3(){
Map<String,String> map = new HashMap<>();
map.put("name","张三");
map.put("age","16");
HttpClientUtil.ClientResult cr = null;
try {
cr = HttpClientUtil.doPost("url",map);
} catch (IOException e) {
e.printStackTrace();
}
System.out.println(cr.getStatus());//输出状态码
System.out.println(cr.getHtml());//输出内容
}
@Test//post无参
public void test4(){
HttpClientUtil.ClientResult cr = null;
try {
cr = HttpClientUtil.doPost("url");
} catch (IOException e) {
e.printStackTrace();
}
System.out.println(cr.getStatus());//输出状态码
System.out.println(cr.getHtml());//输出内容
}
}