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傳送到遠程計算機。