com.ibm.di.protocols
Class FTPClient

java.lang.Object
  com.ibm.di.protocols.FTPClient

public class FTPClient
extends Object

This class represents a custom FTP client, that has the functionality to connect to a FTP server, to login, list contents, transfer data, etc.

Field Summary

protected static String

COPYRIGHT Copyright information.

Constructor Summary

FTPClient()
Default constructor.

FTPClient(Log logger)
Constructor.

Method Summary

void	checkComplete() Checks whether the file transfer (when getting/putting a file on the FTP server) is over.
void	connect(String host, int port, boolean useSSLonCommandChannel, boolean useSSLonDataChannel) Creates a connection to the given host and port.
void	connect(String host, int port, boolean useSSLonCommandChannel, boolean useSSLonDataChannel, boolean useExplicitModeSSL) Creates a connection to the given host and port.
void	cwd(String cwd) Changes the working directory with the one specified.
void	deleteFile(String remoteFile) Deletes a given file from the FTP server.
String[]	dir() Returns a long list of the contents of the current working directory on the FTP server.
String[]	dir(String path, boolean longlisting) Returns a string array with the contents of the given path.
void	disconnect() Disconnects the client from the FTP server.
boolean	getDebug() Gets the debug level used.
Socket	getFile(String remoteFile, boolean binary) Retrieves the specified file from the FTP server.
void	getFile(String remoteFile, String localFile, boolean binary) Retrieves the specified file from the FTP server.
String	getResponse() Retrieves the server response to a previously sent by the client command.
boolean	getUsePassive() Returns true if we should try to use passive mode.
String[]	list() Returns a short list of the contents of the current working directory on the FTP server.
Socket	list(String path, boolean longlisting) Lists the contents of a given path on the FTP server.
void	login(String user, String password) Logs to the FTP server using the given credentials.
String	mkdir(String dir) Creates the directory
Socket	putFile(String remoteFile, boolean binary) Sends a local file to the server.
void	putFile(String localPath, String remoteFile, boolean binary) Sends a local file to the server.
String	pwd() Get the current remote working directory.
void	rename(String from, String to) Renames a file or directory on the FTP server.
String	sendCommand(String cmd) Sends the given command through the command channel.
void	setDebug(boolean debug) Sets the client in detailed logging mode.
void	setTimeout(int millis) This method does nothing.
void	setTransferMode(boolean binary) Sets the transfer mode according to the type of files to be transfered.
void	setupDataSocket() Creates the data socket used for data transferring between the FTP client and server.
void	setUsePassive(boolean value) Sets this FTPClient to use passive mode (or not).

Methods inherited from class java.lang.Object

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

Field Detail

COPYRIGHT

protected static final String COPYRIGHT

Copyright information.

See Also:

Constant Field Values

Constructor Detail

FTPClient

public FTPClient()

Default constructor.

FTPClient

public FTPClient(Log logger)

Constructor.

Parameters:

logger - a Log object used for logging debug messages.

Method Detail

setTimeout

public void setTimeout(int millis)

This method does nothing.

Parameters:

millis - the timeout to be set in milliseconds.

setDebug

public void setDebug(boolean debug)

Sets the client in detailed logging mode.

Parameters:

debug - whether to log in details or not.

getDebug

public boolean getDebug()

Gets the debug level used.

Returns:

whether the client is in detail logging mode.

connect

public void connect(String host,
                    int port,
                    boolean useSSLonCommandChannel,
                    boolean useSSLonDataChannel)
             throws Exception

Creates a connection to the given host and port. The security of the two channels established is determined by the other two input parameters.

Parameters:

host - the host to connect to.

port - the port to connect to.

useSSLonCommandChannel - whether to use SSL on the command channel.

useSSLonDataChannel - whether to use SSL on the data channel.

Throws:

Exception - if there is a problem during the connection establishment.

connect

public void connect(String host,
                    int port,
                    boolean useSSLonCommandChannel,
                    boolean useSSLonDataChannel,
                    boolean useExplicitModeSSL)
             throws Exception

Creates a connection to the given host and port. The two parameters useSSLonCommandChannel and useSSLonDataChannel determine the SSL settings on the two channels respectively. If useSSLonCommandChannel is true, then the useExplicitModeSSL parameter will determine if the command channel will use explicit or implicit mode SSL.

Parameters:

host - the host to connect to.

port - the port to connect to.

useSSLonCommandChannel - whether to use SSL on the command channel.

useSSLonDataChannel - whether to use SSL on the data channel.

useExplicitModeSSL - whether to negotiate SSL on the control channel (ftpes).

Throws:

Exception - if there is a problem during the connection establishment.

disconnect

public void disconnect()

Disconnects the client from the FTP server.

login

public void login(String user,
                  String password)
           throws Exception

Logs to the FTP server using the given credentials.

Parameters:

user - the username to be used.

password - the password to be used.

Throws:

Exception - if the logging process is unsuccessful.

cwd

public void cwd(String cwd)
         throws Exception

Changes the working directory with the one specified.

Parameters:

cwd - the new working directory.

Throws:

Exception - if the process fails.

setupDataSocket

public void setupDataSocket()
                     throws Exception

Creates the data socket used for data transferring between the FTP client and server. If the client is in passive mode it creates a Socket and attempts to connect to the server, otherwise it creates a ServerSocket and waits for the server to make the connection. The security settings of the client(whether SSL is used or not) are taken into account when sreating the socket.

Throws:

Exception - if the operation fails.

getFile

public Socket getFile(String remoteFile,
                      boolean binary)
               throws Exception

Retrieves the specified file from the FTP server.

Parameters:

remoteFile - the file to be copied.

binary - the type of the file (ASCII text or binary data). This determines the transfer mode used by the client.

Returns:

a socket from which to read the contents of the file.

Throws:

Exception - if the transfer fails.

getFile

public void getFile(String remoteFile,
                    String localFile,
                    boolean binary)
             throws Exception

Retrieves the specified file from the FTP server.

Parameters:

remoteFile - the file to be copied.

localFile - the local file in which the contents of the remote to be transfered.

binary - the type of the file (ASCII text or binary data). This determines the transfer mode used by the client.

Throws:

Exception - if the transfer fails.

putFile

public Socket putFile(String remoteFile,
                      boolean binary)
               throws Exception

Sends a local file to the server.

Parameters:

remoteFile - the file to be put on the server.

binary - the type of the file (ASCII text or binary data). This determines the transfer mode used by the client.

Returns:

the socket used for sending the file contents.

Throws:

Exception - if the operation fails.

putFile

public void putFile(String localPath,
                    String remoteFile,
                    boolean binary)
             throws Exception

Sends a local file to the server.

Parameters:

localPath - the location of the transfered file on the FTP client machine.

remoteFile - the file to be put on the server.

binary - the type of the file (ASCII text or binary data). This determines the transfer mode used by the client.

Throws:

Exception - if the operation fails.

setTransferMode

public void setTransferMode(boolean binary)
                     throws Exception

Sets the transfer mode according to the type of files to be transfered.

Parameters:

binary - if true the files will be sent as binary data, otherwise they will be sent as ASCII text.

Throws:

Exception - if the operation failed and the server did not return a OK code.

deleteFile

public void deleteFile(String remoteFile)
                throws Exception

Deletes a given file from the FTP server.

Parameters:

remoteFile - the file to be deleted.

Throws:

Exception - if the operation fails.

rename

public void rename(String from,
                   String to)
            throws Exception

Renames a file or directory on the FTP server.

Parameters:

from - name of file or directory to rename.

to - intended name.

Throws:

Exception - if the operation fails.

pwd

public String pwd()
           throws Exception

Get the current remote working directory.

Returns:

the current working directory on the FTP server.

Throws:

Exception - if the request fails.

mkdir

public String mkdir(String dir)
             throws Exception

Creates the directory

Parameters:

dir - Path of the directory to be created

Throws:

Exception - if the request fails.

sendCommand

public String sendCommand(String cmd)
                   throws Exception

Sends the given command through the command channel.

Parameters:

cmd - the command sent to the FTP server.

Returns:

the FTP server response.

Throws:

Exception - if the operation fails.

dir

public String[] dir()
             throws Exception

Returns a long list of the contents of the current working directory on the FTP server.

Returns:

an array of the contents.

Throws:

Exception

list

public String[] list()
              throws Exception

Returns a short list of the contents of the current working directory on the FTP server.

Returns:

the

Throws:

Exception

dir

public String[] dir(String path,
                    boolean longlisting)
             throws Exception

Returns a string array with the contents of the given path.

Parameters:

path - the path which contents will be listed.

longlisting - whether the list will be long or short.

Returns:

the contents of the path.

Throws:

Exception

checkComplete

public void checkComplete()
                   throws Exception

Checks whether the file transfer (when getting/putting a file on the FTP server) is over.

Throws:

Exception - if the operation fails.

list

public Socket list(String path,
                   boolean longlisting)
            throws Exception

Lists the contents of a given path on the FTP server. If the path refers to a file sends information for that file.

Parameters:

path - the path which contents must be shown.

longlisting - determines whether the list should be short or long.

Returns:

the socket used for transferring the contents.

Throws:

Exception - if the operation fails.

getResponse

public String getResponse()
                   throws Exception

Retrieves the server response to a previously sent by the client command.

Returns:

the server response.

Throws:

Exception - if the operation fails.

setUsePassive

public void setUsePassive(boolean value)

Sets this FTPClient to use passive mode (or not).

Parameters:

value - If true, try to use passive mode before falling back to the old PORT mode. If false, never use passive mode.

getUsePassive

public boolean getUsePassive()

Returns true if we should try to use passive mode.

Returns:

true if passive mode is to be used, otherwise false.