转载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();
// 连接
connection.connect();
// 4.得到相应状态码的返回值
int responseCode = connection.getResponseCode();
logger.info("Get-responseCode:"+responseCode);
// 5.如果返回值正常,数据在网络中是以流的形式得到服务器返回的数据
String msg = "";
// 正常响应
if(responseCode == ) {
// 从流中读取数据
BufferedReader reader = new BufferedReader(
new InputStreamReader(connection.getInputStream())
);
String line = null;
// 循环从流中读取
while ((line = reader.readLine()) != null) {
msg += line + "\n";
}
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();
// 设置是否向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 == ) {
BufferedReader reader = new BufferedReader(
new InputStreamReader(connection.getInputStream())
);
String line = "";
while ((line = reader.readLine()) != null) {
msg += line + "\n";
}
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);
}
}
说明:
- HttpURLConnection对象不能直接构造,需要通过URL类中的openConnection()方法来获得。
- HttpURLConnection的connect()函数,实际上只是建立了一个与服务器的TCP连接,并没有实际发送HTTP请求。HTTP请求实际上直到我们获取服务器响应数据(如调用getInputStream()、getResponseCode()等方法)时才正式发送出去。
- 对HttpURLConnection对象的配置都需要在connect()方法执行之前完成。
- HttpURLConnection是基于HTTP协议的,其底层通过socket通信实现。如果不设置超时(timeout),在网络异常的情况下,可能会导致程序僵死而不继续往下执行。
- HTTP正文的内容是通过OutputStream流写入的, 向流中写入的数据不会立即发送到网络,而是存在于内存缓冲区中,待流关闭时,根据写入的内容生成HTTP正文。
- 调用getInputStream()方法时,返回一个输入流,用于从中读取服务器对于HTTP请求的返回信息。
- 我们可以使用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协议的),即提高了开发的效率,也方便提高代码的健壮性。