@Produces: Die Annotation kann zwar grunds\u00e4tzlich auch entfallen, aber besser ist es, deutlich einen MIME-Typ zu setzen. Es gibt String-Konstanten f\u00fcr die wichtigsten MIME-Typen, wie TEXT_XML oder MediaType.TEXT_HTML, und auch Strings wie \u201eapplication\/pdf\u201c k\u00f6nnen direkt gesetzt werden. Neben @Produces gibt es das symmetrische @Consumes.<\/li>\n<\/ul>\nTest-Server starten<\/h3>\n
Ein Java\u00a0EE-Application-Server w\u00fcrde die Klasse aufgrund der Annotationen gleich einlesen und als REST-Service anmelden. Da wir die Klasse jedoch in der Java SE ohne Application-Server verwenden, muss ein REST-Server von Hand aufgebaut werden. Das ist aber problemlos, denn daf\u00fcr haben wir jersey-container-jdk-http-2.x.y.jar eingebunden, sodass sich Jersey in den im JDK eingebauten HTTP-Server integriert.<\/p>\n
ResourceConfig\u00a0rc\u00a0=\u00a0new\u00a0ResourceConfig().packages(\u00a0\"com.tutego.insel.rest\"\u00a0);\n HttpServer\u00a0server\u00a0=\u00a0JdkHttpServerFactory.createHttpServer(\u00a0\n \u00a0\u00a0\u00a0URI.create(\u00a0\"http:\/\/localhost:8080\/api\"\u00a0),\u00a0rc );\n JOptionPane.showMessageDialog(\u00a0null,\u00a0\"Ende\"\u00a0);\n server.stop(\u00a00\u00a0);<\/pre>\nNach dem Start des Servers scannt Jersey die Klassen im genannten Paket daraufhin ab, ob sie passende JAX-RS-Annotationen tragen. Das Class-Scanning wurde aktiviert mit der package(\u2026)-Methode beim ResourceConfig, es ist aber auch m\u00f6glich, im Konstruktor von ResourceConfig direkt die JAW-RS-Ressourcen \u00fcber ihre Class-Objekte aufzuz\u00e4hlen.<\/p>\n
Die statische Methode JdkHttpServerFactory.createHttpServer(\u2026) liefert ein Objekt vom Typ com.sun.net.httpserver.HttpServer, das Teil der internen Java-API ist. Die JdkHttpServerFactory stammt aus dem internen Jersey-Paket.<\/p>\n
REST-Services konsumieren<\/h3>\n
Bei createHttpServer(\u2026) ist als Testpfad „http:\/\/localhost:8080\/api“ eingetragen, und zusammen mit @Path(„dating“) an der Klasse ergibt sich der Pfad http:\/\/localhost:8080\/api\/dating f\u00fcr die Ressource. Wir k\u00f6nnen die URL im Browser eintragen.<\/p>\n
REST-Client mit Jersey<\/h4>\n
Sich im Browser das Ergebnis eines REST-Aufrufs anzuschauen, ist nicht das \u00fcbliche Szenario. Oft sind es JavaScript-Programme im Browser, die REST-Aufrufe starten und die konsumierten Daten auf einer Webseite integrieren.<\/p>\n
Ist es ein Java-Programm, das einen REST-Dienst anzapft, so kann dies mit einer einfachen URLConnection erledigt werden, was eine Standardklasse aus dem java.net-Paket ist, um auf HTTP-Ressourcen zuzugreifen. Doch Jersey definiert eine standardisierte API zum einfachen Zugriff. Es reicht ein Einzeiler:<\/p>\n
System.out.println(\n \u00a0\u00a0ClientBuilder.newClient().target( \"http:\/\/localhost:8080\/api\" )\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 .path( \"dating\" ).request().get( String.class )\n );<\/pre>\nDer API-Stil, den die Bibliotheksautoren hier verwenden, nennt sich Fluent-API; Methodenaufrufe werden verkettet, um alle Parameter wie URL oder MIME-Typ f\u00fcr die Anfrage zu setzen. Das ist eine Alternative zu den bekannten Settern auf JavaBeans bzw. einen \u00fcberladenen Konstruktor mit un\u00fcbersichtlichen Parameterlisten.<\/p>\n
Um die Typen bei der javax.ws.rs.client-API etwas besser zu verstehen, schreiben wir alles ganz vollst\u00e4ndig aus:<\/p>\n
Client\u00a0client\u00a0=\u00a0ClientBuilder.newClient();\n WebTarget\u00a0target\u00a0=\u00a0client.target(\u00a0\"http:\/\/localhost:8080\/api\"\u00a0);\n WebTarget\u00a0resourceTarget\u00a0=\u00a0target.path(\u00a0\"dating\"\u00a0);\n Invocation.Builder\u00a0request\u00a0=\u00a0resourceTarget.request(\u00a0MediaType.TEXT_PLAIN\u00a0);\n Response\u00a0response\u00a0=\u00a0request.get();\n System.out.println(\u00a0response.readEntity(\u00a0String.class\u00a0)\u00a0);<\/pre>\nDas Response-Objekt hat auch eine Methode getStatus() f\u00fcr den HTTP-Statuscode und hasEntry(), um zu pr\u00fcfen, ob es ein Ergebnis gibt und keinen Fehler. Apropos Fehler: Ist die URL falsch, gibt es eine RuntimeException \u2013 gepr\u00fcfte Ausnahmen verwendet Jersey nicht.<\/p>\n
Exception\u00a0in\u00a0thread\u00a0„main“\u00a0javax.ws.rs.NotFoundException:\u00a0HTTP\u00a0404\u00a0Not\u00a0Found<\/p>\n
[1]<\/sup><\/a>\u00a0\u00a0 Roy Fielding meint dazu nur: \u201eFlickr obviously don\u2019t have a clue what REST means since they just use it as an alias for HTTP. Perhaps that is because the Wikipedia entry is also confused. I don\u2019t know.\u201c (Quelle: http:\/\/roy.gbiv.com\/untangled\/2008\/no-rest-in-cmis).<\/p>\n","protected":false},"excerpt":{"rendered":"Dieser Abschnitt stellt das Architekturprinzip REST vor und anschlie\u00dfend den Java-Standard JAX-RS. Es folgen Beispiele mit der JAX-RS-Referenzimplementierung Jersey. Aus Prinzip REST Bei RESTful Services liegt das Konzept zugrunde, dass eine Ressource \u00fcber einen Webserver verf\u00fcgbar ist und eindeutig \u00fcber einen URI identifiziert wird. Da unterschieden werden muss, ob eine Ressource neu angelegt, gelesen, aktualisiert, […]<\/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":[1,11],"tags":[],"class_list":["post-3923","post","type-post","status-publish","format-standard","hentry","category-allgemein","category-insel"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/3923","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=3923"}],"version-history":[{"count":9,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/3923\/revisions"}],"predecessor-version":[{"id":3932,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/3923\/revisions\/3932"}],"wp:attachment":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/media?parent=3923"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/categories?post=3923"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/tags?post=3923"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}