README.md

FTP Samples

Introduction

This example demonstrates the following aspects of the FTP support available with Spring Integration:

  1. Transfer local files via the FTP Outbound Channel Adapter to a remote directory
  2. Poll for remote files using the FTP Inbound Channel Adapter
  3. Execute explicit FTP command (LS, RM) in order to retrieve a remote file listing and to subsequently delete those files.

Setup

The samples work out of the box using an embedded Apache FTP Server. Simply execute:

$ gradlew :ftp:run

and the samples are build as well as executed. The samples are part of a JUnit test suite:

org.springframework.integration.samples.ftp.TestSuite.java

which comprises the following tests that correspond to the scenarios outlined above:

  • org.springframework.integration.samples.ftp.FtpOutboundChannelAdapterSample.class,
  • org.springframework.integration.samples.ftp.FtpInboundChannelAdapterSample.class,
  • org.springframework.integration.samples.ftp.FtpOutboundGatewaySample.class

Keep in mind that the tests are meant to be executed in sequence.

The Scenarios

Outbound Channel Adapter

This sample will take 2 local files

  1. a.txt
  2. b.txt

and transfer them to a remote directory '/'.

Inbound Channel Adapter

This test will use the 2 files previously uploaded. Using an Inbound Channel Adapter, the test will poll the remote (Root) directory that will contain 2 files. The adapter will attempt to transfer them to a local directory, which will be generated. Once copied, the files will be sent as a payload of the message to a channel. We are using a file filter, transferring only files that end with 'txt'. The remote files are not deleted.

Outbound Gateway

The last test will re-use the 2 files that are still on the remote FTP server. This test will retrieve and removes them through explicit FTP commands (ls and rm).