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();
}
}
}
我们看到,控制台打印出的是网页的源代码,如下图。