public class FTPClient extends FTP implements Configurable
SocketClient
, you must first connect to the server with connect
before
doing anything, and finally disconnect
after you're completely finished interacting with the server.
Then you need to check the FTP reply code to see if the connection was successful. For example:
FTPClient ftp = new FTPClient(); FTPClientConfig config = new FTPClientConfig(); config.setXXX(YYY); // change required options // for example config.setServerTimeZoneId("Pacific/Pitcairn") ftp.configure(config ); boolean error = false; try { int reply; String server = "ftp.example.com"; ftp.connect(server); System.out.println("Connected to " + server + "."); System.out.print(ftp.getReplyString()); // After connection attempt, you should check the reply code to verify // success. reply = ftp.getReplyCode(); if(!FTPReply.isPositiveCompletion(reply)) { ftp.disconnect(); System.err.println("FTP server refused connection."); System.exit(1); } ... // transfer files ftp.logout(); } catch(IOException e) { error = true; e.printStackTrace(); } finally { if(ftp.isConnected()) { try { ftp.disconnect(); } catch(IOException ioe) { // do nothing } } System.exit(error ? 1 : 0); }
Immediately after connecting is the only real time you need to check the reply code (because connect is of type void). The convention for all the FTP command
methods in FTPClient is such that they either return a boolean value or some other value. The boolean methods return true on a successful completion reply
from the FTP server and false on a reply resulting in an error condition or failure. The methods returning a value other than boolean return a value
containing the higher level data produced by the FTP command, or null if a reply resulted in an error condition or failure. If you want to access the exact
FTP reply code causing a success or failure, you must call getReplyCode
after a success or failure.
The default settings for FTPClient are for it to use FTP.ASCII_FILE_TYPE
, FTP.NON_PRINT_TEXT_FORMAT
,
FTP.STREAM_TRANSFER_MODE
, and FTP.FILE_STRUCTURE
. The only file types directly supported are FTP.ASCII_FILE_TYPE
and FTP.BINARY_FILE_TYPE
. Because there are at least 4 different EBCDIC encodings, we have opted not to provide direct support for EBCDIC. To
transfer EBCDIC and other unsupported file types you must create your own filter InputStreams and OutputStreams and wrap them around the streams returned or
required by the FTPClient methods. FTPClient uses the NetASCII
filter streams to provide transparent handling of ASCII files.
We will consider incorporating EBCDIC support if there is enough demand.
FTP.NON_PRINT_TEXT_FORMAT
, FTP.STREAM_TRANSFER_MODE
, and FTP.FILE_STRUCTURE
are the only supported formats,
transfer modes, and file structures.
Because the handling of sockets on different platforms can differ significantly, the FTPClient automatically issues a new PORT (or EPRT) command prior to every transfer requiring that the server connect to the client's data port. This ensures identical problem-free behavior on Windows, Unix, and Macintosh platforms. Additionally, it relieves programmers from having to issue the PORT (or EPRT) command themselves and dealing with platform dependent issues.
Additionally, for security purposes, all data connections to the client are verified to ensure that they originated from the intended party (host and port).
If a data connection is initiated by an unexpected party, the command will close the socket and throw an IOException. You may disable this behavior with
setRemoteVerificationEnabled()
.
You should keep in mind that the FTP server may choose to prematurely close a connection if the client has been idle for longer than a given time period
(usually 900 seconds). The FTPClient class will detect a premature FTP server connection closing when it receives a
FTPReply.SERVICE_NOT_AVAILABLE
response to a command. When that occurs, the FTP class
method encountering that reply will throw an FTPConnectionClosedException
. FTPConnectionClosedException
is a
subclass of IOException
and therefore need not be caught separately, but if you are going to catch it separately, its catch block must appear
before the more general IOException
catch block. When you encounter an FTPConnectionClosedException
, you
must disconnect the connection with disconnect()
to properly clean up the system resources used by FTPClient. Before disconnecting, you
may check the last reply code and text with getReplyCode
,
getReplyString
, and getReplyStrings
. You may
avoid server disconnections while the client is idle by periodically sending NOOP commands to the server.
Rather than list it separately for each method, we mention here that every method communicating with the server and throwing an IOException can also throw a
MalformedServerReplyException
, which is a subclass of IOException. A MalformedServerReplyException will be thrown when the
reply received from the server deviates enough from the protocol specification that it cannot be interpreted in a useful manner despite attempts to be as
lenient as possible.
Listing API Examples Both paged and unpaged examples of directory listings are available, as follows:
Unpaged (whole list) access, using a parser accessible by auto-detect:
FTPClient f = new FTPClient(); f.connect(server); f.login(username, password); FTPFile[] files = f.listFiles(directory);
Paged access, using a parser not accessible by auto-detect. The class defined in the first parameter of initateListParsing should be derived from org.apache.commons.net.FTPFileEntryParser:
FTPClient f = new FTPClient(); f.connect(server); f.login(username, password); FTPListParseEngine engine = f.initiateListParsing("com.whatever.YourOwnParser", directory); while (engine.hasNext()) { FTPFile[] files = engine.getNext(25); // "page size" you want // do whatever you want with these files, display them, etc. // expensive FTPFile objects not created until needed. }
Paged access, using a parser accessible by auto-detect:
FTPClient f = new FTPClient(); f.connect(server); f.login(username, password); FTPListParseEngine engine = f.initiateListParsing(directory); while (engine.hasNext()) { FTPFile[] files = engine.getNext(25); // "page size" you want // do whatever you want with these files, display them, etc. // expensive FTPFile objects not created until needed. }
For examples of using FTPClient on servers whose directory listings
MM d yyyy
FTPClientConfig
.
Control channel keep-alive feature:
Please note: this does not apply to the methods where the user is responsible for writing or reading the data stream, i.e.
retrieveFileStream(String)
, storeFileStream(String)
and the other xxxFileStream methods
During file transfers, the data connection is busy, but the control connection is idle. FTP servers know that the control connection is in use, so won't
close it through lack of activity, but it's a lot harder for network routers to know that the control and data connections are associated with each other.
Some routers may treat the control connection as idle, and disconnect it if the transfer over the data connection takes longer than the allowable idle time
for the router.
One solution to this is to send a safe command (i.e. NOOP) over the control connection to reset the router's idle timer. This is enabled as follows:
// Set timeout to 5 minutes ftpClient.setControlKeepAliveTimeout(Duration.ofMinutes(5));This will cause the file upload/download methods to send a NOOP approximately every 5 minutes. The following public methods support this:
retrieveFile(String, OutputStream)
appendFile(String, InputStream)
storeFile(String, InputStream)
storeUniqueFile(InputStream)
storeUniqueFileStream(String)
retrieveFileStream(String)
,
storeFileStream(String)
and the other xxxFileStream methods. In such cases, the user is responsible for keeping the control connection alive if
necessary.
The implementation currently uses a CopyStreamListener
which is passed to the
Util.copyStream(InputStream, OutputStream, int, long, CopyStreamListener, boolean)
method, so the timing is partially dependent on how long each
block transfer takes.
This keep-alive feature is optional; if it does not help or causes problems then don't use it.
Modifier and Type | Class and Description |
---|---|
static interface |
FTPClient.HostnameResolver
Strategy interface for updating host names received from FTP server for passive NAT workaround.
|
static class |
FTPClient.NatServerResolverImpl
Default strategy for passive NAT workaround (site-local replies are replaced.)
|
Modifier and Type | Field and Description |
---|---|
static int |
ACTIVE_LOCAL_DATA_CONNECTION_MODE
A constant indicating the FTP session is expecting all transfers to occur between the client (local) and server and that the server should connect to the
client's data port to initiate a data transfer.
|
static int |
ACTIVE_REMOTE_DATA_CONNECTION_MODE
A constant indicating the FTP session is expecting all transfers to occur between two remote servers and that the server the client is connected to
should connect to the other server's data port to initiate a data transfer.
|
static String |
FTP_IP_ADDRESS_FROM_PASV_RESPONSE
The system property that defines the default for
isIpAddressFromPasvResponse() . |
static String |
FTP_SYSTEM_TYPE
The system property ("org.apache.commons.net.ftp.systemType") which can be used to override the system type.
If defined, the value will be used to create any automatically created parsers. |
static String |
FTP_SYSTEM_TYPE_DEFAULT
The system property ("org.apache.commons.net.ftp.systemType.default") which can be used as the default system type.
If defined, the value will be used if the SYST command fails. |
static int |
PASSIVE_LOCAL_DATA_CONNECTION_MODE
A constant indicating the FTP session is expecting all transfers to occur between the client (local) and server and that the server is in passive mode,
requiring the client to connect to the server's data port to initiate a transfer.
|
static int |
PASSIVE_REMOTE_DATA_CONNECTION_MODE
A constant indicating the FTP session is expecting all transfers to occur between two remote servers and that the server the client is connected to is in
passive mode, requiring the other server to connect to the first server's data port to initiate a data transfer.
|
static String |
SYSTEM_TYPE_PROPERTIES
The name of an optional systemType properties file ("/systemType.properties"), which is loaded using
Class.getResourceAsStream(String) .The entries are the systemType (as determined by getSystemType() ) and the values are the replacement type or parserClass, which is passed
to FTPFileEntryParserFactory.createFileEntryParser(String) .For example: |
_commandSupport_, _controlEncoding, _controlInput_, _controlOutput_, _newReplyString, _replyCode, _replyLines, _replyString, ASCII_FILE_TYPE, BINARY_FILE_TYPE, BLOCK_TRANSFER_MODE, CARRIAGE_CONTROL_TEXT_FORMAT, COMPRESSED_TRANSFER_MODE, DEFAULT_CONTROL_ENCODING, DEFAULT_DATA_PORT, DEFAULT_PORT, EBCDIC_FILE_TYPE, FILE_STRUCTURE, LOCAL_FILE_TYPE, NON_PRINT_TEXT_FORMAT, PAGE_STRUCTURE, RECORD_STRUCTURE, REPLY_CODE_LEN, STREAM_TRANSFER_MODE, strictMultilineParsing, TELNET_TEXT_FORMAT
_defaultPort_, _hostname_, _input_, _output_, _serverSocketFactory_, _socket_, _socketFactory_, _timeout_, connectTimeout, NETASCII_EOL
Constructor and Description |
---|
FTPClient()
Default FTPClient constructor.
|
Modifier and Type | Method and Description |
---|---|
protected void |
_connectAction_()
Initiates control connections and gets initial reply.
|
protected void |
_connectAction_(Reader socketIsReader)
Initiates control connections and gets initial reply.
|
protected Socket |
_openDataConnection_(FTPCmd command,
String arg)
Establishes a data connection with the FTP server, returning a Socket for the connection if successful.
|
protected Socket |
_openDataConnection_(int command,
String arg)
Deprecated.
(3.3) Use
_openDataConnection_(FTPCmd, String) instead |
protected Socket |
_openDataConnection_(String command,
String arg)
Establishes a data connection with the FTP server, returning a Socket for the connection if successful.
|
protected void |
_parseExtendedPassiveModeReply(String reply) |
protected void |
_parsePassiveModeReply(String reply) |
protected boolean |
_retrieveFile(String command,
String remote,
OutputStream local) |
protected InputStream |
_retrieveFileStream(String command,
String remote) |
protected boolean |
_storeFile(String command,
String remote,
InputStream local) |
protected OutputStream |
_storeFileStream(String command,
String remote) |
boolean |
abort()
Abort a transfer in progress.
|
boolean |
allocate(int bytes)
Reserve a number of bytes on the server for the next file transfer.
|
boolean |
allocate(int bytes,
int recordSize)
Reserve space on the server for the next file transfer.
|
boolean |
allocate(long bytes)
Reserve a number of bytes on the server for the next file transfer.
|
boolean |
allocate(long bytes,
int recordSize)
Reserve space on the server for the next file transfer.
|
boolean |
appendFile(String remote,
InputStream local)
Appends to a file on the server with the given name, taking input from the given InputStream.
|
OutputStream |
appendFileStream(String remote)
Returns an OutputStream through which data can be written to append to a file on the server with the given name.
|
boolean |
changeToParentDirectory()
Change to the parent directory of the current working directory.
|
boolean |
changeWorkingDirectory(String pathname)
Change the current working directory of the FTP session.
|
boolean |
completePendingCommand()
There are a few FTPClient methods that do not complete the entire sequence of FTP commands to complete a transaction.
|
void |
configure(FTPClientConfig config)
Implementation of the
Configurable interface. |
boolean |
deleteFile(String pathname)
Deletes a file on the FTP server.
|
void |
disconnect()
Closes the connection to the FTP server and restores connection parameters to the default values.
|
boolean |
doCommand(String command,
String params)
Issue a command and wait for the reply.
|
String[] |
doCommandAsStrings(String command,
String params)
Issue a command and wait for the reply, returning it as an array of strings.
|
void |
enterLocalActiveMode()
Set the current data connection mode to
ACTIVE_LOCAL_DATA_CONNECTION_MODE . |
void |
enterLocalPassiveMode()
Set the current data connection mode to
PASSIVE_LOCAL_DATA_CONNECTION_MODE . |
boolean |
enterRemoteActiveMode(InetAddress host,
int port)
Set the current data connection mode to
ACTIVE_REMOTE_DATA_CONNECTION . |
boolean |
enterRemotePassiveMode()
Set the current data connection mode to
PASSIVE_REMOTE_DATA_CONNECTION_MODE . |
boolean |
features()
Queries the server for supported features.
|
String |
featureValue(String feature)
Queries the server for a supported feature, and returns the its value (if any).
|
String[] |
featureValues(String feature)
Queries the server for a supported feature, and returns its values (if any).
|
boolean |
getAutodetectUTF8()
Tells if automatic server encoding detection is enabled or disabled.
|
int |
getBufferSize()
Retrieve the current internal buffer size for buffered data streams.
|
int |
getControlKeepAliveReplyTimeout()
Deprecated.
|
Duration |
getControlKeepAliveReplyTimeoutDuration()
Gets how long to wait for control keep-alive message replies.
|
long |
getControlKeepAliveTimeout()
Deprecated.
|
Duration |
getControlKeepAliveTimeoutDuration()
Gets the time to wait between sending control connection keepalive messages when processing file upload or download.
|
CopyStreamListener |
getCopyStreamListener()
Obtain the currently active listener.
|
int[] |
getCslDebug()
Deprecated.
3.7 For testing only; may be dropped or changed at any time
|
int |
getDataConnectionMode()
Returns the current data connection mode (one of the
_DATA_CONNECTION_MODE constants. |
Duration |
getDataTimeout()
Gets the timeout to use when reading from the data connection.
|
protected String |
getListArguments(String pathname) |
boolean |
getListHiddenFiles() |
String |
getModificationTime(String pathname)
Issue the FTP MDTM command (not supported by all servers) to retrieve the last modification time of a file.
|
String |
getPassiveHost()
Returns the hostname or IP address (in the form of a string) returned by the server when entering passive mode.
|
InetAddress |
getPassiveLocalIPAddress()
Set the local IP address in passive mode.
|
int |
getPassivePort()
If in passive mode, returns the data port of the passive host.
|
int |
getReceiveDataSocketBufferSize()
Retrieve the value to be used for the data socket SO_RCVBUF option.
|
long |
getRestartOffset()
Fetches the restart offset.
|
int |
getSendDataSocketBufferSize()
Retrieve the value to be used for the data socket SO_SNDBUF option.
|
String |
getSize(String pathname)
Issue the FTP SIZE command to the server for a given pathname.
|
String |
getStatus()
Issue the FTP STAT command to the server.
|
String |
getStatus(String pathname)
Issue the FTP STAT command to the server for a given pathname.
|
String |
getSystemName()
Deprecated.
use
getSystemType() instead |
String |
getSystemType()
Fetches the system type from the server and returns the string.
|
boolean |
hasFeature(FTPCmd feature)
Queries the server for a supported feature.
|
boolean |
hasFeature(String feature)
Queries the server for a supported feature.
|
boolean |
hasFeature(String feature,
String value)
Queries the server for a supported feature with particular value, for example "AUTH SSL" or "AUTH TLS".
|
FTPListParseEngine |
initiateListParsing()
Using the default autodetect mechanism, initialize an FTPListParseEngine object containing a raw file information for the current working directory on
the server This information is obtained through the LIST command.
|
FTPListParseEngine |
initiateListParsing(String pathname)
Using the default autodetect mechanism, initialize an FTPListParseEngine object containing a raw file information for the supplied directory.
|
FTPListParseEngine |
initiateListParsing(String parserKey,
String pathname)
Using the supplied parser key, initialize an FTPListParseEngine object containing a raw file information for the supplied directory.
|
FTPListParseEngine |
initiateMListParsing()
Initiate list parsing for MLSD listings in the current working directory.
|
FTPListParseEngine |
initiateMListParsing(String pathname)
Initiate list parsing for MLSD listings.
|
boolean |
isIpAddressFromPasvResponse()
Returns, whether the IP address from the server's response should be used.
|
boolean |
isRemoteVerificationEnabled()
Return whether or not verification of the remote host participating in data connections is enabled.
|
boolean |
isUseEPSVwithIPv4()
Whether should attempt to use EPSV with IPv4.
|
FTPFile[] |
listDirectories()
Using the default system autodetect mechanism, obtain a list of directories contained in the current working directory.
|
FTPFile[] |
listDirectories(String parent)
Using the default system autodetect mechanism, obtain a list of directories contained in the specified directory.
|
FTPFile[] |
listFiles()
Using the default system autodetect mechanism, obtain a list of file information for the current working directory.
|
FTPFile[] |
listFiles(String pathname)
Using the default system autodetect mechanism, obtain a list of file information for the current working directory or for just a single file.
|
FTPFile[] |
listFiles(String pathname,
FTPFileFilter filter)
Version of
listFiles(String) which allows a filter to be provided. |
String |
listHelp()
Fetches the system help information from the server and returns the full string.
|
String |
listHelp(String command)
Fetches the help information for a given command from the server and returns the full string.
|
String[] |
listNames()
Obtain a list of file names in the current working directory This information is obtained through the NLST command.
|
String[] |
listNames(String pathname)
Obtain a list of file names in a directory (or just the name of a given file, which is not particularly useful).
|
boolean |
login(String username,
String password)
Login to the FTP server using the provided username and password.
|
boolean |
login(String username,
String password,
String account)
Login to the FTP server using the provided username, password, and account.
|
boolean |
logout()
Logout of the FTP server by sending the QUIT command.
|
boolean |
makeDirectory(String pathname)
Creates a new subdirectory on the FTP server in the current directory (if a relative pathname is given) or where specified (if an absolute pathname is
given).
|
Calendar |
mdtmCalendar(String pathname)
Issue the FTP MDTM command (not supported by all servers) to retrieve the last modification time of a file.
|
FTPFile |
mdtmFile(String pathname)
Issue the FTP MDTM command (not supported by all servers) to retrieve the last modification time of a file.
|
Instant |
mdtmInstant(String pathname)
Issue the FTP MDTM command (not supported by all servers) to retrieve the last modification time of a file.
|
FTPFile[] |
mlistDir()
Generate a directory listing for the current directory using the MLSD command.
|
FTPFile[] |
mlistDir(String pathname)
Generate a directory listing using the MLSD command.
|
FTPFile[] |
mlistDir(String pathname,
FTPFileFilter filter)
Generate a directory listing using the MLSD command.
|
FTPFile |
mlistFile(String pathname)
Get file details using the MLST command
|
String |
printWorkingDirectory()
Returns the pathname of the current working directory.
|
boolean |
reinitialize()
Reinitialize the FTP session.
|
boolean |
remoteAppend(String fileName)
Initiate a server to server file transfer.
|
boolean |
remoteRetrieve(String fileName)
Initiate a server to server file transfer.
|
boolean |
remoteStore(String fileName)
Initiate a server to server file transfer.
|
boolean |
remoteStoreUnique()
Initiate a server to server file transfer.
|
boolean |
remoteStoreUnique(String fileName)
Initiate a server to server file transfer.
|
boolean |
removeDirectory(String pathname)
Removes a directory on the FTP server (if empty).
|
boolean |
rename(String from,
String to)
Renames a remote file.
|
protected boolean |
restart(long offset)
Restart a
STREAM_TRANSFER_MODE file transfer starting from the given offset. |
boolean |
retrieveFile(String remote,
OutputStream local)
Retrieves a named file from the server and writes it to the given OutputStream.
|
InputStream |
retrieveFileStream(String remote)
Returns an InputStream from which a named file from the server can be read.
|
boolean |
sendNoOp()
Sends a NOOP command to the FTP server.
|
boolean |
sendSiteCommand(String arguments)
Send a site specific command.
|
void |
setActiveExternalIPAddress(String ipAddress)
Set the external IP address in active mode.
|
void |
setActivePortRange(int minPort,
int maxPort)
Set the client side port range in active mode.
|
void |
setAutodetectUTF8(boolean autodetect)
Enables or disables automatic server encoding detection (only UTF-8 supported).
|
void |
setBufferSize(int bufSize)
Set the internal buffer size for buffered data streams.
|
void |
setControlKeepAliveReplyTimeout(Duration timeout)
Sets how long to wait for control keep-alive message replies.
|
void |
setControlKeepAliveReplyTimeout(int timeoutMillis)
Deprecated.
|
void |
setControlKeepAliveTimeout(Duration controlIdle)
Sets the time to wait between sending control connection keepalive messages when processing file upload or download.
|
void |
setControlKeepAliveTimeout(long controlIdleSeconds)
Deprecated.
|
void |
setCopyStreamListener(CopyStreamListener listener)
Set the listener to be used when performing store/retrieve operations.
|
void |
setDataTimeout(Duration timeout)
Sets the timeout to use when reading from the data connection.
|
void |
setDataTimeout(int timeoutMillis)
Deprecated.
|
boolean |
setFileStructure(int structure)
Sets the file structure.
|
boolean |
setFileTransferMode(int mode)
Sets the transfer mode.
|
boolean |
setFileType(int fileType)
Sets the file type to be transferred.
|
boolean |
setFileType(int fileType,
int formatOrByteSize)
Sets the file type to be transferred and the format.
|
void |
setIpAddressFromPasvResponse(boolean usingIpAddressFromPasvResponse)
Sets whether the IP address from the server's response should be used.
|
void |
setListHiddenFiles(boolean listHiddenFiles)
You can set this to true if you would like to get hidden files when
listFiles() too. |
boolean |
setModificationTime(String pathname,
String timeval)
Issue the FTP MFMT command (not supported by all servers) which sets the last modified time of a file.
|
void |
setParserFactory(FTPFileEntryParserFactory parserFactory)
set the factory used for parser creation to the supplied factory object.
|
void |
setPassiveLocalIPAddress(InetAddress inetAddress)
Set the local IP address to use in passive mode.
|
void |
setPassiveLocalIPAddress(String ipAddress)
Set the local IP address to use in passive mode.
|
void |
setPassiveNatWorkaround(boolean enabled)
Deprecated.
(3.6) use
setPassiveNatWorkaroundStrategy(HostnameResolver) instead |
void |
setPassiveNatWorkaroundStrategy(FTPClient.HostnameResolver resolver)
Sets the workaround strategy to replace the PASV mode reply addresses.
|
void |
setReceieveDataSocketBufferSize(int bufSize)
Sets the value to be used for the data socket SO_RCVBUF option.
|
void |
setRemoteVerificationEnabled(boolean enable)
Enable or disable verification that the remote host taking part of a data connection is the same as the host to which the control connection is attached.
|
void |
setReportActiveExternalIPAddress(String ipAddress)
Sets the external IP address to report in EPRT/PORT commands in active mode.
|
void |
setRestartOffset(long offset)
Sets the restart offset for file transfers.
|
void |
setSendDataSocketBufferSize(int bufSize)
Sets the value to be used for the data socket SO_SNDBUF option.
|
void |
setUseEPSVwithIPv4(boolean selected)
Set whether to use EPSV with IPv4.
|
boolean |
storeFile(String remote,
InputStream local)
Stores a file on the server using the given name and taking input from the given InputStream.
|
OutputStream |
storeFileStream(String remote)
Returns an OutputStream through which data can be written to store a file on the server using the given name.
|
boolean |
storeUniqueFile(InputStream local)
Stores a file on the server using a unique name assigned by the server and taking input from the given InputStream.
|
boolean |
storeUniqueFile(String remote,
InputStream local)
Stores a file on the server using a unique name derived from the given name and taking input from the given InputStream.
|
OutputStream |
storeUniqueFileStream()
Returns an OutputStream through which data can be written to store a file on the server using a unique name assigned by the server.
|
OutputStream |
storeUniqueFileStream(String remote)
Returns an OutputStream through which data can be written to store a file on the server using a unique name derived from the given name.
|
boolean |
structureMount(String pathname)
Issue the FTP SMNT command.
|
__getReplyNoReport, __noop, abor, acct, allo, allo, allo, allo, appe, cdup, cwd, dele, eprt, epsv, feat, getCommandSupport, getControlEncoding, getReply, getReplyCode, getReplyString, getReplyStrings, help, help, isStrictMultilineParsing, isStrictReplyParsing, list, list, mdtm, mfmt, mkd, mlsd, mlsd, mlst, mlst, mode, nlst, nlst, noop, pass, pasv, port, pwd, quit, rein, rest, retr, rmd, rnfr, rnto, sendCommand, sendCommand, sendCommand, sendCommand, sendCommand, sendCommand, setControlEncoding, setStrictMultilineParsing, setStrictReplyParsing, site, size, smnt, stat, stat, stor, stou, stou, stru, syst, type, type, user
addProtocolCommandListener, applySocketAttributes, connect, connect, connect, connect, connect, connect, createCommandSupport, fireCommandSent, fireReplyReceived, getCharset, getCharsetName, getConnectTimeout, getDefaultPort, getDefaultTimeout, getKeepAlive, getLocalAddress, getLocalPort, getProxy, getReceiveBufferSize, getRemoteAddress, getRemotePort, getSendBufferSize, getServerSocketFactory, getSoLinger, getSoTimeout, getTcpNoDelay, isAvailable, isConnected, removeProtocolCommandListener, setCharset, setConnectTimeout, setDefaultPort, setDefaultTimeout, setKeepAlive, setProxy, setReceiveBufferSize, setSendBufferSize, setServerSocketFactory, setSocketFactory, setSoLinger, setSoTimeout, setTcpNoDelay, verifyRemote
public static final String FTP_SYSTEM_TYPE
public static final String FTP_SYSTEM_TYPE_DEFAULT
public static final String FTP_IP_ADDRESS_FROM_PASV_RESPONSE
isIpAddressFromPasvResponse()
. This property, if present, configures the default for the
following: If the client receives the servers response for a PASV request, then that response will contain an IP address. If this property is true, then
the client will use that IP address, as requested by the server. This is compatible to version 3.8.0
, and before. If this property is false, or
absent, then the client will ignore that IP address, and instead use the remote address of the control connection.isIpAddressFromPasvResponse()
,
setIpAddressFromPasvResponse(boolean)
,
Constant Field Valuespublic static final String SYSTEM_TYPE_PROPERTIES
Class.getResourceAsStream(String)
.getSystemType()
) and the values are the replacement type or parserClass, which is passed
to FTPFileEntryParserFactory.createFileEntryParser(String)
.Plan 9=Unix OS410=org.apache.commons.net.ftp.parser.OS400FTPEntryParser
public static final int ACTIVE_LOCAL_DATA_CONNECTION_MODE
public static final int ACTIVE_REMOTE_DATA_CONNECTION_MODE
public static final int PASSIVE_LOCAL_DATA_CONNECTION_MODE
public static final int PASSIVE_REMOTE_DATA_CONNECTION_MODE
public FTPClient()
ACTIVE_LOCAL_DATA_CONNECTION_MODE
,
the file type set to FTP.ASCII_FILE_TYPE
, the file format set to FTP.NON_PRINT_TEXT_FORMAT
, the file structure set to
FTP.FILE_STRUCTURE
, and the transfer mode set to FTP.STREAM_TRANSFER_MODE
.
The list parsing auto-detect feature can be configured to use lenient future dates (short dates may be up to one day in the future) as follows:
FTPClient ftp = new FTPClient(); FTPClientConfig config = new FTPClientConfig(); config.setLenientFutureDates(true); ftp.configure(config);
protected void _connectAction_() throws IOException
FTP
FTP._controlInput_
and FTP._controlOutput_
._connectAction_
in class FTP
IOException
- (SocketException) if a problem occurs with the socketprotected void _connectAction_(Reader socketIsReader) throws IOException
FTP
FTP._controlInput_
and FTP._controlOutput_
._connectAction_
in class FTP
socketIsReader
- the reader to reuse (if non-null)IOException
- on errorprotected Socket _openDataConnection_(FTPCmd command, String arg) throws IOException
setRestartOffset(long)
, a REST command is issued to the server with the offset as an argument before establishing the data connection. Active
mode connections also cause a local PORT command to be issued.command
- The int representation of the FTP command to send.arg
- The arguments to the FTP command. If this parameter is set to null, then the command is sent with no argument.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.@Deprecated protected Socket _openDataConnection_(int command, String arg) throws IOException
_openDataConnection_(FTPCmd, String)
insteadsetRestartOffset(long)
, a REST command is issued to the server with the offset as an argument before establishing the data connection. Active
mode connections also cause a local PORT command to be issued.command
- The int representation of the FTP command to send.arg
- The arguments to the FTP command. If this parameter is set to null, then the command is sent with no argument.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.protected Socket _openDataConnection_(String command, String arg) throws IOException
setRestartOffset(long)
, a REST command is issued to the server with the offset as an argument before establishing the data connection. Active
mode connections also cause a local PORT command to be issued.command
- The text representation of the FTP command to send.arg
- The arguments to the FTP command. If this parameter is set to null, then the command is sent with no argument.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.protected void _parseExtendedPassiveModeReply(String reply) throws MalformedServerReplyException
MalformedServerReplyException
protected void _parsePassiveModeReply(String reply) throws MalformedServerReplyException
reply
- the reply to parseMalformedServerReplyException
- if the server reply does not match (n,n,n,n),(n),(n)protected boolean _retrieveFile(String command, String remote, OutputStream local) throws IOException
command
- the command to getremote
- the remote file namelocal
- The local OutputStream to which to write the file.IOException
- on errorprotected InputStream _retrieveFileStream(String command, String remote) throws IOException
command
- the command to sendremote
- the remote file nameIOException
- on errorprotected boolean _storeFile(String command, String remote, InputStream local) throws IOException
command
- the command to sendremote
- the remote file namelocal
- The local InputStream from which to read the data to be written/appended to the remote file.IOException
- on errorprotected OutputStream _storeFileStream(String command, String remote) throws IOException
command
- the command to sendremote
- the remote file nameIOException
- on errorpublic boolean abort() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean allocate(int bytes) throws IOException
bytes
- The number of bytes which the server should allocate.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean allocate(int bytes, int recordSize) throws IOException
bytes
- The number of bytes which the server should allocate.recordSize
- The size of a file record.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean allocate(long bytes) throws IOException
bytes
- The number of bytes which the server should allocate.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean allocate(long bytes, int recordSize) throws IOException
bytes
- The number of bytes which the server should allocate.recordSize
- The size of a file record.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean appendFile(String remote, InputStream local) throws IOException
remote
- The name of the remote file.local
- The local InputStream from which to read the data to be appended to the remote file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some
other reason causing the server to send FTP reply code 421. This exception may be caught either as
an IOException or independently as itself.CopyStreamException
- If an I/O error occurs while actually transferring the file. The CopyStreamException allows you to
determine the number of bytes transferred and the IOException causing the error. This exception may
be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the
server.public OutputStream appendFileStream(String remote) throws IOException
To finalize the file transfer you must call completePendingCommand
and check its return value to verify success.
If this is not done, subsequent commands may behave unexpectedly.
remote
- The name of the remote file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean changeToParentDirectory() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean changeWorkingDirectory(String pathname) throws IOException
pathname
- The new current working directory.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean completePendingCommand() throws IOException
For example,
InputStream input; OutputStream output; input = new FileInputStream("foobaz.txt"); output = ftp.storeFileStream("foobar.txt") if(!FTPReply.isPositiveIntermediate(ftp.getReplyCode())) { input.close(); output.close(); ftp.logout(); ftp.disconnect(); System.err.println("File transfer failed."); System.exit(1); } Util.copyStream(input, output); input.close(); output.close(); // Must call completePendingCommand() to finish command. if(!ftp.completePendingCommand()) { ftp.logout(); ftp.disconnect(); System.err.println("File transfer failed."); System.exit(1); }
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public void configure(FTPClientConfig config)
Configurable
interface. In the case of this class, configuring merely makes the config object available for
the factory methods that construct parsers.configure
in interface Configurable
config
- FTPClientConfig
object used to provide non-standard configurations to the parser.public boolean deleteFile(String pathname) throws IOException
pathname
- The pathname of the file to be deleted.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public void disconnect() throws IOException
disconnect
in class FTP
IOException
- If an error occurs while disconnecting.public boolean doCommand(String command, String params) throws IOException
Should only be used with commands that return replies on the command channel - do not use for LIST, NLST, MLSD etc.
command
- The command to invokeparams
- The parameters string, may be null
FTP.getReplyCode()
or FTP.getReplyString()
to get the reason.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public String[] doCommandAsStrings(String command, String params) throws IOException
Should only be used with commands that return replies on the command channel - do not use for LIST, NLST, MLSD etc.
command
- The command to invokeparams
- The parameters string, may be null
null
if the command failed, in which case call FTP.getReplyCode()
or FTP.getReplyString()
to get the
reason.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public void enterLocalActiveMode()
ACTIVE_LOCAL_DATA_CONNECTION_MODE
. No communication with the FTP server is conducted, but this
causes all future data transfers to require the FTP server to connect to the client's data port. Additionally, to accommodate differences between socket
implementations on different platforms, this method causes the client to issue a PORT command before every data transfer.public void enterLocalPassiveMode()
PASSIVE_LOCAL_DATA_CONNECTION_MODE
. Use this method only for data transfers between the client and
server. This method causes a PASV (or EPSV) command to be issued to the server before the opening of every data connection, telling the server to open a
data port to which the client will connect to conduct data transfers. The FTPClient will stay in PASSIVE_LOCAL_DATA_CONNECTION_MODE
until
the mode is changed by calling some other method such as enterLocalActiveMode()
N.B. currently calling any connect method will reset the mode to ACTIVE_LOCAL_DATA_CONNECTION_MODE.
public boolean enterRemoteActiveMode(InetAddress host, int port) throws IOException
ACTIVE_REMOTE_DATA_CONNECTION
. Use this method only for server to server data transfers. This
method issues a PORT command to the server, indicating the other server and port to which it should connect for data transfers. You must call this method
before EVERY server to server transfer attempt. The FTPClient will NOT automatically continue to issue PORT commands. You also must remember to call
enterLocalActiveMode()
if you wish to return to the normal data connection mode.host
- The passive mode server accepting connections for data transfers.port
- The passive mode server's data port.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean enterRemotePassiveMode() throws IOException
PASSIVE_REMOTE_DATA_CONNECTION_MODE
. Use this method only for server to server data transfers.
This method issues a PASV command to the server, telling it to open a data port to which the active server will connect to conduct data transfers. You
must call this method before EVERY server to server transfer attempt. The FTPClient will NOT automatically continue to issue PASV commands. You also must
remember to call enterLocalActiveMode()
if you wish to return to the normal data connection mode.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean features() throws IOException
C> feat S> 211-Extensions supported: S> MLST size*;create;modify*;perm;media-type S> SIZE S> COMPRESSION S> MDTM S> 211 END
IOException
- on errorpublic String featureValue(String feature) throws IOException
feature
- the feature to checknull
if the
feature is not found or the command failed. Check FTP.getReplyCode()
or FTP.getReplyString()
if so.IOException
- on errorpublic String[] featureValues(String feature) throws IOException
feature
- the feature to checknull
if the feature is not found or the command
failed. Check FTP.getReplyCode()
or FTP.getReplyString()
if so.IOException
- on errorpublic boolean getAutodetectUTF8()
public int getBufferSize()
@Deprecated public int getControlKeepAliveReplyTimeout()
getControlKeepAliveReplyTimeoutDuration()
.public Duration getControlKeepAliveReplyTimeoutDuration()
@Deprecated public long getControlKeepAliveTimeout()
getControlKeepAliveTimeoutDuration()
.See the class Javadoc section "Control channel keep-alive feature"
public Duration getControlKeepAliveTimeoutDuration()
See the class Javadoc section "Control channel keep-alive feature"
public CopyStreamListener getCopyStreamListener()
null
@Deprecated public int[] getCslDebug()
For debug use only
Currently contains:
public int getDataConnectionMode()
_DATA_CONNECTION_MODE
constants. _DATA_CONNECTION_MODE
constants.public Duration getDataTimeout()
Note: the timeout will also be applied when calling accept() whilst establishing an active local data connection.
protected String getListArguments(String pathname)
pathname
- the initial pathnamepublic boolean getListHiddenFiles()
setListHiddenFiles(boolean)
public String getModificationTime(String pathname) throws IOException
pathname
- The file path to query.yyyyMMDDhhmmss
format.IOException
- if an I/O error occurs.public String getPassiveHost()
enterLocalPassiveMode()
.
This is because FTPClient sends a PASV command to the server only just before opening a data connection, and not when you call
enterLocalPassiveMode()
.public InetAddress getPassiveLocalIPAddress()
public int getPassivePort()
enterLocalPassiveMode()
. This is because FTPClient sends a PASV command to the server only just before opening a
data connection, and not when you call enterLocalPassiveMode()
.public int getReceiveDataSocketBufferSize()
public long getRestartOffset()
public int getSendDataSocketBufferSize()
public String getSize(String pathname) throws IOException
pathname
- the file namenull
if there was an errorFTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public String getStatus() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public String getStatus(String pathname) throws IOException
pathname
- the file nameFTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.@Deprecated public String getSystemName() throws IOException
getSystemType()
insteadIOException
- on errorpublic String getSystemType() throws IOException
If the SYST command fails, and the system property FTP_SYSTEM_TYPE_DEFAULT
is defined, then this is used instead.
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server (and the
default system type property is not defined)public boolean hasFeature(FTPCmd feature) throws IOException
feature
- the name of the feature; it is converted to upper case.true
if the feature is present, false
if the feature is not present or the FTP.feat()
command failed. Check
FTP.getReplyCode()
or FTP.getReplyString()
if it is necessary to distinguish these cases.IOException
- on errorpublic boolean hasFeature(String feature) throws IOException
feature
- the name of the feature; it is converted to upper case.true
if the feature is present, false
if the feature is not present or the FTP.feat()
command failed. Check
FTP.getReplyCode()
or FTP.getReplyString()
if it is necessary to distinguish these cases.IOException
- on errorpublic boolean hasFeature(String feature, String value) throws IOException
feature
- the name of the feature; it is converted to upper case.value
- the value to find.true
if the feature is present, false
if the feature is not present or the FTP.feat()
command failed. Check
FTP.getReplyCode()
or FTP.getReplyString()
if it is necessary to distinguish these cases.IOException
- on errorpublic FTPListParseEngine initiateListParsing() throws IOException
FTPFileEntryParser
used.
This method differs from using the listFiles() methods in that expensive FTPFile objects are not created until needed which may be an advantage on large lists.
parser
parameter. Null will be returned if a data
connection cannot be opened. If the current working directory contains no files, an empty array will be the return.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the autodetect mechanism cannot resolve the type of system we are
connected with.FTPListParseEngine
public FTPListParseEngine initiateListParsing(String pathname) throws IOException
FTPFileEntryParser
used.
The server may or may not expand glob expressions. You should avoid using glob expressions because the return format for glob listings differs from server to server and will likely cause this method to fail.
This method differs from using the listFiles() methods in that expensive FTPFile objects are not created until needed which may be an advantage on large lists.
FTPClient f = FTPClient(); f.connect(server); f.login(username, password); FTPListParseEngine engine = f.initiateListParsing(directory); while (engine.hasNext()) { FTPFile[] files = engine.getNext(25); // "page size" you want // do whatever you want with these files, display them, etc. // expensive FTPFile objects not created until needed. }
pathname
- the starting directory parser
parameter. Null will be returned if a data
connection cannot be opened. If the current working directory contains no files, an empty array will be the return.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the autodetect mechanism cannot resolve the type of system we are
connected with.FTPListParseEngine
public FTPListParseEngine initiateListParsing(String parserKey, String pathname) throws IOException
FTPFileEntryParser
used.
The server may or may not expand glob expressions. You should avoid using glob expressions because the return format for glob listings differs from server to server and will likely cause this method to fail.
This method differs from using the listFiles() methods in that expensive FTPFile objects are not created until needed which may be an advantage on large lists.
parserKey
- A string representing a designated code or fully-qualified class name of an FTPFileEntryParser
that should be used to
parse each server file listing. May be null
, in which case the code checks first the system property FTP_SYSTEM_TYPE
,
and if that is not defined the SYST command is used to provide the value. To allow for arbitrary system types, the return from the SYST
command is used to look up an alias for the type in the SYSTEM_TYPE_PROPERTIES
properties file if it is available.pathname
- the starting directory parser
parameter. Null will be returned if a data
connection cannot be opened. If the current working directory contains no files, an empty array will be the return.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the parserKey parameter cannot be resolved by the selected parser
factory. In the DefaultFTPEntryParserFactory, this will happen when parserKey is
neither the fully qualified class name of a class implementing the interface
org.apache.commons.net.ftp.FTPFileEntryParser nor a string containing one of the
recognized keys mapping to such a parser or if class loader security issues
prevent its being loaded.FTPListParseEngine
public FTPListParseEngine initiateMListParsing() throws IOException
IOException
- on errorpublic FTPListParseEngine initiateMListParsing(String pathname) throws IOException
pathname
- the path from where to MLSD.IOException
- on errorpublic boolean isIpAddressFromPasvResponse()
FTP_IP_ADDRESS_FROM_PASV_RESPONSE
.FTP_IP_ADDRESS_FROM_PASV_RESPONSE
,
setIpAddressFromPasvResponse(boolean)
public boolean isRemoteVerificationEnabled()
public boolean isUseEPSVwithIPv4()
false
public FTPFile[] listDirectories() throws IOException
This information is obtained through the LIST command. The contents of the returned array is determined by the FTPFileEntryParser
used.
N.B. the LIST command does not generally return very precise timestamps. For recent files, the response usually contains hours and minutes (not seconds).
For older files, the output may only contain a date. If the server supports it, the MLSD command returns timestamps with a precision of seconds, and may
include milliseconds. See mlistDir()
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the parserKey parameter cannot be resolved by the selected parser
factory. In the DefaultFTPEntryParserFactory, this will happen when parserKey is
neither the fully qualified class name of a class implementing the interface
org.apache.commons.net.ftp.FTPFileEntryParser nor a string containing one of the
recognized keys mapping to such a parser or if class loader security issues
prevent its being loaded.DefaultFTPFileEntryParserFactory
,
FTPFileEntryParserFactory
,
FTPFileEntryParser
public FTPFile[] listDirectories(String parent) throws IOException
This information is obtained through the LIST command. The contents of the returned array is determined by the FTPFileEntryParser
used.
N.B. the LIST command does not generally return very precise timestamps. For recent files, the response usually contains hours and minutes (not seconds).
For older files, the output may only contain a date. If the server supports it, the MLSD command returns timestamps with a precision of seconds, and may
include milliseconds. See mlistDir()
parent
- the starting directoryFTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the parserKey parameter cannot be resolved by the selected parser
factory. In the DefaultFTPEntryParserFactory, this will happen when parserKey is
neither the fully qualified class name of a class implementing the interface
org.apache.commons.net.ftp.FTPFileEntryParser nor a string containing one of the
recognized keys mapping to such a parser or if class loader security issues
prevent its being loaded.DefaultFTPFileEntryParserFactory
,
FTPFileEntryParserFactory
,
FTPFileEntryParser
public FTPFile[] listFiles() throws IOException
This information is obtained through the LIST command. The contents of the returned array is determined by the FTPFileEntryParser
used.
N.B. the LIST command does not generally return very precise timestamps. For recent files, the response usually contains hours and minutes (not seconds).
For older files, the output may only contain a date. If the server supports it, the MLSD command returns timestamps with a precision of seconds, and may
include milliseconds. See mlistDir()
NOTE: This array may contain null members if any of the individual file listings failed to parse. The caller should check each entry for null before referencing it.
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the parserKey parameter cannot be resolved by the selected parser
factory. In the DefaultFTPEntryParserFactory, this will happen when parserKey is
neither the fully qualified class name of a class implementing the interface
org.apache.commons.net.ftp.FTPFileEntryParser nor a string containing one of the
recognized keys mapping to such a parser or if class loader security issues
prevent its being loaded.DefaultFTPFileEntryParserFactory
,
FTPFileEntryParserFactory
,
FTPFileEntryParser
public FTPFile[] listFiles(String pathname) throws IOException
This information is obtained through the LIST command. The contents of the returned array is determined by the FTPFileEntryParser
used.
N.B. the LIST command does not generally return very precise timestamps. For recent files, the response usually contains hours and minutes (not seconds).
For older files, the output may only contain a date. If the server supports it, the MLSD command returns timestamps with a precision of seconds, and may
include milliseconds. See mlistDir()
pathname
- The file or directory to list. Since the server may or may not expand glob expressions, using them here is not recommended and may well
cause this method to fail. Also, some servers treat a leading '-' as being an option. To avoid this interpretation, use an absolute
pathname or prefix the pathname with ./ (unix style servers). Some servers may support "--" as meaning end of options, in which case "--
-xyz" should work.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client
being idle or some other reason causing the server to send FTP reply code 421.
This exception may be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving
a reply from the server.ParserInitializationException
- Thrown if the parserKey parameter cannot be resolved by the selected parser
factory. In the DefaultFTPEntryParserFactory, this will happen when parserKey is
neither the fully qualified class name of a class implementing the interface
org.apache.commons.net.ftp.FTPFileEntryParser nor a string containing one of the
recognized keys mapping to such a parser or if class loader security issues
prevent its being loaded.DefaultFTPFileEntryParserFactory
,
FTPFileEntryParserFactory
,
FTPFileEntryParser
public FTPFile[] listFiles(String pathname, FTPFileFilter filter) throws IOException
listFiles(String)
which allows a filter to be provided. For example: listFiles("site", FTPFileFilters.DIRECTORY);
pathname
- the initial path, may be nullfilter
- the filter, non-nullIOException
- on errorpublic String listHelp() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public String listHelp(String command) throws IOException
command
- The command on which to ask for help.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public String[] listNames() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public String[] listNames(String pathname) throws IOException
pathname
- The file or directory to list. Warning: the server may treat a leading '-' as an option introducer. If so, try using an absolute path, or
prefix the path with ./ (unix style servers). Some servers may support "--" as meaning end of options, in which case "-- -xyz" should
work.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean login(String username, String password) throws IOException
username
- The username to login under.password
- The password to use.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean login(String username, String password, String account) throws IOException
username
- The username to login under.password
- The password to use.account
- The account to use.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean logout() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean makeDirectory(String pathname) throws IOException
pathname
- The pathname of the directory to create.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public Calendar mdtmCalendar(String pathname) throws IOException
pathname
- The file path to query.null
. The Calendar timestamp will be null if a parse error occurs.IOException
- if an I/O error occurs.public FTPFile mdtmFile(String pathname) throws IOException
pathname
- The file path to query.null
. The FTPFile timestamp will be null if a parse error occurs.IOException
- if an I/O error occurs.public Instant mdtmInstant(String pathname) throws IOException
pathname
- The file path to query.null
. The Instant timestamp will be null if a parse error occurs.IOException
- if an I/O error occurs.public FTPFile[] mlistDir() throws IOException
IOException
- on errorpublic FTPFile[] mlistDir(String pathname) throws IOException
pathname
- the directory name, may be null
IOException
- on errorpublic FTPFile[] mlistDir(String pathname, FTPFileFilter filter) throws IOException
pathname
- the directory name, may be null
filter
- the filter to apply to the responsesIOException
- on errorpublic FTPFile mlistFile(String pathname) throws IOException
pathname
- the file or directory to list, may be null
null
IOException
- on errorpublic String printWorkingDirectory() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean reinitialize() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean remoteAppend(String fileName) throws IOException
remoteRetrieve
issued to it by another FTPClient.fileName
- The name of the file to be appended to, or if the file does not exist, the name to call the file being stored.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean remoteRetrieve(String fileName) throws IOException
fileName
- The name of the file to retrieve.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean remoteStore(String fileName) throws IOException
remoteRetrieve
issued to it by another FTPClient.fileName
- The name to call the file that is to be stored.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean remoteStoreUnique() throws IOException
remoteRetrieve
issued to it by another FTPClient. Many FTP servers require that a base
file name be given from which the unique file name can be derived. For those servers use the other version of remoteStoreUnique
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean remoteStoreUnique(String fileName) throws IOException
remoteRetrieve
issued to it by another FTPClient.fileName
- The name on which to base the file name of the file that is to be stored.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean removeDirectory(String pathname) throws IOException
pathname
- The pathname of the directory to remove.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean rename(String from, String to) throws IOException
from
- The name of the remote file to rename.to
- The new name of the remote file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.protected boolean restart(long offset) throws IOException
STREAM_TRANSFER_MODE
file transfer starting from the given offset. This will only work on FTP servers supporting the REST comand
for the stream transfer mode. However, most FTP servers support this. Any subsequent file transfer will start reading or writing the remote file from the
indicated offset.offset
- The offset into the remote file at which to start the next file transfer.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean retrieveFile(String remote, OutputStream local) throws IOException
Note: if you have used setRestartOffset(long)
, the file data will start from the selected offset.
remote
- The name of the remote file.local
- The local OutputStream to which to write the file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some
other reason causing the server to send FTP reply code 421. This exception may be caught either as
an IOException or independently as itself.CopyStreamException
- If an I/O error occurs while actually transferring the file. The CopyStreamException allows you to
determine the number of bytes transferred and the IOException causing the error. This exception may
be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the
server.public InputStream retrieveFileStream(String remote) throws IOException
To finalize the file transfer you must call completePendingCommand
and check its return value to verify success.
If this is not done, subsequent commands may behave unexpectedly.
Note: if you have used setRestartOffset(long)
, the file data will start from the selected offset.
remote
- The name of the remote file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean sendNoOp() throws IOException
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean sendSiteCommand(String arguments) throws IOException
arguments
- The site specific command and arguments.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public void setActiveExternalIPAddress(String ipAddress) throws UnknownHostException
ipAddress
- The external IP address of this machine.UnknownHostException
- if the ipAddress cannot be resolvedpublic void setActivePortRange(int minPort, int maxPort)
minPort
- The lowest available port (inclusive).maxPort
- The highest available port (inclusive).public void setAutodetectUTF8(boolean autodetect)
Does not affect existing connections; must be invoked before a connection is established.
autodetect
- If true, automatic server encoding detection will be enabled.public void setBufferSize(int bufSize)
bufSize
- The size of the buffer. Use a non-positive value to use the default.public void setControlKeepAliveReplyTimeout(Duration timeout)
timeout
- number of milliseconds to wait (defaults to 1000)setControlKeepAliveTimeout(Duration)
@Deprecated public void setControlKeepAliveReplyTimeout(int timeoutMillis)
setControlKeepAliveReplyTimeout(Duration)
.timeoutMillis
- number of milliseconds to wait (defaults to 1000)setControlKeepAliveTimeout(long)
public void setControlKeepAliveTimeout(Duration controlIdle)
See the class Javadoc section "Control channel keep-alive feature"
controlIdle
- the wait between keepalive messages. Zero (or less) disables.setControlKeepAliveReplyTimeout(Duration)
@Deprecated public void setControlKeepAliveTimeout(long controlIdleSeconds)
setControlKeepAliveTimeout(Duration)
.See the class Javadoc section "Control channel keep-alive feature"
controlIdleSeconds
- the wait (in seconds) between keepalive messages. Zero (or less) disables.setControlKeepAliveReplyTimeout(int)
public void setCopyStreamListener(CopyStreamListener listener)
null
.listener
- to be used, may be null
to disablepublic void setDataTimeout(Duration timeout)
Note: the timeout will also be applied when calling accept() whilst establishing an active local data connection.
timeout
- The default timeout that is used when opening a data connection socket. The value 0 (or null) means an infinite timeout.@Deprecated public void setDataTimeout(int timeoutMillis)
setDataTimeout(Duration)
.Note: the timeout will also be applied when calling accept() whilst establishing an active local data connection.
timeoutMillis
- The default timeout in milliseconds that is used when opening a data connection socket. The value 0 means an infinite timeout.public boolean setFileStructure(int structure) throws IOException
FTP.FILE_STRUCTURE
if this method is never called or if a connect method is called.structure
- The structure of the file (one of the FTP class _STRUCTURE
constants).FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean setFileTransferMode(int mode) throws IOException
FTP.STREAM_TRANSFER_MODE
if this method is never called or if a connect method is
called.mode
- The new transfer mode to use (one of the FTP class _TRANSFER_MODE
constants).FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean setFileType(int fileType) throws IOException
FTP.ASCII_FILE_TYPE
, FTP.BINARY_FILE_TYPE
, etc. The file type
only needs to be set when you want to change the type. After changing it, the new type stays in effect until you change it again. The default file type
is FTP.ASCII_FILE_TYPE
if this method is never called. N.B. currently calling any connect method will reset the type to FTP.ASCII_FILE_TYPE.
fileType
- The _FILE_TYPE
constant indicating the type of file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean setFileType(int fileType, int formatOrByteSize) throws IOException
FTP.ASCII_FILE_TYPE
, FTP.BINARY_FILE_TYPE
,
etc. The file type only needs to be set when you want to change the type. After changing it, the new type stays in effect until you change it again. The
default file type is FTP.ASCII_FILE_TYPE
if this method is never called. TEXT_FORMAT
constants, or if the type is FTP.LOCAL_FILE_TYPE
, the format should
be the byte size for that type. The default format is FTP.NON_PRINT_TEXT_FORMAT
if this method is never called.
N.B. currently calling any connect method will reset the type to FTP.ASCII_FILE_TYPE and the formatOrByteSize to FTP.NON_PRINT_TEXT_FORMAT.
fileType
- The _FILE_TYPE
constant indicating the type of file.formatOrByteSize
- The format of the file (one of the _FORMAT
constants. In the case of LOCAL_FILE_TYPE
, the byte size.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public void setIpAddressFromPasvResponse(boolean usingIpAddressFromPasvResponse)
FTP_IP_ADDRESS_FROM_PASV_RESPONSE
.usingIpAddressFromPasvResponse
- True, if the IP address from the server's response should be used (pre-3.9.0 compatible behavior), or false (ignore
that IP address).FTP_IP_ADDRESS_FROM_PASV_RESPONSE
,
isIpAddressFromPasvResponse()
public void setListHiddenFiles(boolean listHiddenFiles)
listFiles()
too. A LIST -a
will be issued to the ftp server. It
depends on your ftp server if you need to call this method, also dont expect to get rid of hidden files if you call this method with "false".listHiddenFiles
- true if hidden files should be listedpublic boolean setModificationTime(String pathname, String timeval) throws IOException
yyyyMMDDhhmmss
. It should also be in GMT, but not all servers honor this.
An FTP server would indicate its support of this feature by including "MFMT" in its response to the FEAT command, which may be retrieved by
FTPClient.features()pathname
- The file path for which last modified time is to be changed.timeval
- The timestamp to set to, in yyyyMMDDhhmmss
format.IOException
- if an I/O error occurs.public void setParserFactory(FTPFileEntryParserFactory parserFactory)
parserFactory
- factory object used to create FTPFileEntryParsersFTPFileEntryParserFactory
,
DefaultFTPFileEntryParserFactory
public void setPassiveLocalIPAddress(InetAddress inetAddress)
inetAddress
- The local IP address of this machine.public void setPassiveLocalIPAddress(String ipAddress) throws UnknownHostException
ipAddress
- The local IP address of this machine.UnknownHostException
- if the ipAddress cannot be resolved@Deprecated public void setPassiveNatWorkaround(boolean enabled)
setPassiveNatWorkaroundStrategy(HostnameResolver)
insteadThe default is true, i.e. site-local replies are replaced.
enabled
- true to enable replacing internal IP's in passive mode.public void setPassiveNatWorkaroundStrategy(FTPClient.HostnameResolver resolver)
NatServerResolverImpl
, i.e. site-local replies are replaced.resolver
- strategy to replace internal IP's in passive mode or null to disable the workaround (i.e. use PASV mode reply address.)public void setReceieveDataSocketBufferSize(int bufSize)
bufSize
- The size of the buffer, zero or negative means the value is ignored.public void setRemoteVerificationEnabled(boolean enable)
enable
- True to enable verification, false to disable verification.public void setReportActiveExternalIPAddress(String ipAddress) throws UnknownHostException
ipAddress
- The external IP address of this machine.UnknownHostException
- if the ipAddress cannot be resolvedgetReportHostAddress()
public void setRestartOffset(long offset)
The restart command is not sent to the server immediately. It is sent when a data connection is created as part of a subsequent command. The restart marker is reset to zero after use.
Note: This method should only be invoked immediately prior to the transfer to which it applies.
offset
- The offset into the remote file at which to start the next file transfer. This must be a value greater than or equal to zero.public void setSendDataSocketBufferSize(int bufSize)
bufSize
- The size of the buffer, zero or negative means the value is ignored.public void setUseEPSVwithIPv4(boolean selected)
selected
- value to set.public boolean storeFile(String remote, InputStream local) throws IOException
remote
- The name to give the remote file.local
- The local InputStream from which to read the file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some
other reason causing the server to send FTP reply code 421. This exception may be caught either as
an IOException or independently as itself.CopyStreamException
- If an I/O error occurs while actually transferring the file. The CopyStreamException allows you to
determine the number of bytes transferred and the IOException causing the error. This exception may
be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the
server.public OutputStream storeFileStream(String remote) throws IOException
To finalize the file transfer you must call completePendingCommand
and check its return value to verify success.
If this is not done, subsequent commands may behave unexpectedly.
remote
- The name to give the remote file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean storeUniqueFile(InputStream local) throws IOException
local
- The local InputStream from which to read the file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some
other reason causing the server to send FTP reply code 421. This exception may be caught either as
an IOException or independently as itself.CopyStreamException
- If an I/O error occurs while actually transferring the file. The CopyStreamException allows you to
determine the number of bytes transferred and the IOException causing the error. This exception may
be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the
server.public boolean storeUniqueFile(String remote, InputStream local) throws IOException
remote
- The name on which to base the unique name given to the remote file.local
- The local InputStream from which to read the file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some
other reason causing the server to send FTP reply code 421. This exception may be caught either as
an IOException or independently as itself.CopyStreamException
- If an I/O error occurs while actually transferring the file. The CopyStreamException allows you to
determine the number of bytes transferred and the IOException causing the error. This exception may
be caught either as an IOException or independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the
server.public OutputStream storeUniqueFileStream() throws IOException
To finalize the file transfer you must call completePendingCommand
and check its return value to verify success.
If this is not done, subsequent commands may behave unexpectedly.
FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public OutputStream storeUniqueFileStream(String remote) throws IOException
To finalize the file transfer you must call completePendingCommand
and check its return value to verify success.
If this is not done, subsequent commands may behave unexpectedly.
remote
- The name on which to base the unique name given to the remote file.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.public boolean structureMount(String pathname) throws IOException
pathname
- The pathname to mount.FTPConnectionClosedException
- If the FTP server prematurely closes the connection as a result of the client being idle or some other reason
causing the server to send FTP reply code 421. This exception may be caught either as an IOException or
independently as itself.IOException
- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.Copyright © 2001–2022 The Apache Software Foundation. All rights reserved.