实现背景
近期接触到一个需求，就是将文件从Android系统上传到FTP服务器，虽然之前接触过FTP服务器，了解基本的使用流程，但是将此流程从使用习惯转化为代码实现还是有一定难度的。但是基本的流程还是比较清楚的：
- 1.在Android手机上创建一个FTP客户端
- 2.设置host及端口建立与FTP服务器的连接
- 3.使用用户名和密码登录FTP服务器
- 4.更改目录，将当前客户端指向的服务端的文件夹从跟目录调整到指定的目录
- 5.上传文件，并等待上传完成的结果
- 6.断开和FTP服务器的链接
代码实现
1.创建FTP客户端并定义相关的操作流程
public class FTPClientFunctions { private static final String TAG = "FTPClientFunctions"; private FTPClient ftpClient = null; // FTP客户端 /** * 连接到FTP服务器 * * @param host ftp服务器域名 * @param username 访问用户名 * @param password 访问密码 * @param port 端口 * @return 是否连接成功 */ public boolean ftpConnect(String host, String username, String password, int port) { try { ftpClient = new FTPClient(); Log.d(TAG, "connecting to the ftp server " + host + " ：" + port); ftpClient.connect(host, port); // 根据返回的状态码，判断链接是否建立成功 if (FTPReply.isPositiveCompletion(ftpClient.getReplyCode())) { Log.d(TAG, "login to the ftp server"); boolean status = ftpClient.login(username, password); /* * 设置文件传输模式 * 避免一些可能会出现的问题，在这里必须要设定文件的传输格式。 * 在这里我们使用BINARY_FILE_TYPE来传输文本、图像和压缩文件。 */ ftpClient.setFileType(FTP.BINARY_FILE_TYPE); ftpClient.enterLocalPassiveMode(); return status; } } catch (Exception e) { e.printStackTrace(); Log.d(TAG, "Error: could not connect to host " + host); } return false; } /** * 断开ftp服务器连接 * * @return 断开结果 */ public boolean ftpDisconnect() { // 判断空指针 if (ftpClient == null) { return true; } // 断开ftp服务器连接 try { ftpClient.logout(); ftpClient.disconnect(); return true; } catch (Exception e) { Log.d(TAG, "Error occurred while disconnecting from ftp server."); } return false; } /** * ftp 文件上传 * * @param srcFilePath 源文件目录 * @param desFileName 文件名称 * @param desDirectory 目标文件 * @return 文件上传结果 */ public boolean ftpUpload(String srcFilePath, String desFileName, String desDirectory) { boolean status = false; try { FileInputStream srcFileStream = new FileInputStream(srcFilePath); status = ftpClient.storeFile(desFileName, srcFileStream); srcFileStream.close(); return status; } catch (Exception e) { e.printStackTrace(); Log.d(TAG, "upload failed: " + e.getLocalizedMessage()); } return status; } /** * ftp 更改目录 * * @param path 更改的路径 * @return 更改是否成功 */ public boolean ftpChangeDir(String path) { boolean status = false; try { status = ftpClient.changeWorkingDirectory(path); } catch (Exception e) { e.printStackTrace(); Log.d(TAG, "change directory failed: " + e.getLocalizedMessage()); } return status; }} 2.完整的操作流程
// 网络操作，但开一个线程进行处理new Thread(new Runnable() { @Override public void run() { // TODO 可以首先去判断一下网络 ftpClient = new FTPClientFunctions(); boolean connectResult = ftpClient.ftpConnect(FTP_SERVER, FTP_USERNAME, FTP_PASSWORD, FTP_PORT); if (connectResult) { boolean changeDirResult = ftpClient.ftpChangeDir("/**"); if (changeDirResult) { boolean uploadResult = ftpClient.ftpUpload(sourceFilePath, descFileName, ""); if (uploadResult) { Log.w(TAG, "上传成功"); boolean disConnectResult = ftpClient.ftpDisconnect(); if(disConnectResult) { Log.e(TAG, "关闭ftp连接成功"); } else { Log.e(TAG, "关闭ftp连接失败"); } } else { Log.w(TAG, "上传失败"); } } else { Log.w(TAG, "切换ftp目录失败"); } } else { Log.w(TAG, "连接ftp服务器失败"); } }}).start(); 3.FTP交互相关库
commons-net-3.6.jar : Apache Commons Net 阿帕奇提供的常用的网络交互的jar包。
支持以下协议:
- FTP/FTPS
- FTP over HTTP (experimental)
- NNTP
- SMTP(S)
- POP3(S)
- IMAP(S)
- Telnet
- TFTP
- Finger
- Whois
- rexec/rcmd/rlogin
- Time (rdate) and Daytime
- Echo
- Discard
- NTP/SNTP
在这里我们只用的了FTP协议。不得不说，库使用起来还是相当方便的。
相关链接：http://commons.apache.org/proper/commons-net/