Author: buildbot
Date: Tue Oct 2 14:47:25 2012
New Revision: 833754
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-rs.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jax-rs.html
==============================================================================
--- websites/production/cxf/content/docs/jax-rs.html (original)
+++ websites/production/cxf/content/docs/jax-rs.html Tue Oct 2 14:47:25 2012
@@ -125,15 +125,15 @@ Apache CXF -- JAX-RS
<div>
-<ul><li><a shape="rect"
href="#JAX-RS-Introduction">Introduction</a></li><li><a shape="rect"
href="#JAX-RS-Projectsetupandconfiguration">Project setup and
configuration</a></li><ul><li><a shape="rect"
href="#JAX-RS-Migration">Migration</a></li><ul><li><a shape="rect"
href="#JAX-RS-MigratingfromJAXRS1.1to2.0">Migrating from JAX-RS 1.1 to
2.0</a></li><li><a shape="rect"
href="#JAX-RS-MigratingfromJAXRS1.0to1.1">Migrating from JAX-RS 1.0 to
1.1</a></li></ul><li><a shape="rect" href="#JAX-RS-Mavendependencies">Maven
dependencies</a></li><ul><li><a shape="rect" href="#JAX-RS-CXF2.7.0">CXF
2.7.0</a></li><li><a shape="rect" href="#JAX-RS-CXF2.3.xCXF2.6.x">CXF 2.3.x -
CXF 2.6.x</a></li><li><a shape="rect" href="#JAX-RS-CXF2.6.x">CXF
2.6.x</a></li></ul><li><a shape="rect"
href="#JAX-RS-Settinguptheclasspath">Setting up the classpath</a></li><li><a
shape="rect" href="#JAX-RS-CXFJAXRSbundle">CXF JAX-RS
bundle</a></li></ul><li><a shape="rect" href="#JAX-RS-WhatisNew">What is
New</a></li
><li><a shape="rect" href="#JAX-RS-GettingStartedwithJAXRS">Getting Started
>with JAX-RS</a></li><ul><li><a shape="rect"
>href="#JAX-RS-UnderstandingtheBasics">Understanding the Basics</a></li><li><a
>shape="rect" href="#JAX-RS-SupportforDataBindings">Support for Data
>Bindings</a></li><li><a shape="rect"
>href="#JAX-RS-HowRequestURIisMatched">How Request URI is
>Matched</a></li><li><a shape="rect" href="#JAX-RS-ClientAPI">Client
>API</a></li><li><a shape="rect"
>href="#JAX-RS-Filters%2CInterceptorsandInvokers">Filters, Interceptors and
>Invokers</a></li><li><a shape="rect"
>href="#JAX-RS-ServicelistingsandWADLsupport">Service listings and WADL
>support</a></li><li><a shape="rect"
>href="#JAX-RS-ConfiguringJAXRSservices">Configuring JAX-RS
>services</a></li><li><a shape="rect"
>href="#JAX-RS-Testing">Testing</a></li><li><a shape="rect"
>href="#JAX-RS-Debugging">Debugging</a></li><li><a shape="rect"
>href="#JAX-RS-Logging">Logging</a></li></ul><li><a shape="rect"
>href="#JAX-RS-AdvancedFeatur
es">Advanced Features</a></li><ul><li><a shape="rect"
href="#JAX-RS-Multiparts">Multiparts</a></li><li><a shape="rect"
href="#JAX-RS-SecureJAXRSservices">Secure JAX-RS services</a></li><li><a
shape="rect" href="#JAX-RS-FailoverandLoadDistributionFeatures">Failover and
Load Distribution Features</a></li><li><a shape="rect"
href="#JAX-RS-Redirection">Redirection</a></li><li><a shape="rect"
href="#JAX-RS-XSLTandXPath">XSLT and XPath</a></li><li><a shape="rect"
href="#JAX-RS-ComplexSearchQueries">Complex Search Queries</a></li><li><a
shape="rect" href="#JAX-RS-ModelViewControllersupport">Model-View-Controller
support</a></li><li><a shape="rect"
href="#JAX-RS-CombiningJAXWSandJAXRS">Combining JAX-WS and
JAX-RS</a></li><li><a shape="rect"
href="#JAX-RS-IntegrationwithDistributedOSGi">Integration with Distributed
OSGi</a></li><li><a shape="rect" href="#JAX-RS-OtherAdvancedFeatures">Other
Advanced Features</a></li></ul><li><a shape="rect"
href="#JAX-RS-MavenPlugins">Maven Plugins</a
></li><li><a shape="rect" href="#JAX-RS-Deployment">Deployment</a></li><li><a
>shape="rect" href="#JAX-RS-RESTfulResources">RESTful Resources</a></li><li><a
>shape="rect" href="#JAX-RS-Howtocontribute">How to
>contribute</a></li></ul></div>
+<ul><li><a shape="rect"
href="#JAX-RS-Introduction">Introduction</a></li><li><a shape="rect"
href="#JAX-RS-Projectsetupandconfiguration">Project setup and
configuration</a></li><ul><li><a shape="rect"
href="#JAX-RS-Migration">Migration</a></li><ul><li><a shape="rect"
href="#JAX-RS-MigratingfromJAXRS1.1to2.0">Migrating from JAX-RS 1.1 to
2.0</a></li><li><a shape="rect"
href="#JAX-RS-MigratingfromJAXRS1.0to1.1">Migrating from JAX-RS 1.0 to
1.1</a></li></ul><li><a shape="rect" href="#JAX-RS-Mavendependencies">Maven
dependencies</a></li><ul><li><a shape="rect" href="#JAX-RS-CXF2.7.0">CXF
2.7.0</a></li><li><a shape="rect" href="#JAX-RS-CXF2.6.x">CXF
2.6.x</a></li><li><a shape="rect" href="#JAX-RS-CXF2.5.xCXF2.3.x">CXF 2.5.x -
CXF 2.3.x</a></li></ul><li><a shape="rect"
href="#JAX-RS-Settinguptheclasspath">Setting up the classpath</a></li><li><a
shape="rect" href="#JAX-RS-CXFJAXRSbundle">CXF JAX-RS
bundle</a></li></ul><li><a shape="rect" href="#JAX-RS-WhatisNew">What is
New</a></li
><li><a shape="rect" href="#JAX-RS-GettingStartedwithJAXRS">Getting Started
>with JAX-RS</a></li><ul><li><a shape="rect"
>href="#JAX-RS-UnderstandingtheBasics">Understanding the Basics</a></li><li><a
>shape="rect" href="#JAX-RS-SupportforDataBindings">Support for Data
>Bindings</a></li><li><a shape="rect"
>href="#JAX-RS-HowRequestURIisMatched">How Request URI is
>Matched</a></li><li><a shape="rect" href="#JAX-RS-ClientAPI">Client
>API</a></li><li><a shape="rect"
>href="#JAX-RS-Filters%2CInterceptorsandInvokers">Filters, Interceptors and
>Invokers</a></li><li><a shape="rect"
>href="#JAX-RS-ServicelistingsandWADLsupport">Service listings and WADL
>support</a></li><li><a shape="rect"
>href="#JAX-RS-ConfiguringJAXRSservices">Configuring JAX-RS
>services</a></li><li><a shape="rect"
>href="#JAX-RS-Testing">Testing</a></li><li><a shape="rect"
>href="#JAX-RS-Debugging">Debugging</a></li><li><a shape="rect"
>href="#JAX-RS-Logging">Logging</a></li></ul><li><a shape="rect"
>href="#JAX-RS-AdvancedFeatur
es">Advanced Features</a></li><ul><li><a shape="rect"
href="#JAX-RS-Multiparts">Multiparts</a></li><li><a shape="rect"
href="#JAX-RS-SecureJAXRSservices">Secure JAX-RS services</a></li><li><a
shape="rect" href="#JAX-RS-FailoverandLoadDistributionFeatures">Failover and
Load Distribution Features</a></li><li><a shape="rect"
href="#JAX-RS-Redirection">Redirection</a></li><li><a shape="rect"
href="#JAX-RS-XSLTandXPath">XSLT and XPath</a></li><li><a shape="rect"
href="#JAX-RS-ComplexSearchQueries">Complex Search Queries</a></li><li><a
shape="rect" href="#JAX-RS-ModelViewControllersupport">Model-View-Controller
support</a></li><li><a shape="rect"
href="#JAX-RS-CombiningJAXWSandJAXRS">Combining JAX-WS and
JAX-RS</a></li><li><a shape="rect"
href="#JAX-RS-IntegrationwithDistributedOSGi">Integration with Distributed
OSGi</a></li><li><a shape="rect" href="#JAX-RS-OtherAdvancedFeatures">Other
Advanced Features</a></li></ul><li><a shape="rect"
href="#JAX-RS-MavenPlugins">Maven Plugins</a
></li><li><a shape="rect" href="#JAX-RS-Deployment">Deployment</a></li><li><a
>shape="rect" href="#JAX-RS-RESTfulResources">RESTful Resources</a></li><li><a
>shape="rect" href="#JAX-RS-Howtocontribute">How to
>contribute</a></li></ul></div>
<h1><a shape="rect" name="JAX-RS-Introduction"></a>Introduction</h1>
<p><a shape="rect" class="external-link"
href="http://en.wikipedia.org/wiki/JAX-RS" rel="nofollow">JAX-RS</a>: 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. </p>
-<p>CXF supports the Java API for RESTful Web Services: JAX-RS 1.1 (<a
shape="rect" class="external-link" href="http://jcp.org/en/jsr/detail?id=311"
rel="nofollow">JSR-311</a>) and JAX-RS 2.0 (<a shape="rect"
class="external-link" href="http://jcp.org/en/jsr/detail?id=339"
rel="nofollow">JSR-339</a>). </p>
+<p>CXF supports the Java API for RESTful Web Services: JAX-RS 2.0 (<a
shape="rect" class="external-link" href="http://jcp.org/en/jsr/detail?id=339"
rel="nofollow">JSR-339</a>) and JAX-RS 1.1 (<a shape="rect"
class="external-link" href="http://jcp.org/en/jsr/detail?id=311"
rel="nofollow">JSR-311</a>). </p>
-<p>CXF 2.7.0 supports JAX-RS 2.0 (server side only, client API to be supported
later).</p>
+<p>CXF 2.7.0 supports most of the new features introduced in JAX-RS 2.0
(excluding the 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).</p>
<p>CXF 2.6.x, 2.5.x, 2.4.x and 2.3.x supports <a shape="rect"
class="external-link"
href="https://jsr311.dev.java.net/nonav/releases/1.1/index.html"
rel="nofollow">JSR-311 API 1.1</a> and is JAX-RS TCK 1.1 compliant.<br
clear="none">
The JAX-RS 1.1 specification may be found <a shape="rect"
class="external-link"
href="http://jcp.org/aboutJava/communityprocess/mrel/jsr311/index.html"
rel="nofollow">here</a></p>
@@ -145,7 +145,7 @@ The JAX-RS 1.0 specification may be foun
<p>JAX-RS related demos are located under the <a shape="rect"
class="external-link"
href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/jax_rs/">samples/jax_rs
</a> directory.</p>
-<p>This documentation will refer to JSR-311 API 1.1.</p>
+<p>This documentation will refer to JAX-RS 2.0 (JSR-339) API.</p>
<p>Outstanding JAX-RS JIRA issues can be found <a shape="rect"
class="external-link"
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&jqlQuery=project+%3D+CXF+AND+resolution+%3D+Unresolved+AND+component+%3D+JAX-RS+ORDER+BY+priority+DESC&mode=hide">here</a>.</p>
@@ -155,7 +155,9 @@ The JAX-RS 1.0 specification may be foun
<h3><a shape="rect" name="JAX-RS-MigratingfromJAXRS1.1to2.0"></a>Migrating
from JAX-RS 1.1 to 2.0</h3>
-<p>//TODO</p>
+<p>JAX-RS 2.0 is backward compatible with JAX-RS 1.1. Please see <a
shape="rect" href="jax-rs-basics.html" title="JAX-RS Basics">JAX-RS Basics</a>
for more information.</p>
+
+<p>The following CXF specific classes are not available in CXF 2.7.0:
org.apache.cxf.jaxrs.client.ResponseReader,
org.apache.cxf.jaxrs.client.ServerWebApplicationException,
org.apache.cxf.jaxrs.client.ClientWebApplicationException</p>
<h3><a shape="rect" name="JAX-RS-MigratingfromJAXRS1.0to1.1"></a>Migrating
from JAX-RS 1.0 to 1.1</h3>
@@ -166,122 +168,112 @@ There have been just a few minor modific
<h2><a shape="rect" name="JAX-RS-Mavendependencies"></a>Maven dependencies</h2>
-<h3><a shape="rect" name="JAX-RS-CXF2.7.0"></a>CXF 2.7.0</h3>
-
-<h3><a shape="rect" name="JAX-RS-CXF2.3.xCXF2.6.x"></a>CXF 2.3.x - CXF
2.6.x</h3>
+<p>The cxf-rt-frontend-jaxrs dependency is required:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.cxf<span
class="code-tag"></groupId></span>
<span
class="code-tag"><artifactId></span>cxf-rt-frontend-jaxrs<span
class="code-tag"></artifactId></span>
- <span class="code-tag"><version></span>2.6.0<span
class="code-tag"></version></span>
+ <span class="code-tag"><version></span>${cxf.version}<span
class="code-tag"></version></span>
<span class="code-tag"></dependency></span>
</pre>
</div></div>
-<p>This will in turn pull in other <a shape="rect"
href="http://cxf.apache.org/project-status.html">CXF modules</a> such
<tt>cxf-api</tt>, <tt>cxf-rt-core</tt>, <tt>cxf-rt-transports-http</tt> and
<tt>cxf-rt-bindings-xml</tt> as well as <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/pom.xml">the
following 3rd-party dependencies</a>:</p>
+<p>This will in turn pull in other <a shape="rect"
href="http://cxf.apache.org/project-status.html">CXF modules</a> such
<tt>cxf-api</tt>, <tt>cxf-rt-core</tt>, <tt>cxf-rt-transports-http</tt> and
<tt>cxf-rt-bindings-xml</tt> as well as <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/pom.xml">the
following 3rd-party dependencies</a>.</p>
-<p>1. <tt>javax.ws.rs/jsr311-api/1.1.1</tt> (or 1.0 for CXF 2.2.x)</p>
+<p>Here is a list of the additional dependencies:</p>
-<p>2. org.apache.abdera groupId: abdera-core, abdera-parser and
abdera-extensions-json artifacts, version 1.1. <b>Note that starting from CXF
2.3.0 the Abdera dependencies are optional</b>.</p>
+<h3><a shape="rect" name="JAX-RS-CXF2.7.0"></a>CXF 2.7.0</h3>
-<p>3. <tt>org.springframework/spring-core/3.0.5-RELEASE</tt> (and other core
Spring dependencies)</p>
+<p><tt>javax.ws.rs/javax.ws.rs-api/m10</tt> replaces
<tt>javax.ws.rs/jsr311-api/1.1.1</tt>. This is very close to JSR-339 Public
Release API level. Users can expect very minor differences in the Final Release
of API. </p>
-<p>4. <tt>org.codehaus.jettison/jettison/1.3</tt></p>
+<h3><a shape="rect" name="JAX-RS-CXF2.6.x"></a>CXF 2.6.x</h3>
-<p><b>Note that starting from CXF 2.3.2 and 2.4.0 the
<tt>cxf-rt-databindings-aegis</tt> and
<tt>org.apache.xmlbeans/xmlbeans/2.4.0</tt> dependencies are optional</b>. If
you are not working with the CXF distributions containing these dependencies
but using Maven to pull in either the CXF JAX-RS Bundle or the
<tt>cxf-rt-frontend-jaxrs</tt> frontend then please make sure one of the
following dependencies are also included:</p>
+<p>Please check the <a shape="rect"
href="http://cxf.apache.org/docs/26-migration-guide.html">CXF 2.6 Migration
Guide</a> for the information about all the changes affecting the JAX-RS users.
Typically adding the frontend jaxrs dependency should be enough.</p>
+
+<p>1. <tt>javax.ws.rs/jsr311-api/1.1.1</tt> </p>
+
+<p>Optional providers (including the default JSONProvider) are located in this
module:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.cxf<span
class="code-tag"></groupId></span>
- <span
class="code-tag"><artifactId></span>cxf-rt-databinding-aegis<span
class="code-tag"></artifactId></span>
- <span class="code-tag"><span class="code-comment"><!-- 2.4.4 or 2.5.0
--></span></span>
- <span class="code-tag"><version></span>${cxf.version}<span
class="code-tag"></version></span>
- <span class="code-tag"></dependency></span>
- <span class="code-tag"><dependency></span>
- <span class="code-tag"><groupId></span>org.apache.xmlbeans<span
class="code-tag"></groupId></span>
- <span class="code-tag"><artifactId></span>xmlbeans<span
class="code-tag"></artifactId></span>
- <span class="code-tag"><version></span>2.4.0<span
class="code-tag"></version></span>
+ <span
class="code-tag"><artifactId></span>cxf-rt-rs-extension-providers<span
class="code-tag"></artifactId></span>
+ <span class="code-tag"><version></span>2.6.0<span
class="code-tag"></version></span>
<span class="code-tag"></dependency></span>
</pre>
</div></div>
-<p><b>Starting from CXF 2.4.0</b> the wsdl4j transitive dependency is only
required for running the CXF JAX-RS client code due to one of the HTTP
transport extensions indirectly depending on wsdl4j. When running the server
endpoints only, you can add the wsdl4j exclusion to either cxf-frontend-jaxrs
or cxf-bundle-jaxrs dependency: </p>
-
-<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml">
-<span class="code-tag"><exclusion></span>
- <span class="code-tag"><groupId></span>wsdl4j<span
class="code-tag"></groupId></span>
- <span class="code-tag"><artifactId></span>wsdl4j<span
class="code-tag"></artifactId></span>
-<span class="code-tag"></exclusion></span>
-</pre>
-</div></div>
-
-<p>Please check the <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/pom.xml">pom.xml</a>
for the list of cxf components used by the JAX-RS implementation. Snapshots
are available from <a shape="rect" class="external-link"
href="http://repository.apache.org/snapshots/org/apache/cxf/apache-cxf/">http://repository.apache.org/snapshots/org/apache/cxf/apache-cxf/</a>.</p>
-
-<h3><a shape="rect" name="JAX-RS-CXF2.6.x"></a>CXF 2.6.x</h3>
-
-<p>Please check the <a shape="rect"
href="http://cxf.apache.org/docs/26-migration-guide.html">CXF 2.6 Migration
Guide</a> for the information about all the changes affecting the JAX-RS users.
Typically the frontend dependency should be enough:</p>
+<p>The Search extension is now located in</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.cxf<span
class="code-tag"></groupId></span>
- <span
class="code-tag"><artifactId></span>cxf-rt-frontend-jaxrs<span
class="code-tag"></artifactId></span>
+ <span
class="code-tag"><artifactId></span>cxf-rt-rs-extension-search<span
class="code-tag"></artifactId></span>
<span class="code-tag"><version></span>2.6.0<span
class="code-tag"></version></span>
<span class="code-tag"></dependency></span>
</pre>
</div></div>
-<p>Optional providers (including the default JSONProvider) are located in this
module:</p>
+<h3><a shape="rect" name="JAX-RS-CXF2.5.xCXF2.3.x"></a>CXF 2.5.x - CXF
2.3.x</h3>
+
+<p>1. <tt>javax.ws.rs/jsr311-api/1.1.1</tt> </p>
+
+<p>2. org.apache.abdera groupId: abdera-core, abdera-parser and
abdera-extensions-json artifacts, version 1.1. <b>Note that starting from CXF
2.3.0 the Abdera dependencies are optional</b>.</p>
+
+<p>3. <tt>org.springframework/spring-core/3.0.5-RELEASE</tt> (and other core
Spring dependencies)</p>
+
+<p>4. <tt>org.codehaus.jettison/jettison/1.3.2</tt></p>
+
+<p><b>Note that starting from CXF 2.4.x the <tt>cxf-rt-databindings-aegis</tt>
and <tt>org.apache.xmlbeans/xmlbeans/2.4.0</tt> dependencies are optional</b>.
If you are not working with the CXF distributions containing these dependencies
but using Maven to pull in either the CXF JAX-RS Bundle or the
<tt>cxf-rt-frontend-jaxrs</tt> frontend then please make sure one of the
following dependencies are also included:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.cxf<span
class="code-tag"></groupId></span>
- <span
class="code-tag"><artifactId></span>cxf-rt-rs-extension-providers<span
class="code-tag"></artifactId></span>
- <span class="code-tag"><version></span>2.6.0<span
class="code-tag"></version></span>
+ <span
class="code-tag"><artifactId></span>cxf-rt-databinding-aegis<span
class="code-tag"></artifactId></span>
+ <span class="code-tag"><span class="code-comment"><!-- 2.4.4 or 2.5.0
--></span></span>
+ <span class="code-tag"><version></span>${cxf.version}<span
class="code-tag"></version></span>
+ <span class="code-tag"></dependency></span>
+ <span class="code-tag"><dependency></span>
+ <span class="code-tag"><groupId></span>org.apache.xmlbeans<span
class="code-tag"></groupId></span>
+ <span class="code-tag"><artifactId></span>xmlbeans<span
class="code-tag"></artifactId></span>
+ <span class="code-tag"><version></span>2.4.0<span
class="code-tag"></version></span>
<span class="code-tag"></dependency></span>
</pre>
</div></div>
-<p>The Search extension is now located in</p>
+<p><b>Starting from CXF 2.4.0</b> the wsdl4j transitive dependency is only
required for running the CXF JAX-RS client code due to one of the HTTP
transport extensions indirectly depending on wsdl4j. When running the server
endpoints only, you can add the wsdl4j exclusion to either cxf-frontend-jaxrs
or cxf-bundle-jaxrs dependency: </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
- <span class="code-tag"><dependency></span>
- <span class="code-tag"><groupId></span>org.apache.cxf<span
class="code-tag"></groupId></span>
- <span
class="code-tag"><artifactId></span>cxf-rt-rs-extension-search<span
class="code-tag"></artifactId></span>
- <span class="code-tag"><version></span>2.6.0<span
class="code-tag"></version></span>
- <span class="code-tag"></dependency></span>
+<span class="code-tag"><exclusion></span>
+ <span class="code-tag"><groupId></span>wsdl4j<span
class="code-tag"></groupId></span>
+ <span class="code-tag"><artifactId></span>wsdl4j<span
class="code-tag"></artifactId></span>
+<span class="code-tag"></exclusion></span>
</pre>
</div></div>
-
+<p>Please check the <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/pom.xml">pom.xml</a>
for the list of cxf components used by the JAX-RS implementation. Snapshots
are available from <a shape="rect" class="external-link"
href="http://repository.apache.org/snapshots/org/apache/cxf/apache-cxf/">http://repository.apache.org/snapshots/org/apache/cxf/apache-cxf/</a>.</p>
<h2><a shape="rect" name="JAX-RS-Settinguptheclasspath"></a>Setting up the
classpath</h2>
<p>If Maven is not used then the following JARs will need to be available at
the runtime classpath.</p>
-<p>For CXF 2.4.4:</p>
+<p>For CXF 2.7.x:</p>
-<ul class="alternate"
type="square"><li>cxf-2.4.4.jar</li><li>jsr311-api-1.1.1.jar</li><li>jaxb-impl-2.1.13.jar</li><li>jaxb-api-2.1.jar</li></ul>
+<p>TODO</p>
+<p>For CXF 2.6.x:</p>
-<ul class="alternate"
type="square"><li>geronimo-annotation_1.0_spec-1.1.1.jar</li><li>geronimo-activation_1.1_spec-1.1.jar</li><li>geronimo-servlet_3.0_spec_1.0.jar</li><li>commons-logging-1.1.1.jar</li></ul>
+<p>TODO</p>
+<p>For CXF 2.5.x-2.4.x:</p>
-<ul class="alternate"
type="square"><li>geronimo-stax_api_1.0_spec-1.0.1.jar</li><li>woodstox-core-asl-4.0.8.jar</li><li>stax2-api-3.0.1.jar</li></ul>
-
-
-<ul class="alternate" type="square"><li>wsdl4j-1.6.2.jar (only needed at the
client side)</li><li>xmlschema-core-2.0.jar</li><li>neethi-3.0.0.jar</li></ul>
-
-
-<p>For CXF 2.3.7:</p>
-
-<ul class="alternate"
type="square"><li>cxf-2.3.7.jar</li><li>jsr311-api-1.1.1.jar</li><li>jaxb-impl-2.1.13.jar</li><li>jaxb-api-2.1.jar</li></ul>
+<ul class="alternate"
type="square"><li>cxf-2.4.4.jar</li><li>jsr311-api-1.1.1.jar</li><li>jaxb-impl-2.1.13.jar</li><li>jaxb-api-2.1.jar</li></ul>
<ul class="alternate"
type="square"><li>geronimo-annotation_1.0_spec-1.1.1.jar</li><li>geronimo-activation_1.1_spec-1.1.jar</li><li>geronimo-servlet_3.0_spec_1.0.jar</li><li>commons-logging-1.1.1.jar</li></ul>
@@ -290,14 +282,9 @@ There have been just a few minor modific
<ul class="alternate"
type="square"><li>geronimo-stax_api_1.0_spec-1.0.1.jar</li><li>woodstox-core-asl-4.0.8.jar</li><li>stax2-api-3.0.1.jar</li></ul>
-<ul class="alternate"
type="square"><li>wsdl4j-1.6.2.jar</li><li>XmlSchema-1.4.5.jar</li><li>neethi-2.0.4.jar</li></ul>
-
-
+<ul class="alternate" type="square"><li>wsdl4j-1.6.2.jar (only needed at the
client side)</li><li>xmlschema-core-2.0.jar</li><li>neethi-3.0.0.jar</li></ul>
-<p>If Spring configuration is used then add <tt>spring.jar</tt> from the
Spring distribution or the spring jars available in the CXF distribution. When
creating client proxies from concrete classes the
<tt>cglib-nodep-2.1_3.jar</tt> needs to be added. You do not need to add JAXB
libraries if you do not use JAXB. If you depend on Jetty then you will also
need to add Jetty 7 or Jetty 6 JARs shipped with CXF.</p>
-<p>We are working on reducing the set of required dependencies.<br
clear="none">
-Please see the configuration sections below on how the spring dependency can
be dropped.</p>
<h2><a shape="rect" name="JAX-RS-CXFJAXRSbundle"></a>CXF JAX-RS bundle</h2>
@@ -310,7 +297,6 @@ Please see the configuration sections be
<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.cxf<span
class="code-tag"></groupId></span>
<span class="code-tag"><artifactId></span>cxf-bundle-jaxrs<span
class="code-tag"></artifactId></span>
- <span class="code-tag"><span class="code-comment"><!-- 2.3.7 or 2.4.4
or 2.5.0 --></span></span>
<span class="code-tag"><version></span>${cxf.version}<span
class="code-tag"></version></span>
<span class="code-tag"><exclusions></span>
<span class="code-tag"><exclusion></span>
@@ -325,14 +311,14 @@ Please see the configuration sections be
<h1><a shape="rect" name="JAX-RS-WhatisNew"></a>What is New</h1>
-<ul><li>Initial support for MAC token in OAuth2, please see <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs-oauth2.html">JAX-RS OAuth2</a> for more
information.</li><li>Kerberos Support, please see <a shape="rect"
href="http://cxf.apache.org/docs/jaxrs-kerberos.html">JAXRS Kerberos</a> for
more information.</li></ul>
+<ul><li>Initial support for JAX-RS 2.0, please see <a shape="rect"
href="jax-rs-basics.html" title="JAX-RS Basics">JAX-RS Basics</a> for more
information</li><li>Initial support for MAC token in OAuth2, please see <a
shape="rect" href="http://cxf.apache.org/docs/jax-rs-oauth2.html">JAX-RS
OAuth2</a> for more information.</li><li>Kerberos Support, please see <a
shape="rect" href="http://cxf.apache.org/docs/jaxrs-kerberos.html">JAXRS
Kerberos</a> for more information.</li></ul>
<h1><a shape="rect" name="JAX-RS-GettingStartedwithJAXRS"></a>Getting Started
with JAX-RS</h1>
<h2><a shape="rect" name="JAX-RS-UnderstandingtheBasics"></a>Understanding the
Basics</h2>
-<p>You are encouraged to read <a shape="rect" class="external-link"
href="http://jcp.org/en/jsr/detail?id=311" rel="nofollow">JAX-RS spec </a> <a
shape="rect" class="external-link"
href="http://jsr311.java.net/nonav/releases/1.1/spec/spec.html"
rel="nofollow">(html version) </a> to find out information not covered by this
documentation. The specification introduces many terms such as root resources,
resource methods, sub-resources and sub-resource locators, message body readers
and writers. </p>
+<p>You are encouraged to read <a shape="rect" class="external-link"
href="http://jcp.org/en/jsr/detail?id=339" rel="nofollow">JSR-339</a>
specification to find out information not covered by this documentation. The
specification introduces many terms such as root resources, resource methods,
sub-resources and sub-resource locators, message body readers and writers.
JAX-RS 2.0 additionally introduces filters, interceptors, new client API,
features, new exception classes, server-side support for asynchronous
invocations. </p>
<p>Please see the <a shape="rect" href="jax-rs-basics.html" title="JAX-RS
Basics">JAX-RS Basics</a> page for more information.</p>