Class CachingSessionFactory.CachedSession

java.lang.Object

org.springframework.integration.file.remote.session.CachingSessionFactory.CachedSession

All Implemented Interfaces:

Closeable, AutoCloseable, Session<F>

Enclosing class:

CachingSessionFactory<F>

public class CachingSessionFactory.CachedSession
extends Object
implements Session<F>

Since:

2.0

Author:

Josh Long, Oleg Zhurakousky, Mark Fisher, Gary Russell, Alen Turkovic, Artem Bilan, Christian Tzolov

Method Summary

Modifier and Type	Method	Description
void	append(InputStream inputStream, String destination)	Append to a file.
void	close()
void	dirty()	Mark this session as dirty, indicating that it should not be reused and any delegated sessions should be taken care of before closing.
boolean	exists(String path)	Check if the remote file or directory exists.
boolean	finalizeRaw()	Invoke after closing the InputStream from Session.readRaw(String).
Object	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()
F[]	list(String path)
String[]	listNames(String path)
boolean	mkdir(String directory)
void	read(String source, OutputStream os)
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.
void	write(InputStream inputStream, String destination)

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

test

Method Details

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface Session<F>

remove

public boolean remove(String path)
               throws IOException

Specified by:

remove in interface Session<F>

Throws:

IOException

list

public F[] list(String path)
         throws IOException

Specified by:

list in interface Session<F>

Throws:

IOException

read

public void read(String source,
 OutputStream os)
          throws IOException

Specified by:

read in interface Session<F>

Throws:

IOException

write

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

Specified by:

write in interface Session<F>

Throws:

IOException

append

public void append(InputStream inputStream,
 String destination)
            throws IOException

Description copied from interface: Session

Append to a file.

Specified by:

append in interface Session<F>

Parameters:

inputStream - the stream.

destination - the destination.

Throws:

IOException - an IO Exception.

isOpen

public boolean isOpen()

Specified by:

isOpen in interface Session<F>

rename

public void rename(String pathFrom,
 String pathTo)
            throws IOException

Specified by:

rename in interface Session<F>

Throws:

IOException

mkdir

public boolean mkdir(String directory)
              throws IOException

Specified by:

mkdir in interface Session<F>

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<F>

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<F>

Parameters:

path - the remote path.

Returns:

true or false if remote path exists or not.

Throws:

IOException - an IO exception during remote interaction.

listNames

public String[] listNames(String path)
                   throws IOException

Specified by:

listNames in interface Session<F>

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<F>

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<F>

Returns:

true if successful.

Throws:

IOException - Any IOException.

dirty

public void dirty()

Description copied from interface: Session

Mark this session as dirty, indicating that it should not be reused and any delegated sessions should be taken care of before closing.

Specified by:

dirty in interface Session<F>

See Also:

• close()

getClientInstance

public Object 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<F>

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<F>

Returns:

the host:port pair this session is connected to.