org.springframework.integration.ftp.session

Class FtpSession

java.lang.Object

org.springframework.integration.ftp.session.FtpSession

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Session<org.apache.commons.net.ftp.FTPFile>

public class FtpSession
extends java.lang.Object
implements Session<org.apache.commons.net.ftp.FTPFile>

Implementation of Session for FTP.

Since:

2.0

Author:

Mark Fisher, Oleg Zhurakousky, Gary Russell, Artem Bilan

Constructor Summary

Constructors

Constructor and Description
FtpSession(org.apache.commons.net.ftp.FTPClient client)

Method Summary

Modifier and Type	Method and Description
void	append(java.io.InputStream inputStream, java.lang.String path) Append to a file.
void	close()
boolean	exists(java.lang.String path) Check if the remote file or directory exists.
boolean	finalizeRaw() Invoke after closing the InputStream from Session.readRaw(String).
org.apache.commons.net.ftp.FTPClient	getClientInstance() Get the underlying client library's client instance for this session.
boolean	isOpen()
org.apache.commons.net.ftp.FTPFile[]	list(java.lang.String path)
java.lang.String[]	listNames(java.lang.String path)
boolean	mkdir(java.lang.String remoteDirectory)
void	read(java.lang.String path, java.io.OutputStream fos)
java.io.InputStream	readRaw(java.lang.String source) Retrieve a remote file as a raw InputStream.
boolean	remove(java.lang.String path)
void	rename(java.lang.String pathFrom, java.lang.String pathTo)
boolean	rmdir(java.lang.String directory) Remove a remote directory.
void	write(java.io.InputStream inputStream, java.lang.String path)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FtpSession

public FtpSession(org.apache.commons.net.ftp.FTPClient client)

Method Detail

remove

public boolean remove(java.lang.String path)
               throws java.io.IOException

Specified by:

remove in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

list

public org.apache.commons.net.ftp.FTPFile[] list(java.lang.String path)
                                          throws java.io.IOException

Specified by:

list in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

listNames

public java.lang.String[] listNames(java.lang.String path)
                             throws java.io.IOException

Specified by:

listNames in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

read

public void read(java.lang.String path,
                 java.io.OutputStream fos)
          throws java.io.IOException

Specified by:

read in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

readRaw

public java.io.InputStream readRaw(java.lang.String source)
                            throws java.io.IOException

Description copied from interface: Session

Retrieve a remote file as a raw InputStream.

Specified by:

readRaw in interface Session<org.apache.commons.net.ftp.FTPFile>

Parameters:

source - The path of the remote file.

Returns:

The raw inputStream.

Throws:

java.io.IOException - Any IOException.

finalizeRaw

public boolean finalizeRaw()
                    throws java.io.IOException

Description copied from interface: Session

Invoke after closing the InputStream from Session.readRaw(String). Required by some session providers.

Specified by:

finalizeRaw in interface Session<org.apache.commons.net.ftp.FTPFile>

Returns:

true if successful.

Throws:

java.io.IOException - Any IOException.

write

public void write(java.io.InputStream inputStream,
                  java.lang.String path)
           throws java.io.IOException

Specified by:

write in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

append

public void append(java.io.InputStream inputStream,
                   java.lang.String path)
            throws java.io.IOException

Description copied from interface: Session

Append to a file.

Specified by:

append in interface Session<org.apache.commons.net.ftp.FTPFile>

Parameters:

inputStream - the stream.

path - the destination.

Throws:

java.io.IOException - an IO Exception.

close

public void close()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface Session<org.apache.commons.net.ftp.FTPFile>

isOpen

public boolean isOpen()

Specified by:

isOpen in interface Session<org.apache.commons.net.ftp.FTPFile>

rename

public void rename(java.lang.String pathFrom,
                   java.lang.String pathTo)
            throws java.io.IOException

Specified by:

rename in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

mkdir

public boolean mkdir(java.lang.String remoteDirectory)
              throws java.io.IOException

Specified by:

mkdir in interface Session<org.apache.commons.net.ftp.FTPFile>

Throws:

java.io.IOException

rmdir

public boolean rmdir(java.lang.String directory)
              throws java.io.IOException

Description copied from interface: Session

Remove a remote directory.

Specified by:

rmdir in interface Session<org.apache.commons.net.ftp.FTPFile>

Parameters:

directory - The directory.

Returns:

True if the directory was removed.

Throws:

java.io.IOException - an IO exception.

exists

public boolean exists(java.lang.String path)
               throws java.io.IOException

Description copied from interface: Session

Check if the remote file or directory exists.

Specified by:

exists in interface Session<org.apache.commons.net.ftp.FTPFile>

Parameters:

path - the remote path.

Returns:

true or false if remote path exists or not.

Throws:

java.io.IOException - an IO exception during remote interaction.

getClientInstance

public org.apache.commons.net.ftp.FTPClient getClientInstance()

Description copied from interface: Session

Get the underlying client library's client instance for this session. Returns an Object to avoid significant changes to -file, -ftp, -sftp modules, which would be required if we added another generic parameter. Implementations should narrow the return type.

Specified by:

getClientInstance in interface Session<org.apache.commons.net.ftp.FTPFile>

Returns:

The client instance.