diff --git a/docbook/reference/en/en-US/master.xml b/docbook/reference/en/en-US/master.xml index f44f0b1db6c..219cacfc964 100755 --- a/docbook/reference/en/en-US/master.xml +++ b/docbook/reference/en/en-US/master.xml @@ -56,6 +56,7 @@ + ]> @@ -152,6 +153,7 @@ This one is short &Deprecated_security_modules; &Migration_to_3_1; &Migration_from_older_versions; + &JAX-RS_2.1_additions; &Books; diff --git a/docbook/reference/en/en-US/modules/JAX-RS_2.1_additions.xml b/docbook/reference/en/en-US/modules/JAX-RS_2.1_additions.xml new file mode 100644 index 00000000000..edf836742e5 --- /dev/null +++ b/docbook/reference/en/en-US/modules/JAX-RS_2.1_additions.xml @@ -0,0 +1,66 @@ + + JAX-RS 2.1 Additions + JAX-RS 2.1 adds more asynchronous processing support in both the + Client and the Server API. The specification adds a Reactive programming + style to the Client side and Server-Sent Events (SSE) protocol support to + both client and server. + + + + Rective Clients API + The specification defines a new type of invoker named RxInvoker, and a default + implementation of this type named CompletionStageRxInvoker. + CompletionStageRxInvoker implements Java 8's interface CompletionStage. + This interface declares a large number of methods dedicated to managing + asynchronous computations. + + There is also a new rx method which is used in a similar manner to async. + + + + + Server-Sent Events (SSE) + Server-sent events provides a way to establish a one-way channel from a server + to a client. The connection is long running and it is re-used for multiple events + sent from the server. + + + SSE Client API + + The SSE entry point in the client API is the SseEventSource class. + This object is constructed from a WebTarget. + It does not duplicate any functionality in WebTarget. + It only adds the necessary logic for SSE. + + + Clients request an SSE connection by using the special media type + text/event-stream + in the Accept header. + + + + SSE Server API + + The SSE server API is used to accept connections and send events to one or more clients. + A resource method that injects an SseEventSink and produces the media type + text/event-stream + is an SSE resource method. + + + + Broadcasting + + SSE provides a way to broadcast events to multiple clients simultaneously. + Multiple SseEventSink’s can be registered on a single SseBroadcaster object. + + + + + Java API for JSON Binding + + RESTEasy supports both JSON-B and JSON-P. In accordance with the specification, + entity providers for JSON-B take precedence over those for JSON-P for all types + except JsonValue and its sub-types. + + + \ No newline at end of file