Enterprise-IT-Praktikum JAX-RS-Einführung Institut für Telematik Universität zu Lübeck Wintersmester 2012/13 Dennis Boldt David Gregorczyk

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung2 Wer kennt es nicht – ROA ROA steht für Resource-oriented Architecture  Counterpart: Service-oriented Architecture (SOA) Roy Fielding: Representational State Transfer (ReST) Konzept: über Hyperlinks (URIs) werden Ressourcen bereitgestellt und/oder miteinander verknüpft –Adressierbarkeit –Unterschiedliche Repräsentationen –Zustandslosigkeit –Wohldefinierte Zugriffsoperationen –Hypermedia Wie komisch, passt ja perfekt zu HTTP…

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung3 Gibt’s da auch was von Ratiopharm? Nein, aber von Java: JSR-311  Java API for RESTful Web Services (JAX-RS) Reference Implementation „Jersey“ Subprojekt vom GlassFish-Application-Server Unterstützt die Konstruktion von REST-konformen Schnittstellen mit Hilfe von Java-Annotationen JAX-RS 1.1 fertiggestellt Version 2.0 ist im Bearbeitungsstatus

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung4 Vorgehen Server-Seite Klassen mit Funktionalität programmieren Annotationen einfügen Web-Server-Deployment durchführen Client-Seite Testen z.B. mit curl auf Kommandozeile: curl –HAccept:application/json Browser-Plugin: XHR-Poster Jersey-Client-API

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung5 Server-Seite: Klassen programmieren public class HelloResource // Name beliebig { public String sayProst() // Name beliebig { return "Prost"; }

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung6 Server-Seite: Annotationen public class HelloResource //Name public String sayProst() //Name beliebig { return "Prost"; }

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung7 Deployment: Servlet-Container mit Tomcat ServletAdaptor com.sun.jersey.spi.container.servlet.ServletContainer 1 ServletAdaptor /rest/* 30

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung8 Deployment: Java NIO mit Grizzly URI baseUri = UriBuilder.fromUri(" ResourceConfig rc = new PackagesResourceConfig("pkg.to.resources"); HttpServer srv = GrizzlyServerFactory.createHttpServer(baseUri, rc); System.in.read(); srv.stop(); Quelle: Jersey Documentation guide.html#d4e54

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung9 Da geht noch was… Ein- und Ausgabeparameter Sub-resources-Konzept für strukturierten Ressourcen- Zugriff Automatisches Marshalling/Unmarshalling von Java- Objekten zu XML/JSON  sehr elegant z.B. mit JAXB

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung10 Ein- und public class @Produces(MediaType.APPLICATION_JSON) public String createUser(String userData) @Produces(MediaType.APPLICATION_JSON) public String String userId) {... }

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung11 Das public class RestResource public String userSubresource(String userData) { return new UserResource(); } public class UserResource {... } Sub-sub-Resources, Sub-sub-sub-Resources usw. möglich Sub-Resources erhalten KEINE Kontextinformationen

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung12 Automatisches Marshalling/Unmarshalling (1/2) Ein-/Ausgabe-Parameter standardmäßig Strings… Automatische Transformation wünschenswert JAXB XML-zu-Java-Objekt-Mapping-Spezifikation, JSR Kann in Zusammenhang mit Jersey eingesetzt werden Sowohl für XML als auch für JSON Statt Strings werden in den Resource-Definitionen die JAXB-Beans angegeben Vorteil mit Hibernate: gemeinsame Klassen für Persistenz und Serialisierung möglich

Institut für Telematik | Enterprise-IT-Praktikum Enterprise-IT-Praktikum – JAX-RS-Einführung13 Automatisches Marshalling/Unmarshalling (2/2) // public class User { private String userName; private String password; } // JAX-RS-Ressource – Parameter und Rückgabe sind public class @Produces(MediaType.APPLICATION_JSON) public User createUser(User userData) {... }