Author: gertv
Date: Tue Nov 2 20:27:11 2010
New Revision: 1030205
URL: http://svn.apache.org/viewvc?rev=1030205&view=rev
Log:
Add documentation about configuring timeouts to servicemix-ftp and
servicemix-cxf-bc
Modified:
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-cxf-bc.conf
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-ftp.conf
Modified:
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-cxf-bc.conf
URL:
http://svn.apache.org/viewvc/servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-cxf-bc.conf?rev=1030205&r1=1030204&r2=1030205&view=diff
==============================================================================
---
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-cxf-bc.conf
(original)
+++
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-cxf-bc.conf
Tue Nov 2 20:27:11 2010
@@ -39,3 +39,91 @@ h3. {{cxfbc:provider}}
h4. Endpoint properties
{include:jbi/components/_servicemix-cxf-bc-provider.conf}
+
+h3. Examples
+h4. Configuring the CXF JMS Transport
+The ServiceMix CXF binding component also allows using the CXF JMS Transport
to send and receive messages. You can use the *{{<cxf:features/>}}* element to
add and configure the {{org.apache.cxf.transport.jms.JMSConfigFeature}} on the
endpoint, as in the example below.
+
+{pygmentize:lang=xml}
+<cxfbc:provider wsdl="org/apache/servicemix/cxfbc/ws/security/hello_world.wsdl"
+ service="greeter:HelloWorldService"
+ endpoint="HelloWorldPortProxy"
+ interfaceName="greeter:Greeter"
+ busCfg="jms_conduit_config.xml">
+
+ <!-- add interceptors here -->
+
+ <cxfbc:features>
+ <bean class="org.apache.cxf.transport.jms.JMSConfigFeature">
+ <property name="jmsConfig">
+ <bean class="org.apache.cxf.transport.jms.JMSConfiguration">
+ <property name="concurrentConsumers">
+ <value>5</value>
+ </property>
+ <property name="connectionFactory">
+ <ref bean="myConnectionFactory" />
+ </property>
+ <property name="targetDestination">
+ <value>test.jmstransport.text.provider</value>
+ </property>
+ <property name="useJms11">
+ <value>false</value>
+ </property>
+ </bean>
+ </property>
+ </bean>
+ </cxfbc:features>
+
+</cxfbc:provider>
+
+<amq:connectionFactory id="myConnectionFactory" brokerURL="vm://localhost"/>
+{pygmentize}
+
+The {{jms_conduit_config.xml}} file specified in the {{busCfg}} parameter, is
optional and can be used to specify additional JMS transport parameters:
+{pygmentize:lang=xml}
+<?xml version="1.0" encoding="UTF-8"?>
+<beans xmlns="http://www.springframework.org/schema/beans";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xmlns:jms="http://cxf.apache.org/transports/jms";
+ xsi:schemaLocation="
+ http://cxf.apache.org/transports/jms
http://cxf.apache.org/schemas/configuration/jms.xsd
+ http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd";>
+
+ <jms:conduit
name="{http://apache.org/hello_world_soap_http}HelloWorldPort.jms-conduit";
abstract="true">
+ <jms:clientConfig clientReceiveTimeout="200000"/>
+ </jms:conduit>
+
+</beans>
+{pygmentize}
+
+h4. Configuring the CXF HTTP Transport
+In order to configure the underlying HTTP transport used by a CXF BC endpoint,
you can specify an additional {{busCfg}} file as in the example below.
+{pygmentize:lang=xml}
+<cxfbc:provider wsdl="org/apache/servicemix/cxfbc/ws/security/hello_world.wsdl"
+ service="greeter:HelloWorldService"
+ endpoint="HelloWorldPortProxy"
+ interfaceName="greeter:Greeter"
+ busCfg="http_conduit_config.xml">
+
+ <!-- add interceptors and additional CXF features here -->
+
+</cxfbc:provider>
+{pygmentize}
+
+The {{http_conduit_config.xml}} file can then specify the additional CXF
configuration. Have a look at [this
page|http://cxf.apache.org/docs/client-http-transport-including-ssl-support.html]
for an overview of all the options supported by CXF.
+{pygmentize:lang=xml}
+<beans xmlns="http://www.springframework.org/schema/beans";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xmlns:http-conf="http://cxf.apache.org/transports/http/configuration";
+ xsi:schemaLocation="http://cxf.apache.org/transports/http/configuration
+
http://cxf.apache.org/schemas/configuration/http-conf.xsd
+ http://www.springframework.org/schema/beans
+
http://www.springframework.org/schema/beans/spring-beans.xsd";>
+
+ <http-conf:conduit
name="{http://apache.org/hello_world_soap_http}HelloWorldPort.http-conduit";>
+ <http-conf:client Connection="Keep-Alive"
+ MaxRetransmits="1"
+ AllowChunking="false" />
+ </http-conf:conduit>
+</beans>
+{pygmentize}
Modified:
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-ftp.conf
URL:
http://svn.apache.org/viewvc/servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-ftp.conf?rev=1030205&r1=1030204&r2=1030205&view=diff
==============================================================================
---
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-ftp.conf
(original)
+++
servicemix/documentation/trunk/src/main/webapp/jbi/components/servicemix-ftp.conf
Tue Nov 2 20:27:11 2010
@@ -28,3 +28,29 @@ h3. {{ftp:sender}}
h4. Endpoint properties
{include:jbi/components/_servicemix-ftp-sender.conf}
+
+h3. Examples
+
+h4. Using {{ftp:pool}} to configure the FTP connections
+
+In order to gain more control over the FTP connection parameters
(active/passive, timeout, ...) that are being used, you can define your own FTP
connection pool. Afterward, you can refer to the pool object from both a
sender and poller endpoint.
+
+{pygmentize:lang=xml}
+<?xml version="1.0"?>
+<beans xmlns:ftp="http://servicemix.apache.org/ftp/1.0";
+ xmlns:sample="urn:servicemix:example">
+
+ <ftp:sender service="sample:sender" endpoint="endpoint"
+ uri="ftp://localhost/myfolder";
+ clientPool="#clientPool"/>
+
+ <ftp:pool id="clientPool" username="myname" password="$ecret"
+ dataTimeout="90000" />
+
+</beans>
+{pygmentize}
+
+The table below shows the full list of options offered by {{ftp:pool}}:
+{include:jbi/components/_servicemix-ftp-pool.conf}
+
+If you need even more fine-grained control over the FTP connections or the way
the payloads are being handled, have a look at the [Camel
FTP|http://camel.apache.org/ftp2.html] component, which offers a lot of options
out of the box, but also allows setting any property on its underlying Commons
NET
[FTPClient|http://commons.apache.org/net/api/org/apache/commons/net/ftp/FTPClient.html]
and
[FTPClientConfig|http://commons.apache.org/net/api/org/apache/commons/net/ftp/FTPClientConfig.html]
instances.
