All needed information must be defined in the service-unit JBI descriptor. This JBI descriptor is configured through parameters divided in following groups:
* *JBI parameters* that defines the service provider identification,
* *CDK parameters* that are parameters driving the service provider implementation at CDK layer,
* *CDK interceptor parameters* that are parameters driving interceptors at CDK layer,
* *Dedicated parameters* that are parameters driving the service provider implementation at component layer.
h3. CDK parameters defining service provider implementation
The following parameters correspond to the CDK configuration of the service provider implementation.
{include:0 CDK SU Provide Configuration 5.8.0}
h3. CDK parameters driving interceptors
The following parameters drive interceptors at CDK layer.
{include:0 CDK SU Interceptor configuration 5.8.0}
h3. Dedicated configuration
The following parameters correspond to the component specific configuration of the service provider implementation.
{anchor:connection-parameters}
{table-plus}
|| Parameter || Description || Default || Required ||
| server | IP or DNS name of the server | {center}\-{center} | {center}Yes{center}{center}except when using FtpService{center} |
| port | the port number of the FTP server | {center}21{center} | {center}No{center} |
| user | the user login name used to connect to the server | {center}\-{center} | {center}Yes{center}{center}except when using FtpService{center} |
| password | the user password | {center}\-{center} | {center}Yes{center}{center}except when using FtpService{center} |
| folder | the folder on the FTP server | {center}\-{center} | {center}No{center} |
| filename | file name for the standard PUT operation (write the XML message content on the FTP server) | {center}content.xml{center} | {center}No{center} |
| connection-mode | In Active mode, the connection port is set by the client. In Passive mode, it is set by the server (default is Active) | {center}active{center} | {center}No{center} |
| transfer-type | transfer mode used for put or get files ascii/binary | {center}ascii{center} | {center}No{center} |
| delete-processed-files | If true, the service delete the files processed by operation get or mget | {center}false{center} | {center}No{center} |
| encoding | Set the encoding encoding value used to process FTP operation | {center}Default JVM Encoding{center} | {center}No{center} |
| max-idle-time | Max idle connection time (milliseconds). Default value is 10000ms | {center}10000 ms{center}\\ | {center}No{center}\\ |
| max-connection | This parameter specifies the maximum number of simultaneous connection allowed by the FTP server. \\ | {center}\-1 (unlimited){center}\\ | {center}No{center}\\ |
{table-plus}
h3. Service unit content
The service unit has to contain the following elements, packaged in the archive:
* the META-INF/jbi.xml descriptor file as described above,
* it is also highly recommended to provide a WSDL description for service provider embeded in the service-unit. The service provider contract must implement the interface "\{http://petals.ow2.org/components/ftp/version-3}Ftp" defined in the abstract WSDL 'FtpServiceInterface.wsdl' available as resource in the component archive.
{code}
service-unit.zip
+ META-INF
- jbi.xml (as defined above)
- service.wsdl (optional)
{code}
h3. Example
An example of a Service Unit descriptor to provide an FTP service:
{code:lang=xml}
<?xml version="1.0" encoding="UTF-8"?>
<jbi:jbi xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jbi="http://java.sun.com/xml/ns/jbi"
xmlns:ftp="http://petals.ow2.org/components/ftp/version-3"
xmlns:petalsCDK="http://petals.ow2.org/components/extensions/version-5"
version="1.0">
<jbi:services binding-component="true">
<jbi:provides
interface-name="ftp:Ftp"
service-name="ftp:myFTPSUServiceName"
endpoint-name="myFTPSUEndpointName">
<!-- CDK specific elements -->
<petalsCDK:timeout>30000</petalsCDK:timeout>
<petalsCDK:validate-wsdl>true</petalsCDK:validate-wsdl>
<petalsCDK:wsdl>FtpService.wsdl</petalsCDK:wsdl>
<petalsCDK:retrypolicy>
<petalsCDK:attempts>3</petalsCDK:attempts>
<petalsCDK:delay>20</petalsCDK:delay>
</petalsCDK:retrypolicy>
<!-- Component specific elements -->
<ftp:server>192.168.1.206</ftp:server>
<ftp:port>21</ftp:port>
<ftp:user>user1</ftp:user>
<ftp:password>test</ftp:password>
<ftp:folder>/home/user1/integration</ftp:folder>
<ftp:transfer-type>binary</ftp:transfer-type>
<ftp:connection-mode>active</ftp:connection-mode>
<ftp:delete-processed-files>false</ftp:delete-processed-files>
<ftp:encoding>UTF-8</ftp:encoding>
<ftp:max-idle-time>10000</ftp:max-idle-time>
<ftp:max-connection>-1</ftp:max-connection>
</jbi:provides>
</jbi:services>
</jbi:jbi>{code}
h1. The integration service
The component exposes directly a generic FTP service without deploying a service unit (*Integration service mode*). This generic service can be deactivate removing the file '{{component.wsdl}}' from the component archive.
In integration service mode, parameters for the FTP connection are set in the XML message request in a connection node added to the operation payload as following. See [connection parameters|#connection-parameters] for more details:
{code:lang=xml}
<?xml version="1.0" encoding="UTF-8"?>
<ftp:... xmlns:ftp="http://petals.ow2.org/components/ftp/version-3">
<ftp:connection>
<ftp:server>?</ftp:server>
<ftp:port>?</ftp:port>
<ftp:user>?</ftp:user>
<ftp:password>?</ftp:password>
<!--Optional:-->
<ftp:folder>?</ftp:folder>
<ftp:transfer-type>?</ftp:transfer-type>
<ftp:connection-mode>?</ftp:connection-mode>
<ftp:delete-processed-files>?</ftp:delete-processed-files>
<ftp:encoding>?</ftp:encoding>
</ftp:connection>
</ftp:...>
{code}
Example of a PUT request :
{code:lang=xml}
<?xml version="1.0" encoding="UTF-8"?>
<ftp:put xmlns:ftp="http://petals.ow2.org/components/ftp/version-3">
<ftp:body>xml body</ftp:body>
<ftp:filename>file name on the FTP server</ftp:filename>
<ftp:connection>
<ftp:server>192.168.1.206</ftp:server>
<ftp:port>21</ftp:port>
<ftp:user>user1</ftp:user>
<ftp:password>test</ftp:password>
<ftp:folder>/home/user1/integration</ftp:folder>
<ftp:transfer-type>binary</ftp:transfer-type>
<ftp:connection-mode>active</ftp:connection-mode>
<ftp:delete-processed-files>false</ftp:delete-processed-files>
<ftp:encoding>UTF-8</ftp:encoding>
</ftp:connection>
</ftp:put>
{code}
h1. Configuring the component
The component can be configured through the parameters of its JBI descriptor file. These parameters are divided in following groups:
* *JBI parameters* that have not to be changed otherwise the component will not work,
* *CDK parameters* that are parameters driving the processing of the CDK layer,
* *Dedicated parameters* that are parameters specific to this component.
h2. CDK parameters
The component configuration includes the configuration of the CDK. The following parameters correspond to the CDK configuration.
{include:0 CDK Component Configuration Table 5.8.0}
h2. Interception configuration
{include:0 CDK Component Interceptor configuration 5.8.0}
h2. Dedicated configuration
No dedicated configuration parameter is available.
h1. Business monitoring
h2. MONIT traces
{include:0 CDK BC Business Monitoring Traces 5.8.0}
h2. Flow tracing activation
{include:0 CDK BC Provides Business Monitoring Flow Tracing Activation 5.8.0}
h1. Monitoring the component
h2. Using metrics
Several probes providing metrics are included in the component, and are available through the JMX MBean '{{org.ow2.petals:type=custom,name=monitoring_*<component-id>*}}', where {{*<component-id>*}} is the unique JBI identifier of the component.