What s New in JAX-RS 2.1?

Transcription

1 What s New in JAX-RS 2.1? CON3625 David Java and Container NaMve PlaOorm - Oracle October,

2 @delabassee 2

3 Safe Harbor Statement The following is intended to outline our general product direcmon. It is intended for informamon purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or funcmonality, and should not be relied upon in making purchasing decisions. The development, release, and Mming of any features or funcmonality described for Oracle s products remains at the sole discremon of Oracle. 3

4 JAX-RS 4

5 JAX-RS Java API for RESTful Web Services JAX-RS 2.0 JSR 339, lead by SanMago Pericasgeertsen & Marek Potociar Java EE 7 JAX-RS 2.1 JSR 370, lead by SanMago Pericasgeertsen & Pavel Bucek Java EE 8 Java EE & Java SE 5

6 JAX-RS Java API for RESTful Web Services Reference ImplementaMon Jersey h`ps://jersey.github.io But also RESTEasy Restlet Apache CXF Apache Wink IBM JAX-RS, 6

7 JAX-RS Client API Client client = ClientBuilder.newClient(); WebTarget target = client.target(" "Paris"); Forecast forecast = target.request().get(forecast.class); // client.close(); 7

8 JAX-RS Client API javax.ws.rs.client.client interface Fluent API Client Builder è Client è Web Target è Request building è Response List<Forecast> forecast = ClientBuilder.newClient().target(" GenericType<List<Forecast>>() {}); 8

9 JAX-RS Client API JAX-RS 2.0 Invokers Synchronous invoker String city = client.target(" "Paris").request().get(String.class); Asynchronous invoker Future<String> fcity = client.target(" "Paris").request().async().get(String.class); 9

10 Async. 10

11 JAX-RS Client API Asynchronous invocajon Future<String> fcity = client.target(" "Paris").request().async().get(String.class); String city = fcity.get(); 11

12 JAX-RS Client API Asynchronous invocajon Future<String> fcity = client.target(" "Paris").request().async().get(String.class); try { String city = fcity.get(5, TimeUnit.SECONDS); } catch(timeoutexception timeout) { } // 12

13 JAX-RS Client API Asynchronous invocajon // Set ClientProperties.CONNECT_TIMEOUT & READ_TIMEOUT Future<String> fcity = client.target(" "Paris").request().async().get(String.class); while (!fcity.isdone() ) { } // response hasn't been received yet String city = fcity.get(); 13

14 JAX-RS Client API Asynchronous invocajon InvocaMonCallback Interface javax.ws.rs.client.invocationcallback<response> Container will receive async processing events from an invocamon completed(response response) failed(throwable throwable) 14

15 JAX-RS Client API InvocaJonCallback WebTarget myresource = client.target(" Future<Customer> future = myresource.request(mediatype.text_plain).async().get(new InvocationCallback<Customer>() { public void completed (Customer customer) { // do something with the customer public void failed (Throwable throwable) { // Oops! } 15

16 The Travel Service 16

17 The Travel Service Synchronous Customer details: 150 ms Recommended desmnamons: 250 ms Price calculamon for a customer and desmnamon: 170 ms (each) Weather forecast for a desmnamon: 330 ms (each) ms 17

18 The Travel Service Asynchronous 730 ms 18

19 The Travel Service 19

20 The Travel Service destination.path("destination").request().header("rx-user", "Async").async().get(new InvocationCallback<List<Destination>>() public void completed(final List<Destination> destination) { final CountDownLatch innerlatch = new CountDownLatch(destination.size()); final Map<String, Forecast> forecasts = Collections.synchronizedMap(new HashMap<>()); for (final Destination dest : destination) { forecast.resolvetemplate("dest", dest.getdestination()).request().async().get(new InvocationCallback<Forecast>() public void completed(final Forecast forecast) { forecasts.put(dest.getdestination(), forecast); innerlatch.countdown(); } 20

21 The Travel Service // cont. public void failed(final Throwable throwable) { innerlatch.countdown(); } }); try { if (!innerlatch.await(10, TimeUnit.SECONDS)) { // timeout } } catch (final InterruptedException e) { // Ooops, interrupted! } } // Continue with processing public void failed(final Throwable throwable) { // Recommendation error } }); 21

22 JAX-RS Client API New JAX-RS ReacJve Invoker // JAX-RS 2.0 Response response = ClientBuilder.newClient().target(someEndPoint).request().get(); Future<Response> fresponse = ClientBuilder.newClient().target(someEndPoint).request().async().get(); // JAX-RS 2.1 CompletionStage<Response> csresponse = ClientBuilder.newClient().target(someEndPoint).request().rx().get(); 22

23 JAX-RS Client API New JAX-RS ReacJve Invoker // get IP CompletionStage<JsonObject> cfip = client.target(" "json").request().rx().get(jsonobject.class); // get IP location CompletionStage<JsonObject> cfloc = client.target(" 23

24 JAX-RS Client API New JAX-RS ReacJve Invoker CompletionStage<JsonObject> cfip = client.target(" "json").request().rx().get(jsonobject.class); Function<JsonObject, CompletionStage<JsonObject>> function = ip -> client.target(" Consumer<JsonObject> consumer = location -> async.resume(locdetails); cfip.thencompose(function).thenaccept(consumer); h`ps://github.com/delabassee/ee8_jax-rs_rx 24

25 The Travel Service h`ps://github.com/jersey/jersey/tree/master/examples/rx-client-webapp 25

26 JAX-RS 2.1 Invokers Sync Async RX Performance and scalability Easy to develop and maintain complex workflow error handling Leverage new Java SE feature 26

27 JAX-RS ReacMve Extensions All JAX-RS implementamons MUST support an invoker for CompleMonStage. AddiMonally, JAX-RS implementamons MAY support other reacmve APIs using an extension built into the Client API. Jersey CompleMonStageRxInvoker (Default) RxListenableFutureInvoker Guava RxObservableInvoker RxJava RxFlowableInvoker RxJava2 27

28 Long Running OperaMon JAX-RS public void populatedestination(@suspended final AsyncResponse asyncresponse) { } executor.submit( new Runnable() { public void run() { JsonObject destination = executelongrunningoptogetdest(); asyncresponse.resume(destination); } }); 28

29 Long Running OperaMon JAX-RS public void populatedestination(@suspended final AsyncResponse asyncresponse) { } CompletionStage<JsonObject> destinationcs = client.target("destination").queryparam("format", "json").request().rx().get(jsonobject.class); destinationcs.thenapply(unmarhsalldestination).thenapply(populatedestination).thenaccept(asyncresponse::resume); 29

30 Long Running OperaMon JAX-RS public CompletionStage<Destination> populatedestination() { } CompletionStage<JsonObject> destinationcs = client.target("destination").queryparam("format", "json").request().rx().get(jsonobject.class); return destinationcs.thenapply(unmarhsalldestination).thenapply(populatedestination); 30

31 Long Running OperaMon Client Request Long running operamon Response AsyncResponse.resume( ) 31

32 Executor Services Used for Asynchronous invocamons Specified when creamng the Client container ClientBuilder.executorService(ExecutorService) ClientBuilder.scheduledExecutorService(ScheduledExecutorService) Use ManagedExecutorService and ManagedScheduledExecutorService when "Concurrency UMliMes for Java EE" is supported E.g. Java EE full plaoorm 32

33 Server-Sent Events 33

34 Server-Sent Events WHATWG standard Persistent, one-way communicamon channel Text protocol, special media type "text/event-stream" Server can send mulmple messages (events) to a client Can contain id, name, comment, retry interval 34

35 Server-Sent Events Supported in all modern browsers JavaScript API h`ps://developer.microsot.com/en-us/microsot-edge/plaoorm/status/serversenteventseventsource/ 35

36 Server-Sent Events javax.ws.rs.sse.sseevent interface Events propermes ID Name Comment Reconnect interval 36

37 Server-Sent Events OutboundSseEvent Server-side representamon of a Server-Sent event OutboundSseEvent.Builder() InboundSseEvent Client-side representamon of a Server-Sent event 37

38 Server-Sent Events Server-side SseEventSink Outbound Server-Sent Events public void SseEventSink SSE sse) {... eventsink.send( sse.newevent("an event") ); eventsink.send( sse.newevent("another event") );... eventsink.close(); } 38

39 Server-Sent Event Client side SseEventSource Client for processing incoming Server-Sent Events WebTarget target = client.target(" "); try (SseEventSource source = SseEventSource.target(target).reconnectingEvery(5, SECONDS).build()) { source.register(system.out::println); //InboundSSEvent consumer... source.open(); } catch (InterruptedException e) { // Ooops } 39

40 Various 40

41 JAX-RS 2.1 JSON support When JSON-P is supported MUST support enmty providers for JsonValue and its sub-types JsonValue, JsonStructure, JsonObject, JsonArray, JsonString and JsonNumber When JSON-B is supported MUST support enmty providers for all Java types supported by JSON-B in combinamon with following media types applicamon/json, text/json &Media types matching */json or */*+json When both JSON-P and JSON-B are supported EnMty providers for JSON-B take precedence for all types except JsonValue and its sub-types 41

42 JAX-RS 2.1 JSON-B & JSON-P for all providers Allow sub-resource locators to return classes as well ClarificaMons, 42

43 Wrap-up 43

44 JAX-RS 2.1 Java API for RESTful Web Services JSR 370 Java EE 8 Async New ReacMve Client API New method for pausing resquest processing Server-Sent Event support JSON-P & JSON-B support 44

45 JAX-RS 2.1 Java API for RESTful Web Services Jersey 2.26 h`ps://jersey.github.io Apache CXF h`p://cxf.apache.org/ RESTEasy 3.? soon! h`p://resteasy.jboss.org 45

46 Java EE 8 ModernizaMon & SimplificaMon JAX-RS 2.1 Servlet 4.0 JSON-B 1.0 (*) JSON-P 1.1 CDI 2.0 Bean ValidaJon 2.0 JSF 2.3 Security 1.0 (*) ReacMve Client API, Server-Sent Events, HTTP/2, Server Push, Java <-> JSON binding Updates to JSON standards, JSON Collectors, Async Event, Observers ordering, SE support, Embrace Java SE 8, new constraints, Improved CDI, WebSocket, SE 8 integramon, Portable IdenMty Store, AuthenMcaMon & Security Context 46

47 Eclipse Enterprise for Java - EE4J Moving Java EE to Eclipse FoundaJon Community and Vendors Technology Sponsorship Enterprise for Java ü Nimble ü Flexible ü Open ü CompaMble Join the discussion at ee4j-community@eclipse.org 47

48 JAX-RS 2.1 Java API for RESTful Web Services Resources h`ps://jcp.org/en/jsr/detail?id=370 h`ps://javaee.groups.io/g/jaxrs-spec/ h`ps://github.com/jax-rs h`ps://jersey.github.io/documentamon/latest/index.html h`ps://github.com/jersey/ h`ps://docs.oracle.com/javaee/8/tutorial/index.html 48

49 JAX-RS 2.1 Dependencies API <groupid>javax.ws.rs</groupid> <artifactid>javax.ws.rs-api</artifactid> <version>2.1</version> <groupid>javax</groupid> <groupid>javax</groupid> <artifactid>javaee-api</artifactid> <artifactid>javaee-web-api</artifactid> <version>8.0</version> <version>8.0</version> Jersey h`ps://jersey.github.io/documentamon/latest/modules-and-dependencies.html 49

50