svn commit: r854987 - in /websites/production/cxf/content: cache/docs.pageCache docs/ws-addressing.html

[buildbot]

Author: buildbot
Date: Mon Mar 18 18:48:06 2013
New Revision: 854987

Log:
Production update by buildbot for cxf

Modified:
    websites/production/cxf/content/cache/docs.pageCache
    websites/production/cxf/content/docs/ws-addressing.html

Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/cxf/content/docs/ws-addressing.html
==============================================================================
--- websites/production/cxf/content/docs/ws-addressing.html (original)
+++ websites/production/cxf/content/docs/ws-addressing.html Mon Mar 18 18:48:06 
2013
@@ -173,7 +173,47 @@ MyService client = (MyService) factory.c
 
 <h1><a shape="rect" 
name="WS-Addressing-EnablingWSAddressingwithWSPolicy"></a>Enabling 
WS-Addressing with WS-Policy</h1>
 <p>If you're using <a shape="rect" href="ws-policy.html" 
title="WS-Policy">WS-Policy</a>, CXF can automatically set up WS-Addressing for 
you if you use the &lt;Addressing&gt; policy expression.</p>
-</div>
+
+<h1><a shape="rect" name="WS-Addressing-Decoupledresponses"></a>Decoupled 
responses</h1>
+<p>By default, WS-Addressing using anonymous Reply-To addresses.   This means 
the request/response patterns are synchronous in nature and the response is 
sent back via the normal reply channel.   However, WS-Addressing allows for a 
decoupled endpoint to be used for receiving the response and CXF will then 
correlate it with the appropriate request.  There are a few ways for 
configuring the address on which CXF will listen for decoupled WS-Addressing 
responses.</p>
+
+<h3><a shape="rect" name="WS-Addressing-HTTPConduitconfiguration"></a>HTTP 
Conduit configuration</h3>
+<p>The HTTP Conduit's client configuration has an option for a 
DecoupledEndpoint address.  If the conduit has this configured, all requests 
sent via that conduit that have WS-Addressing enabled will have their responses 
sent to that endpoint:</p>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent 
panelContent">
+<pre class="code-xml">
+    <span class="code-tag">&lt;http:conduit name=<span 
class="code-quote">"{http://apache.org/hello_world_soap_http}SoapPort.http-conduit";</span>&gt;</span>
+      <span class="code-tag">&lt;http:client DecoupledEndpoint=<span 
class="code-quote">"http://localhost:9090/decoupled_endpoint";</span>/&gt;</span>
+    <span class="code-tag">&lt;/http:conduit&gt;</span>
+</pre>
+</div></div>
+
+<h3><a shape="rect" name="WS-Addressing-RequestProperty"></a>Request 
Property</h3>
+<p>The address can be set via a Request Context property.   </p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent 
panelContent">
+<pre class="code-java">
+((BindingProvider)proxy).getRequestContext()
+    .put(<span 
class="code-quote">"org.apache.cxf.ws.addressing.replyto"</span>, <span 
class="code-quote">"http:<span 
class="code-comment">//localhost:9090/decoupled_endpoint"</span>);</span>
+</pre>
+</div></div>
+
+<h3><a shape="rect" 
name="WS-Addressing-AddressingProperties"></a>AddressingProperties</h3>
+<p>The CXF org.apache.cxf.ws.addressing.impl.AddressingPropertiesImpl object 
can be used to control many aspects of WS-Addressing including the Reply-To:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent 
panelContent">
+<pre class="code-java">
+        AddressingProperties maps = <span class="code-keyword">new</span> 
AddressingPropertiesImpl();
+        EndpointReferenceType ref = <span class="code-keyword">new</span> 
EndpointReferenceType();
+        AttributedURIType add = <span class="code-keyword">new</span> 
AttributedURIType();
+        add.setValue(<span class="code-quote">"http:<span 
class="code-comment">//localhost:9090/decoupled_endpoint"</span>);
+</span>        ref.setAddress(add);
+        maps.setReplyTo(ref);
+        maps.setFaultTo(ref);
+
+        ((BindingProvider)port).getRequestContext()
+            .put(<span 
class="code-quote">"javax.xml.ws.addressing.context"</span>, maps);
+</pre>
+</div></div>
+<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col 
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" 
valign="top"><img align="middle" 
src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif"; 
width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1">This 
method can also be used to configure the namespace/version of the WS-Addressing 
headers, exact message ID's, etc...</td></tr></table></div></div>
            </div>
            <!-- Content -->
          </td>