Android FTP 多线程断点续传下载\上传的实例_网络技术

Android FTP 多线程断点续传下载\上传的实例

发布时间 - 2026-01-11 02:37:33 点击率：次

最近在给我的开源下载框架Aria增加FTP断点续传下载和上传功能，在此过程中，爬了FTP的不少坑，终于将功能实现了，在此把一些核心功能点记录下载。

FTP下载原理

FTP单线程断点续传

FTP和传统的HTTP协议有所不同，由于FTP没有所谓的头文件，因此我们不能像HTTP那样通过设置header向服务器指定下载区间。

但是FTP协议提供了一个更好用的命令REST用于从指定位置恢复任务，同时FTP协议也提供了一个命令SIZE用于获取下载的文件大小，有了这两个命令，FTP断点续传也就没有什么问题。

FTP断点续传的原理和HTTP的断点续传原理差不多，在暂停时记录文件的停止位置，再次下载时，先读取记录的位置，如果位置存在，则通过REST命令告诉服务器从指定区间进行下载。

FTP多线程断点续传

多线程下载的原理和HTTP多线程下载的原理差不多。先获取文件大小，然后根据线程数，对整个文件进行分段下载，在任务停止时，记录每一条线程的暂停位置，重新开始下载，每一条线程读取对应的下载记录，然后每一线程从指定位置开始下载。

分段下载

和HTTP所不同的是，FTP并没有提供文件区间的API，因此，FTP在分段下载中，只有起始位置而没有结束位置。
因此，你需要在指定位置手动停止线程。

功能实现

本文使用将采用apache commons-net实现FTP断点续传下载\上传功能。<br>

通过下文的几步操作，你就能很简单的实现FTP断点续传。

FTP协议和HTTP协议有所不同，使用FTP进行下载时，你需要进行登录操作。

当然，如果你服务器没有登录功能，你可以忽略登录操作。

FTPClient client = new FTPClient();
client.connect(serverIp, port); //连接到FTP服务器
client.login(userName, passsword);

通过上面三行代码，就可以很简单的登录到FTP服务器上。

在进行登录后，还需要验证是否登录成功

int reply = client.getReplyCode();
if (!FTPReply.isPositiveCompletion(reply)) {
  client.disconnect();
  Log.d(TAG, "无法连接到ftp服务器，错误码为：" + reply);
  return;
 }

由于FTP协议中，连接成功的状态有多个，因此需要通过FTPReply.isPositiveCompletion(reply)用于验证是否成功连接到FTP服务器。

文件信息获取

在连接到FTP服务器后，就需要开始获取下载最重要的几个参数（文件长度、文件名）。

客户端可以通过client.listFiles(remotePath)获取FTP服务器上该路径的文件列表。

如果路径是文件，只会返回一个长度为1的数组。
如果该路径为文件夹，则会返回该文件夹下对应的所有文件。

String remotePath = "/upload/qjnn.apk"; //FTP服务器上文件路径
FTPFile[] files = client.listFiles(remotePath);
FTPFile file = files[0]; //文件信息
long size = file.getSize();
String fileaName = file.getName();

如果你的文件为英文名，并且路径中没有中文，那么通过上述代码，便可以获取到正确的文件信息。

但如果FTP上的服务器上的文件名有中文或路径有中文，那么上述代码，你将获取不到正确的文件信息。

正确的写法

由于FTP服务器默认的编码是ISO-8859-1，因此，客户端在获取文件信息时

需要请求服务器使用UTF-8编码（如果服务器支持的话），如果服务器不支持开启UTF-8编码，那么客户端需要指定字符串编码格式
客户端在请求remotePath路径、获取文件名时，都需要对路径进行编码转换处理。

String remotePath = "/upload/qjnn.apk"; //FTP服务器上文件路径

String charSet = "UTF-8";
if (!FTPReply.isPositiveCompletion(client.sendCommand("OPTS UTF8", "ON"))) {  //向服务器请求使用"UTF-8"编码
  charSet = "GBK";
}
FTPFile[] files = client.listFiles(new String(remotePath.getBytes(charSet), "ISO-8859-1")); //对remotePath进行编码转换
FTPFile file = files[0]; //文件信息
long size = file.getSize();
String fileaName = new String(fileName.getBytes(), Charset.forName(charSet));

通过以上代码，便可以获取到正确的文件信息。

文件下载

配置每条线程的下载区间

long fileLength = mEntity.getFileSize();
Properties pro = CommonUtil.loadConfig(mConfigFile);
int blockSize = (int) (fileLength / mThreadNum);
int[] recordL = new int[mThreadNum];
for (int i = 0; i < mThreadNum; i++) {
 recordL[i] = -1;
}
int rl = 0;
for (int i = 0; i < mThreadNum; i++) {
 long startL = i * blockSize, endL = (i + 1) * blockSize;
 Object state = pro.getProperty(mTempFile.getName() + "_state_" + i);
 if (state != null && Integer.parseInt(state + "") == 1) { //该线程已经完成
  if (resumeRecordLocation(i, startL, endL)) return;
  continue;
 }
 //分配下载位置
 Object record = pro.getProperty(fileName + "_record_" + i);
 //如果有记录，则恢复下载
 if (record != null && Long.parseLong(record + "") >= 0) {
  Long r = Long.parseLong(record + "");
  mConstance.CURRENT_LOCATION += r - startL;
  Log.d(TAG, "任务【" + mEntity.getFileName() + "】线程__" + i + "__恢复下载");
  startL = r;
  recordL[rl] = i;
  rl++;
 } else {
  recordL[rl] = i;
  rl++;
 }
 //最后一个线程的结束位置即为文件的总长度
 if (i == (mThreadNum - 1)) endL = fileLength;
 //创建分段线程
 AbsThreadTask task = createSingThreadTask(i, startL, endL, fileLength);
 if (task == null) return;
 mTask.put(i, task);
}
startSingleTask(recordL);

在上面的代码中，主要做了两步操作：

在文件下载前，先从本地文件中读取当前下载的每一条线程的下载情况
如果下载记录存在，从记录位置开始下载，如果记录不存在，则重新开始下载

FTP 分段线程区间自动停止

由于FTP协议没有区间下载的原因，为了让线程只下载特定区间的内容，需要客户端在单条线程累计读的数据长度已经超过了所分配的区间长度的时候，停止该条线程。

 client.enterLocalPassiveMode();  //设置被动模式
 client.setFileType(FTP.BINARY_FILE_TYPE); //设置文件传输模式
 client.setRestartOffset(mConfig.START_LOCATION);  //设置恢复下载的位置
 client.allocate(mBufSize);
 is = client.retrieveFileStream(new String(remotePath.getBytes(charSet), SERVER_CHARSET));
 //发送第二次指令时，还需要再做一次判断
 reply = client.getReplyCode();
 if (!FTPReply.isPositivePreliminary(reply)) {
  client.disconnect();
  fail(mChildCurrentLocation, "获取文件信息错误，错误码为：" + reply, null);
  return;
 }
 file = new BufferedRandomAccessFile(mConfig.TEMP_FILE, "rwd", mBufSize);
 file.seek(mConfig.START_LOCATION);
 byte[] buffer = new byte[mBufSize];
 int len;
 while ((len = is.read(buffer)) != -1) { 
  //如果该条线程读取的数据长度大于所分配的区间长度，则只能读到区间的最大长度
  if (mChildCurrentLocation + len >= mConfig.END_LOCATION) {
    len = (int) (mConfig.END_LOCATION - mChildCurrentLocation);
    file.write(buffer, 0, len);
    progress(len);
    break;
  } else {
    file.write(buffer, 0, len);
    progress(len);
  }
 }

这里还有几个坑需要处理一下：

对于FTP客户端来说，一般需要设置被动模式，被动模式和主动模式的区别
在获取文件流后，还需要使用FTPReply.isPositivePreliminary(reply)进行第二次命令判断

关于FTP文件上传

FTP 文件断点续传的方式原理和下载的都差不多：

都是在停止的时候记录停止位置，重新开始下载的时候从指定位置通过REST命令恢复断点。
都需要在任务执行前获取文件信息，比对服务器上的文件。

而和下载有区别的是：

FTP上传时需要指定工作目录、在远程服务器上创建文件夹
需要服务器给用户打开删除和读入IO的权限，否则会出现550权限错误问题
上传文件需要storeFileStream获取outputStream流

最终效果

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# Android # 多线程断点续传下载 # 多线程断点续传上传 # android实现多线程下载文件（支持暂停、取消、断点续传） # Android多线程+单线程+断点续传+进度条显示下载功能 # Android多线程断点续传下载功能实现代码 # Android多线程断点续传下载示例详解 # Android 使用AsyncTask实现多任务多线程断点续传下载 # Android实现网络多线程断点续传下载实例 # Android编程开发实现多线程断点续传下载器实例 # PC版与Android手机版带断点续传的多线程下载 # Android 使用AsyncTask实现多线程断点续传 # android原生实现多线程断点续传功能 # 断点续传 # 器上 # 客户端 # 连接到 # 还需要 # 的是 # 几个 # 多线程 # 在此 # 有所不同 # 很简单 # 便可 # 上传 # 则会 # 进行下载 # 如果你 # 是在 # 你可以 # 就能 # 也就

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：拖拽式建站新方案：可视化系统+H5响应式企业官网

下一篇：c++如何解析命令行参数 c++ Boost.Program

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：拖拽式建站新方案：可视化系统+H5响应式企业官网

下一篇：c++如何解析命令行参数 c++ Boost.Program