cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r823593 - in /websites/production/cxf/content: cache/docs.pageCache docs/jax-rs-advanced-features.html
Date Thu, 28 Jun 2012 10:48:00 GMT
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">"&amp;replyToName=dynamicQueues/test.jmstransport.response"</span>
+             + <span class="code-quote">"&amp;jndiURL=tcp:<span class="code-comment">//localhost:"</span>
+ JMS_PORT
+</span>             + <span class="code-quote">"&amp;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>



Mime
View raw message