Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Span
stylefont-size:2em;font-weight:bold
JAX-RS (JSR-339)
 

 

Table of Contents

Introduction

JAX-RS: Java API for RESTful Web Services is a Java programming language API that provides support in creating web services according to the Representational State Transfer (REST) architectural style.

CXF supports the Java API for RESTful Web Services: JAX-RS 2.1 (JSR-370), 2.0 (JSR-339) and JAX-RS 1.1 (JSR-311).

New:CXF 3.2.0 SNAPSHOT implements some parts of the early supports JAX-RS 2.1 Draft, in particular Reactive Client API (CompletableFuture or RxJava based) and Server Side Events (server only) have already been implemented.CXF 3.0.0 completely implements . All existing JAX-RS 2.0 including new Client API.  See below for information about compliance.Existing JAX-RS and 1.1 applications can be run with CXF 3.02.0.

CXF 23.71.0 supports most of the new features introduced in x and 3.0.x support JAX-RS 2.0 (excluding 2.0 Client API for now - but note that CXF client API has been retrofitted to support new filters, interceptors, exception classes and Response API, plus the asynchronous client invoker API).

CXF 2.6.x supports JSR-311 API 1.1 and is JAX-RS TCK 1.1 compliant.

.  Existing JAX-RS 1.1 applications can be run with CXF 3.1.x/3.0.x.

See below for more information about the compliance.

JAX-RS related demos are located under the samples/jax_rs directory.

This documentation will refer to JAX-RS 2.0 (JSR-339) API.

Outstanding JAX-RS JIRA issues can be found here.

JAX-RS Compliance

Anchor
2_0_FINAL
2_0_FINAL

2.1 Final

CXF 3.2.0 has been updated to implement the JAX-RS 2.1 API’s as completely as possible.

If another TCK licensee that uses CXF’s JAX-RS 2.1 implementation in their products finds issues with CXF’s compliance, we are more than happy to fix bugs that are raised.

2.0 Final

CXF 3.x has 1.x and CXF 3.0.x have been updated to implement the JAX-RS 2.0 API’s as completely as possible without access to the final JAX-RS 2.0 TCK.
We have done extensive testing with JAX-RS 2.0 user applications, samples, and the preliminary TCK to make sure CXF’s implementation is as complete and compatible as we can make it.
CXF makes and will continue making the best possible effort to have JAX-RS 2.0 and new JAX-RS version implementations technically complete and offering an environment for running the portable JAX-RS 2.0 applications.
If the final 2.0 TCK is made available to Apache, we will make sure CXF is updated to pass.
If another TCK licensee that uses CXF’s JAX-RS 2.0 implementation in their products finds issues with CXF’s compliance, we are more than happy to fix bugs that are raised.

...

From JAX-RS 2.0 to JAX-RS 2.1

CXF 3.JAX-RS 2.1 is backward compatible with JAX-RS 2.0-SNAPSHOT depends on the first . Please see JAX-RS Basics for more information about JAX-RS 2.1 API draft.

All the existing JAX-RS 2.0 and 1.1 applications will run on CXF 3.2.0.

...

JAX-RS 2.0 is backward compatible with JAX-RS 1.1. Please see JAX-RS Basics for more information about JAX-RS 2.0.

CXF 23.71.10 x and CXF 3.0.0 x are expected to support the existing JAX-RS 1.1 applications.

From CXF 2.7.x to CXF 3.0.

...

x or 3.1.x

Please check the CXF 3.0.0 Migration Guide for the information about all the changes
in CXF 3.0.0. Here are more details on the changes specifically affecting JAX-RS users:

...