FTPConnection (gnu-classpath-ext-inetlib 1.1.1 API)

java.lang.Object
- gnu.inet.ftp.FTPConnection

```
public class FTPConnection
extends Object
```
An FTP client connection, or PI. This implements RFC 959, with the following exceptions:
- STAT, HELP, SITE, SMNT, and ACCT commands are not supported.
- the TYPE command does not allow alternatives to the default bytesize (Non-print), and local bytesize is not supported.
Author:

Chris Burdess

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`ABOR`
`protected static String`	`ACCT`
`protected static String`	`ALLO`
`protected static String`	`APPE`
`protected static String`	`AUTH`
`protected static String`	`CCC`
`protected static String`	`CDUP`
`protected int`	`connectionTimeout` The timeout when attempting to connect a socket.
`protected static String`	`CWD`
`protected boolean`	`debug` If true, print debugging information.
`protected static String`	`DELE`
`protected gnu.inet.ftp.DTP`	`dtp` The current data transfer process in use by this connection.
`protected int`	`fileStructure` The current file structure type.
`static int`	`FTP_DATA_PORT` The FTP data port.
`static int`	`FTP_PORT` The default FTP transmission control port.
`protected static String`	`HELP`
`protected LineInputStream`	`in` The socket input stream.
`protected static String`	`LIST`
`protected static String`	`MKD`
`protected static String`	`MODE`
`static int`	`MODE_BLOCK`
`static int`	`MODE_COMPRESSED`
`static int`	`MODE_STREAM`
`protected static String`	`NLST`
`protected static String`	`NOOP`
`protected CRLFOutputStream`	`out` The socket output stream.
`protected static String`	`PASS`
`protected boolean`	`passive` If true, use passive mode.
`protected static String`	`PASV`
`protected static String`	`PBSZ`
`protected static String`	`PORT`
`protected static String`	`PROT`
`protected static String`	`PWD`
`protected static String`	`QUIT`
`protected static String`	`REIN`
`protected int`	`representationType` The current representation type.
`protected static String`	`REST`
`protected static String`	`RETR`
`protected static String`	`RMD`
`protected static String`	`RNFR`
`protected static String`	`RNTO`
`protected static String`	`SITE`
`protected static String`	`SMNT`
`protected Socket`	`socket` The socket used to communicate with the server.
`protected static String`	`STAT`
`protected static String`	`STOR`
`protected static String`	`STOU`
`protected static String`	`STRU`
`static int`	`STRUCTURE_FILE`
`static int`	`STRUCTURE_PAGE`
`static int`	`STRUCTURE_RECORD`
`protected static String`	`SYST`
`protected int`	`timeout` The read timeout on sockets.
`protected static String`	`TLS`
`protected int`	`transferMode` The current transfer mode.
`protected static String`	`TYPE`
`static int`	`TYPE_ASCII`
`static int`	`TYPE_BINARY`
`static int`	`TYPE_EBCDIC`
`protected static String`	`USER`

Constructor Summary

Constructors
Constructor and Description
`FTPConnection(String hostname)` Creates a new connection to the server using the default port.
`FTPConnection(String hostname, int port)` Creates a new connection to the server.
`FTPConnection(String hostname, int port, int connectionTimeout, int timeout, boolean debug)` Creates a new connection to the server.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`abort()` Aborts the transfer in progress.
`void`	`allocate(long size)` This command may be required by some servers to reserve sufficient storage to accommodate the new file to be transferred.
`OutputStream`	`append(String filename)` Returns a stream for uploading a file.
`boolean`	`authenticate(String username, String password)` Authenticate using the specified username and password.
`boolean`	`changeToParentDirectory()` Changes directory to the parent of the current working directory.
`boolean`	`changeWorkingDirectory(String path)` Changes directory to the specified path.
`boolean`	`delete(String filename)` Causes the file specified to be deleted at the server site.
`int`	`getFileStructure()` Returns the current file structure type.
`int`	`getRepresentationType()` Returns the current representation type of the transfer data.
`protected FTPResponse`	`getResponse()` Reads the next response from the server.
`int`	`getTransferMode()` Returns the current transfer mode.
`String`	`getWorkingDirectory()` Returns the current working directory.
`protected void`	`initialiseDTP()` Initialise the data transfer process.
`InputStream`	`list(String pathname)` Returns a listing of information about the specified pathname.
`void`	`logout()` Terminates the control connection.
`boolean`	`makeDirectory(String pathname)` Causes the directory specified to be created at the server site.
`List`	`nameList(String pathname)` Returns a directory listing.
`void`	`noop()` Does nothing.
`protected FTPResponse`	`readResponse()` Reads and parses the next response from the server.
`void`	`reinitialize()` Terminates an authenticated login.
`boolean`	`removeDirectory(String pathname)` Causes the directory specified to be deleted.
`boolean`	`rename(String oldName, String newName)` Renames a file.
`InputStream`	`retrieve(String filename)` Retrieves the specified file.
`protected void`	`send(String cmd)` Sends the specified command line to the server.
`void`	`setFileStructure(int structure)` Sets the desired file structure type.
`void`	`setPassive(boolean flag)` Set passive mode.
`void`	`setRepresentationType(int type)` Sets the desired representation type of the transfer data.
`void`	`setTransferMode(int mode)` Sets the desired transfer mode.
`boolean`	`starttls(boolean confidential)` Negotiates TLS over the current connection.
`boolean`	`starttls(boolean confidential, TrustManager tm)` Negotiates TLS over the current connection.
`OutputStream`	`store(String filename)` Returns a stream for uploading a file.
`String`	`system()` Returns the type of operating system at the server.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - FTP_PORT
```
public static final int FTP_PORT
```
    The default FTP transmission control port.
    
    See Also:
    
    Constant Field Values
  - FTP_DATA_PORT
```
public static final int FTP_DATA_PORT
```
    The FTP data port.
    
    See Also:
    
    Constant Field Values
  - USER
```
protected static final String USER
```
    See Also:
    
    Constant Field Values
  - PASS
```
protected static final String PASS
```
    See Also:
    
    Constant Field Values
  - ACCT
```
protected static final String ACCT
```
    See Also:
    
    Constant Field Values
  - CWD
```
protected static final String CWD
```
    See Also:
    
    Constant Field Values
  - CDUP
```
protected static final String CDUP
```
    See Also:
    
    Constant Field Values
  - SMNT
```
protected static final String SMNT
```
    See Also:
    
    Constant Field Values
  - REIN
```
protected static final String REIN
```
    See Also:
    
    Constant Field Values
  - QUIT
```
protected static final String QUIT
```
    See Also:
    
    Constant Field Values
  - PORT
```
protected static final String PORT
```
    See Also:
    
    Constant Field Values
  - PASV
```
protected static final String PASV
```
    See Also:
    
    Constant Field Values
  - TYPE
```
protected static final String TYPE
```
    See Also:
    
    Constant Field Values
  - STRU
```
protected static final String STRU
```
    See Also:
    
    Constant Field Values
  - MODE
```
protected static final String MODE
```
    See Also:
    
    Constant Field Values
  - RETR
```
protected static final String RETR
```
    See Also:
    
    Constant Field Values
  - STOR
```
protected static final String STOR
```
    See Also:
    
    Constant Field Values
  - STOU
```
protected static final String STOU
```
    See Also:
    
    Constant Field Values
  - APPE
```
protected static final String APPE
```
    See Also:
    
    Constant Field Values
  - ALLO
```
protected static final String ALLO
```
    See Also:
    
    Constant Field Values
  - REST
```
protected static final String REST
```
    See Also:
    
    Constant Field Values
  - RNFR
```
protected static final String RNFR
```
    See Also:
    
    Constant Field Values
  - RNTO
```
protected static final String RNTO
```
    See Also:
    
    Constant Field Values
  - ABOR
```
protected static final String ABOR
```
    See Also:
    
    Constant Field Values
  - DELE
```
protected static final String DELE
```
    See Also:
    
    Constant Field Values
  - RMD
```
protected static final String RMD
```
    See Also:
    
    Constant Field Values
  - MKD
```
protected static final String MKD
```
    See Also:
    
    Constant Field Values
  - PWD
```
protected static final String PWD
```
    See Also:
    
    Constant Field Values
  - LIST
```
protected static final String LIST
```
    See Also:
    
    Constant Field Values
  - NLST
```
protected static final String NLST
```
    See Also:
    
    Constant Field Values
  - SITE
```
protected static final String SITE
```
    See Also:
    
    Constant Field Values
  - SYST
```
protected static final String SYST
```
    See Also:
    
    Constant Field Values
  - STAT
```
protected static final String STAT
```
    See Also:
    
    Constant Field Values
  - HELP
```
protected static final String HELP
```
    See Also:
    
    Constant Field Values
  - NOOP
```
protected static final String NOOP
```
    See Also:
    
    Constant Field Values
  - AUTH
```
protected static final String AUTH
```
    See Also:
    
    Constant Field Values
  - PBSZ
```
protected static final String PBSZ
```
    See Also:
    
    Constant Field Values
  - PROT
```
protected static final String PROT
```
    See Also:
    
    Constant Field Values
  - CCC
```
protected static final String CCC
```
    See Also:
    
    Constant Field Values
  - TLS
```
protected static final String TLS
```
    See Also:
    
    Constant Field Values
  - TYPE_ASCII
```
public static final int TYPE_ASCII
```
    See Also:
    
    Constant Field Values
  - TYPE_EBCDIC
```
public static final int TYPE_EBCDIC
```
    See Also:
    
    Constant Field Values
  - TYPE_BINARY
```
public static final int TYPE_BINARY
```
    See Also:
    
    Constant Field Values
  - STRUCTURE_FILE
```
public static final int STRUCTURE_FILE
```
    See Also:
    
    Constant Field Values
  - STRUCTURE_RECORD
```
public static final int STRUCTURE_RECORD
```
    See Also:
    
    Constant Field Values
  - STRUCTURE_PAGE
```
public static final int STRUCTURE_PAGE
```
    See Also:
    
    Constant Field Values
  - MODE_STREAM
```
public static final int MODE_STREAM
```
    See Also:
    
    Constant Field Values
  - MODE_BLOCK
```
public static final int MODE_BLOCK
```
    See Also:
    
    Constant Field Values
  - MODE_COMPRESSED
```
public static final int MODE_COMPRESSED
```
    See Also:
    
    Constant Field Values
  - socket
```
protected Socket socket
```
    The socket used to communicate with the server.
  - in
```
protected LineInputStream in
```
    The socket input stream.
  - out
```
protected CRLFOutputStream out
```
    The socket output stream.
  - connectionTimeout
```
protected int connectionTimeout
```
    The timeout when attempting to connect a socket.
  - timeout
```
protected int timeout
```
    The read timeout on sockets.
  - debug
```
protected boolean debug
```
    If true, print debugging information.
  - dtp
```
protected gnu.inet.ftp.DTP dtp
```
    The current data transfer process in use by this connection.
  - representationType
```
protected int representationType
```
    The current representation type.
  - fileStructure
```
protected int fileStructure
```
    The current file structure type.
  - transferMode
```
protected int transferMode
```
    The current transfer mode.
  - passive
```
protected boolean passive
```
    If true, use passive mode.
- Constructor Detail
  - FTPConnection
```
public FTPConnection(String hostname)
              throws UnknownHostException,
                     IOException
```
    Creates a new connection to the server using the default port.
    
    Parameters:
    
    hostname - the hostname of the server to connect to
    
    Throws:
    
    UnknownHostException
    
    IOException
  - FTPConnection
```
public FTPConnection(String hostname,
                     int port)
              throws UnknownHostException,
                     IOException
```
    Creates a new connection to the server.
    
    Parameters:
    
    hostname - the hostname of the server to connect to
    
    port - the port to connect to(if <=0, use default port)
    
    Throws:
    
    UnknownHostException
    
    IOException
  - FTPConnection
```
public FTPConnection(String hostname,
                     int port,
                     int connectionTimeout,
                     int timeout,
                     boolean debug)
              throws UnknownHostException,
                     IOException
```
    Creates a new connection to the server.
    
    Parameters:
    
    hostname - the hostname of the server to connect to
    
    port - the port to connect to(if <=0, use default port)
    
    connectionTimeout - the connection timeout, in milliseconds
    
    timeout - the I/O timeout, in milliseconds
    
    debug - print debugging information
    
    Throws:
    
    UnknownHostException
    
    IOException
- Method Detail
  - authenticate
```
public boolean authenticate(String username,
                            String password)
                     throws IOException
```
    Authenticate using the specified username and password. If the username suffices for the server, the password will not be used and may be null.
    
    Parameters:
    
    username - the username
    
    password - the optional password
    
    Returns:
    
    true on success, false otherwise
    
    Throws:
    
    IOException
  - starttls
```
public boolean starttls(boolean confidential)
                 throws IOException
```
    Negotiates TLS over the current connection. See IETF draft-murray-auth-ftp-ssl-15.txt for details.
    
    Parameters:
    
    confidential - whether to provide confidentiality for the connection
    
    Throws:
    
    IOException
  - starttls
```
public boolean starttls(boolean confidential,
                        TrustManager tm)
                 throws IOException
```
    Negotiates TLS over the current connection. See IETF draft-murray-auth-ftp-ssl-15.txt for details.
    
    Parameters:
    
    confidential - whether to provide confidentiality for the connection
    
    tm - the trust manager used to validate the server certificate.
    
    Throws:
    
    IOException
  - changeWorkingDirectory
```
public boolean changeWorkingDirectory(String path)
                               throws IOException
```
    Changes directory to the specified path.
    
    Parameters:
    
    path - an absolute or relative pathname
    
    Returns:
    
    true on success, false if the specified path does not exist
    
    Throws:
    
    IOException
  - changeToParentDirectory
```
public boolean changeToParentDirectory()
                                throws IOException
```
    Changes directory to the parent of the current working directory.
    
    Returns:
    
    true on success, false otherwise
    
    Throws:
    
    IOException
  - reinitialize
```
public void reinitialize()
                  throws IOException
```
    Terminates an authenticated login. If file transfer is in progress, it remains active for result response only.
    
    Throws:
    
    IOException
  - logout
```
public void logout()
            throws IOException
```
    Terminates the control connection. The file transfer connection remains open for result response only. This connection is invalid and no further commands may be issued.
    
    Throws:
    
    IOException
  - initialiseDTP
```
protected void initialiseDTP()
                      throws IOException
```
    Initialise the data transfer process.
    
    Throws:
    
    IOException
  - setPassive
```
public void setPassive(boolean flag)
                throws IOException
```
    Set passive mode.
    
    Parameters:
    
    flag - true if we should use passive mode, false otherwise
    
    Throws:
    
    IOException
  - getRepresentationType
```
public int getRepresentationType()
```
    Returns the current representation type of the transfer data.
    
    Returns:
    
    TYPE_ASCII, TYPE_EBCDIC, or TYPE_BINARY
  - setRepresentationType
```
public void setRepresentationType(int type)
                           throws IOException
```
    Sets the desired representation type of the transfer data.
    
    Parameters:
    
    type - TYPE_ASCII, TYPE_EBCDIC, or TYPE_BINARY
    
    Throws:
    
    IOException
  - getFileStructure
```
public int getFileStructure()
```
    Returns the current file structure type.
    
    Returns:
    
    STRUCTURE_FILE, STRUCTURE_RECORD, or STRUCTURE_PAGE
  - setFileStructure
```
public void setFileStructure(int structure)
                      throws IOException
```
    Sets the desired file structure type.
    
    Parameters:
    
    structure - STRUCTURE_FILE, STRUCTURE_RECORD, or STRUCTURE_PAGE
    
    Throws:
    
    IOException
  - getTransferMode
```
public int getTransferMode()
```
    Returns the current transfer mode.
    
    Returns:
    
    MODE_STREAM, MODE_BLOCK, or MODE_COMPRESSED
  - setTransferMode
```
public void setTransferMode(int mode)
                     throws IOException
```
    Sets the desired transfer mode.
    
    Parameters:
    
    mode - MODE_STREAM, MODE_BLOCK, or MODE_COMPRESSED
    
    Throws:
    
    IOException
  - retrieve
```
public InputStream retrieve(String filename)
                     throws IOException
```
    Retrieves the specified file.
    
    Parameters:
    
    filename - the filename of the file to retrieve
    
    Returns:
    
    an InputStream containing the file content
    
    Throws:
    
    IOException
  - store
```
public OutputStream store(String filename)
                   throws IOException
```
    Returns a stream for uploading a file. If a file with the same filename already exists on the server, it will be overwritten.
    
    Parameters:
    
    filename - the name of the file to save the content as
    
    Returns:
    
    an OutputStream to write the file data to
    
    Throws:
    
    IOException
  - append
```
public OutputStream append(String filename)
                    throws IOException
```
    Returns a stream for uploading a file. If a file with the same filename already exists on the server, the content specified will be appended to the existing file.
    
    Parameters:
    
    filename - the name of the file to save the content as
    
    Returns:
    
    an OutputStream to write the file data to
    
    Throws:
    
    IOException
  - allocate
```
public void allocate(long size)
              throws IOException
```
    This command may be required by some servers to reserve sufficient storage to accommodate the new file to be transferred. It should be immediately followed by a store or append.
    
    Parameters:
    
    size - the number of bytes of storage to allocate
    
    Throws:
    
    IOException
  - rename
```
public boolean rename(String oldName,
                      String newName)
               throws IOException
```
    Renames a file.
    
    Parameters:
    
    oldName - the current name of the file
    
    newName - the new name
    
    Returns:
    
    true if successful, false otherwise
    
    Throws:
    
    IOException
  - abort
```
public boolean abort()
              throws IOException
```
    Aborts the transfer in progress.
    
    Returns:
    
    true if a transfer was in progress, false otherwise
    
    Throws:
    
    IOException
  - delete
```
public boolean delete(String filename)
               throws IOException
```
    Causes the file specified to be deleted at the server site.
    
    Parameters:
    
    filename - the file to delete
    
    Throws:
    
    IOException
  - removeDirectory
```
public boolean removeDirectory(String pathname)
                        throws IOException
```
    Causes the directory specified to be deleted. This may be an absolute or relative pathname.
    
    Parameters:
    
    pathname - the directory to delete
    
    Throws:
    
    IOException
  - makeDirectory
```
public boolean makeDirectory(String pathname)
                      throws IOException
```
    Causes the directory specified to be created at the server site. This may be an absolute or relative pathname.
    
    Parameters:
    
    pathname - the directory to create
    
    Throws:
    
    IOException
  - getWorkingDirectory
```
public String getWorkingDirectory()
                           throws IOException
```
    Returns the current working directory.
    
    Throws:
    
    IOException
  - list
```
public InputStream list(String pathname)
                 throws IOException
```
    Returns a listing of information about the specified pathname. If the pathname specifies a directory or other group of files, the server should transfer a list of files in the specified directory. If the pathname specifies a file then the server should send current information on the file. A null argument implies the user's current working or default directory.
    
    Parameters:
    
    pathname - the context pathname, or null
    
    Throws:
    
    IOException
  - nameList
```
public List nameList(String pathname)
              throws IOException
```
    Returns a directory listing. The pathname should specify a directory or other system-specific file group descriptor; a null argument implies the user's current working or default directory.
    
    Parameters:
    
    pathname - the directory pathname, or null
    
    Returns:
    
    a list of filenames(strings)
    
    Throws:
    
    IOException
  - system
```
public String system()
              throws IOException
```
    Returns the type of operating system at the server.
    
    Throws:
    
    IOException
  - noop
```
public void noop()
          throws IOException
```
    Does nothing. This method can be used to ensure that the connection does not time out.
    
    Throws:
    
    IOException
  - send
```
protected void send(String cmd)
             throws IOException
```
    Sends the specified command line to the server. The CRLF sequence is automatically appended.
    
    Parameters:
    
    cmd - the command line to send
    
    Throws:
    
    IOException
  - getResponse
```
protected FTPResponse getResponse()
                           throws IOException
```
    Reads the next response from the server. If the server sends the "transfer complete" code, this is handled here, and the next response is passed to the caller.
    
    Throws:
    
    IOException
  - readResponse
```
protected FTPResponse readResponse()
                            throws IOException
```
    Reads and parses the next response from the server.
    
    Throws:
    
    IOException

Class FTPConnection

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FTP_PORT

FTP_DATA_PORT

USER

PASS

ACCT

CWD

CDUP

SMNT

REIN

QUIT

PORT

PASV

TYPE

STRU

MODE

RETR

STOR

STOU

APPE

ALLO

REST

RNFR

RNTO

ABOR

DELE

RMD

MKD

PWD

LIST

NLST

SITE

SYST

STAT

HELP

NOOP

AUTH

PBSZ

PROT

CCC

TLS

TYPE_ASCII

TYPE_EBCDIC

TYPE_BINARY

STRUCTURE_FILE

STRUCTURE_RECORD

STRUCTURE_PAGE

MODE_STREAM

MODE_BLOCK

MODE_COMPRESSED

socket

in

out

connectionTimeout

timeout

debug

dtp

representationType

fileStructure

transferMode

passive

Constructor Detail

FTPConnection

FTPConnection

FTPConnection

Method Detail

authenticate

starttls

starttls

changeWorkingDirectory

changeToParentDirectory

reinitialize

logout

initialiseDTP

setPassive