sun.net.ftp.FtpClient的函数说明

sun.net.ftp.FtpClient的函数说明

关键字:   sun.net.ftp.FtpClient    

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传送到远程计算机。