Spring Integration provides support for file transfer operations via SFTP

Secure File Transfer Protocol (SFTP) is a network protocol which allows you to transfer files between two computers on the Internet over any reliable stream. SFTP protocol requires secure channel, such as SSH, as well as visibility to client's identity throughout SFTP session. Spring Integration supports sending and receiving files over SFTP by providing two types of clients - Inbound Channel Adapters and Outbound Channel Adapters as well as convenient namespace configuration to define these clients.

Before configuring SFTP adapters you must configure Sftp Session Factory. You configure Sftp Session Factory via regular bean configuration: Below is a basic configuration: ]]> Now all you need to do is inject this Sftp Session Factory into your adapters. A more practical way to provide values for Sftp Session Factory would be via Spring's property placeholder (http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/beans.html#beans-factory-placeholderconfigurer)

SFTP Inbound Channel Adapter is a special listener that will connect to the FTP server and will listen for the remote directory events (e.g., new file created) at which point it will initiate a file transfer. ]]> As you can see form the configuration above you can configure SFTP Inbound Channel Adapter via inbound-channel-adapter element while also providing values for various attributes such as local-directory-path - where files are going to be transfered TO and remote-directory - the remote source directory as well as other attributes including session-factory which we configured earlier. Please refer to the schema for more details on these attributes. It is also important to understand that SFTP Inbound Channel Adapter is a polling consumer and therefore you must configure a poller (global or local) Once the file has been transferred to a local directory a Message with java.io.File being a payload will be generated and sent to the channel identified with channel attribute.

SFTP Outbound Channel Adapter is a special MessageHandler that will connect to the remote directory and will initiate a file transfer for every file it will receive as a payload of the Message. It also supports several representation of the File so you are not limited to the File object. Similar to FTP outbound adapter SFTP Outbound Channel Adapter supports the following payloads: 1) java.io.File - the actual file object; 2) byte[] - byte array that represents the file contents; 3) java.lang.String - represents the file contents. ]]> As you can see form the configuration above you can configure SFTP Outbound Channel Adapter via outbound-channel-adapter. Please refer to the schema for more details on these attributes. SpEL and SFTP Outbound Adapter As with many other components in Spring Integration, you can benefit from Spring Expression Language (SpEL) when configuring SFTP Outbound Channel Adapter, by specifying two attributes remote-directory-expression and remote-filename-generator-expression (see above). Expression evaluation context will have Message as its root object, thus allowing you to provide expressions which can dynamically compute the file name or the existing directory path based on the data in the Message. In the example above we are defining remote-filename-generator-expression attribute with expression value which computes the file name based on its original name while also appending suffix '-foo'.