Package org.apache.commons.net.ftp
Class FTPHTTPClient
java.lang.Object
org.apache.commons.net.SocketClient
org.apache.commons.net.ftp.FTP
org.apache.commons.net.ftp.FTPClient
org.apache.commons.net.ftp.FTPHTTPClient
- All Implemented Interfaces:
- Configurable
Experimental attempt at FTP client that tunnels over an HTTP proxy connection.
- Since:
- 2.2
- 
Nested Class SummaryNested classes/interfaces inherited from class org.apache.commons.net.ftp.FTPClientFTPClient.HostnameResolver, FTPClient.NatServerResolverImpl
- 
Field SummaryFields inherited from class org.apache.commons.net.ftp.FTPClientACTIVE_LOCAL_DATA_CONNECTION_MODE, ACTIVE_REMOTE_DATA_CONNECTION_MODE, FTP_IP_ADDRESS_FROM_PASV_RESPONSE, FTP_SYSTEM_TYPE, FTP_SYSTEM_TYPE_DEFAULT, PASSIVE_LOCAL_DATA_CONNECTION_MODE, PASSIVE_REMOTE_DATA_CONNECTION_MODE, SYSTEM_TYPE_PROPERTIESFields inherited from class org.apache.commons.net.ftp.FTP_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, DEFLATE_TRANSFER_MODE, 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_FORMATFields inherited from class org.apache.commons.net.SocketClient_defaultPort_, _hostname_, _input_, _output_, _serverSocketFactory_, _socket_, _socketFactory_, _timeout_, connectTimeout, NETASCII_EOL, remoteInetSocketAddress
- 
Constructor SummaryConstructorsConstructorDescriptionFTPHTTPClient(String proxyHost, int proxyPort) Create an instance using the UTF-8 encoding, with no proxy credentials.FTPHTTPClient(String proxyHost, int proxyPort, String proxyUser, String proxyPass) Create an instance using the UTF-8 encodingFTPHTTPClient(String proxyHost, int proxyPort, String proxyUser, String proxyPass, Charset encoding) Create an instance with the specified encodingFTPHTTPClient(String proxyHost, int proxyPort, Charset encoding) Create an instance using the specified encoding, with no proxy credentials.
- 
Method SummaryModifier and TypeMethodDescriptionprotected Socket_openDataConnection_(int command, String arg) Deprecated.protected Socket_openDataConnection_(String command, String arg) Establishes a data connection with the FTP server, returning a Socket for the connection if successful.voidOpens a Socket connected to a remote host at the specified port and originating from the current host at a system assigned port.Methods inherited from class org.apache.commons.net.ftp.FTPClient_connectAction_, _connectAction_, _openDataConnection_, _parseExtendedPassiveModeReply, _parsePassiveModeReply, _retrieveFile, _retrieveFileStream, _storeFile, _storeFileStream, abort, allocate, allocate, allocate, allocate, appendFile, appendFileStream, changeToParentDirectory, changeWorkingDirectory, completePendingCommand, configure, deleteFile, disconnect, doCommand, doCommandAsStrings, enterLocalActiveMode, enterLocalPassiveMode, enterRemoteActiveMode, enterRemotePassiveMode, features, featureValue, featureValues, getAutodetectUTF8, getBufferSize, getControlKeepAliveReplyTimeout, getControlKeepAliveReplyTimeoutDuration, getControlKeepAliveTimeout, getControlKeepAliveTimeoutDuration, getCopyStreamListener, getCslDebug, getDataConnectionMode, getDataTimeout, getListArguments, getListHiddenFiles, getModificationTime, getPassiveHost, getPassiveLocalIPAddress, getPassivePort, getReceiveDataSocketBufferSize, getRestartOffset, getSendDataSocketBufferSize, getSize, getStatus, getStatus, getSystemName, getSystemType, hasFeature, hasFeature, hasFeature, initiateListParsing, initiateListParsing, initiateListParsing, initiateMListParsing, initiateMListParsing, isIpAddressFromPasvResponse, isRemoteVerificationEnabled, isUseEPSVwithIPv4, listDirectories, listDirectories, listFiles, listFiles, listFiles, listHelp, listHelp, listNames, listNames, login, login, logout, makeDirectory, mdtmCalendar, mdtmFile, mdtmInstant, mlistDir, mlistDir, mlistDir, mlistFile, printWorkingDirectory, reinitialize, remoteAppend, remoteRetrieve, remoteStore, remoteStoreUnique, remoteStoreUnique, removeDirectory, rename, restart, retrieveFile, retrieveFileStream, sendNoOp, sendSiteCommand, setActiveExternalIPAddress, setActivePortRange, setAutodetectUTF8, setBufferSize, setControlKeepAliveReplyTimeout, setControlKeepAliveReplyTimeout, setControlKeepAliveTimeout, setControlKeepAliveTimeout, setCopyStreamListener, setDataTimeout, setDataTimeout, setFileStructure, setFileTransferMode, setFileType, setFileType, setIpAddressFromPasvResponse, setListHiddenFiles, setModificationTime, setParserFactory, setPassiveLocalIPAddress, setPassiveLocalIPAddress, setPassiveNatWorkaround, setPassiveNatWorkaroundStrategy, setReceieveDataSocketBufferSize, setRemoteVerificationEnabled, setReportActiveExternalIPAddress, setRestartOffset, setSendDataSocketBufferSize, setUseEPSVwithIPv4, storeFile, storeFileStream, storeUniqueFile, storeUniqueFile, storeUniqueFileStream, storeUniqueFileStream, structureMountMethods inherited from class org.apache.commons.net.ftp.FTP__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, userMethods inherited from class org.apache.commons.net.SocketClientaddProtocolCommandListener, applySocketAttributes, checkOpenOutputStream, connect, connect, connect, connect, connect, createCommandSupport, fireCommandSent, fireReplyReceived, getCharset, getCharsetName, getConnectTimeout, getDefaultPort, getDefaultTimeout, getKeepAlive, getLocalAddress, getLocalPort, getProxy, getReceiveBufferSize, getRemoteAddress, getRemoteInetSocketAddress, getRemotePort, getSendBufferSize, getServerSocketFactory, getSoLinger, getSoTimeout, getTcpNoDelay, isAvailable, isConnected, removeProtocolCommandListener, setCharset, setConnectTimeout, setDefaultPort, setDefaultTimeout, setKeepAlive, setProxy, setReceiveBufferSize, setSendBufferSize, setServerSocketFactory, setSocketFactory, setSoLinger, setSoTimeout, setTcpNoDelay, verifyRemote
- 
Constructor Details- 
FTPHTTPClientCreate an instance using the UTF-8 encoding, with no proxy credentials.- Parameters:
- proxyHost- the hostname to use
- proxyPort- the port to use
 
- 
FTPHTTPClientCreate an instance using the specified encoding, with no proxy credentials.- Parameters:
- proxyHost- the hostname to use
- proxyPort- the port to use
- encoding- the encoding to use
 
- 
FTPHTTPClientCreate an instance using the UTF-8 encoding- Parameters:
- proxyHost- the hostname to use
- proxyPort- the port to use
- proxyUser- the user name for the proxy
- proxyPass- the password for the proxy
 
- 
FTPHTTPClientpublic FTPHTTPClient(String proxyHost, int proxyPort, String proxyUser, String proxyPass, Charset encoding) Create an instance with the specified encoding- Parameters:
- proxyHost- the hostname to use
- proxyPort- the port to use
- proxyUser- the user name for the proxy
- proxyPass- the password for the proxy
- encoding- the encoding to use
 
 
- 
- 
Method Details- 
_openDataConnection_Deprecated.(3.3) UseFTPClient._openDataConnection_(FTPCmd, String)insteadEstablishes a data connection with the FTP server, returning a Socket for the connection if successful. If a restart offset has been set withFTPClient.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.- Overrides:
- _openDataConnection_in class- FTPClient
- Parameters:
- 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.
- Returns:
- A Socket corresponding to the established data connection. Null is returned if an FTP protocol error is reported at any point during the establishment and initialization of the connection.
- Throws:
- IllegalStateException- if connection mode is not passive
- IOException- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.
 
- 
_openDataConnection_Establishes a data connection with the FTP server, returning a Socket for the connection if successful. If a restart offset has been set withFTPClient.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.- Overrides:
- _openDataConnection_in class- FTPClient
- Parameters:
- 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.
- Returns:
- A Socket corresponding to the established data connection. Null is returned if an FTP protocol error is reported at any point during the establishment and initialization of the connection.
- Throws:
- IllegalStateException- if connection mode is not passive
- IOException- If an I/O error occurs while either sending a command to the server or receiving a reply from the server.
- Since:
- 3.1
 
- 
connectDescription copied from class:SocketClientOpens a Socket connected to a remote host at the specified port and originating from the current host at a system assigned port. Before returning,_connectAction_()is called to perform connection initialization actions.- Overrides:
- connectin class- SocketClient
- Parameters:
- host- The name of the remote host.
- port- The port to connect to on the remote host.
- Throws:
- SocketException- If the socket timeout could not be set.
- IOException- If the socket could not be opened. In most cases you will only want to catch IOException since SocketException is derived from it.
 
 
- 
FTPClient._openDataConnection_(FTPCmd, String)instead