FTP文件上传下载

本文FTP链接的相关操做均在 被动模式 下进行。

FTP的端口分两种：控制端口和 数据端口 。

链接FTP服务器时的port的默认21为控制端口。

FTP的数据端口顾名思义就是用来进行数据操做的端口。其又分为两种模式：主动模式与 被动模式 。

主动模式端口默认为20，被动模式端口为范围3000/4000。

当服务器上存在防火墙时，需注意开放相关端口的问题。

完整示例代码请见最后相关下载部分。

链接服务器并登陆

public FTPClient connect(String hostname, Integer port, String username, String password) throws IOException {
        // 建立链接
        FTPClient ftpClient = new FTPClient();
        ftpClient.connect(hostname, port);
        // 设置用于FTP控制链接的编码：UTF-8等
        ftpClient.setControlEncoding(properties.getEncoding());
        log.error("windcoder.com：connect=>\t"+ftpClient.getReplyString());
        // 登陆服务器
        ftpClient.login(username, password);
        log.error("login=>\t"+ftpClient.getReplyString());
        return ftpClient;
    }复制代码

退出并断开链接

public void disconnect(FTPClient ftpClient) throws IOException {
        ftpClient.logout();
        log.error("disLogin=>\t"+ftpClient.getReplyString());
        ftpClient.disconnect();
        log.error("disConnect=>\t"+ftpClient.getReplyString());
    }复制代码

获取并下载文件关键代码

// 进入文件所在远程目录
ftpClient.changeWorkingDirectory(remoteFilePath);
// 开启被动模式
ftpClient.enterLocalPassiveMode();
// 设置以二进制方式传输
ftpClient.setFileType(FTPClient.BINARY_FILE_TYPE);
// 获取文件，listFiles参数为空时获取当前目录下全部文件，包含文件名时，可经过files.length == 1判断是否存在该文件
FTPFile[] files =  ftpClient.listFiles(tmpFileName);
// 获取文件大小
long remoteSize =  files[0].getSize();
//  返回一个用于读取服务器上名为tmpFileName的文件的InputStream，
InputStream in = ftpClient.retrieveFileStream(tmpFileName);
// 建立一个用于写入localFile文件的输出流，若需追加写，则添加并将第二个参数设为true。
FileOutputStream out = new FileOutputStream(localFile, true);
// 将in复制到out，具体方式可自由实现，这里展现IOUtils方式
if (remoteSize - localSize >= 2 * FileUtils.ONE_GB) {
    // 文件大小超过2G时
    IOUtils.copyLarge(in, out);
}else {
    IOUtils.copy(in, out);
}
// 刷新此输出流，并强制写出全部缓冲的输出字节。 flush的通常约定是，调用它代表，若是先前写入的任何字节已由输出流的实现缓冲，则应当即将这些字节写入其预期的目标。
out.flush();
// 关闭相关流，这里展现IOUtils方式
IOUtils.closeQuietly(in);
IOUtils.closeQuietly(out);
// 接收来自服务器的完成答复并验证整个事务是否成功
/**
 *  有些FTPClient方法不能完成整个FTP命令序列来完成事务。 这些命令要求程序员在收到确定的中间命令后采起一些措施。 
 *  程序员的代码完成其操做后，必须调用此方法以接收来自服务器的完成答复并验证整个事务是否成功。
 * */
ftpClient.completePendingCommand();复制代码

获取并上传文件关键代码

// 建立输入流
FileInputStream fis = new FileInputStream(filePath);
// 进入文件所在FTP远程目录
ftpClient.changeWorkingDirectory(uploadPath);
// 开启被动模式
ftpClient.enterLocalPassiveMode();
// 调整ftp传输模式为二进制方式
ftpClient.setFileType(FTPClient.BINARY_FILE_TYPE);
// 调用ftp的方法上载
// 从给定InputStream中获取输入并以给定文件名fileName将文件保存在FTP服务器上。
boolean ret = ftpClient.storeFile(fileName, fis);
// 关闭文件流
fis.close();复制代码

参考资料

FtpConnection.java

本文首发 Windcoder。