You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2012/09/05 15:47:27 UTC
svn commit: r831210 - in /websites/production/cxf/content:
cache/docs.pageCache docs/jax-rs.html docs/jaxrs-services-description.html
Author: buildbot
Date: Wed Sep 5 13:47:26 2012
New Revision: 831210
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-rs.html
websites/production/cxf/content/docs/jaxrs-services-description.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 Wed Sep 5 13:47:26 2012
@@ -125,13 +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><li><a shape="rect" href="#JAX-RS-Mavendependencies">Maven dependencies</a></li><ul><li><a shape="rect" href="#JAX-RS-CXF2.3.xCXF2.5.x">CXF 2.3.x - CXF 2.5.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-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 Dis
tribution 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.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>
<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 JAX-RS (<a shape="rect" class="external-link" href="http://jcp.org/en/jsr/detail?id=311" rel="nofollow">JSR-311</a>), the Java API for RESTful Web Services. JAX-RS standardizes the way RESTful services can be developed in Java. </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 2.7.0 supports JAX-RS 2.0 (server side only, client API to be supported later).</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>
@@ -151,7 +153,11 @@ The JAX-RS 1.0 specification may be foun
<h2><a shape="rect" name="JAX-RS-Migration"></a>Migration</h2>
-<p><b>Migrating from JAX-RS 1.0 to 1.1</b></p>
+<h3><a shape="rect" name="JAX-RS-MigratingfromJAXRS1.1to2.0"></a>Migrating from JAX-RS 1.1 to 2.0</h3>
+
+<p>//TODO</p>
+
+<h3><a shape="rect" name="JAX-RS-MigratingfromJAXRS1.0to1.1"></a>Migrating from JAX-RS 1.0 to 1.1</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>
@@ -160,14 +166,16 @@ 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.3.xCXF2.5.x"></a>CXF 2.3.x - CXF 2.5.x</h3>
+<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>
<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.5.0<span class="code-tag"></version></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>
@@ -317,7 +325,7 @@ Please see the configuration sections be
<h1><a shape="rect" name="JAX-RS-WhatisNew"></a>What is New</h1>
-<ul><li>Initial support for 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>Custom Contexts, please see <a shape="rect" href="http://cxf.apache.org/docs/jax-rs-basics.html#JAX-RSBasics-CustomContexts">this section</a> for more information.</li><li>Controlling large XML, JSON and form payloads, please see <a shape="rect" class="external-link" href="https://cwiki.apache.org/confluence/display/CXF20DOC/JAX-RS+Data+Bindings#JAX-RSDataBindings-ControllingLargeJAXBXMLandJSONinputpayloads">this</a> and <a shape="rect" class="external-link" href="https://cwiki.apache.org/confluence/display/CXF20DOC/JAX-RS+Data+Bindings#JAX-RSDataBindings-Formpayloads">this</a> sections for more information.</li></ul>
+<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>
<h1><a shape="rect" name="JAX-RS-GettingStartedwithJAXRS"></a>Getting Started with JAX-RS</h1>
Modified: websites/production/cxf/content/docs/jaxrs-services-description.html
==============================================================================
--- websites/production/cxf/content/docs/jaxrs-services-description.html (original)
+++ websites/production/cxf/content/docs/jaxrs-services-description.html Wed Sep 5 13:47:26 2012
@@ -589,7 +589,7 @@ wg.setSchemaLocations(Collections.single
<h3><a shape="rect" name="JAXRSServicesDescription-Changingthebaseaddress"></a>Changing the base address</h3>
<p>Starting from CXF 2.6.2 it is possible to affect the base address specified in the auto-generated WADL (in wadl:resources/@base attribute).<br clear="none">
-WADLGenerator can be indirectly configured by setting a jaxrs:server/@publishedEndpointUrl attribute, similarly to the way CXF WADL generator can be configured by setting a jaxws;endpoint/@publishedEndpointUrl attribute.</p>
+WADLGenerator can be indirectly configured by setting a jaxrs:server/@publishedEndpointUrl attribute, similarly to the way CXF WSDL generator can be configured by setting a jaxws:endpoint/@publishedEndpointUrl attribute.</p>
<h1><a shape="rect" name="JAXRSServicesDescription-ServicelistingsandWADLqueries"></a>Service listings and WADL queries</h1>