实现背景

近期接触到一个需求，就是将文件从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/