de.unkrig.commons.net.ftp.ftplett

Interface Ftplett

All Known Implementing Classes:

FileFtplett

public interface Ftplett

Defines the semantics of the FTP protocol, in analogy with the Servlett.

Method Summary

Modifier and Type	Method and Description
boolean	changeWorkingDirectory(String directoryName)
boolean	delete(String resourceName)
Date	getModificationTime(String resourceName)
String	getWorkingDirectory()
boolean	list(String name, de.unkrig.commons.lang.protocol.ConsumerWhichThrows<String,IOException> lineConsumer)
boolean	nameList(String name, de.unkrig.commons.lang.protocol.ConsumerWhichThrows<String,IOException> lineConsumer)
boolean	rename(String from, String to)
InputStream	retrieve(String resourceName)
OutputStream	store(String resourceName)

Method Detail

changeWorkingDirectory

boolean changeWorkingDirectory(@Nullable
                               String directoryName)
                        throws IOException

Parameters:

directoryName - null means change to some 'root' or 'home' directory

Returns:

Whether the working directory could be changed to the given directory.

Throws:

IOException

getWorkingDirectory

String getWorkingDirectory()

Returns:

The current working directory

retrieve

@Nullable
InputStream retrieve(String resourceName)
                         throws IOException

Returns:

An InputStream producing the contents of the resource, or null iff the resource cannot be accessed.

Throws:

IOException

store

@Nullable
OutputStream store(String resourceName)
                       throws IOException

Returns:

An OutputStream to which the contents can be written, or null iff the resource cannot be accessed.

Throws:

IOException

list

boolean list(@Nullable
             String name,
             de.unkrig.commons.lang.protocol.ConsumerWhichThrows<String,IOException> lineConsumer)
      throws IOException

Parameters:

name - The name of the directory or file to list, or null to list the current working directory

lineConsumer - Consumes the listing

Throws:

IOException

nameList

boolean nameList(@Nullable
                 String name,
                 de.unkrig.commons.lang.protocol.ConsumerWhichThrows<String,IOException> lineConsumer)
          throws IOException

Parameters:

name - The name of the directory or file to list, or null to list the current working directory

lineConsumer - Consumes the listing

Throws:

IOException

delete

boolean delete(String resourceName)
        throws IOException

Returns:

Whether the resource was successfully deleted

Throws:

IOException

rename

boolean rename(String from,
               String to)
        throws IOException

Returns:

Whether the resource was successfully renamed

Throws:

IOException

getModificationTime

@Nullable
Date getModificationTime(String resourceName)
                             throws IOException

Returns:

null iff the modification time cannot be determined

Throws:

IOException