svn commit: r938791 - in /websites/production/cxf/content: cache/docs.pageCache docs/jax-rs-client-api.html

[bu...@apache.org]

Author: buildbot
Date: Tue Feb  3 12:47:23 2015
New Revision: 938791

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

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 Feb  3 12:47:23 2015
@@ -118,15 +118,15 @@ Apache CXF -- JAX-RS Client API
            <!-- Content -->
            <div class="wiki-content">
 <div id="ConfluenceContent"><p>&#160;</p><p>&#160;</p><p>&#160;</p><p>&#160;</p><p>&#160;<span class="inline-first-p" style="font-size:2em;font-weight:bold">JAX-RS : Client API</span>&#160;</p><p>&#160;</p><p>&#160;</p><p>&#160;</p><p>&#160;</p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1419015832037 {padding: 0px;}
-div.rbtoc1419015832037 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1419015832037 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1422967614866 {padding: 0px;}
+div.rbtoc1422967614866 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1422967614866 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style></p><div class="toc-macro rbtoc1419015832037">
+/*]]>*/</style></p><div class="toc-macro rbtoc1422967614866">
 <ul class="toc-indentation"><li><a shape="rect" href="#JAX-RSClientAPI-MavenDependency">Maven Dependency</a></li><li><a shape="rect" href="#JAX-RSClientAPI-JAX-RS2.0ClientAPI">JAX-RS 2.0 Client API</a>
 <ul class="toc-indentation"><li><a shape="rect" href="#JAX-RSClientAPI-JAX-RS2.0andCXFspecificAPI">JAX-RS 2.0 and CXF specific API</a></li></ul>
 </li><li><a shape="rect" href="#JAX-RSClientAPI-Proxy-basedAPI">Proxy-based API</a>
-<ul class="toc-indentation"><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>
+<ul class="toc-indentation"><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-BufferingResponses">Buffering Responses</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><li><a shape="rect" href="#JAX-RSClientAPI-CXFWebClientAPI">CXF WebClient API</a>
 <ul class="toc-indentation"><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.1">Handling exceptions</a></li><li><a shape="rect" href="#JAX-RSClientAPI-ConfiguringHTTPclientsinSpring">Configuring HTTP clients in Spring</a></li></ul>
 </li><li><a shape="rect" href="#JAX-RSClientAPI-XML-centricclients">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-ConfiguringClientsatRuntime">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>
@@ -232,7 +232,7 @@ BookStore proxy = JAXRSClientFactory.cre
          &lt;/jaxrs:headers&gt;
   &lt;/jaxrs:client&gt;  
 ]]></script>
-</div></div><p>See this <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/cxf/trunk/systests/jaxrs/src/test/resources/jaxrs_soap_rest/WEB-INF/beans.xml">bean</a> for a full example of how jaxrs:client can be used to inject a proxy</p><h2 id="JAX-RSClientAPI-Limitations">Limitations</h2><p>Proxy sub-resource methods returning Objects can not be invoked. Prefer to have sub-resource methods returning typed classes: interfaces, abstract classes or concrete implementations.</p><p><strong>The following applies to CXF 2.6.x-2.4.x only</strong>:</p><p>When a proxy method returning a JAX-RS Response is invoked, the returned Response.getEntity() will return a response InputStream by default. Starting with CXF 2.3.2 one can register an org.apache.cxf.jaxrs.client.ResponseReader provider and cast the Response.getEntity() to more specific application classes:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p>See this <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/cxf/trunk/systests/jaxrs/src/test/resources/jaxrs_soap_rest/WEB-INF/beans.xml">bean</a> for a full example of how jaxrs:client can be used to inject a proxy</p><h2 id="JAX-RSClientAPI-BufferingResponses">Buffering Responses</h2><p>One way to buffer proxy responses is to have a proxy method return JAX-RS Response, use its bufferEntity()&#160; method (available in JAX-RS 2.0) and use Response.readEntity which can return typed responses if preferred.</p><p>The other option is to have a "buffer.proxy.response" property enabled on a given proxy instance.</p><h2 id="JAX-RSClientAPI-Limitations">Limitations</h2><p>Proxy sub-resource methods returning Objects can not be invoked. Prefer to have sub-resource methods returning typed classes: interfaces, abstract classes or concrete implementations.</p><p><strong>The following applies to CXF 2.6.x-2.4.x only</strong>:</p><p>When a proxy method re
 turning a JAX-RS Response is invoked, the returned Response.getEntity() will return a response InputStream by default. Starting with CXF 2.3.2 one can register an org.apache.cxf.jaxrs.client.ResponseReader provider and cast the Response.getEntity() to more specific application classes:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
 <script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[ResponseReader reader = new ResponseReader();
 reader.setEntityClass(Book.class);