org.apache.commons.NET.ftpClass FTPClient类FTPClient

org.apache.commons.net.ftp.FTPClientorg.apache.commons.Net.ftp.FTPClient

All Implemented Interfaces:所有已实现的接口：

Direct Known Subclasses:直接已知子类：

extends FTP

FTPClient encapsulates all the functionality necessary to store and retrieve files from an FTP server.FTPClient封装了所有必要的功能来存储和检索从FTP服务器上的文件。 This class takes care of all low level details of interacting with an FTP server and provides a convenient higher level interface.这个类负责所有与FTP服务器交互的底层细节，并提供了便捷的更高层次的接口。 As with all classes derived from SocketClient, you must first connect to the server with connectbefore doing anything, and finally disconnectafter you're completely finished interacting with the server.正如来自所有类SocketClient，您必须首先连接到与服务器connect做任何事之前，最后disconnect完成后，你完全与服务器交互。 Then you need to check the FTP reply code to see if the connection was successful.然后，你需要检查的FTP答复代码，看看是否连接成功。 For example:例如：

boolean error = false;布尔错误= 0;

try {尝试{

int reply;诠释答复;

ftp.connect("ftp.foobar.com");ftp.connect(“ftp.foobar.com”);

System.out.println("Connected to " + server + ".");System.out.println(“连接到”+服务器+ ".");

System.out.print(ftp.getReplyString());System.out.print(ftp.getReplyString());

// After connection attempt, you should check the reply code to verify/ /连接尝试后，你应该检查代码以验证答复

// success./ /成功。

reply = ftp.getReplyCode();答复= ftp.getReplyCode();

if(!FTPReply.isPositiveCompletion(reply)) {如果(！FTPReply.isPositiveCompletion(回复)){

ftp.disconnect();ftp.disconnect();

System.err.println("FTP server refused connection.");System.err.println(“FTP服务器拒绝连接。”);

System.exit(1);System.exit(1);

}}

...... // transfer files/ /传送文件

ftp.logout();ftp.logout();

} catch(IOException e) {}捕捉(IOException异常五){

error = true;误差为真;

e.printStackTrace();e.printStackTrace();

} finally {最后} {

if(ftp.isConnected()) {如果(ftp.isConnected()){

try {尝试{

ftp.disconnect();ftp.disconnect();

} catch(IOException ioe) {}捕捉(IOException异常雇主组织){

// do nothing/ /什么也不做

}}

}}

System.exit(error ? 1 : 0);System.exit(错误1：0？);

}}

Immediately after connecting is the only real time you need to check the reply code (because connect is of type void).连接后立即是唯一真正的时候你需要检查答复代码(因为是连接类型为void)。 The convention for all the FTP command methods in FTPClient is such that they either return a boolean value or some other value.对于所有的FTP FTPClient指挥方法的公约就是这样，他们要么返回一个布尔值或其他值。 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.该方法返回一个布尔从FTP服务器成功完成答辩，假假真真的错误条件中的一个或故障而导致的答复。 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.该方法返回一个布尔值返回值比含有较高水平的FTP命令，或者为null，如果产生一个错误条件答复或故障导致其他数据。 If you want to access the exact FTP reply code causing a success or failure, you must call getReplyCodeafter a success or failure.如果您要访问的FTP的确切答复代码导致成功或失败，你必须调用getReplyCode后，成功或失败。

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 .FTPClient的默认设置是它使用FTP.ASCII_FILE_TYPE ， FTP.NON_PRINT_TEXT_FORMAT ， FTP.STREAM_TRANSFER_MODE和FTP.FILE_STRUCTURE 。 The only file types directly supported are FTP.ASCII_FILE_TYPE and FTP.BINARY_FILE_TYPE .唯一的文件直接支持的类型是FTP.ASCII_FILE_TYPE和FTP.BINARY_FILE_TYPE 。 Because there are at least 4 different EBCDIC encodings, we have opted not to provide direct support for EBCDIC.因为至少有4种不同的EBCDIC编码，我们还选择了不提供直接支持的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.为了转移EBCDIC和其他不支持的文件类型，你必须创建自己的过滤InputStreams和OutputStreams和总结他们周围的流退回或由FTPClient方法所需。 FTPClient uses the NetASCIIfilter streams to provide transparent handling of ASCII files.FTPClient使用NetASCII过滤器流提供ASCII文件透明处理。 We will consider incorporating EBCDIC support if there is enough demand.我们会考虑把EBCDIC码的支持，如果有足够的需求。

FTP.NON_PRINT_TEXT_FORMAT , FTP.STREAM_TRANSFER_MODE , and FTP.FILE_STRUCTURE are the only supported formats, transfer modes, and file structures.FTP.NON_PRINT_TEXT_FORMAT ， FTP.STREAM_TRANSFER_MODE和FTP.FILE_STRUCTURE是唯一支持的格式，传输模式和文件结构。

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.由于在不同平台上插座处理可以显着差异，在FTPClient自动发出一个新的端口(或EPRT)命令之前，每次传输要求的服务器连接到客户端的数据端口。 This ensures identical problem-free behavior on Windows, Unix, and Macintosh platforms.这将确保相同的Windows，Unix和Macintosh平台无故障的行为。 Additionally, it relieves programmers from having to issue the PORT (or EPRT) command themselves and dealing with platform dependent issues.此外，它解除不必发出端口(或EPRT)命令自己和与平台有关问题的程序员。

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.如果一个数据连接是由党发起的一个意外，该命令将关闭套接字并抛出一个IOException异常。

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).你应该记住，在FTP服务器可以选择过早关闭连接，如果客户已超过给定的时间较长时期(通常为900秒)闲置。 The FTPClient class will detect a premature FTP server connection closing when it receives a FTPReply.SERVICE_NOT_AVAILABLEresponse to a command.将检测的FTPClient类FTP服务器连接过早关闭，当它收到FTPReply.SERVICE_NOT_AVAILABLE响应命令。 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.一旦这种情况发生时，FTP类方法遇到的答复将抛出一个FTPConnectionClosedException。 FTPConnectionClosedException是一个子类IOException ，因此不必分别被捕获，但如果你要抓住它分开，它的catch块必须出现在更一般的IOException catch块。 When you encounter an FTPConnectionClosedException, you must disconnect the connection with disconnect()to properly clean up the system resources used by FTPClient.当你遇到一个FTPConnectionClosedException，必须断开与连接disconnect()妥善清理，系统资源使用FTPClient。 Before disconnecting, you may check the last reply code and text with getReplyCode, getReplyString, and getReplyStrings.在断开，你可以检查代码和文本的最后答复与getReplyCode， getReplyString和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.它不是单独列出每个方法，我们在这里提到的每个方法与服务器通信，并抛出一个IOException异常也可引发MalformedServerReplyException，这是一个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.将抛出一个MalformedServerReplyException答复时，从服务器收到的偏离足够的协议规范，它不能在一个有用的方式解释尽管试图尽可能宽松。

Listing API Examples Both paged and unpaged examples of directory listings are available, as follows:上市API的两个例子的目录列表分页和无页数的范例，如下：

Unpaged (whole list) access, using a parser accessible by auto-detect:无页数(全名单)访问，使用分析器可经自动检测：

FTPClient f = new FTPClient();FTPClient f =new FTPClient();

f.connect(server);f.connect(服务器);

f.login(username, password);f.login(用户名，密码);

FTPFile[] files = listFiles(directory);FTPFile []文件= listfiles

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:在应该从org.apache.commons.net.FTPFileEntryParser派生initateListParsing第一个参数定义的类：

FTPClient f = new FTPClient();FTPClient f =new FTPClient();

f.connect(server);f.connect(服务器);

f.login(username, password);f.login(用户名，密码);

FTPListParseEngine engine =FTPListParseEngine引擎=

f.initiateListParsing("com.whatever.YourOwnParser", directory);f.initiateListParsing(“com.whatever.YourOwnParser”，目录);

while (engine.hasNext()) {而(engine.hasNext()){

FTPFile[] files = engine.getNext(25); // "page size" you wantFTPFile []文件= engine.getNext(25); / /“页面大小”你想要

//do whatever you want with these files, display them, etc./ /做你想做这些文件，显示它们，等

//expensive FTPFile objects not created until needed./ /昂贵FTPFile不创建对象，直到需要。

}}

Paged access, using a parser accessible by auto-detect:分页访问，使用分析器可经自动检测：

FTPClient f = new FTPClient();FTPClient f =new FTPClient();

f.connect(server);f.connect(服务器);

f.login(username, password);f.login(用户名，密码);

FTPListParseEngine engine = f.initiateListParsing(directory);FTPListParseEngine engine = f.initiateListParsing(目录);

while (engine.hasNext()) {而(engine.hasNext()){

FTPFile[] files = engine.getNext(25); // "page size" you wantFTPFile []文件= engine.getNext(25); / /“页面大小”你想要

//do whatever you want with these files, display them, etc./ /做你想做这些文件，显示它们，等

//expensive FTPFile objects not created until needed./ /昂贵FTPFile不创建对象，直到需要。

}}

For examples of using FTPClient on servers whose directory listings有关使用服务器上的目录清单FTPClient例子

· use languages other than English使用英语以外的语言

· use date formats other than the American English "standard" MM d yyyy使用日期格式“以外的美国英语”标准MM d yyyy

· are in different timezones and you need accurate timestamps for dependency checking as in Ant在不同的时区，你需要在蚁群依赖检查准确的时间戳

Author:作者：

Daniel F. Savarese, Rory Winston丹尼尔楼Savarese，罗里温斯顿

See Also:另见：

Field Summary字段摘要

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.一个常量指示期待的FTP会话之间发生的所有传输客户端(本地)和服务器，该服务器应该连接到客户端的数据端口来启动数据传输。

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.一个常量指示期待的FTP会话的所有转让发生在两个远程服务器，而客户端连接到要连接到其他服务器的数据端口发起数据传输服务器。

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.一个常量指示期待的FTP会话之间发生的所有传输客户端(本地)和服务器，服务器在被动模式时，要求客户端连接到服务器的数据端口来启动传输。

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.一个常量指示期待的FTP会话的所有转让发生在两个远程服务器，而客户端连接到处于被动模式，要求其他服务器连接到第一个服务器的数据端口发起数据传输服务器。

Constructor Summary构造方法摘要

FTPClient () Default FTPClient constructor.默认FTPClient构造。

Method Summary方法摘要

protected void

_connectAction_ () Initiates control connections and gets initial reply.启动控制连接，并得到初步答复。

protected

_openDataConnection_ (int command, String arg) Establishes a data connection with the FTP server, returning a Socket for the connection if successful.建立一个与FTP服务器的数据连接，如果返回的成功连接的Socket。

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

appendFile ( String remote, InputStream local) Appends to a file on the server with the given name, taking input from the given InputStream.上的一个带有特定名称的服务器上的文件追加，即从定InputStream输入。

appendFileStream ( String remote) Returns an OutputStream through which data can be written to append to a file on the server with the given name.返回一个通过该数据可以被写入附加的带有特定名称的服务器上的文件的OutputStream。

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.更改的FTP会话的当前工作目录。

boolean

completePendingCommand () There are a few FTPClient methods that do not complete the entire sequence of FTP commands to complete a transaction.有几个FTPClient方法不完成整个FTP命令序列来完成交易。

void

boolean

deleteFile ( String pathname) Deletes a file on the FTP server.删除在FTP服务器上的文件。

void

disconnect () Closes the connection to the FTP server and restores connection parameters to the default values.关闭到FTP服务器，连接参数恢复到默认值的连接。

void

enterLocalActiveMode () Set the current data connection mode to ACTIVE_LOCAL_DATA_CONNECTION_MODE .设置当前数据连接模式ACTIVE_LOCAL_DATA_CONNECTION_MODE 。

void

enterLocalPassiveMode () Set the current data connection mode to PASSIVE_LOCAL_DATA_CONNECTION_MODE .设置当前数据连接模式PASSIVE_LOCAL_DATA_CONNECTION_MODE 。

boolean

enterRemoteActiveMode ( InetAddress host, int port) Set the current data connection mode to ACTIVE_REMOTE_DATA_CONNECTION .设置当前数据连接模式ACTIVE_REMOTE_DATA_CONNECTION 。

boolean

enterRemotePassiveMode () Set the current data connection mode to PASSIVE_REMOTE_DATA_CONNECTION_MODE .设置当前数据连接模式PASSIVE_REMOTE_DATA_CONNECTION_MODE 。

boolean

features () Query the server for supported features.查询支持的功能服务器。

int

getBufferSize () Retrieve the current internal buffer size.检索当前的内部缓冲区的大小。

int

getDataConnectionMode () Returns the current data connection mode (one of the _DATA_CONNECTION_MODE constants.返回当前的数据连接模式(一_DATA_CONNECTION_MODE常数。

getModificationTime ( String pathname) Issue the FTP MDTM command (not supported by all servers to retrieve the last modification time of a file.问题的FTP MDTM命令(并非所有的服务器支持，以获取一个文件的最后修改时间。

getPassiveHost () Returns the hostname or IP address (in the form of a string) returned by the server when entering passive mode.返回的主机名或IP地址(在一个字符串的形式)时，由服务器返回进入被动模式。

int

getPassivePort () If in passive mode, returns the data port of the passive host.如果在被动模式下，返回被动主机的数据端口。

long

getRestartOffset () Fetches the restart offset.撷取重新启动所抵消。

getStatus () Issue the FTP STAT command to the server.STAT命令发出的FTP服务器。

getStatus ( String pathname) Issue the FTP STAT command to the server for a given pathname.STAT命令发出的FTP的服务器为给定的路径名。

getSystemName () Deprecated.Use getSystemType() - which does not return null.。弃用使用getSystemType() -不返回null。Will be deleted in version 3.0将3.0版中删除

getSystemType () Fetches the system type from the server and returns the string.从服务器获取并返回字符串系统类型。

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对象，包含了当前工作的这些信息是通过LIST命令获取服务器目录中的原始文件信息。

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对象，包含了原始文件所提供的目录信息。

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.是否应该尝试使用与IPv4 EPSV。

listFiles () Using the default system autodetect mechanism, obtain a list of file information for the current working directory.使用默认的系统自动检测机制，获取当前工作目录的文件资料清单。

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.使用默认的系统自动检测机制，获取当前工作目录或只是一个单一的文件档案资料清单。

listFiles ( String pathname, FTPFileFilter filter) Version of listFiles(String) which allows a filter to be provided.

listHelp () Fetches the system help information from the server and returns the full string.从服务器获取系统帮助信息并返回完整的字符串。

listHelp ( String command) Fetches the help information for a given command from the server and returns the full string.为获取从服务器提供的命令的帮助信息，并返回完整的字符串。

listNames () Obtain a list of filenames in the current working directory This information is obtained through the NLST command.获取当前工作目录的文件名列表，这个信息是通过获得NLST命令。

listNames ( String pathname) Obtain a list of filenames 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.登录到FTP服务器使用提供的用户名和密码。

boolean

login ( String username, String password, String account) Login to the FTP server using the provided username, password, and account.登录到FTP服务器使用提供的用户名，密码和帐号。

boolean

logout () Logout of the FTP server by sending the QUIT command.注销的通过发送QUIT命令FTP服务器。

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).在上创建一个FTP服务器的当前目录的子目录(如果给出一个相对路径名)，或在指定的(如果给出一个绝对路径名)。

printWorkingDirectory () Returns the pathname of the current working directory.返回当前工作目录的路径名。

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).删除在FTP服务器(如果是空的)目录。

boolean

rename ( String from, String to) Renames a remote file.重命名远程文件。

boolean

retrieveFile ( String remote, OutputStream local) Retrieves a named file from the server and writes it to the given OutputStream.从服务器检索命名文件并将其写入给定的OutputStream。

retrieveFileStream ( String remote) Returns an InputStream from which a named file from the server can be read.返回从其中一个指定的文件从服务器可以读取的InputStream。

boolean

sendNoOp () Sends a NOOP command to the FTP server.发送一个NOOP命令到FTP服务器。

boolean

sendSiteCommand ( String arguments) Send a site specific command.发送一个站点特定的命令。

void

setActiveExternalIPAddress ( String ipAddress) Set the external IP address in active mode.设置在主动模式下的外部IP地址。

void

setActivePortRange (int minPort, int maxPort) Set the client side port range in active mode.客户端设置在主动模式端口范围。

void

setBufferSize (int bufSize) Set the internal buffer size.设置内部缓冲区的大小。

void

setDataTimeout (int timeout) Sets the timeout in milliseconds to use when reading from the data connection.设置超时时间以毫秒为单位使用时，从数据连接读。

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

setListHiddenFiles (boolean listHiddenFiles) You can set this to true if you would like to get hidden files when

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.问题的FTP MFMT命令(并非所有服务器都支持)中规定的最后修改文件的时间。

void

setParserFactory ( FTPFileEntryParserFactory parserFactory) set the factory used for parser creation to the supplied factory object.为创建为所提供的解析器工厂对象所使用的工厂。

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

setRestartOffset (long offset) Sets the restart offset.设置重新启动所抵消。

void

setUseEPSVwithIPv4 (boolean selected) Set whether to use EPSV with IPv4.设置是否使用与IPv4 EPSV。

boolean

storeFile ( String remote, InputStream local) Stores a file on the server using the given name and taking input from the given InputStream.存储一个使用给定的名称，并采取从给定的InputStream输入服务器的文件。

storeFileStream ( String remote) Returns an OutputStream through which data can be written to store a file on the server using the given name.返回一个通过该数据可以被写入存储在使用给定的名称服务器上的文件的OutputStream。

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.使用上存储一个唯一的名称由服务器和从给定的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.使用上存储一个唯一的名称从给定的名称和给定的InputStream输入导出到服务器上的文件。

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.通过返回一个可写入的数据存储上使用一个唯一的名称从给定的名称派生服务器上的文件的OutputStream。

boolean

structureMount ( String pathname) Issue the FTP SMNT command.问题的FTP SMNT命令。