Author: buildbot
Date: Thu Jun 28 10:47:59 2012
New Revision: 823593
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-rs-advanced-features.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jax-rs-advanced-features.html
==============================================================================
--- websites/production/cxf/content/docs/jax-rs-advanced-features.html
(original)
+++ websites/production/cxf/content/docs/jax-rs-advanced-features.html Thu Jun
28 10:47:59 2012
@@ -124,11 +124,16 @@ Apache CXF -- JAX-RS Advanced Features
<div id="ConfluenceContent"><p><span
style="font-size:2em;font-weight:bold">JAX-RS : Advanced Features</span></p>
<div>
-<ul><li><a shape="rect" href="#JAX-RSAdvancedFeatures-JMSSupport">JMS
Support</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-FIQLsearchqueries">FIQL search
queries</a></li><ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Introduction">Introduction</a></li><li><a
shape="rect"
href="#JAX-RSAdvancedFeatures-DependenciesandConfiguration">Dependencies and
Configuration</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-ConsumingFIQLqueries">Consuming FIQL
queries</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-ConvertingFIQLqueries">Converting FIQL
queries</a></li><ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-SQL">SQL</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-JPA2.0">JPA 2.0</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Customvisitors">Custom visitors</a></li><li><a
shape="rect"
href="#JAX-RSAdvancedFeatures-SearchBean">SearchBean</a></li></ul><li><a
shape="rect" href="#JAX-RSAdvancedFeatures-BuildingFIQLqueries
">Building FIQL queries</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Usingdatesinqueries">Using dates in
queries</a></li></ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Onewayinvocations">Oneway
invocations</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-SupportforContinuations">Support for
Continuations</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Serversidecaching">Server-side
caching</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-RESTfulserviceswithoutannotations">RESTful
services without annotations</a></li><ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Configuration">Configuration</a></li></ul></ul></div>
+<ul><li><a shape="rect" href="#JAX-RSAdvancedFeatures-JMSSupport">JMS
Support</a></li><ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Endpoints">Endpoints</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Client">Client</a></li></ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-FIQLsearchqueries">FIQL search
queries</a></li><ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Introduction">Introduction</a></li><li><a
shape="rect"
href="#JAX-RSAdvancedFeatures-DependenciesandConfiguration">Dependencies and
Configuration</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-ConsumingFIQLqueries">Consuming FIQL
queries</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-ConvertingFIQLqueries">Converting FIQL
queries</a></li><ul><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-SQL">SQL</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-JPA2.0">JPA 2.0</a></li><li><a shape="rect"
href="#JAX-RSAdvancedFeatures-Customvisitors">Custom visitors</a
></li><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-SearchBean">SearchBean</a></li></ul><li><a
>shape="rect" href="#JAX-RSAdvancedFeatures-BuildingFIQLqueries">Building FIQL
>queries</a></li><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-Usingdatesinqueries">Using dates in
>queries</a></li></ul><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-Onewayinvocations">Oneway
>invocations</a></li><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-SupportforContinuations">Support for
>Continuations</a></li><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-Serversidecaching">Server-side
>caching</a></li><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-RESTfulserviceswithoutannotations">RESTful
>services without annotations</a></li><ul><li><a shape="rect"
>href="#JAX-RSAdvancedFeatures-Configuration">Configuration</a></li></ul></ul></div>
<h1><a shape="rect" name="JAX-RSAdvancedFeatures-JMSSupport"></a>JMS
Support</h1>
-<p>CXF has been designed such that multiple transports can be supported for a
given endpoint. If you would like your JAXRS endpoint be capable of serving not
only HTTP but also JMS requests then you need to specify a JMS transportId,
example :</p>
+<p>CXF has been designed such that multiple transports can be supported for a
given endpoint. CXF JAX-RS endpoint and proxies can optionally <br clear="none">
+support the JMS transport. </p>
+
+<h2><a shape="rect" name="JAX-RSAdvancedFeatures-Endpoints"></a>Endpoints</h2>
+
+<p>If you would like your JAXRS endpoint be capable of serving not only HTTP
but also JMS requests then you need to specify a JMS transportId, example:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
@@ -156,6 +161,29 @@ jaxrs:server/@address is set to "/bar" t
<p>By referencing a bean such as 'org.apache.cxf.systest.jaxrs.JMSBookStore'
from multiple jaxrs endpoints you can ensure that both HTTP and JMS requests
are handled by the same service bean. In such cases you may want to use a CXF
JAXRS specific <a shape="rect" class="external-link"
href="http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/src/main/java/org/apache/cxf/jaxrs/ext/ProtocolHeaders.java";>ProtocolHeaders</a>
context which will let you get either HTTP or JMS headers. </p>
+<h2><a shape="rect" name="JAX-RSAdvancedFeatures-Client"></a>Client</h2>
+
+<p>Starting from CXF 2.5.5 and CXF 2.6.2 it is possible to use the client
proxies to invoke on JMS endpoints. All one needs to do is to provide a JMS
endpoint address and then continue working with the proxy as usual. For
example:</p>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-java">
+<span class="code-comment">// setup the the client
+</span><span class="code-object">String</span> endpointAddressUrlEncoded =
<span class="code-quote">"jms:jndi:dynamicQueues/test.jmstransport.text"</span>
+ + <span
class="code-quote">"?jndiInitialContextFactory=org.apache.activemq.jndi.ActiveMQInitialContextFactory"</span>
+ + <span
class="code-quote">"&replyToName=dynamicQueues/test.jmstransport.response"</span>
+ + <span class="code-quote">"&jndiURL=tcp:<span
class="code-comment">//localhost:"</span> + JMS_PORT
+</span> + <span
class="code-quote">"&jndiConnectionFactoryName=ConnectionFactory"</span>;
+
+JMSBookStore client = JAXRSClientFactory.create(endpointAddressUrlEncoded,
JMSBookStore.class);
+Book book = client.getBook(<span class="code-quote">"123"</span>);
+assertEquals(<span class="code-quote">"Get a wrong response code."</span>,
200, WebClient.client(client).getResponse().getStatus());
+assertEquals(<span class="code-quote">"Get a wrong book id."</span>, 123,
book.getId());
+</pre>
+</div></div>
+
+<p>The client runtime will set up the JMS properties described in the previous
section according to JAX-RS and other annotations (such as
org.apache.cxf.jaxrs.ext.Oneway) available in JMSBookStore resource class.</p>
+
+
<h1><a shape="rect" name="JAX-RSAdvancedFeatures-FIQLsearchqueries"></a>FIQL
search queries</h1>
<h2><a shape="rect"
name="JAX-RSAdvancedFeatures-Introduction"></a>Introduction</h2>
