Der HTTP-Standard ist schon relativ alt, und die Urspr\u00fcnge wurden Anfang der 1990er Jahre gelegt. Offiziell wurde die Version 1.0 im Jahr 1996 verabschiedet, also etwa zu gleichen Zeit, als Java 1.0 erschien. 2015 wurde HTTP\/2 verabschiedet, und viele Verbesserungen kamen in den Standard. Die Java-Klassen rund um HTTP wurden allerdings nicht aktualisiert, sodass quelloffene Bibliotheken wie Apache HttpComponents (http:\/\/hc.apache.org\/) oder die Asynchronous Http and WebSocket Client library for Java (http:\/\/github.com\/AsyncHttpClient\/async-http-client) die L\u00fccken f\u00fcllten.<\/p>\n
Statt die existierenden HTTP-Klassen wie HttpURLConnection um die Neuerungen von HTTP\/2 zu erweitern, hat Oracle das Modul java.net.http eingef\u00fchrt. Erstmalig wurde es in Java 9 im \u00bbBrutkasten\u00ab (engl. incubator) mit ausgeliefert und in Java 11 festgeschrieben. Neben synchronen Aufrufen k\u00f6nnen auch asynchrone Aufrufe get\u00e4tigt werden, die ein modernes CompletableFuture lieferrn.<\/p>\n
Das Modul besteht aus einem Paket java.net.http und den wesentlichen Typen:<\/p>\n
Schauen wir uns ein Beispiel an:<\/p>\n
try {\r\n\r\n\u00a0 URI uri = new URI( \"https:\/\/tutego.de\/\" );\r\n\r\n\u00a0 HttpRequest request = HttpRequest.newBuilder().uri( uri ).GET().build();\r\n\r\n\u00a0 HttpResponse<String> response =\r\n\r\n\u00a0\u00a0\u00a0 HttpClient.newHttpClient().send( request, BodyHandlers.ofString() );\r\n\r\n\u00a0 System.out.println( response.body() );\r\n\r\n}\r\n\r\ncatch ( URISyntaxException | IOException | InterruptedException e ) {\r\n\r\n\u00a0 e.printStackTrace();\r\n\r\n}<\/pre>\nDie Methoden von HttpRequest sind allesamt abstrakt.<\/p>\n
abstract class java.net.http.HttpRequest<\/strong><\/p>\n\n- Optional<HttpRequest.BodyPublisher> bodyPublisher()<\/li>\n
- boolean expectContinue()<\/li>\n
- HttpHeaders headers()<\/li>\n
- String method()<\/li>\n
- Builder newBuilder()<\/li>\n
- Builder newBuilder(URI uri)<\/li>\n
- Optional<Duration> timeout()<\/li>\n
- URI uri()<\/li>\n
- Version version()<\/li>\n<\/ul>\n
F\u00fchrt der HttpClient die Anfrage aus, bekommen wir ein HttpResponse; die Schnittstelle deklariert folgende Methoden:<\/p>\n
public interface java.net.http.HttpResponse<T><\/strong><\/p>\n\n- T body()<\/li>\n
- HttpHeaders headers()<\/li>\n
- Optional<HttpResponse<T>> previousResponse()<\/li>\n
- HttpRequest request()<\/li>\n
- Optional<SSLSession> sslSession()<\/li>\n
- int statusCode()<\/li>\n
- URI uri()<\/li>\n
- Version version()<\/li>\n<\/ul>\n
Was die Methode body() f\u00fcr einen Typ liefert, bestimmt die Parametrisierung von HttpResponse<T>, und die ergibt sich aus dem \u00fcbergebenen BodyHandler<T> der HttpClient-Methode send(\u2026):<\/p>\n
public abstract class java.net.http.HttpClient<\/strong><\/p>\n\n- static HttpClient newHttpClient()<\/li>\n
- HttpResponse<T> send(HttpRequest req, HttpResponse.BodyHandler<T> responseBodyHandler)<\/li>\n<\/ul>\n
Der BodyHandler ist eine funktionale Schnittstelle mit einer Methode<\/p>\n
\n- BodySubscriber<T> apply\u200b(HttpResponse.ResponseInfo responseInfo)<\/li>\n<\/ul>\n
Es gibt einige vordefinierte Implementierungen in der Klasse HttpResponse.BodyHandlers:<\/p>\n
public static class java.net.http.HttpResponse.BodyHandlers<\/strong><\/p>\n\n- static HBodyHandler<byte[]> ofByteArray()<\/li>\n
- staticBodyHandler<Path> ofFile\u200b(Path file)<\/li>\n
- static HttpRespoBodyHandler<Stream<String>> ofLines()<\/li>\n
- static HBodyHandler<String> ofString()<\/li>\n<\/ul>\n
Weitere Methoden nennt die Javadoc.<\/p>\n","protected":false},"excerpt":{"rendered":"
Der HTTP-Standard ist schon relativ alt, und die Urspr\u00fcnge wurden Anfang der 1990er Jahre gelegt. Offiziell wurde die Version 1.0 im Jahr 1996 verabschiedet, also etwa zu gleichen Zeit, als Java 1.0 erschien. 2015 wurde HTTP\/2 verabschiedet, und viele Verbesserungen kamen in den Standard. Die Java-Klassen rund um HTTP wurden allerdings nicht aktualisiert, sodass quelloffene […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":"","_links_to":"","_links_to_target":""},"categories":[11],"tags":[],"class_list":["post-4219","post","type-post","status-publish","format-standard","hentry","category-insel"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/4219","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/comments?post=4219"}],"version-history":[{"count":1,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/4219\/revisions"}],"predecessor-version":[{"id":4220,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/4219\/revisions\/4220"}],"wp:attachment":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/media?parent=4219"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/categories?post=4219"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/tags?post=4219"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}