最近一段時間，因?yàn)楣卷椖康男枰瑢TTP協(xié)議以及FTP協(xié)議都有所了解，并且在基于網(wǎng)絡(luò)開放源代碼

基礎(chǔ)上， 能夠完成項目的要求。今天給大家分享下，怎樣建立屬于我們自己的FTP服務(wù)器以及FPT客戶端，同時

非常非常感謝 這些開源軟件及其作者為IT行業(yè)做出的貢獻(xiàn)，最大程度上至少解放了我們這些IT碼農(nóng)。且看正文。

本文主要內(nèi)容：

1、FTP服務(wù)端部署---- 基于Android中SwiFTP開源軟件介紹；

2、FTP客戶端部署 --- 基于 ftp4j 開源jar包的客戶端開發(fā)；

3、使用步驟 --- 如何測試我們搭建的FTP可操作性。

本文所涉及到的知識、文檔、源代碼照舊會在文章末尾列出。歡迎大家一起學(xué)習(xí)。

一、 FTP服務(wù)端部署

SwiFTP 開源軟件是為Android系統(tǒng)開發(fā)，也就是說我們可以將其源代碼嵌入到我們的項目中。當(dāng)然，對其進(jìn)行

一定改造還是 必不可少的。這兒只是從感官上對SwiFTP的運(yùn)行效果圖進(jìn)行一下說面，以便幫助大家有初步認(rèn)識：

SwiFTP 資料信息：

Google Download 介紹 ： http://code.google.com/p/swiftp/downloads/list

GitHub 介紹 ： https://github.com/ppareit/swiftp

Android版本SwiFTP截圖

界面其實(shí)很簡單，但是從設(shè)計角度分析，SwiFTP框架系統(tǒng)還是值得我們研究的，當(dāng)然如果你想改造成

屬于自己的 FTP服務(wù)器(一般就是改改用戶名、密碼、PWD(起始工作目錄))等，那更得花時間去鉆研了。

二、FTP客戶端部署

接下來，重點(diǎn)介紹我們的主角ftp4j開源jar包，該jar包就是開發(fā)我們FTP客戶端核心了。

ftp4j 官網(wǎng)地址： http://www.sauronsoftware.it/projects/ftp4j/ 。對比與AndroidSDK而言，也就是ftp4j

SDK了， 一切的 一切(文檔、源代碼、示例)都可以在官網(wǎng)查詢 。想要了解的同學(xué)，至少得保證把首頁給 整明白吧。

1、 ftp4j概要

官網(wǎng)描述如下:

Theftp4jlibraryimplementsaJava full-features FTP client. With ftp4j embedded in your

applicationyou can : FTPsite(directorylistingincluded),create,delete,transfer files

(uploadanddownload) , browsethe remote FTPsite(directorylistingincluded),create,delete,

renameandmoveremotedirectoriesandfiles.

關(guān)于FTP連接主要有如下幾種方式：

The ftp4j library can connect the remote FTP server:

· Througha direct TCP/IPconnection. 一般就是直接連接了。

· ThroughaFTP proxy. FTP代理

· Tunnelling through aHTTPproxy. HTTP代理

· ThroughaSOCKS 4/4aproxy.

· ThroughaSOCKS 5 proxy.

· You can add support to otherproxies plugging your own connector, since the ftp4jconnection manager

architecture is modular.

2、主要類簡介

下面根據(jù)官網(wǎng)的描述，將該 ftp4j 庫的主要類簡單說明下：

FTPClient類

該類封裝了對FTPCommand的請求操作。例如：連接FTP服務(wù)器、進(jìn)行各種各樣的FTP操作(上傳、下載、

刪除、重命名文件 等)。基本使用流程圖如下：

利用偽代碼描述如下：

    	//1、登錄至FTPp服務(wù)器
	mFTPClient.connect(mFTPHost, mFTPPort);
	//2、請求授權(quán)
	mFTPClient.login(mFTPUser, mFTPPassword);
	//3、各種FTP操作
	mFTPClient.upload();
	mFTPClient.download();
	//4、斷開FTP連接
	mFTPClient.disconnect();
  

主要方法：

public java.lang.String []connect(java.lang.Stringhost, intport) throws java.lang.IllegalStateException,

java.io.IOException , FTPIllegalReplyException , FTPException

功能：與FTP服務(wù)器主機(jī)建立連接 .

參數(shù) ：

host- FTP服務(wù)器的主機(jī)名(host name) 或者 ip地址

port- FTP服務(wù)器的監(jiān)聽端口

返回值 :The server welcome message ，F(xiàn)TP服務(wù)器響應(yīng)消息

拋出異常類型 ： (略，參見后文)

public void login(java.lang.Stringusername , java.lang.Stringpassword)

throws java.lang.IllegalStateException,

java.io.IOException,FTPIllegalReplyException, FTPException

功能：根據(jù)用戶名以及密碼登錄FTP服務(wù)器

參數(shù)：

username– 登錄FTP服務(wù)器的用戶名.

password- 登錄FTP服務(wù)器的 密碼

返回值：(無)

拋出異常類型 ：(略，參見后文)

public java.lang.String currentDirectory() throws java.lang.IllegalStateException, java.io.IOException,

FTPIllegalReplyException, FTPException

功能 ：獲取FTP服務(wù)器當(dāng)前工作目錄。

返回值：FTP服務(wù)器當(dāng)前工作目錄

拋出異常類型 ：(略，參見后文)

public longfileSize(java.lang.Stringpath)

功能：獲取指定文件的大小。

參數(shù)：

path -- 指定文件所在的路徑，可以是相對路徑或者是絕對路徑。

返回值 ： 指定文件的大小，單位為byte.

拋出異常類型 : (略，參見后文)

public void deleteFile(java.lang.Stringpath) throws java.lang.IllegalStateException, java.io.IOException,

FTPIllegalReplyException, FTPException

功能：刪除指定文件

參數(shù)：

path -- 指定文件所在的路徑，可以使相對路徑或者是絕對路徑。

返回值：(無)

拋出異常類型 : (略，參見后文)

public void deleteDirectory (java.lang.Stringpath) throws java.lang.IllegalStateException,

java.io.IOException, FTPIllegalReplyException, FTPException

功能：刪除指定文件夾

參數(shù)：

path -- 指定文件所在的路徑，可以使相對路徑或者是絕對路徑。

返回值：(無)

拋出異常類型 ： (略，參見后文)

publicFTPFile[] list() throws java.lang.IllegalStateException , java.io.IOException,

功能： 獲取當(dāng)前工作目錄所有文件信息：文件名、文件大小、文件類型(文件或者文件夾)。

返回值：FTPFile[]數(shù)組對象 ---- 該文件夾所對應(yīng)的信息

拋出異常類型 ：(略，參見后文)

public java.lang.String[] listNames()

功能：獲取當(dāng)前工作目錄的所有文件名。

返回值：String[]類型 ----- 所有文件名

拋出異常類型 ：(略，參見后文)

public void upload(java.io.Filefile , FTPDataTransferListenerlistener) throws java.lang.IllegalStateException,

java.io.FileNotFoundException, java.io.IOException, FTPIllegalReplyException, FTPException,

FTPDataTransferException,FTPAbortedException

功能 ：上傳文件至FTP服務(wù)器。 該操作會阻塞當(dāng)前線程，阻塞會在操作完成后解除 。 該方法可以通過調(diào)用

abortCurrentDataTransfer()方法去中斷。默認(rèn)上傳的文件目錄是當(dāng)前工作目錄，通過currentDirectory()方法

可以獲得。 注意：不支持上傳文件夾。

參數(shù)：file -- 上傳文件的File對象

listener --監(jiān)聽器 (稍后介紹)

拋出異常類型 :(略，參見后文)

public void download(java.lang.StringremoteFileName, java.io.FilelocalFile,

FTPDataTransferListenerlistener)

throws java.lang.IllegalStateException,java.io.FileNotFoundException,

java.io.IOException, FTPIllegalReplyException, FTPException,

FTPDataTransferException,FTPAbortedException

功能：下載某個文件值指定路徑。該操作會阻塞當(dāng)前線程，阻塞會在操作完成后解除。該方法可以通過調(diào)用

abortCurrentDataTransfer()方法去中斷。注意：不支持下載文件夾。

參數(shù):

remoteFileName- 相對路徑(相對于當(dāng)前目錄)時則是文件名或者絕對路徑(例如：Linux中以”\”為前綴)

localFile- 本地存放文件的File對象。

listener- 監(jiān)聽器 (稍后介紹)

拋出異常類型 ：(略，參見后文)

public voidabortCurrentDataTransfer(booleansendAborCommand) throws java.io.IOException,

FTPIllegalReplyException

功能：如果存在任何正在進(jìn)行的文件操作(上傳/下載)，該方法會中斷它

參數(shù)

sendAborCommand -- true則代表中斷文件操作，并且發(fā)送ABORT 命令給FTP服務(wù)器

false 代表關(guān)閉中斷文件操作，將不會發(fā)送任何消息給FTP服務(wù)器。

拋出異常類型 ：(略，參見后文)

FTPFile 類

該類封裝了FTP服務(wù)器中文件的信息，即Model類。

常量字段：

文件對應(yīng)類型

public static final intTYPE_FILE 文件

public static final intTYPE_DIRECTORY文件夾

public static final intTYPE_LINK 文件引用

主要方法：

public java.util.Date getModifiedDate() 獲取文件最后修改日期。

public int getType() 獲取文件類型。

public long getSize() 獲取文件大小 ，單位為byte。

FTPDataTransferListener Interface

該接口約定了文件傳輸過程中的回調(diào)方法類型。我們可以實(shí)現(xiàn)該類去監(jiān)聽每個具體的文件操作過程。

回調(diào)接口有：

void started() 回調(diào)方法，表示已開始文件傳輸。

void completed() 回調(diào)方法，表示文件傳輸已完成。

void aborted() 回調(diào)方法，表示文件傳輸已被中斷，可由abortCurrentDataTransfer()觸發(fā)。

void failed() 回調(diào)方法，表示文件傳輸由于某種錯誤而失敗。

void transferred(intlength) 回調(diào)方法，表示本次回調(diào)過程中已下載/上傳的文件字節(jié)大小。

參數(shù)： length--本次回調(diào)過程中下載/上傳的文件字節(jié)大小。

PS ：我們可以累積length大小，以便獲得當(dāng)前文件已傳輸?shù)淖止?jié)數(shù)。

異常種類：

ftp4j 的自定義共有如下幾種，基本上每個FTP操作，都伴隨著這些異常，因此，我們需要捕獲這些異常信息。

FTPAbortedException

當(dāng)文件傳輸過程被顯示中斷(例如，調(diào)用abortCurrentDataTransfer()方法)時，拋出該異常。

FTPDataTransferException

在文件傳輸過程中，發(fā)生任何I/O(例如,無法創(chuàng)建文件流)錯誤，都會拋出 該異常 。

FTPException

封裝了FTP錯誤碼以及錯誤消息的異常類。PS：類似于HTTP錯誤碼以及錯誤消息

常用方法：

public int getCode() 獲取異常發(fā)生時，F(xiàn)TP的錯誤碼(錯誤碼字段值具體可見FTPCodes類)

public java.lang.String getMessage() 獲取異常發(fā)生時，F(xiàn)TP的錯誤消息。

FTPIllegalReplyException

當(dāng)FTP服務(wù)器以一種非正常的方式---違反了FTP協(xié)議的規(guī)則響應(yīng)時，拋出該異常。

FTPListParseException

通過list()方法請求FTP服務(wù)時，如果此時FTP服務(wù)器的返回的消息不能被正確的解析時，都會拋出該異常。

通過對這些相關(guān)知識的學(xué)習(xí)，足矣利用 ftp4j jar包完成我們簡易卻又充實(shí)的專屬我們自己的FTP客戶端了。

接下來，便開始我們的FTP客戶端的開發(fā) 。

3、FTP客戶端開發(fā)

在功能需求上，開發(fā)一個FTP客戶端和開發(fā)一個文件選擇器甚至文件管理器基本上沒有任何區(qū)別，唯一的區(qū)別

只在于數(shù)據(jù) 來源不同，這個不同會導(dǎo)致功能實(shí)踐上更多細(xì)節(jié)的差異，例如：異常的捕獲、斷點(diǎn)嘗試等。代碼方面

我就不再贅述了，對前面 所介紹類的掌握和理解，應(yīng)該No Problem了。主要說一下兩點(diǎn)：

①、由于Android4.0不允許在主線程上進(jìn)行網(wǎng)絡(luò)操作，例如：Socket編程，我們的操作必須放在新的線程中。

同 時為了 減少創(chuàng)建線程的開銷，我們試用了線程池去執(zhí)行每一個FTP操作。

②、試用FTPClient時，不允許上傳/下載文件夾，我也沒有針對這一方面進(jìn)行更多的開發(fā)(具體實(shí)現(xiàn)過程大致

為：對文件夾里 的每個文件皆進(jìn)行上傳/下載操作)，有興趣的同學(xué)可以看看這篇帖子< 基于ftp4j的FTP客戶端工具 >，

會提升對你對 ftp4j 的使用 認(rèn)知的。

我們的FTP客戶端主要功能為：

①、顯示特定目錄列表;

②、刪除文件以及文件夾，下載文件;

③、上傳文件。

主要代碼如下：

    /**
 * 
 * @author jun.qin
 * {@link} http://blog.csdn.net/qinjuning
 *
 */
public class FtpMainActivity extends Activity implements OnClickListener {

	private static String TAG = CopyOfFtpMainActivity.class.getName();

	private CmdFactory mCmdFactory;
	private FTPClient mFTPClient;
	private ExecutorService mThreadPool;
	
	@Override
	protected void onDestroy() {
		mDameonRunning = false ;
		Thread thread = new Thread(mCmdFactory.createCmdDisConnect()) ;
		thread.start();
		//等待連接中斷
		try {
			thread.join(2000);
		} catch (InterruptedException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		mThreadPool.shutdownNow();
		super.onDestroy();
	}
    //put線程池中執(zhí)行
	private void executeConnectRequest() {
		mThreadPool.execute(mCmdFactory.createCmdConnect());
	}

	private void executeDisConnectRequest() {
		mThreadPool.execute(mCmdFactory.createCmdDisConnect());
	}

	private void executePWDRequest() {
		mThreadPool.execute(mCmdFactory.createCmdPWD());
	}

	private void executeLISTRequest() {
		mThreadPool.execute(mCmdFactory.createCmdLIST());
	}
    //創(chuàng)建FtpCmd的工廠類
	public class CmdFactory {

		public FtpCmd createCmdConnect() {
			return new CmdConnect();
		}

		public FtpCmd createCmdDisConnect() {
			return new CmdDisConnect();
		}

	}
    //繼承了Runnable接口
	public abstract class FtpCmd implements Runnable {

		public abstract void run();

	}
	//連接命令
	public class CmdConnect extends FtpCmd {
		@Override
		public void run() {
			boolean errorAndRetry = false ;  //根據(jù)不同的異常類型，是否重新捕獲
			try {
				String[] welcome = mFTPClient.connect(mFTPHost, mFTPPort);
				if (welcome != null) {
					for (String value : welcome) {
						logv("connect " + value);
					}
				}
				mFTPClient.login(mFTPUser, mFTPPassword);
				mHandler.sendEmptyMessage(MSG_CMD_CONNECT_OK);
			}catch (IllegalStateException illegalEx) {
				illegalEx.printStackTrace();
				errorAndRetry = true ;
			}catch (IOException ex) {
				ex.printStackTrace();
				errorAndRetry = true ;
			}catch (FTPIllegalReplyException e) {
				e.printStackTrace();
			}catch (FTPException e) {
				e.printStackTrace();
				errorAndRetry = true ;
			}
			if(errorAndRetry && mDameonRunning){
				mHandler.sendEmptyMessageDelayed(MSG_CMD_CONNECT_FAILED, 2000);
			}
		}
	}

	public class CmdDisConnect extends FtpCmd {

		@Override
		public void run() {
			if (mFTPClient != null) {
				try {
					mFTPClient.disconnect(true);
				} catch (Exception ex) {
					ex.printStackTrace();
				}
			}
		}
	}
    //下載命令
	public class CmdDownLoad extends AsyncTask<Void, Integer, Boolean> {

		@Override
		protected Boolean doInBackground(Void... params) {
			try {
				String localPath = getParentRootPath() + File.separator
						+ mFileList.get(mSelectedPosistion).getName();
				mFTPClient.download(
						mFileList.get(mSelectedPosistion).getName(),
						new File(localPath),
						new DownloadFTPDataTransferListener(mFileList.get(
								mSelectedPosistion).getSize()));
			} catch (Exception ex) {
				ex.printStackTrace();
				return false;
			}

			return true;
		}

		protected void onPostExecute(Boolean result) {
			toast(result ? "下載成功" : "下載失敗");
			progressDialog.dismiss();
		}
	}
}
  

三，使用方法說明

前提條件， 確保兩臺手機(jī)分別安裝FTP服務(wù)端，F(xiàn)TP客戶端 ，并且能連接上WIFI網(wǎng)絡(luò)。

第一步：運(yùn)行FTP服務(wù)器SwiFtp，輸入基本信息(端口、用戶名、密碼)，同時確保FTP服務(wù)器成功開啟 。如圖：

配置FTP服務(wù)器信息 FTP服務(wù)器狀態(tài)

第二步：運(yùn)行FTP客戶端，填寫FTP驗(yàn)證時的資料(即第一步輸入信息)后，連接FTP服務(wù)器即可。如圖：

最后，本文所涉及到的所有資料以及文章中示例的源代碼的下載地址為：

http://download.csdn.net/detail/qinjuning/5034873

Android中FTP服務(wù)器、客戶端搭建以及SwiFTP、ftp4j介紹