diff --git a/src/docbkx/client.xml b/src/docbkx/client.xml index b088bfd2..a59e3e0b 100644 --- a/src/docbkx/client.xml +++ b/src/docbkx/client.xml @@ -44,21 +44,50 @@ messageSenders properties of the WebServiceTemplate class. - - There are two implementations of the WebServiceMessageSender - interface for sending messages via HTTP. The default implementation is the - HttpUrlConnectionMessageSender, which uses the facilities provided - by Java itself. The alternative is the CommonsHttpMessageSender, - which uses the - Jakarta Commons HttpClient. - Use the latter if you need more advanced and easy-to-use functionality (such as authentication, - HTTP connection pooling, and so forth). - +
+ HTTP transports + + There are two implementations of the WebServiceMessageSender + interface for sending messages via HTTP. The default implementation is the + HttpUrlConnectionMessageSender, which uses the facilities provided + by Java itself. The alternative is the CommonsHttpMessageSender, + which uses the + Jakarta Commons HttpClient. + Use the latter if you need more advanced and easy-to-use functionality (such as authentication, + HTTP connection pooling, and so forth). + + + To use the HTTP transport, either set the defaultUri to something like + http://example.com/services, or supply the uri parameter + for one of the methods. + +
+
+ JMS transport + + For sending messages over JMS, Spring Web Services provides the + JmsMessageSender. This class uses the facilities of the Spring framework + to transform the WebServiceMessage into a JMS + BytesMessages, send it on its way on a + Queue or Topic, and receive a + response (if any). + + + To use the JmsMessageSender, you need to set the + defaultUri or uri to a JMS URI, which - at a + minimum - consists of the jms: prefix and a destination name. Some examples of + JMS URIs are: jms:SomeQueue, + jms:SomeTopic?priority=3&deliveryMode=NON_PERSISTENT, and + jms:RequestQueue?replyToName=ResponseName. + For more information on this URI syntax, refer to the class level Javadocs of the + JmsMessageSender. + +
Message factories - In addition to a message sender, the WebServiceTemplate requires a Web + In addition to a message sender, the WebServiceTemplate requires a Web service message factory. There are two message factories for SOAP: SaajSoapMessageFactory and AxiomSoapMessageFactory. If no message factory is specified (via the 'messageFactory' property),