cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r1000825 - in /websites/production/cxf/content: cache/docs.pageCache docs/jax-rs.html
Date Wed, 09 Nov 2016 16:47:34 GMT
Author: buildbot
Date: Wed Nov  9 16:47:34 2016
New Revision: 1000825

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 Wed Nov  9 16:47:34 2016
@@ -118,13 +118,13 @@ Apache CXF -- JAX-RS
            <!-- Content -->
            <div class="wiki-content">
 <div id="ConfluenceContent"><p>&#160;</p><p>&#160;<span
class="inline-first-p" style="font-size:2em;font-weight:bold">JAX-RS (JSR-339)</span>&#160;</p><p>&#160;</p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1442843228833 {padding: 0px;}
-div.rbtoc1442843228833 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1442843228833 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1478710019816 {padding: 0px;}
+div.rbtoc1478710019816 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1478710019816 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style></p><div class="toc-macro rbtoc1442843228833">
+/*]]>*/</style></p><div class="toc-macro rbtoc1478710019816">
 <ul class="toc-indentation"><li><a shape="rect" href="#JAX-RS-Introduction">Introduction</a></li><li><a
shape="rect" href="#JAX-RS-JAX-RSCompliance">JAX-RS Compliance</a>
-<ul class="toc-indentation"><li><a shape="rect" href="#JAX-RS-1.1">1.1</a></li><li><a
shape="rect" href="#JAX-RS-2.0Final">2.0 Final</a></li></ul>
+<ul class="toc-indentation"><li><a shape="rect" href="#JAX-RS-2.1(WorkinProgress)">2.1
(Work in Progress)</a></li><li><a shape="rect" href="#JAX-RS-2.0Final">2.0
Final</a></li><li><a shape="rect" href="#JAX-RS-1.1">1.1</a></li></ul>
 </li><li><a shape="rect" href="#JAX-RS-Projectsetupandconfiguration">Project
setup and configuration</a>
 <ul class="toc-indentation"><li><a shape="rect" href="#JAX-RS-Migration">Migration</a>
 <ul class="toc-indentation"><li><a shape="rect" href="#JAX-RS-FromJAX-RS1.1to2.0">From
JAX-RS 1.1 to 2.0</a></li><li><a shape="rect" href="#JAX-RS-FromCXF2.7.xtoCXF3.0.0">From
CXF 2.7.x to CXF 3.0.0</a></li><li><a shape="rect" href="#JAX-RS-CXF3.1.2ProviderSortingChanges">CXF
3.1.2 Provider Sorting Changes</a></li><li><a shape="rect" href="#JAX-RS-FromCXF2.6.xtoCXF2.7.x">From
CXF 2.6.x to CXF 2.7.x</a></li></ul>
@@ -136,7 +136,7 @@ div.rbtoc1442843228833 li {margin-left:
 </li><li><a shape="rect" href="#JAX-RS-AdvancedFeatures">Advanced Features</a>
 <ul class="toc-indentation"><li><a shape="rect" href="#JAX-RS-Multiparts">Multiparts</a></li><li><a
shape="rect" href="#JAX-RS-SecureJAX-RSservices">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-Model-View-Controllersupport">Model-View-Controller support</a></li><li><a
shape="rect" href="#JAX-RS-CombiningJAX-WSandJAX-RS">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><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-Third-partyprojects">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 id="JAX-RS-Introduction">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 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 3.0.0 completely implements JAX-RS
2.0 including new Client API. &#160;See&#160;<a shape="rect" href="jax-rs.html">below</a>
for information about compliance.</p><p>Existing JAX-RS 1.1 applications can be
run with CXF 3.0.0.</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.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><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&amp;jqlQuery=project+%3D+CXF+AND+resolution+%3D+Unresolved+AND+component+%3D+JAX-RS+ORDER+BY+priority+DESC&amp;mode=hide">here</a>.</p><h1
id="JAX-RS-JAX-RSCompliance">JAX-RS Compliance<
 /h1><h2 id="JAX-RS-1.1">1.1</h2><p>Apache CXF 2.6.x passes the final
JAX-RS 1.1 TCK and is formally 1.1 compliant.</p><p>Please consult the <a shape="rect"
class="external-link" href="http://tomee.apache.org/apache-tomee.html">TomEE</a>
documentation on the support of Java EE related JAX-RS 1.1 options in its Apache CXF-based
JAX-RS runtime.</p><p>CXF 2.7.x and CXF 3.0.0 will fully support and run JAX-RS
1.1 applications but will not pass the JAX-RS 1.1 TCK Signature tests due to</p><p>CXF
2.7.x and CXF 3.0.0 depending on 2.0-m10 and 2.0 final versions of JAX-RS 2.0 API.</p><p>&#160;</p><p><span
class="confluence-anchor-link" id="JAX-RS-2_0_FINAL"></span></p><h2 id="JAX-RS-2.0Final">2.0
Final</h2><p>CXF 3.x has been updated to implement the JAX-RS 2.0 API&#8217;s
as completely as possible without access to the final JAX-RS 2.0 TCK. <br clear="none">We
have done extensive testing with JAX-RS 2.0 user applications, samples, and the preliminary
TCK to make sure CXF&#8217;s implementati
 on is as complete and compatible as we can make it. <br clear="none">CXF makes and
will continue making the best possible effort to have JAX-RS 2.0 and new JAX-RS version implementations
technically complete and offering an environment for running the portable JAX-RS 2.0 applications.<br
clear="none">If the final 2.0 TCK is made available to Apache, we will make sure CXF is
updated to pass.<br clear="none">If another TCK licensee that uses CXF&#8217;s JAX-RS
2.0 implementation in their products finds issues with CXF&#8217;s compliance, we are
more than happy to fix bugs that are raised.</p><h1 id="JAX-RS-Projectsetupandconfiguration">Project
setup and configuration</h1><h2 id="JAX-RS-Migration">Migration</h2><h3
id="JAX-RS-FromJAX-RS1.1to2.0">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">JAX-RS
Basics</a> for more information about JAX-RS 2.0.</p><p>CXF 2.7.10 and CXF
3.0.0 are expected to suppor
 t existing JAX-RS 1.1 applications.</p><h3 id="JAX-RS-FromCXF2.7.xtoCXF3.0.0">From
CXF 2.7.x to CXF 3.0.0</h3><p>Please check the <a shape="rect" href="http://cxf.apache.org/docs/30-migration-guide.html">CXF
3.0.0 Migration Guide</a> for the information about all the changes<br clear="none">
in CXF 3.0.0. Here are more details on the changes specifically affecting JAX-RS users:</p><p>1.
CXF RequestHandler and ResponseHandler filters have been removed.</p><p>These
legacy CXF filters are still supported in 2.7.x but no longer in 3.0.0. Please use <a shape="rect"
class="external-link" href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/container/ContainerRequestFilter.html"
rel="nofollow">ContainerRequestFilter</a> and <a shape="rect" class="external-link"
href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/container/ContainerResponseFilter.html"
rel="nofollow">ContainerResponseFilter</a> instead. Also, <a shape="rect" class="external-link"
href="https://jax-r
 s-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/ext/ReaderInterceptor.html" rel="nofollow">ReaderInterceptor</a>
and <a shape="rect" class="external-link" href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/ext/WriterInterceptor.html"
rel="nofollow">WriterInterceptor</a> can be used too.</p><p>Note, CXF
filters had org.apache.cxf.message.Message available in the signature. If CXF Message is used
in the existing CXF RequestHandler or ResponseHandler then use "org.apache.cxf.phase.PhaseInterceptorChain.getCurrentMessage()"
or "org.apache.cxf.jaxrs.util.JAXRSUtils.getCurrentMessage()" to get a Message which has all
the contextual information available.</p><p>For example, instead of</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent
pdl">
+</div><h1 id="JAX-RS-Introduction">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 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><strong>New</strong>:CXF
3.2.0 SNAPSHOT implements some parts of the early JAX-RS 2.1 Draft, in particular Reactive
Client API (CompletableFuture or RxJava based) and Server Side Events (server only) have already
been implemented.</p><p>CXF 3.0.0 completely implements JAX-RS 2.0 including new
Client API. &#160;See&#160;<a shape=
 "rect" href="jax-rs.html">below</a> for information about compliance.</p><p>Existing
JAX-RS 1.1 applications can be run with CXF 3.0.0.</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.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><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.apa
 che.org/jira/secure/IssueNavigator.jspa?reset=true&amp;jqlQuery=project+%3D+CXF+AND+resolution+%3D+Unresolved+AND+component+%3D+JAX-RS+ORDER+BY+priority+DESC&amp;mode=hide">here</a>.</p><h1
id="JAX-RS-JAX-RSCompliance">JAX-RS Compliance</h1><h2 id="JAX-RS-2.1(WorkinProgress)">2.1
(Work in Progress)</h2><p>CXF 3.2.0-SNAPSHOT depends on the first JAX-RS 2.1 API
draft. All the existing JAX-RS 2.0 applications will run on CXF 3.2.0.</p><p>&#160;</p><p><span
class="confluence-anchor-link" id="JAX-RS-2_0_FINAL"></span></p><h2 id="JAX-RS-2.0Final">2.0
Final</h2><p>CXF 3.x has been updated to implement the JAX-RS 2.0 API&#8217;s
as completely as possible without access to the final JAX-RS 2.0 TCK. <br clear="none">We
have done extensive testing with JAX-RS 2.0 user applications, samples, and the preliminary
TCK to make sure CXF&#8217;s implementation is as complete and compatible as we can make
it. <br clear="none">CXF makes and will continue making the best possible effort to
have JAX-RS 2
 .0 and new JAX-RS version implementations technically complete and offering an environment
for running the portable JAX-RS 2.0 applications.<br clear="none">If the final 2.0 TCK
is made available to Apache, we will make sure CXF is updated to pass.<br clear="none">If
another TCK licensee that uses CXF&#8217;s JAX-RS 2.0 implementation in their products
finds issues with CXF&#8217;s compliance, we are more than happy to fix bugs that are
raised.</p><h2 id="JAX-RS-1.1">1.1</h2><p>Apache CXF 2.6.x passes
the final JAX-RS 1.1 TCK and is formally 1.1 compliant.</p><p>Please consult the
<a shape="rect" class="external-link" href="http://tomee.apache.org/apache-tomee.html">TomEE</a>
documentation on the support of Java EE related JAX-RS 1.1 options in its Apache CXF-based
JAX-RS runtime.</p><p>CXF 2.7.x and CXF 3.0.0 will fully support and run JAX-RS
1.1 applications but will not pass the JAX-RS 1.1 TCK Signature tests due to</p><p>CXF
2.7.x and CXF 3.0.0 depending on 2.0-m10 and 2.0 final
  versions of JAX-RS 2.0 API.</p><p>&#160;</p><p>&#160;</p><h1
id="JAX-RS-Projectsetupandconfiguration">Project setup and configuration</h1><h2
id="JAX-RS-Migration">Migration</h2><h3 id="JAX-RS-FromJAX-RS1.1to2.0">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">JAX-RS Basics</a> for more information
about JAX-RS 2.0.</p><p>CXF 2.7.10 and CXF 3.0.0 are expected to support existing
JAX-RS 1.1 applications.</p><h3 id="JAX-RS-FromCXF2.7.xtoCXF3.0.0">From CXF 2.7.x
to CXF 3.0.0</h3><p>Please check the <a shape="rect" href="http://cxf.apache.org/docs/30-migration-guide.html">CXF
3.0.0 Migration Guide</a> for the information about all the changes<br clear="none">
in CXF 3.0.0. Here are more details on the changes specifically affecting JAX-RS users:</p><p>1.
CXF RequestHandler and ResponseHandler filters have been removed.</p><p>These
legacy CXF filters are still supported in 2.7.x but no longer in 3.0.0.
  Please use <a shape="rect" class="external-link" href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/container/ContainerRequestFilter.html"
rel="nofollow">ContainerRequestFilter</a> and <a shape="rect" class="external-link"
href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/container/ContainerResponseFilter.html"
rel="nofollow">ContainerResponseFilter</a> instead. Also, <a shape="rect" class="external-link"
href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/ext/ReaderInterceptor.html"
rel="nofollow">ReaderInterceptor</a> and <a shape="rect" class="external-link"
href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/ext/WriterInterceptor.html"
rel="nofollow">WriterInterceptor</a> can be used too.</p><p>Note, CXF
filters had org.apache.cxf.message.Message available in the signature. If CXF Message is used
in the existing CXF RequestHandler or ResponseHandler then use "org.apache.cxf.phase.PhaseInterceptorChain.getCurrentMessage()"
o
 r "org.apache.cxf.jaxrs.util.JAXRSUtils.getCurrentMessage()" to get a Message which has all
the contextual information available.</p><p>For example, instead of</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent
pdl">
 <pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">public
class CustomRequestHandler implements RequestHandler {
     public Response handleRequest(Message message, ClassResourceInfo cri) {
     }



Mime
View raw message