HttpClient的基本使用

前言

HttpClient是Apache提供的一个用于在Java中处理HTTP请求、响应操作的工具，由于JDK自带的API对HTTP协议的支持不是很友好，使用起来也不是很方便，加上这几天刚好有个小项目需要使用到，所以学习了HttpClient的基本使用，并且将学习过程的笔记整理出来

Http请求

正如我们所知道的，一个Http请求包含了一下几个部分的内容，首先是请求行(包括了请求方法、请求的URI、HTTP协议的版本)，请求头(若干的键值对)，以及可选的请求体(POST中经常存放，GET中则没有该项内容)

HttpClient对其中各个部分都进行了封装，接下来我们来详细看下具体的操作

Http请求行

一个Http请求行对应的内容在上面已经提过了，这里就不做过多的叙述，在HttpClient中，一个Http请求行对应的类为RequestLine，具体的操作如下代码所示：

 ???// 创建一个GET对象 ???HttpGet get = new HttpGet("http://www.baidu.com"); ???// 获得请求行对象 ???RequestLine statusLine = get.getRequestLine(); ???// 获得请求方法 ???System.out.println(statusLine.getMethod()); ???// 获得请求URI ???System.out.println(statusLine.getUri()); ???// 获得HTTP版本协议 ???System.out.println(statusLine.getProtocolVersion());

对应的输出结果如下所示：

GEThttp://www.baidu.comHTTP/1.1

可以看到，HttpClient通过RequestLine对象将一个Http请求对应的请求行封装起来了。

请求头

在Http中，Http的头信息包含了很多的内容，比如Content-type、Set-Cookie等，这里我们演示一个简单的小案例，注意这里的头信息包括了请求以及响应，它们只是对应的键值对以及含义不同而已吗，形式上是一致的，如下代码所示：

 ???/* ???????通过Header对象设置头信息 ????*/ ???Header header = new BasicHeader("Content-type", "text/plain"); ???Header header1 = new BasicHeader("Set-Cookie", "c1=a; path=/; domain=localhost"); ???response.addHeader(header); ???response.addHeader(header1); ???/* ???????获取特定的头信息 ???*/ ???Header respHeader = response.getFirstHeader("Content-type"); ???System.out.println(respHeader.getName() + " : " + respHeader.getValue()); ???respHeader = response.getFirstHeader("Set-Cookie"); ???System.out.println(respHeader.getName() + " : " + respHeader.getValue()); ????/* ???????通过迭代器访问所有的头信息 ????*/ ???HeaderIterator iterator = response.headerIterator(); ???while (iterator.hasNext()){ ???????Header tmp = iterator.nextHeader(); ???????System.out.println(tmp.getName() + " : " + tmp.getValue()); ???} ???/* ???????获取某一头信息中的所有元素以及其值 ???*/ ???HeaderElementIterator iterator1 = new BasicHeaderElementIterator(response.headerIterator("Set-Cookie")); ???while (iterator1.hasNext()){ ???????HeaderElement element = iterator1.nextElement(); ???????System.out.println(element.getName() + " : " + element.getValue()); ???????NameValuePair[] params = element.getParameters(); ???????for (NameValuePair n : params) { ???????????System.out.println(n.getName() + " : " + n.getValue()); ???????} ???}

对应的输出结果如下所示：

Content-type : text/plainSet-Cookie : c1=a; path=/; domain=localhostContent-type : text/plainSet-Cookie : c1=a; path=/; domain=localhostc1 : apath : /domain : localhost

Http实体

在一个Http中，通常还会涉及到实体，Entity，也就是请求/响应的真正内容，在请求中，通常是PUT以及POST中会含有该实体，而在响应中，一般都会包含一个实体，用于作为服务端返回信息的载体。

在HttpClient中，实体有三种形式，内容以及具体的含义如下所示：

1. streamed：来自于字节流，尤其是来自response的内容，通常是不可重复的
2. self-contained：来自内存或者跟连接没有关系，通常是可重复的，通常用于封装Http请求
3. wrapping：来自于其他entity

这里需要注意的是，实体的形式并不意味着实体的具体类型，也就是说，上面的实体形式只是一个概念上的理解，具体的类型可以有：StringEntity、ByteArrayEntity、InputStreamEntity、FileEntity等，基本上这些类型都见名之意，故这里不做过多的解释，具体可以参考官方手册

下面简单演示使用StringEntity传递以及接收数据

 ???/* ???????设置String类型的实体 ???*/ ???StringEntity entity = new StringEntity("hello"); ???response.setEntity(entity); ???/* ??????接收String类型的实体 ???*/ ???HttpEntity entity1 = response.getEntity(); ???if (entity1 != null){ ???????// 通过EntityUtils工具来获取 ???????//System.out.println(EntityUtils.toString(entity1)); ???????// 通过流来获取数据 ???????InputStream inputStream = entity1.getContent(); ???????byte[] data = new byte[inputStream.available()]; ???????inputStream.read(data); ???????System.out.println(new String(data, 0, data.length)); ???????inputStream.close(); // 这里切记要记得关闭资源 ???}

Http响应

Http响应行

正如我们所知道的Http响应包含了一个响应行(Http版本，状态码，状态码的解释)响应头(参见上面请求头部分)以及对应的实体(参见上面的实体部分)

接下来我们来具体看下响应行以及HttpResponse对象的使用

 ???// 创建一个HttpResponse ???HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1, HttpStatus.SC_OK, "ok"); ???// 获得相应的状态行 ???StatusLine statusLine1 = response.getStatusLine(); ???// Http协议版本 ???System.out.println(statusLine1.getProtocolVersion()); ???// 响应结果 ???System.out.println(statusLine1.getStatusCode()); ???// 响应结果的解释 ???System.out.println(statusLine1.getReasonPhrase());

对应的结果如下所示

HTTP/1.1200ok

发送/接收Http请求

上面主要是关于Http请求以及响应的内容，接下来来看下HttpClient是如何发送Http请求以及接收请求

 ???// 创建一个HttpClient对象 ???CloseableHttpClient client = HttpClients.createDefault(); ???// 发送请求并且获得返回的结果 ???CloseableHttpResponse response = client.execute(request);

总结

本节主要介绍了HttpClient的使用，包括了对Http请求对象的使用、Http响应对象的使用以及如何发送Http请求以及获得返回的结果