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中，实体有三种形式，内容以及具体的含义如下所示：
- streamed：来自于字节流，尤其是来自response的内容，通常是不可重复的
- self-contained：来自内存或者跟连接没有关系，通常是可重复的，通常用于封装Http请求
- 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请求以及获得返回的结果