Java开发笔记（一百一十二）Java11新增的HttpClient
前面介绍了基于HttpURLConnection的网络访问请求，包括GET方式调用接口、POST方式调用接口、下载网络文件、上传本地文件这四种HTTP操作。虽然通过HttpURLConnection能够实现相应的业务功能，但是它的编码过程却有些繁琐，需要时时刻刻注意有关细节，一不留神便会掉到坑里。比如下列编码细节就经常令初学者头痛不已：
1、HttpURLConnection工具独自一人承担了所有的方法实现，分不清哪些方法与请求有关，哪些方法与应答有关；
2、HTTP调用的步骤太多，诸如参数设置、开启连接、写入请求报文、读取应答报文、断开连接这些操作的次序得牢牢记住，一旦弄错顺序就无法正常调用；
3、对于请求报文与应答报文，HttpURLConnection只笼统提供了输出流和输入流，剩下的事全凭开发者自由发挥，害得开发者忙于I/O流与字符串/文件之间的转换工作；
4、服务器返回的应答报文，其数据有可能采用gzip压缩，还可能采取GBK字符编码，然而HttpURLConnection默认情况下却袖手旁观，必须由开发者对数据手工解压和重新编码；
总而言之，HttpURLConnection要求开发者掌握太多的技术细节，容易造成初学者对其望而却步。为此第三方的HTTP框架层出不穷，意图通过简单明了的方法调用来简化HTTP通信编程。Apache旗下的HttpClient便是其中一个佼佼者，它封装了大部分的编码细节，开发者只需书写寥寥数行代码，即可完成常见的HTTP访问操作。当然，Apache的HttpClient毕竟是个外来者，它运用得越广泛，Java的老板Oracle越是觉得不爽，老财主Oracle心想：咱卧榻之侧，岂容他人鼾睡？与其依赖Apache，不如自己动手丰衣足食，于是从Java11开始，JDK新增了自己的HttpClient框架，总算在自力更生的道路上迈开了小小的一步。
Java11的HttpClient体系由三部分组成，分别是表示HTTP客户端的HttpClient、表示HTTP请求过程的HttpRequest、表示HTTP应答过程的HttpResponse。其中HttpClient用于描述通用的客户端连接信息，包括HTTP协议的版本号、HTTP代理、重定向方式、连接超时时间、身份认证、SSL证书等等。下面是创建HTTP客户端对象的代码例子：
// 创建一个自定义的HTTP客户端对象 HttpClient client = HttpClient.newBuilder() .version(Version.HTTP_1_1) // 遵循HTTP协议的1.1版本 .followRedirects(Redirect.NORMAL) // 正常的重定向 .connectTimeout(Duration.ofMillis(5000)) // 连接的超时时间为5秒 .authenticator(Authenticator.getDefault()) // 默认的身份认证 .build();
显然以上的代码例子很啰嗦，对于普通的HTTP连接，一律按照默认的参数就行。于是HTTP客户端对象的创建代码可缩短到如下一行：
// 创建默认的HTTP客户端对象 HttpClient client = HttpClient.newHttpClient();
至于HttpRequest，则用于描述本次网络访问的请求信息，包括对方地址、接口的调用方式（GET还是POST）、请求的超时时间、请求的头部属性等等。下面是创建HTTP请求对象的代码例子：
// 创建一个自定义的HTTP请求对象
HttpRequest request = HttpRequest.newBuilder()
.GET() // 调用方式为GET
.uri(URI.create(url)) // 待调用的url地址
.header("Accept-Language", "zh-CN") // 设置头部参数，中文文本
.timeout(Duration.ofMillis(5000)) // 请求的超时时间为5秒
.build();
对于一般的GET调用而言，HTTP请求可以使用默认的参数，再把对方地址作为newBuilder方法的输入参数，如此一来HTTP请求对象的创建代码也可缩短到如下一行：
// 创建默认的HTTP请求对象（默认GET调用） HttpRequest request = HttpRequest.newBuilder(URI.create(url)).build();
接着调用HTTP客户端对象的send方法，第一个参数填HTTP请求对象，第二个参数填BodyHandlers.ofString()表示要求返回字符串形式的应答报文，而send方法的返回值便是HttpResponse对象。HttpResponse主要提供了下列三个方法，以便开发者处理应答数据：
statusCode：获取应答的状态码。
body：获取应答报文的内容。
headers：获取应答的所有头部属性。
接下来结合HttpClient、HttpRequest、HttpResponse，很容易写出GET方式的HTTP调用代码，具体代码如下所示：
// 对指定url发起GET调用
private static void testCallGet(String url) {
// 创建默认的HTTP客户端对象
HttpClient client = HttpClient.newHttpClient();
// 创建默认的HTTP请求对象（默认GET调用）
HttpRequest request = HttpRequest.newBuilder(URI.create(url)).build();
try {
// 客户端传递请求信息，且返回字符串形式的应答报文
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
// 获取应答的所有头部属性
HttpHeaders headers = response.headers();
// 打印HTTP调用的应答内容长度、内容类型、压缩方式
System.out.println( String.format("应答内容长度=%s, 内容类型=%s, 压缩方式=%s",
headers.firstValue("Content-Length").orElse(null),
headers.firstValue("Content-Type").orElse(null),
headers.firstValue("Content-Encoding").orElse(null)) );
// 打印HTTP调用的应答状态码和应答报文
System.out.println( String.format("应答状态码=%d, 应答报文=%s",
response.statusCode(), response.body()) );
} catch (Exception e) {
e.printStackTrace();
}
}
然后在外部调用上面的testCallGet方法，以股指查询的接口地址为例，查询上证指数的调用代码如下：
testCallGet("https://hq.sinajs.cn/list=s_sh000001");
运行以上的股指查询代码，观察到以下的查询日志，可见HttpClient已经自动完成了中文字符的GBK编码。
应答内容长度=75, 内容类型=application/javascript; charset=GBK, 压缩方式=null 应答状态码=200, 应答报文=var hq_str_s_sh000001="上证指数,3244.8103,-1.7611,-0.05,5045184,50643124";
利用HttpClient发起POST方式的调用过程类似GET方式，唯一的区别在于：创建HTTP请求对象之时要调用POST方法并传入请求报文。下面是采取POST方式访问服务地址的HttpClient代码例子：
// 对指定url发起POST调用
private static void testCallPost(String url, String body) {
System.out.println("请求报文="+body);
// 创建默认的HTTP客户端对象
HttpClient client = HttpClient.newHttpClient();
// 创建一个自定义的HTTP请求对象
HttpRequest request = HttpRequest.newBuilder(URI.create(url)) // 待调用的url地址
.POST(BodyPublishers.ofString(body)) // 调用方式为POST，且请求报文为字符串
.header("Content-Type", "application/json") // 设置头部参数，内容类型为json
.build();
try {
// 客户端传递请求信息，且返回字符串形式的应答报文
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
// 打印HTTP调用的应答状态码和应答报文
System.out.println( String.format("应答状态码=%d, 应答报文=%s",
response.statusCode(), response.body()) );
} catch (Exception e) {
e.printStackTrace();
}
}
接着由外部调用上面的testCallPost方法，这里访问的是本机的HTTP服务，交互报文为json格式，具体代码如下所示：
testCallPost("http://localhost:8080/NetServer/checkUpdate", "{\"package_list\":[{\"package_name\":\"com.qiyi.video\"}]}");
运行以上的服务访问代码，观察到以下的接口日志，可见HttpClient正确完成了POST方式的接口调用。
请求报文={"package_list":[{"package_name":"com.qiyi.video"}]}
应答状态码=200, 应答报文={"package_list":[{"package_name":"com.qiyi.video","download_url":"https://3g.lenovomm.com/w3g/yydownload/com.qiyi.video/60020","new_version":"10.2.0"}]}
更多Java技术文章参见《Java开发笔记（序）章节目录》
