转 - sun.net.ftp.FtpClient 中文API

sun.net.ftp.FtpClient.，该类库主要提供了用于建立FTP连接的类。利用这些类的方法，编程人员可以远程登录到FTP服务器，列举该服务器上的目录，设置传输协议，以及传送文件。FtpClient类涵盖了几乎所有FTP的功能，FtpClient的实例变量保存了有关建立"代理"的各种信息。下面给出了这些实例变量。

 

　　public static boolean useFtpProxy

 

　　这个变量用于表明FTP传输过程中是否使用了一个代理，因此，它实际上是一个标记，此标记若为TRUE，表明使用了一个代理主机。

 

　　public static String ftpProxyHost

 

　　此变量只有在变量useFtpProxy为TRUE时才有效，用于保存代理主机名。

 

　　public static int ftpProxyPort

 

　　此变量只有在变量useFtpProxy为TRUE时才有效，用于保存代理主机的端口地址。

 

　　FtpClient有三种不同形式的构造函数，如下所示：

 

　　1、public FtpClient(String hostname,int port)

 

　　　此构造函数利用给出的主机名和端口号建立一条FTP连接。

 

　　2、public FtpClient(String hostname)

 

　　此构造函数利用给出的主机名建立一条FTP连接，使用默认端口号。

 

　　3、FtpClient()

 

　　此构造函数将创建一FtpClient类，但不建立FTP连接。这时，FTP连接可以用openServer方法建立。

 

　　一旦建立了类FtpClient，就可以用这个类的方法来打开与FTP服务器的连接。类ftpClient提供了如下两个可用于打开与FTP服务器之间的连接的方法。

 

　　public void openServer(String hostname)

 

　　这个方法用于建立一条与指定主机上的FTP服务器的连接，使用默认端口号。

 

　　public void openServer(String host,int port)

 

　　这个方法用于建立一条与指定主机、指定端口上的FTP服务器的连接。

 

　　打开连接之后，接下来的工作是注册到FTP服务器。这时需要利用下面的方法。

 

　　public void login(String username，String password)

 

　　此方法利用参数username和password登录到FTP服务器。使用过Intemet的用户应该知道，匿名FTP服务器的登录用户名为anonymous，密码一般用自己的电子邮件地址。

 

　　下面是FtpClient类所提供的一些控制命令。

 

　　public void cd(String remoteDirectory)

 

　　该命令用于把远程系统上的目录切换到参数remoteDirectory所指定的目录。

 

　　public void cdUp()：该命令用于把远程系统上的目录切换到上一级目录。

 

　　public String pwd()：该命令可显示远程系统上的目录状态。

 

　　public void binary()：该命令可把传输格式设置为二进制格式。

 

　　public void ascii()：该命令可把传输协议设置为ASCII码格式。

 

　　public void rename(String string，String string1)

 

　　该命令可对远程系统上的目录或者文件进行重命名操作。

 

　　除了上述方法外，类FtpClient还提供了可用于传递并检索目录清单和文件的若干方法。这些方法返回的是可供读或写的输入、输出流。下面是其中一些主要的方法。

 

　　public TelnetInputStream list()

 

　　返回与远程机器上当前目录相对应的输入流。

 

　　public TelnetInputStream get(String filename)

 

　　获取远程机器上的文件filename，借助TelnetInputStream把该文件传送到本地。

 

　　public TelnetOutputStream put(String filename)

 

　　以写方式打开一输出流，通过这一输出流把文件filename传送到远程计算机。