This page last changed on Sep 16, 2009 by michael.

JAX-RS Concepts

JAX-RS (JSR 311) is the latest JCP specification that provides a Java based API for REST Web services over the HTTP protocol. The JAX-RS specification is an annotation based server side API.

Applying JAX-RS to Apache Wink

Apache Wink is a full implementation of the JAX-RS 1.0 specification, providing a rich set of features and expansions that extend and supplement the JAX-RS specification. Apache Wink is designed to be an easy to use, production quality and efficient implementation.

The Apache Wink architecture enables the incorporation of custom functionality via the use of handlers that provide for the manipulation of requests, Apache Wink also provides a powerful client module for the consumption of REST web services and is bundled with a range of built-in Providers that enable the developer to quickly implement applications that make use of industry standard formats such as XML, ATOM, APP, RSS, JSON, CSV, HTML.

Developing REST Applications

For those new to JAX-RS or developing REST applications, follow this in-progress developer guide. If you have comments or questions, send an e-mail to the appropriate Apache Wink mailing lists.

While this developer guide covers common scenarios, it is not intended to detail the JAX-RS specification itself. Please read the (brief yet understandable) specification if it is available to you.

Getting Started - A Simple JAX-RS Application

  • Creating a Resource
  • Creating a sub-class
  • Packaging Apache Wink with a Web Application
  • Installation and Running the Application

Application Configuration

  • subclass
  • Container environment information

Resources, HTTP Methods, and Paths

Request and Response Entities (Message Bodies) and Media Types


HTTP Headers

Content Negotiation

Using Request Context Information


  • Expires
  • Cache-Control
Document generated by Confluence on Nov 11, 2009 06:57