INTSAMPLES-41 - Use embedded Apache FTP Server

For Reference see: https://jira.springsource.org/browse/INTSAMPLES-41

basic/ftp/README.md

@@ -0,0 +1,47 @@
+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:
+
+    $ mvn clean package
+
+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).