JDK11的新特性:新的HTTP API
簡介
JDK11之前,java的HTTP功能很弱,只提供了HttpURLConnection來進行HTTP連接,並且使用起來非常復雜。所以一般大家都是用第三方的HTTP client(Apache HttpComponents 或者 OkHttp)來進行HTTP請求。
一切在JDK11的時候完全變了,在java.net.http包,最新的HttpClient, HttpRequest 和 HttpResponse完全可以滿足你的需求。
更多內容請訪問www.flydean.com
使用HTTP Client請求的基本流程
通常我們要在代碼中做一個HTTP請求,通常有三個步驟。
- 構建一個HTTP client。
- 生成一個HTTP Request。
- 使用HTTP Client發送HTTP Request得到一個HTTP Response。
創建HTTP Client
做HTTP請求,需要建立一個HTTP客戶端和HTTP server之間的連接,HTTP協議是非常復雜的,有很多可控的參數。所以需要有一個HttpClient來進行相關的配置。
HttpClient client = HttpClient.newBuilder()
.version(HttpClient.Version.HTTP_2)
.connectTimeout(Duration.ofSeconds(5))
.followRedirects(HttpClient.Redirect.ALWAYS)
.build();
創建HttpClient很簡單,使用newBuilder就可以了,我們可以指定version,connectTimeout,proxy,SSL,認證或者cookie等。
創建HTTP Request
同樣的,使用HttpRequest.newBuilder()就可以用來創建HTTP Request。
HttpRequest getRequest = HttpRequest.newBuilder()
.GET()
.uri(URI.create("http://www.flydean.com"))
.header("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36")
.build();
上面的例子我們創建了一個get請求,並設置了請求的url和head。
如果是post請求,則需要構建一個request body:
HttpRequest.BodyPublisher requestBody = HttpRequest.BodyPublishers
.ofString("{ 我是body }");
HttpRequest postRequest = HttpRequest.newBuilder()
.POST(requestBody)
.uri(URI.create("http://www.flydean.com"))
.build();
發送HTTP請求
有了client和request,我們就可以發送HTTP請求了。
HttpResponse<String> response = client.send( getRequest, HttpResponse.BodyHandlers.ofString());
String respnseBody = response.body();
log.info(respnseBody);
這樣一個完美的HTTP請求就完成了。
異步HTTP請求
上面的例子我們使用client.send來發送http請求,這個請求實際上是同步的,這意味着我們的程序必須一直等待,直到返回請求結果。
HttpClient還提供了一個sendAsync的異步執行的方法。該方法返回一個CompletableFuture。
還是看個例子:
public void useAsyncHttp() {
HttpClient client = HttpClient.newBuilder()
.version(HttpClient.Version.HTTP_2)
.connectTimeout(Duration.ofSeconds(5))
.followRedirects(HttpClient.Redirect.ALWAYS)
.build();
CompletableFuture<Void> completableFuture=checkUri(client,URI.create("http://www.flydean.com"));
//獲取completableFuture的值
completableFuture.join();
}
private CompletableFuture<Void> checkUri(HttpClient httpClient, URI uri){
HttpRequest request = HttpRequest.newBuilder()
.GET()
.uri(uri)
.header("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36")
.build();
return httpClient.sendAsync(request,HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::statusCode)
.thenApply(statusCode -> statusCode == 200 )
.exceptionally(ex -> false)
.thenAccept(valid ->
{
if (valid) {
log.info("uri {} is valid",uri);
} else {
log.info("uri {} is not valid", uri);
}
});
}
上面的例子中我們獲取了HTTP請求,然后調用了CompletableFuture的thenApply和thenAccept對結果進行過濾和處理。
CompletableFuture是Future和CompletionStage的混合體。Future大家都很熟悉了,可以通過get方法獲取異步執行的結果。而CompletionStage代表的是一個異步計算的stage,不同的stage可以互相依賴,通過then***方法來組成一個級聯操作。和Stream的操作有點像,和ES6中的promise的then一樣,使用CompletionStage可以避免回調地獄。CompletionStage可以將異步回調轉換成級聯操作。
關於CompletableFuture的更多內容,可以參考關於CompletableFuture的一切,看這篇文章就夠了
thenApply的參數是一個Function,thenAccept是一個Consumer。
最后,我們需要調用completableFuture.join()來保證completableFuture的異步操作執行完成。
當然調用completableFuture.get()方法也是可以的。
總結
本文講解了JDK12新創建的HTTP Client操作,並進一步討論了CompletableFuture的使用。
本文的例子https://github.com/ddean2009/
learn-java-base-9-to-20
本文作者:flydean程序那些事
本文鏈接:http://www.flydean.com/jdk11-http-api/
本文來源:flydean的博客
歡迎關注我的公眾號:程序那些事,更多精彩等着您!
