org.springframework.integration.ftp.session

Class FtpSession

java.lang.Object

org.springframework.integration.ftp.session.FtpSession

All Implemented Interfaces:

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

public class FtpSession
extends 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, Den Ivanov

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	append(InputStream inputStream, String path) Append to a file.
void	close()
boolean	exists(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.
String	getHostPort() Return the host:port pair this session is connected to.
boolean	isOpen()
org.apache.commons.net.ftp.FTPFile[]	list(String path)
String[]	listNames(String path)
boolean	mkdir(String remoteDirectory)
void	read(String path, OutputStream fos)
InputStream	readRaw(String source) Retrieve a remote file as a raw InputStream.
boolean	remove(String path)
void	rename(String pathFrom, String pathTo)
boolean	rmdir(String directory) Remove a remote directory.
boolean	test() Test the session is still alive, e.g.
void	write(InputStream inputStream, String path)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.integration.file.remote.session.Session

dirty

Constructor Detail

FtpSession

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

Method Detail

remove

public boolean remove(String path)
               throws IOException

Specified by:

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

Throws:

IOException

list

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

Specified by:

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

Throws:

IOException

listNames

public String[] listNames(String path)
                   throws IOException

Specified by:

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

Throws:

IOException

read

public void read(String path,
                 OutputStream fos)
          throws IOException

Specified by:

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

Throws:

IOException

readRaw

public InputStream readRaw(String source)
                    throws 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:

IOException - Any IOException.

finalizeRaw

public boolean finalizeRaw()
                    throws 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:

IOException - Any IOException.

write

public void write(InputStream inputStream,
                  String path)
           throws IOException

Specified by:

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

Throws:

IOException

append

public void append(InputStream inputStream,
                   String path)
            throws 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:

IOException - an IO Exception.

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface 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(String pathFrom,
                   String pathTo)
            throws IOException

Specified by:

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

Throws:

IOException

mkdir

public boolean mkdir(String remoteDirectory)
              throws IOException

Specified by:

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

Throws:

IOException

rmdir

public boolean rmdir(String directory)
              throws 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:

IOException - an IO exception.

exists

public boolean exists(String path)
               throws 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:

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.

getHostPort

public String getHostPort()

Description copied from interface: Session

Return the host:port pair this session is connected to.

Specified by:

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

Returns:

the host:port pair this session is connected to.

test

public boolean test()

Description copied from interface: Session

Test the session is still alive, e.g. when checking out from a pool. The default implementation simply delegates to Session.isOpen().

Specified by:

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

Returns:

true if the test is successful.