Here in Prague, July and August are the main “vacation” months of the year. With that in mind we decided to plan for a longer Jersey sprint run. So after a time little bit longer than usual I am happy to announce that another Jersey 2.0-m06 milestone has been just released.
As part of the release, several important changes are part of Jersey 2.0-m06 release. Let’s briefly look at them in more detail.
- Switch to HK2 v2.1.x from v2.0.x. While this minor version update does not look significant at the first glance, it’s actually one of the most significant changes in Jersey 2.0 yet. The new HK2 2.1.x API brings a complete redesign and rewrite of the injection runtime and comes with a full support for JSR 330 Dependency Injection that replaces the old proprietary HK2 injection API. As such, Jersey now naturally supports injection using standard DI API from
javax.injectpackage. Not bad for a minor version update, right?
- Improved support for JAX-RS 2.0 filters and interceptors. In this release we added support for post-matching name-bound filters and interceptors. With that change we were able to move on and convert more of the existing Jersey 1.x features to the new JAX-RS 2.0 API (message encoders/decoders, authorization filters, etc.).
- Suport for singleton resources. This is another feature that was available in Jersey 1.x already. This time we are however ditching the proprietary Jersey
@Singletonannotation in favor of a standard
@javax.inject.Singleton(thanks to the new HK2 implementation).
- Added modules for MOXy support. This is another major improvement that gives Jersey users ability to use advanced MOXy data binding constructs in beans that can be marshalled using both XML and JSON media types.
- Other improvements and bug fixes. Among other things we’ve revised and simplified API around Jersey Client instance creation, redesigned modules for JSON support, made improvements to our SSE support API.
If you are interested in more details, the list of all the resolved feature requests, tasks and issues in the Jersey 2.0-m06 sprint can be browsed in our Jersey Jira.
For a complete overview of the updates in the Jersey API, please have a look at the Jersey 2.0-m06 API documentation. Note that we are still in the middle of a development cycle and Jersey 2.0-m06 is an early development preview release so you can still expect significant changes in the API since the parts of the API are moving every now and then. You may want to also bookmark the Jersey 2.0 snapshot API documentation link to if you want to see the latest development version of the API. Also feel free to browse Jersey 2 source code and check out the examples that leverage JAX-RS 2.0 Client API as well as Jersey 2 server-side programmatic API.
In this sprint we also continued work on an updated user guide that also contains an initial draft of a migration guide for your Jersey 1.x code. Again, as with API documentation, you may want to bookmark the Jersey 2.0 snapshot user guide to see the very latest updates to the guide.
The third early draft of JAX-RS 2.0 specification that is implemented by this Jersey milestone release is available at the JCP web site. The latest version of JAX-RS 2.0 API documentation is also available for browsing here. This link and more information about the JAX-RS project can be found on the JAX-RS project web site.
For some time already, Jersey is available on github as a first-class citizen. So if you prefer accessing the code over github to accessing it over java.net, check it out.
Jersey 2.0 provides support for Java SE HTTP Server, Grizzly 2 HTTP server, Servlet 2.5 or higher containers as well as OSGi containers on the server side and
HTTPURLConnection-based or Grizzly asynchronous client transport connectors. To leverage JAX-RS/Jersey server-side async features in the servlet container, you need a container that supports Servlet 3.0 at least. Jersey supports asynchronous resource invocations on Grizzly 2 HTTP server too.
All the 2.0-m06 milestone binaries, including the source & apidocs jars, are available for download under the Jersey 2.0 maven root group identifier
org.glassfish.jersey from the central maven repository as well as from the java.net maven repository.
To run Jersey 2 you’ll need the core artifacts:
org.glassfish.jersey.core:jersey-common org.glassfish.jersey.core:jersey-server org.glassfish.jersey.core:jersey-client
Additionally, you’ll need a Jersey container implementation, e.g. Jersey Grizzly2 HTTP container:
Chances are you are using maven on your project. If you do, there is a very easy and convenient way to start playing with Jersey 2.0 by generating the skeleton application from one of the Jersey 2.0 maven archetypes that we provide. For instance, to create a Jersey 2.0 application using the Grizzly 2 HTTP server container, use
mvn archetype:generate -DarchetypeGroupId=org.glassfish.jersey.archetypes -DarchetypeArtifactId=jersey-quickstart-grizzly2 -DarchetypeVersion=2.0-m06
If you want to create a Servlet container deployable Jersey 2.0 web application instead, use
mvn archetype:generate -DarchetypeGroupId=org.glassfish.jersey.archetypes -DarchetypeArtifactId=jersey-quickstart-webapp -DarchetypeVersion=2.0-m06
Have fun looking around, running examples, testing new additions to the set of features and playing with Jersey 2. To provide feedback send us an email to our users mailing list
or log discovered bugs & new feature requests in Jersey Jira issue tracker.