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

你可能感兴趣的:(FTPClient)