借助Java 11,Rest API调用非常简单轻松。在本文中,Adrian D. Finlay解释了如何利用Java 11中的新异步API来执行REST API调用,实现HTTP和WebSocket操作。
曾几何时,使用Java SE(标准版)API执行常见的HTTP操作(如REST API调用)可能被描述为不自然且繁琐。Java 11正式改变了这一点。
从Java 11开始,API现在完全异步。本文将尝试通过执行REST API调用向您展示新API的基本用法,我们将使用openJDK 11。
新API使用java.util.concurrent.CompleteableFuture提供的异步,非阻塞的请求/响应行为;新API为HTTP 1.1 / 2,WebSocket提供本机支持。
新API提供核心功能的核心类和接口包括:
HttpClient类, java.net.http.HttpClient
HttpRequest类, java.net.http.HttpRequest
HttpResponse界面, java.net.http.HttpResponse
WebSocket接口,java.net.http.WebSocket
在Java 11之前调用http:
var HTTP_CLIENT= (HttpURLConnection)
URI.create(
new StringBuilder(API_ENDPOINT)
.append("firstName=").append(args[0])
.append("&surname=").append(args[1])
.append("&season=").append(args[2])
.toString())
.toURL()
.openConnection();
HTTP_CLIENT.setRequestMethod("GET");
var HTTP_RESPONSE = HTTP_CLIENT.getInputStream();
使用Java 11调用http:
var HTTP_REQUEST = HttpRequest.newBuilder()
.uri(URI.create( //Set the appropriate endpoint
new StringBuilder(API_ENDPOINT)
.append("firstName=").append(args[0])
.append("&surname=").append(args[1])
.append("&season=").append(args[2])
.toString() ) )
.timeout(Duration.ofMinutes(1))
.header("Content-Type", "application/json")
.build();
var HTTP_RESPONSE = HTTP_CLIENT.send(HTTP_REQUEST, asString);
var statusCode = HTTP_RESPONSE.statusCode();
if (statusCode == 200 || statusCode == 201)
System.out.println("Success! -- Java 11 REST API Call/n" +
args[1] + ", " + args[0] + " [" + args[3] +"]/n" + HTTP_RESPONSE.body());
else
System.out.println("Failure! -- Java 11 REST API Call");
从语义上讲,新API是2018年Java API所需的一切。首先,它是详细的。其次,它是模块化的。第三,它遵循新的OOP方式链接(或使用构建器)来构造对象。第四,它和HTTP更自然。
API感觉更加原生于HTTP。命名方法名称(如body()和headers())比getContent()和getHeaderField(),getHeaderKey()更适合。旧的API是抽象的,并且与通用网络相关,而不针对HTTP。
优于HttpURLConnection的优点:
1.改进了对HTTP,HTTP / 2的支持
2.原生HTTP感觉,HTTP是一流的公民
3.异步,非阻塞实现
4.新的API,更自然地与现代语言功能