Author: buildbot
Date: Tue Sep 16 05:46:51 2014
New Revision: 922350
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/soap-over-jms-10-support.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/soap-over-jms-10-support.html
==============================================================================
--- websites/production/cxf/content/docs/soap-over-jms-10-support.html
(original)
+++ websites/production/cxf/content/docs/soap-over-jms-10-support.html Tue Sep
16 05:46:51 2014
@@ -124,7 +124,7 @@ Apache CXF -- SOAP over JMS 1.0 support
<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[jms:jndi:SomeJndiNameForDestination?jndiInitialContextFactory=org.apache.activemq.jndi.ActiveMQInitialContextFactory&jndiURL=tcp://localhost:61616&priority=3
jms:queue:ExampleQueueName?timeToLive=1000
]]></script>
-</div></div><h3 id="SOAPoverJMS1.0support-JMSparameters">JMS
parameters</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Query Parameter</p></th><th colspan="1" rowspan="1"
class="confluenceTh">From <br clear="none">Version</th><th colspan="1"
rowspan="1" class="confluenceTh"><p>DefaultValue</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">conduitIdSelectorPrefix</td><td
colspan="1" rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">If set then this string will be the prefix for all
correlation ids the conduit creates and also be used in the selector for
listening to replies</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>deliveryMode</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td co
lspan="1" rowspan="1" class="confluenceTd"><p>PERSISTENT</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>NON_PERSISTENT messages will
kept only in memory <br clear="none"> PERSISTENT messages will be saved to
disk</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">durableSubscriptionClientId</td><td colspan="1"
rowspan="1" class="confluenceTd">3.0.1</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Optional Client identifier for the connection. The purpose
is to associate a connection with a state maintained on behalf of the client by
a provider. The only such state identified by the JMS API is that required to
support durable subscriptions.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">durableSubscriptionName</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd"
> </td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>jndiConnectionFactoryName</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>ConnectionFactory</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Specifies the JNDI name bound to the JMS connection
>factory to use when connecting to the JMS destination.</p></td></tr><tr><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p>jndiInitialContextFactory</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Specifies the fully qualified Java class name of the
>"InitialContextFactory" implementation class to use.</p></td></tr><tr><td
>colspan="1" rowspan="1"
>class="confluenceTd">jndiTransactionManagerName</td><td colspan="1"
>rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
>class="confluenceTd">
 </td><td colspan="1" rowspan="1" class="confluenceTd"><p>Name of the JTA
TransactionManager. Will be searched in spring, blueprint and jndi.<br
clear="none"> If a transaction manager is found then JTA transactions will be
enabled. See details below.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jndiURL</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the JNDI provider URL</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">jndi-*</td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Additional parameters for a JNDI provider</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">messageType</td><td colspan="1"
rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1" rows
pan="1" class="confluenceTd">byte</td><td colspan="1" rowspan="1"
class="confluenceTd">JMS message type used by CXF (byte, text or
binary)</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">password</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Password for creating the connection. Using this in the
URI is discouraged</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">priority</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd">4</td><td colspan="1" rowspan="1"
class="confluenceTd">Priority for the messages. See your JMS provider
documentation for details. Values range from 0 to 9 where 0 is lowest
priority</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>replyToName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1" c
lass="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the JNDI name bound to the JMS destinations
where replies are sent</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">receiveTimeout</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd">60000</td><td colspan="1" rowspan="1"
class="confluenceTd">Timeout in milliseconds the client waits for a reply in
case of request / repy exchanges</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">reconnectOnException</td><td colspan="1" rowspan="1"
class="confluenceTd"><p>deprecated</p><p>in 3.0.0</p></td><td colspan="1"
rowspan="1" class="confluenceTd">true</td><td colspan="1" rowspan="1"
class="confluenceTd">Should the transport reconnect in case of exceptions. From
version 3.0.0 on the transport will always reconnect in case of
exceptions</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">sessionTransa
cted</td><td colspan="1" rowspan="1" class="confluenceTd">3.0.0</td><td
colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1"
rowspan="1" class="confluenceTd">Set to true for resource local transactions.
Do not set if you use JTA</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">targetService</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>timeToLive</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"><p>0</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Time (in ms) after which the message will be discarded
by the jms provider</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">topicReplyToName</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1
" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Reply to messages on a topic with this name. Depending on
the variant this is either  a jndi or jms name.</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">useConduitIdSelector</td><td
colspan="1" rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1"
rowspan="1" class="confluenceTd">true</td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Each conduit is assigned with a UUID. If set to true
this conduit id will be the prefix for all correlation ids. This allows several
endpoints to</p><p>share a JMS queue or topic</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>username</p></td><td colspan="1"
rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Username for creating the
connection</p></td></tr></tbody></table></div><p>Some of these att
ributes are specified in the <a shape="rect" class="external-link"
href="http://tools.ietf.org/id/draft-merrick-jms-uri-06.txt"; rel="nofollow">JMS
URI specification</a>.</p><h2 id="SOAPoverJMS1.0support-WSDLExtension">WSDL
Extension</h2><p>The WSDL extensions for defining a JMS endpoint use a special
namespace. In order to use the JMS WSDL extensions you will need to add the
namespace definition shown below to the definitions element of your
contract.</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+</div></div><h3 id="SOAPoverJMS1.0support-JMSparameters">JMS
parameters</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Query Parameter</p></th><th colspan="1" rowspan="1"
class="confluenceTh">From <br clear="none">Version</th><th colspan="1"
rowspan="1" class="confluenceTh"><p>DefaultValue</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">conduitIdSelectorPrefix</td><td
colspan="1" rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">If set then this string will be the prefix for all
correlation ids the conduit creates and also be used in the selector for
listening to replies</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>deliveryMode</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td co
lspan="1" rowspan="1" class="confluenceTd"><p>PERSISTENT</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>NON_PERSISTENT messages will
kept only in memory <br clear="none"> PERSISTENT messages will be saved to
disk</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">durableSubscriptionClientId</td><td colspan="1"
rowspan="1" class="confluenceTd">3.0.1</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Optional Client identifier for the connection. The purpose
is to associate a connection with a state maintained on behalf of the client by
a provider. The only such state identified by the JMS API is that required to
support durable subscriptions.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">durableSubscriptionName</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd"
> </td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>jndiConnectionFactoryName</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>ConnectionFactory</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Specifies the JNDI name bound to the JMS connection
>factory to use when connecting to the JMS destination.</p></td></tr><tr><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p>jndiInitialContextFactory</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Specifies the fully qualified Java class name of the
>"InitialContextFactory" implementation class to use.</p></td></tr><tr><td
>colspan="1" rowspan="1"
>class="confluenceTd">jndiTransactionManagerName</td><td colspan="1"
>rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
>class="confluenceTd">
 </td><td colspan="1" rowspan="1" class="confluenceTd"><p>Name of the JTA
TransactionManager. Will be searched in spring, blueprint and jndi.<br
clear="none"> If a transaction manager is found then JTA transactions will be
enabled. See details below.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jndiURL</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the JNDI provider URL</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">jndi-*</td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Additional parameters for a JNDI provider</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">messageType</td><td colspan="1"
rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1" rows
pan="1" class="confluenceTd">byte</td><td colspan="1" rowspan="1"
class="confluenceTd">JMS message type used by CXF (byte, text or
binary)</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">password</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Password for creating the connection. Using this in the
URI is discouraged</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">priority</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd">4</td><td colspan="1" rowspan="1"
class="confluenceTd">Priority for the messages. See your JMS provider
documentation for details. Values range from 0 to 9 where 0 is lowest
priority</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>replyToName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1" c
lass="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Specifies the JNDI name bound to the JMS destinations
where replies are sent</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">receiveTimeout</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd">60000</td><td colspan="1" rowspan="1"
class="confluenceTd">Timeout in milliseconds the client waits for a reply in
case of request / repy exchanges</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">reconnectOnException</td><td colspan="1" rowspan="1"
class="confluenceTd"><p>deprecated</p><p>in 3.0.0</p></td><td colspan="1"
rowspan="1" class="confluenceTd">true</td><td colspan="1" rowspan="1"
class="confluenceTd">Should the transport reconnect in case of exceptions. From
version 3.0.0 on the transport will always reconnect in case of
exceptions</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">sessionTransa
cted</td><td colspan="1" rowspan="1" class="confluenceTd">3.0.0</td><td
colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1"
rowspan="1" class="confluenceTd">Set to true for resource local transactions.
Do not set if you use JTA</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>timeToLive</p></td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"><p>0</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Time (in ms) after which the message will be discarded
by the jms provider</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">topicReplyToName</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">Reply to messages on a topic with this name. Depending on
the variant this is either  a jndi or jms name.</td></tr><tr><td
colspan="1" rowspan="1" class="co
nfluenceTd">useConduitIdSelector</td><td colspan="1" rowspan="1"
class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd">true</td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Each conduit is assigned with a UUID. If set to true
this conduit id will be the prefix for all correlation ids. This allows several
endpoints to</p><p>share a JMS queue or topic</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>username</p></td><td colspan="1"
rowspan="1" class="confluenceTd">3.0.0</td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Username for creating the
connection</p></td></tr></tbody></table></div><p>Some of these attributes are
specified in the <a shape="rect" class="external-link"
href="http://tools.ietf.org/id/draft-merrick-jms-uri-06.txt"; rel="nofollow">JMS
URI specification</a>.</p><h2 id="SOAPoverJMS1.0support-WSDLExtension">WSDL
Extension</h2><p>The WSDL extensi
ons for defining a JMS endpoint use a special namespace. In order to use the
JMS WSDL extensions you will need to add the namespace definition shown below
to the definitions element of your contract.</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[xmlns:soapjms="http://www.w3.org/2010/soapjms/"
]]></script>
</div></div><p>Various JMS properties may be set in three places in the WSDL
— the binding, the service, and the port. Values specified at the service
will propagate to all ports. Values specified at the binding will propagate to
all ports using that binding. <br clear="none"> For example, if the
<strong>jndiInitialContextFactory</strong> is indicated for a service, it will
be used for all of the port elements it contains.</p><p>JMS Properties. For
details refer to the URI query parameters with the same name:</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>deliveryMode</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jndiConnectionFactoryName</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jndiInitialContextFactory</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>jndiURL</
p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>replyToName</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>priority</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>timeToLive</p></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><p>jndiContextParameter</p></td></tr></tbody></table></div><p>Here
is an example:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Ways to
define a Service with JMS transport</b></div><div class="codeContent
panelContent pdl">
