要求

要運(yùn)行ftp4j library，你需要Java 運(yùn)行時(shí)環(huán)境v. 1.4+.

安裝

將ftp4j JAR文件添加到你應(yīng)用程序的classpath中, 然后你就可以自動(dòng)啟用ftp4j類的使用了.

Javadocs

可參考ftp4j javadocs.

快速入門

包中的主類是FTPClient (it.sauronsoftware.ftp4j.FTPClient).

創(chuàng)建一個(gè)FTPClient 實(shí)例：

FTPClient client = new FTPClient();

連接遠(yuǎn)程FTP服務(wù):

client.connect("ftp.host.com");

如果服務(wù)端口不是標(biāo)準(zhǔn)的21端口 (或 FTPS的990端口)，需要使用port參數(shù)進(jìn)行指定:

client.connect("ftp.host.com", port);

如:

client.connect("ftp.host.com", 8021);

然后進(jìn)行登錄流程:

client.login("carlo", "mypassword");

如果沒有拋出任何異常的話，那么你就通過遠(yuǎn)程服務(wù)器的認(rèn)證了.否則，如果驗(yàn)證失敗，你將會(huì)收到it.sauronsoftware.ftp4j.FTPException異常.

匿名認(rèn)證，如果被連接服務(wù)認(rèn)可的話， 可通過發(fā)送用戶名"anonymous" 和任意密碼來完成(注意，有些服務(wù)器需要e-mail地址來代替密碼):

client.login("anonymous", "ftp4j");

使用遠(yuǎn)程FTP服務(wù)來做任何事情，然后再斷開連接:

client.disconnect(true);

這會(huì)向遠(yuǎn)程器發(fā)送FTP QUIT命令, 以進(jìn)行一個(gè)合法斷開流程.如果你只是想中斷連接而不想向服務(wù)器發(fā)送任何通知，那么可以使用:

client.disconnect(false);

使用代理進(jìn)行連接

客戶端通過連接器（一個(gè)繼承自it.sauronsoftware.ftp4j.FTPConnector的對(duì)象）來連接服務(wù)器, 它將返回一個(gè)已經(jīng)打開的連接(一個(gè)實(shí)現(xiàn)了it.sauronsoftware.ftp4j.FTPConnection 接口的對(duì)象).這也是為什么ftp4j 可以支持大量代理的原因.

在連接遠(yuǎn)程服務(wù)器前，客戶端實(shí)例可以使用setConnector() 方法來設(shè)置連接器:

client.setConnector(anyConnectorYouWant);

如果沒有設(shè)置連接器的話，會(huì)使用默認(rèn)的連接器DirectConnector (it.sauronsoftware.ftp4j.connectors.DirectConnector), 它實(shí)現(xiàn)了對(duì)遠(yuǎn)程服務(wù)器的直接連接，且不會(huì)使用代理。

如果你只能通過代理來連接遠(yuǎn)程服務(wù)器, ftp4j包可以讓你在下面的連接器中進(jìn)行選擇:

• HTTPTunnelConnector (it.sauronsoftware.ftp4j.connectors.HTTPTunnelConnector)
  它可以通過HTTP代理來進(jìn)行連接，并支持CONNECT方法.
• FTPProxyConnector (it.sauronsoftware.ftp4j.connectors.FTPProxyConnector)
  它可以通過FTP代理進(jìn)行連接,支持SITE和OPEN命令風(fēng)格的苛刻遠(yuǎn)程主機(jī)連接.其它類型的FTP代理,需要username@remotehost 認(rèn)證，且可以不使用連接器，因?yàn)樗鼈儗?duì)于客戶端來說是透明的。
• SOCKS4Connector (it.sauronsoftware.ftp4j.connectors.SOCKS4Connector)
  它可以通過SOCKS 4/4a代理進(jìn)行連接.
• SOCKS5Connector (it.sauronsoftware.ftp4j.connectors.SOCKS5Connector)
  它可以通過SOCKS 5代理進(jìn)行連接.

因?yàn)閒tp4j的連接器架構(gòu)設(shè)計(jì)為可插拔的，因此你可以繼承FTPConnector 抽象類來構(gòu)建自己的連接器.

FTPS/FTPES 安全連接

ftp4j包支持FTPS (隱式基于 TLS/SSL的FTP) 和FTPES (顯示基于TLS/SSL的FTP).

setSecurity() 方法可用來打開這種特性:

client.setSecurity(FTPClient.SECURITY_FTPS); // 啟用 FTPS

client.setSecurity(FTPClient.SECURITY_FTPES); // 啟用 FTPES

兩個(gè)方法都需要在連接遠(yuǎn)程服務(wù)器前調(diào)用.

如果安全協(xié)議設(shè)置成了SECURITY_FTPS, 則connect() 方法默認(rèn)使用的端口為990.

默認(rèn)情況下，客戶端對(duì)象商討SSL連接會(huì)使用javax.net.ssl.SSLSocketFactory.getDefault()作為其套接字工廠.可通過調(diào)用client.setSSLSocketFactory()方法來改變默認(rèn)套接字工廠. 另外一種SSLSocketFactory, 可用來信任遠(yuǎn)程服務(wù)器頒發(fā)的證書(謹(jǐn)慎使用):

import it.sauronsoftware.ftp4j.FTPClient;
 import java.security.KeyManagementException; 
import java.security.NoSuchAlgorithmException;
 import java.security.SecureRandom; 
import java.security.cert.X509Certificate;
 import javax.net.ssl.SSLContext;
 import javax.net.ssl.SSLSocketFactory; 
import javax.net.ssl.TrustManager; 
import javax.net.ssl.X509TrustManager;  
// ...  TrustManager[] trustManager = new TrustManager[] { new X509TrustManager() { 	
public X509Certificate[] getAcceptedIssuers() { 		return null; 	
} 	
public void checkClientTrusted(X509Certificate[] certs, String authType) { 	} 	
public void checkServerTrusted(X509Certificate[] certs, String authType) { 	} } }; 
SSLContext sslContext = null;
try { 	sslContext = SSLContext.getInstance("SSL"); 	
sslContext.init(null, trustManager, new SecureRandom()); 
} catch (NoSuchAlgorithmException e) { 	
e.printStackTrace(); 
} catch (KeyManagementException e) { 
	e.printStackTrace(); 
} 
SSLSocketFactory sslSocketFactory = sslContext.getSocketFactory(); 
FTPClient client = new FTPClient(); 
client.setSSLSocketFactory(sslSocketFactory); 
client.setSecurity(FTPClient.SECURITY_FTPS); 
// or client.setSecurity(FTPClient.SECURITY_FTPES);  // ...

瀏覽遠(yuǎn)程站點(diǎn)

獲取當(dāng)前目錄的的絕對(duì)路徑（此目錄是FTP服務(wù)器的home目錄）:

String dir = client.currentDirectory();

改變目錄:

client.changeDirectory(newPath);

你可以使用絕對(duì)路徑和相對(duì)路徑:

client.changeDirectory("/an/absolute/one"); 
client.changeDirectory("relative");

回到父目錄:

client.changeDirectoryUp();

重命名文件和目錄

要重命名遠(yuǎn)程文件或目錄:

client.rename("oldname", "newname");

移動(dòng)文件和文件家

rename() 方法也可以用來從當(dāng)前位置移動(dòng)文件或目錄到其它位置.

在這個(gè)例子子，假設(shè)在當(dāng)前工作目錄中，你有一個(gè)名為"myfile.txt"的文件,然后你想將其移動(dòng)到子目錄"myfolder"中:

client.rename("myfile.txt", "myfolder/myfile.txt");

刪除文件

要?jiǎng)h除遠(yuǎn)程文件，需要調(diào)用:

client.deleteFile(relativeOrAbsolutePath);

在這個(gè)例子中:

client.deleteFile("useless.txt");

創(chuàng)建、刪除目錄

如果遠(yuǎn)程服務(wù)給你機(jī)會(huì)的話，你可以在遠(yuǎn)程站點(diǎn)上創(chuàng)建新目錄:

client.createDirectory("newfolder");

你也可以已存在的目錄:

client.deleteDirectory(absoluteOrRelativePath);

在這個(gè)例子中:

client.deleteDirectory("oldfolder");

請(qǐng)注意，通常情況下，F(xiàn)TP 服務(wù)器只允許刪除空目錄.

列出文件、目錄、連接

FTP 協(xié)議并不會(huì)提供大量支持方法來獲取工作目錄的完整信息.通常LIST命令會(huì)給你想知道的東西，但不辛的是，每個(gè)服務(wù)器會(huì)使用不同樣式的響應(yīng). 這意味著某些服務(wù)器會(huì)返回UNIX樣式的目錄，有些服務(wù)器會(huì)返回DOS樣式的目錄,其它的服務(wù)器又會(huì)使用別的樣式.

ftp4j 包可以處理許多的LIST響應(yīng)格式, 并將它們構(gòu)建成統(tǒng)一目錄內(nèi)容的結(jié)構(gòu)對(duì)象表示.當(dāng)前ftp4j可以處理:

• UNIX 樣式及其變種(如MAC樣式)
• DOS 樣式
• NetWare 樣式
• EPLF
• MLSD

這可以通過使用可插拔的parsers來完成.包it.sauronsoftware.ftp4j.listparsers包含了用于處理上述樣式的對(duì)象.大多數(shù)時(shí)間，這些已經(jīng)夠用了。

要列出當(dāng)前工作目錄下的文件或文件夾，可調(diào)用:

FTPFile[] list = client.list();

如果你收到了FTPListParseException (it.sauronsoftware.ftp4j.FTPListParseException) 異常，這就意味著服務(wù)器對(duì)LIST命令返回了不可理解的樣式,即它不是上述列出的樣式.因此，你可以嘗試使用listNames() 方法， 但它并不如list()方法有優(yōu)勢(shì).。為了彌補(bǔ)這種缺陷，你可以構(gòu)建你自己的LIST響應(yīng)解析器,以支持你遇到的樣式.你可以實(shí)現(xiàn)FTPListParser (it.sauronsoftware.ftp4j.FTPListParser) 接口，然后你可以在client的addListParser()方法使用此實(shí)現(xiàn).

FTPFile (it.sauronsoftware.ftp4j.FTPFile) 對(duì)象提供了目錄內(nèi)容的表示，包括文件，子目錄和連接. 根據(jù)服務(wù)器的響應(yīng)，F(xiàn)TPFile對(duì)象的某些字段可以是null 的或者是無意義的.請(qǐng)檢查javadocs來了解細(xì)節(jié).

在list() 方法中你也可以使用文件過濾參數(shù),如：

FTPFile[] list = client.list("*.jpg");

如果連接服務(wù)器明確支持MLSD命令, ftp4j會(huì)用其來代替基本的LIST命令。MLSD的響應(yīng)事實(shí)更為標(biāo)準(zhǔn)，準(zhǔn)確，更易解析.不幸的是，不是所有服務(wù)器都支持這個(gè)命令，并且有些服務(wù)器支持得非常糟糕.基于這些理由，開發(fā)者可以控制ftp4j是否應(yīng)該使用MLSD命令，即通過調(diào)用FTPClient對(duì)象的setMLSDPolicy()方法. 合法的值:

• FTPClient.MLSD_IF_SUPPORTED
  client只在服務(wù)器明確支持MLSD命令時(shí)，才使用MLSD命令. 這是ftp4j默認(rèn)的行為.

• FTPClient.MLSD_ALWAYS
  client總是會(huì)使用MLSD命令, 即便服務(wù)器沒有明確表明支持MLSD命令.

• FTPClient.MLSD_NEVER
  client絕不使用MLSD命令,即便服務(wù)器明確表明支持MLSD命令.

例如：

獲取文件、目錄的最后修改時(shí)間

通常情況下FTPFile對(duì)象會(huì)告訴你條目的最后修改時(shí)間, 但正如上面描述的，這依賴于服務(wù)器發(fā)回的響應(yīng).如果你需要最后的修改時(shí)間，但你又不能通過list()方法得到，那么可以嘗試這樣做：

java.util.Date md = client.modifiedDate("filename.ext");

下載、上傳文件

下載遠(yuǎn)程文件最簡(jiǎn)單的方式是調(diào)用download(String, File) 方法：

client.download("remoteFile.ext", new java.io.File("localFile.ext"));

要上傳:

client.upload(new java.io.File("localFile.ext"));

要在已有文件中上傳追加內(nèi)容:

client.append(new java.io.File("localFile.ext"));

這些是阻塞式調(diào)用:它們會(huì)在傳輸完成后(或failed, 或 aborted時(shí))才返回. 此外同步鎖是否由客戶端來實(shí)施的，因?yàn)樵诿總€(gè)時(shí)間段內(nèi)只允許有一個(gè)常規(guī)的FTP通信.在每個(gè)時(shí)間段內(nèi)，你可以處理多個(gè)傳輸器，即使用多個(gè)FTPClient 對(duì)象,每個(gè)都與服務(wù)器建立一個(gè)私有連接.

你可以使用FTPDataTransferListener (it.sauronsoftware.ftp4j.FTPDataTransferListener)對(duì)象來監(jiān)控傳輸.你可以自己實(shí)現(xiàn)一個(gè):

import it.sauronsoftware.ftp4j.FTPDataTransferListener;  
public class MyTransferListener implements FTPDataTransferListener {  	
public void started() { 		
// Transfer started 	
}  	
public void transferred(int length) { 		
// Yet other length bytes has been transferred since the last time this 		
// method was called 	
}  	
public void completed() { 		
// Transfer completed 	
}  	
public void aborted() { 		
// Transfer aborted 	
}  	
public void failed() { 		
// Transfer failed 	
}  
}

現(xiàn)在像下面這樣來下載或上傳:

client.download("remoteFile.ext", new java.io.File("localFile.ext"), new MyTransferListener());

client.upload(new java.io.File("localFile.ext"), new MyTransferListener());

client.append(new java.io.File("localFile.ext"), new MyTransferListener());

當(dāng)client處理下載或上傳時(shí)，傳輸器可以被同一個(gè)FTPClient對(duì)象的不同線程通過調(diào)用 abortCurrentDataTransfer() 方法aborted. 此方法還需要一個(gè)boolean參數(shù):true表示執(zhí)行合法的abort過程(即向服務(wù)器發(fā)送ABOR命令), false表示實(shí)然關(guān)閉傳輸器，而不向服務(wù)器發(fā)送通知:

client.abortCurrentDataTransfer(true); // Sends ABOR

client.abortCurrentDataTransfer(false); // Breaks abruptly

需要注意的是，list()和listNames() 方法暗中包含了數(shù)據(jù)傳輸器，因abortCurrentDataTransfer() 方法也可以用來中斷其list過程.

當(dāng)數(shù)據(jù)傳輸器在download(), upload(), append(), list() and listNames() 方法中中斷時(shí)，將會(huì)拋出FTPAbortedException (it.sauronsoftware.ftp4j.FTPAbortedException).

下載和上傳操作可通過restartAt 參數(shù)來重新恢復(fù):

client.download("remoteFile.ext", new java.io.File("localFile.ext"), 1056);

此操作會(huì)文件的第1056個(gè)字節(jié)處繼續(xù)執(zhí)行下載操作。第一個(gè)傳輸?shù)淖止?jié)將是第1057個(gè).

其它 download(), upload() 和append()方法的變種可以讓你使用流來替代java.io.File對(duì)象.因此你可以在數(shù)據(jù)庫，網(wǎng)絡(luò)連接或其它流上來傳輸數(shù)據(jù)。

Active 、 passive 數(shù)據(jù)傳輸模式

客戶端和服務(wù)器之間的數(shù)據(jù)傳輸通道是通過單獨(dú)的網(wǎng)絡(luò)連接來建立的. 在傳輸通道建立期間，服務(wù)器可以是active或passive的. 服務(wù)器激活數(shù)據(jù)傳輸時(shí)，工作如下：

1. client向服務(wù)器發(fā)送其IP地址和端口號(hào).
2. client向服務(wù)器發(fā)送數(shù)據(jù)傳輸請(qǐng)求，并在之前發(fā)送的端口上啟動(dòng)監(jiān)聽.
3. 服務(wù)器使用客戶端提供的地址和端口來連接客房端.
4. 數(shù)據(jù)傳輸將在新建立的通道中進(jìn)行.

active模式需要你的client能夠收到來自服務(wù)器的連接.如果你的client處于防火墻， 代理或這兩者混合之后，那么大部分時(shí)間都會(huì)出現(xiàn)問題，因?yàn)樗荒苁盏絹硗饨绲倪B接. 下面是passive數(shù)據(jù)傳輸模式：

1. client要求服務(wù)器準(zhǔn)備好一個(gè)passive數(shù)據(jù)傳輸.
2. 服務(wù)器使用其IP地址和端口號(hào)進(jìn)行響應(yīng).
3. client請(qǐng)求傳輸和連接.
4. 數(shù)據(jù)傳輸將在新建立的通道中進(jìn)行.

在passive模式中，客戶端連接不要求能收到服務(wù)器的連接請(qǐng)求.

在ftp4j中，你可以使用下面的調(diào)用來切換active、passive模式:

client.setPassive(false); // Active mode

client.setPassive(true); // Passive mode

ftp4j client passive 標(biāo)志的默認(rèn)值為true: 如果你沒有調(diào)用setPassive(false) ，你的客戶端在每次傳輸前，都會(huì)向服務(wù)器請(qǐng)求passive模式.

當(dāng)使用 passive文件傳輸時(shí)，服務(wù)器會(huì)提供一個(gè) IP地址和一個(gè)端口號(hào).作為FTP規(guī)范的client,需要使用給定的主機(jī)號(hào)和端口進(jìn)行連接.在商業(yè)環(huán)境中，這種行為可能會(huì)經(jīng)常帶來問題，因?yàn)镹AT配置可能會(huì)阻止對(duì)IP地址的連接.這就是為什么FTP clients通常會(huì)忽略服務(wù)器返回的任何IP地址，進(jìn)而在通信線路中使用同樣的主機(jī)來連接服務(wù)器.ftp4j的行為依賴于服務(wù)器因素:

• 每個(gè)FTPConnector 都有其默認(rèn)行為.大部分連接器都會(huì)忽略服務(wù)器返回的IP地址。目前，默認(rèn)使用返回地址的連接器是FTPProxyConnector.
• 連接器的行為可通過定義名為ftp4j.passiveDataTransfer.useSuggestedAddress的系統(tǒng)屬性來覆蓋。如果設(shè)置為"true", "yes" 或"1",所有連接器都會(huì)使用服務(wù)器返回的地址，反之，如果將其設(shè)置為"false", "no" or "0", 所有服務(wù)器都不會(huì)使用返回的地址.
• 最后,連接器的默認(rèn)行為和全局設(shè)置都可以在任何連接器實(shí)例中進(jìn)行覆蓋。你可通過獲取客房端連接器，并調(diào)用其setUseSuggestedAddressForDataConnections() 方法來達(dá)到目的.

在active傳輸模式中，可以設(shè)置下面的系統(tǒng)屬性:

• ftp4j.activeDataTransfer.hostAddress
  主機(jī)地址.當(dāng)服務(wù)器請(qǐng)求執(zhí)行與客戶端連接時(shí)，client會(huì)跳轉(zhuǎn)到給定地址的服務(wù)器. 此值應(yīng)該是一個(gè)有效的IPv4地址，如：178.12.34.167. 如果沒有提供此值，客戶端會(huì)自動(dòng)解析系統(tǒng)地址.但如果client運(yùn)行于LAN中，為了激活數(shù)據(jù)傳輸，將會(huì)使用帶端口轉(zhuǎn)發(fā)的路由器來連接外部服務(wù)器,那么自動(dòng)探測(cè)到的地址可能不是正確的. 當(dāng)系統(tǒng)有多個(gè)網(wǎng)絡(luò)接口時(shí)，也可能發(fā)生這種情況.通常使用系統(tǒng)屬性，可以解決這種問題

• ftp4j.activeDataTransfer.portRange
  連接端口范圍. client會(huì)在其中挑選一個(gè)來進(jìn)行數(shù)據(jù)傳輸.此值 必須是start-stop 形式 ，如6000-7000 表示client只會(huì)在給定范圍內(nèi)挑選一個(gè)端口來連接服務(wù)器.默認(rèn)情況下沒有指定端口范圍:這表示client會(huì)挑選任何一個(gè)可用的端口.

• ftp4j.activeDataTransfer.acceptTimeout
  以毫秒為單位的連接超時(shí)時(shí)間. 如果服務(wù)器不能在給定超時(shí)時(shí)間內(nèi)連接client，傳輸會(huì)因FTPDataTransferException異常而中斷.0值表示永不超時(shí)。默認(rèn)值30000 (即30秒).

要設(shè)置系統(tǒng)屬性，你可以:

• 用一個(gè)或多個(gè) -Dproperty=value參數(shù)來啟動(dòng)JVM.如:

  java -Dftp4j.activeDataTransfer.hostAddress=178.12.34.167      -Dftp4j.activeDataTransfer.portRange=6000-7000      -Dftp4j.activeDataTransfer.acceptTimeout=5000 MyClass

• 直接在代碼中設(shè)置系統(tǒng)屬性，如:

  System.setProperty("ftp4j.activeDataTransfer.hostAddress", "178.12.34.167"); 
  System.setProperty("ftp4j.activeDataTransfer.portRange", "6000-7000"); 
  System.setProperty("ftp4j.activeDataTransfer.acceptTimeout", "5000");

二進(jìn)制和文本數(shù)據(jù)傳輸類型

數(shù)據(jù)傳輸?shù)牧硪粋€(gè)核心概念是binary 和textual 類型.當(dāng)傳傳輸?shù)奈募嵌M(jìn)制文件時(shí)，它將視為二進(jìn)制流，服務(wù)器會(huì)按原樣存儲(chǔ)。而文本數(shù)據(jù)傳輸會(huì)將傳輸?shù)奈募暈樽址?會(huì)進(jìn)行字符集轉(zhuǎn)換. 假設(shè)你的client正運(yùn)行Windows平臺(tái)上，而服務(wù)器運(yùn)行UNIX上,它們的默認(rèn)字符集通常是不同的. client以文本類型來發(fā)送文件時(shí)，client會(huì)假設(shè)文件是按機(jī)器標(biāo)準(zhǔn)字符集來編碼的，因此在發(fā)送前，它會(huì)解碼每個(gè)字符并將其編碼為 中間字符集. 服務(wù)器收到流后，在存儲(chǔ)前，會(huì)解碼中間字符集，并將其編碼為機(jī)器默認(rèn)的字符集.字節(jié)雖然被改變了，但內(nèi)容是相同的。

你可以調(diào)用下面的方法選擇你傳輸?shù)念愋?

client.setType(FTPClient.TYPE_TEXTUAL);

client.setType(FTPClient.TYPE_BINARY);

client.setType(FTPClient.TYPE_AUTO);

默認(rèn)的TYPE_AUTO常量 ,會(huì)讓client自動(dòng)來挑選類型:如果文件的擴(kuò)展名是client能被識(shí)別的文本類型標(biāo)記，那么它會(huì)選擇文本傳輸器來執(zhí)行. 文件擴(kuò)展名是通過FTPTextualExtensionRecognizer (it.sauronsoftware.ftp4j.FTPTextualExtensionRecognizer) 實(shí)例來識(shí)別的. 默認(rèn)擴(kuò)展識(shí)別器是it.sauronsoftware.ftp4j.recognizers.DefaultTextualExtensionRecognizer, 會(huì)將下面的視為文本類型:

abc acgi aip asm asp c c cc cc com conf cpp
csh css cxx def el etx f f f77 f90 f90 flx
for for g h h hh hh hlb htc htm html htmls
htt htx idc jav jav java java js ksh list
log lsp lst lsx m m mar mcf p pas php pl pl
pm py rexx rt rt rtf rtx s scm scm sdml sgm
sgm sgml sgml sh shtml shtml spc ssi talk
tcl tcsh text tsv txt uil uni unis uri uris
uu uue vcs wml wmls wsc xml zsh

你可通過實(shí)現(xiàn)FTPTextualExtensionRecognizer 接口來實(shí)現(xiàn)你自己的識(shí)別器，但你可以更喜歡使用 class ParametricTextualExtensionRecognizer(it.sauronsoftware.ftp4j.recognizers.ParametricTextualExtensionRecognizer)便利類.
無論如何，都不要忘記將你的識(shí)別器設(shè)置在client中:

client.setTextualExtensionRecognizer(myRecognizer);

數(shù)據(jù)傳輸壓縮

有些服務(wù)器支持?jǐn)?shù)據(jù)傳輸壓縮特性－MODE Z. 在傳輸大文件時(shí)，此特性可以節(jié)省帶寬.一旦client連上服務(wù)器并通過認(rèn)證,就可通過調(diào)用下面的方法來檢查是否支持壓縮：

如果服務(wù)器端支持壓縮,就可通過下面的調(diào)用來啟用壓縮:

在此調(diào)用之后，后續(xù)的數(shù)據(jù)傳輸(下載，上傳，列舉操作）都被將壓縮以節(jié)省帶寬.

數(shù)據(jù)傳輸壓縮可通過下面的調(diào)用來禁用:

也可以檢查標(biāo)記值:

請(qǐng)注意：壓縮數(shù)據(jù)傳輸只當(dāng)壓縮支持且啟用了的情況下才會(huì)發(fā)生.

默認(rèn)情況下，壓縮是禁用的，即便是服務(wù)器支持壓縮. 如果有需要,可以顯示地打開.

不做任何事（NOOPing the server）

假設(shè)你的client什么事情都不做，因?yàn)樵诘却脩糨斎? 通常情況下， FTP服務(wù)器會(huì)自動(dòng)斷開非活躍客戶端. 為了避免超時(shí)，你可以發(fā)送NOOP命令.
此命令不會(huì)做任何事情，但它會(huì)向服務(wù)器說明：客戶端仍然還活著，請(qǐng)重圍超時(shí)計(jì)數(shù)器.調(diào)用如下:

client.noop();

當(dāng)非活躍超時(shí)發(fā)生時(shí)，客戶端也可以自動(dòng)發(fā)送NOOPs. 默認(rèn)情況下，此特性是禁用的。它可以在 setAutoNoopTimeout() 方法中設(shè)置超時(shí)時(shí)間時(shí)啟用,并提供一個(gè)毫秒為單位的值.如:

client.setAutoNoopTimeout(30000);

使用此值，client會(huì)在30秒后發(fā)送一個(gè)NOOP命令.

NOOP超時(shí)可通過設(shè)置小于等于0的值來禁用:

client.setAutoNoopTimeout(0);

網(wǎng)站特殊的自定義命令

你可以像下面這樣來發(fā)送站點(diǎn)特殊命令：

FTPReply reply = client.sendSiteCommand("YOUR COMMAND");

你也可以發(fā)送自定義命令:

FTPReply reply = client.sendCustomCommand("YOUR COMMAND");

sendSiteCommand() 和 sendCustomCommand() 都會(huì)返回一個(gè)FTPReply (it.sauronsoftware.ftp4j.FTPReply)對(duì)象.使用此對(duì)象，你可以檢查服務(wù)器的響應(yīng)代碼和消息. 
FTPCodes (it.sauronsoftware.ftp4j.FTPCodes) 接口報(bào)告了一些通用的FTP響應(yīng)代碼,因此你可以使用這些包中的某個(gè)來進(jìn)行匹配.

異常處理

ftp4j 包定義了五種類型的異常:

• FTPException (it.sauronsoftware.ftp4.FTPException) 
  依賴于方法，這會(huì)報(bào)告拋出了一個(gè)FTP故障.你可以檢查報(bào)告的錯(cuò)誤碼，使用FTPCodes 常量來獲取故障原因的詳細(xì)信息.
• FTPIllegalReplyException (it.sauronsoftware.ftp4.FTPIllegalReplyException)
  這表示遠(yuǎn)程服務(wù)器使用非法方式進(jìn)行了應(yīng)答, 這與FTP是不兼容的. 這應(yīng)該是非常罕見的.
• FTPListParseException (it.sauronsoftware.ftp4.FTPListParseException)
  這通常發(fā)生在list()方法，如果服務(wù)器發(fā)回的響應(yīng)不能被客戶端包中現(xiàn)有解析器進(jìn)行的話，就會(huì)拋出此種異常
• FTPDataTransferException (it.sauronsoftware.ftp4.FTPDataTransferException)
  當(dāng)數(shù)據(jù)傳輸 (download, upload, but also list and listNames) 因網(wǎng)絡(luò)連接錯(cuò)誤失敗時(shí)，就會(huì)拋出此種異常.
• FTPAbortedException (it.sauronsoftware.ftp4.FTPAbortedException)
  當(dāng)數(shù)據(jù)傳輸 (download, upload, but also list and listNames) 因客戶端發(fā)出中斷請(qǐng)求失敗時(shí)，拋出的異常.