Author: buildbot
Date: Tue Nov 26 11:48:20 2013
New Revision: 888137
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-rs-client-api.html
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-client-api.html
==============================================================================
--- websites/production/cxf/content/docs/jax-rs-client-api.html (original)
+++ websites/production/cxf/content/docs/jax-rs-client-api.html Tue Nov 26
11:48:20 2013
@@ -135,20 +135,22 @@ Apache CXF -- JAX-RS Client API
<div>
<ul><li><a shape="rect" href="#JAX-RSClientAPI-MavenDependency">Maven
Dependency</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-JAXRS2.0ClientAPI">JAX-RS 2.0 Client
API</a></li><ul><li><a shape="rect"
href="#JAX-RSClientAPI-JAXRS2.0andCXFspecificAPI">JAX-RS 2.0 and CXF specific
API</a></li></ul><li><a shape="rect"
href="#JAX-RSClientAPI-ProxybasedAPI">Proxy-based API</a></li><ul><li><a
shape="rect" href="#JAX-RSClientAPI-Customizingproxies">Customizing
proxies</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-ConvertingproxiestoWebClientsandviceversa">Converting
proxies to Web Clients and vice versa</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-Handlingexceptions">Handling exceptions</a></li><li><a
shape="rect" href="#JAX-RSClientAPI-ConfiguringproxiesinSpring">Configuring
proxies in Spring</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-Injectingproxies">Injecting proxies</a></li><li><a
shape="rect" href="#JAX-RSClientAPI-Limitations">Limitations</a></li><li><a
shape="
rect" href="#JAX-RSClientAPI-Workingwithusermodels">Working with user
models</a></li></ul><li><a shape="rect"
href="#JAX-RSClientAPI-CXFWebClientAPI">CXF WebClient API</a></li><ul><li><a
shape="rect" href="#JAX-RSClientAPI-Asynchronousinvocations">Asynchronous
invocations</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-Workingwithexplicitcollections">Working with explicit
collections</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-Handlingexceptions">Handling exceptions</a></li><li><a
shape="rect" href="#JAX-RSClientAPI-ConfiguringHTTPclientsinSpring">Configuring
HTTP clients in Spring</a></li></ul><li><a shape="rect"
href="#JAX-RSClientAPI-XMLcentricclients">XML-centric clients</a></li><li><a
shape="rect"
href="#JAX-RSClientAPI-SupportforarbitraryHTTPmethodsforsyncinvocations.">Support
for arbitrary HTTP methods for sync invocations.</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-ThreadSafety">Thread Safety</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-ConfiguringCli
entsatRuntime">Configuring Clients at Runtime</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-CreatingclientsprogrammaticallywithnoSpringdependencies">Creating
clients programmatically with no Spring dependencies</a></li><li><a
shape="rect"
href="#JAX-RSClientAPI-ConfiguringanHTTPConduitfromSpring">Configuring an HTTP
Conduit from Spring</a></li><li><a shape="rect"
href="#JAX-RSClientAPI-ClientsandAuthentication">Clients and
Authentication</a></li></ul></div>
<h1><a shape="rect" name="JAX-RSClientAPI-MavenDependency"></a>Maven
Dependency</h1>
-
-<p><dependency><br clear="none">
- <groupId>org.apache.cxf</groupId><br clear="none">
- <artifactId>cxf-rt-rs-client</artifactId><br clear="none">
- <version>3.0.0-milestone1</version><br clear="none">
-</dependency></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<dependency>
+ <groupId>org.apache.cxf</groupId>
+ <artifactId>cxf-rt-rs-client</artifactId>
+ <version>3.0.0-milestone1</version>
+</dependency>
+]]></script>
+</div></div>
-In CXF 2.7.x no JAX-RS 2.0 Client API is supported and CXF specific Client API
is located in the cxf-rt-frontend-jaxrs module.
+<p>In CXF 2.7.x no JAX-RS 2.0 Client API is supported and CXF specific Client
API is located in the cxf-rt-frontend-jaxrs module. </p>
-CXF Apache HttpClient based transport is required to get the asynchronous
invocations working correctly:
+<p>CXF Apache HttpClient based transport is required to get the asynchronous
invocations working correctly:</p>
-{code:xml}
+<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-transports-http-hc</artifactId>
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 Nov 26 11:48:20 2013
@@ -246,11 +246,16 @@ Form form = new Form().set("a", "b");
]]></script>
</div></div>
+<p>3. CXF WebClient and proxy code has been moved to a new cxf-rt-rs-client
module. <br clear="none">
+Also, jaxrs:client elements for injecting proxies have had the namespace
changed from from "http://cxf.apache.org/jaxrs"; to
"http://cxf.apache.org/jaxrs-client";.</p>
+<p>Please see <a shape="rect" href="jax-rs-client-api.html" title="JAX-RS
Client API">JAX-RS Client API</a> page for more information.</p>
-<p>3. CXF ParameterHandler has been dropped. Please use <a shape="rect"
class="external-link"
href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/ext/ParamConverterProvider.html";
rel="nofollow">ParameterConverterProvider</a> instead, it can be used both on
the server and client sides.</p>
+<p>4. WADL Auto Generator code has been moved to a new
cxf-rt-rs-service-description module.</p>
-<p>4. JAX-RS 2.0 introduces a controversial requirement that the default
built-in JAX-RS MessageBodyWriter and JAX-RS MessageBodyReader providers are
<b>preferred</b> to custom providers supporting the same types unless the
custom providers are precisely typed, for example, if you have a custom
InputStream reader properly implementing isReadable:</p>
+<p>5. CXF ParameterHandler has been dropped. Please use <a shape="rect"
class="external-link"
href="https://jax-rs-spec.java.net/nonav/2.0/apidocs/javax/ws/rs/ext/ParamConverterProvider.html";
rel="nofollow">ParameterConverterProvider</a> instead, it can be used both on
the server and client sides.</p>
+
+<p>6. JAX-RS 2.0 introduces a controversial requirement that the default
built-in JAX-RS MessageBodyWriter and JAX-RS MessageBodyReader providers are
<b>preferred</b> to custom providers supporting the same types unless the
custom providers are precisely typed, for example, if you have a custom
InputStream reader properly implementing isReadable:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
@@ -287,7 +292,7 @@ public void upload(@Multipart InputStrea
]]></script>
</div></div>
-<p>5. If the custom code throws JAX-RS WebApplicationException with Response
containing a non-null entity then custom WebApplicationException mappers will
be bypassed - another problematic requirement, for example, the custom mappers
doing the logging will miss on such exceptions.<br clear="none">
+<p>7. If the custom code throws JAX-RS WebApplicationException with Response
containing a non-null entity then custom WebApplicationException mappers will
be bypassed - another problematic requirement, for example, the custom mappers
doing the logging will miss on such exceptions.<br clear="none">
Set CXF "support.wae.spec.optimization" property to false to disable it. </p>
<h3><a shape="rect" name="JAX-RS-FromCXF2.6.xtoCXF2.7.x"></a>From CXF 2.6.x to
CXF 2.7.x</h3>
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 Tue
Nov 26 11:48:20 2013
@@ -476,6 +476,19 @@ First option is to pass the collected op
<h1><a shape="rect"
name="JAXRSServicesDescription-WADLAutoGeneration"></a>WADL Auto Generation</h1>
+<p>Note that in CXF 3.0.0 WADL Generator code has been moved to</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-rs-service-description</artifactId>
+ <version>3.0.0-milestone1</version>
+</dependency>
+]]></script>
+</div></div>
+
+
<p>CXF JAX-RS supports the auto-generation of WADL for JAX-RS endpoints. <br
clear="none">
Note that JAX-RS subresources are late-resolved by default, so using annotated
interfaces for subresources and a staticSubresourceResolution=true property
will let the whole resource tree/graph be described in a generated instance.
Schemas will be generated for JAXB-annotated types. See below for the
information on how to get auto-generated WADL instances reference existing
schemas.</p>
