Author: buildbot
Date: Thu Nov 21 12:48:26 2013
New Revision: 887530
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 Thu Nov 21 12:48:26 2013
@@ -134,7 +134,7 @@ 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.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-AdvancedFeatures">Advanced Fea
tures</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-Thirdpartyprojects">Third-party projects</a></li><li><a
shape="rect" href="#JAX-RS-References">References</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-MigrationfromCXF2.7.xtoCXF3.0.0">Migration from CXF 2.7.x to CXF
3.0.0</a></li><li><a shape="rect"
href="#JAX-RS-MigrationfromCXF2.6.xtoCXF2.7.x">Migration from CXF 2.6.x to CXF
2.7.x</a></li></ul><li><a shape="rect" href="#JAX-RS-Mavendependencies">Maven
dependencies</a></li><ul><li><a shape="rect" href="#JAX-RS-CXF3.0.0">CXF
3.0.0</a></li><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></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-AdvancedFeatures">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 Feature
s</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-Thirdpartyprojects">Third-party projects</a></li><li><a
shape="rect" href="#JAX-RS-References">References</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>
@@ -142,15 +142,12 @@ Apache CXF -- JAX-RS
<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 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 3.0.0 completely implements JAX-RS 2.0 including new Client API.
Existing JAX-RS 1.1 applications can be run with CXF 3.0.0.<br clear="none">
+CXF 3.0.0 has been fully tested against the first JAX-RS 2.0 TCK which became
available to Apache.</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>
+<p>CXF 2.7.0 supports most of the new features introduced in 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).</p>
-<p>CXF 2.2.x supports <a shape="rect" class="external-link"
href="https://jsr311.dev.java.net/nonav/releases/1.0/index.html";
rel="nofollow">JSR-311 API 1.0 </a> and is JAX-RS TCK 1.0. compliant.<br
clear="none">
-The JAX-RS 1.0 specification may be found <a shape="rect"
class="external-link"
href="http://jsr311.java.net/nonav/releases/1.0/spec/index.html";
rel="nofollow">here</a></p>
-
-<p>CXF 2.1.x supports <a shape="rect" class="external-link"
href="https://jsr311.dev.java.net/nonav/releases/0.8/index.html";
rel="nofollow">JSR-311 API 0.8</a>. </p>
+<p>CXF 2.6.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.</p>
<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>
@@ -164,19 +161,18 @@ 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>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>Please also check the <a shape="rect"
href="http://cxf.apache.org/docs/27-migration-guide.html";>CXF 2.7 Migration
Guide</a> for the information about all the changes affecting the JAX-RS
users</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 about JAX-RS 2.0.</p>
-<h3><a shape="rect" name="JAX-RS-MigratingfromJAXRS1.0to1.1"></a>Migrating
from JAX-RS 1.0 to 1.1</h3>
+<h3><a shape="rect"
name="JAX-RS-MigrationfromCXF2.7.xtoCXF3.0.0"></a>Migration from CXF 2.7.x to
CXF 3.0.0</h3>
-<p>Existing JAX-RS 1.0 applications should run in CXF starting from 2.3.x
without any problems.<br clear="none">
-There have been just a few minor modifications at the JAX-RS API level:</p>
-<ul class="alternate" type="square"><li>The <a shape="rect"
class="external-link"
href="http://jsr311.java.net/nonav/releases/1.1/javax/ws/rs/ApplicationPath.html";
rel="nofollow"><tt>@ApplicationPath</tt> annotation </a> has been added for
JAX-RS Application subclasses</li><li>The <tt>Request</tt> interface has been
updated with a new no-argument <tt>evaluatePreconditions</tt> method - existing
applications which are already using the <tt>Request</tt> interface may need to
be recompiled</li></ul>
+<h3><a shape="rect"
name="JAX-RS-MigrationfromCXF2.6.xtoCXF2.7.x"></a>Migration from CXF 2.6.x to
CXF 2.7.x</h3>
+<p>Please check the <a shape="rect"
href="http://cxf.apache.org/docs/27-migration-guide.html";>CXF 2.7 Migration
Guide</a> for the information about all the changes affecting the JAX-RS
users</p>
<h2><a shape="rect" name="JAX-RS-Mavendependencies"></a>Maven dependencies</h2>
+<h3><a shape="rect" name="JAX-RS-CXF3.0.0"></a>CXF 3.0.0</h3>
+
<p>The cxf-rt-frontend-jaxrs dependency is required:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
@@ -184,18 +180,16 @@ There have been just a few minor modific
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxrs</artifactId>
- <version>${cxf.version}</version>
+ <version>3.0.0-milestone1</version>
</dependency>
]]></script>
</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>Here is a list of the additional dependencies:</p>
+<p>This will in turn pull other <a shape="rect"
href="http://cxf.apache.org/project-status.html";>CXF modules</a> such
<tt>cxf-core</tt> and <tt>cxf-rt-transports-http</tt>, check <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/pom.xml";>the
pom</a> for more information.</p>
<h3><a shape="rect" name="JAX-RS-CXF2.7.0"></a>CXF 2.7.0</h3>
-<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><tt>javax.ws.rs/javax.ws.rs-api/2.0-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>
<h3><a shape="rect" name="JAX-RS-CXF2.6.x"></a>CXF 2.6.x</h3>
@@ -227,77 +221,26 @@ There have been just a few minor modific
]]></script>
</div></div>
-<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">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
- <dependency>
- <groupId>org.apache.cxf</groupId>
- <artifactId>cxf-rt-databinding-aegis</artifactId>
- <!-- 2.4.4 or 2.5.0 -->
- <version>${cxf.version}</version>
- </dependency>
- <dependency>
- <groupId>org.apache.xmlbeans</groupId>
- <artifactId>xmlbeans</artifactId>
- <version>2.4.0</version>
- </dependency>
-]]></script>
-</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">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<exclusion>
- <groupId>wsdl4j</groupId>
- <artifactId>wsdl4j</artifactId>
-</exclusion>
-]]></script>
-</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.7.x:</p>
+<p>For CXF 3.0.0:</p>
<p>TODO</p>
-<p>For CXF 2.6.x:</p>
+<p>For CXF 2.7.x:</p>
<p>TODO</p>
-<p>For CXF 2.5.x-2.4.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>
-
-
-<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>
-
-
-<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>
-
-
-
<h2><a shape="rect" name="JAX-RS-CXFJAXRSbundle"></a>CXF JAX-RS bundle</h2>
-<p>A standalone <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/distribution/bundle/jaxrs/pom.xml";>JAX-RS
bundle</a> is now available which may be of interest to users doing the JAX-RS
work only.</p>
+<p>Note CXF JAX-RS bundle has been removed in CXF 3.0.0. Prefer depending on
the JAX-RS frontend directly. In CXF 3.0.0 a complete CXF all-inclusive <a
shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/osgi/bundle/all/pom.xml";>bundle</a>
can still be used if really needed. </p>
+
+<p>Only in CXF 2.7.x or earlier:<br clear="none">
+A standalone <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/branches/2.7.x-fixes/osgi/bundle/all/pom.xml";>JAX-RS
bundle</a> is available which may be of interest to users doing the JAX-RS
work only.</p>
<p>Please note that this bundle has a transitive Maven dependency on the Jetty
server modules. If you are using Maven and working with other servlet
containers such as Tomcat then please add the following exclusion:</p>
@@ -320,7 +263,7 @@ There have been just a few minor modific
<h1><a shape="rect" name="JAX-RS-WhatisNew"></a>What is New</h1>
-<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>
+<ul><li>Complete 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>Bean Validation 1.1 Support</li><li>Swagger
Feature</li></ul>
<h1><a shape="rect" name="JAX-RS-GettingStartedwithJAXRS"></a>Getting Started
with JAX-RS</h1>
