Android 断点续传实现指南

在一些网络不稳定的环境中，用户可能会希望在下载文件时实现“断点续传”，也就是说，当下载中途失败时，可以从上次下载的地方继续下载，而不是从头开始。本文将为您介绍如何在Android中实现断点续传，以下是整个流程：

步骤 说明
1 创建下载管理类
2 实现网络请求
3 处理文件的读取与写入
4 实现断点续传逻辑
5 监听下载进度
6 提供用户反馈

1. 创建下载管理类

首先，您需要创建一个下载管理类，该类将负责执行下载任务。

public class DownloadManager {
    private String downloadUrl;  // 下载的URL
    private String savePath;      // 文件保存路径
    private long downloadedBytes; // 已下载字节数

    public DownloadManager(String url, String path) {
        this.downloadUrl = url;
        this.savePath = path;
        this.downloadedBytes = 0;
    }
    
    // 其他方法...
}

2. 实现网络请求

接下来，您将需要使用HTTP库（如OkHttp）进行网络请求，以获取文件数据。

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

public Response makeRequest() throws IOException {
    OkHttpClient client = new OkHttpClient();
    Request request = new Request.Builder()
            .url(downloadUrl)
            .addHeader("Range", "bytes=" + downloadedBytes + "-") // 设置断点续传请求头
            .build();
    
    return client.newCall(request).execute(); // 发起请求
}

3. 处理文件的读取与写入

下载文件需要将其写入本地存储。以下是如何处理文件读取与写入的代码：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;

public void writeToFile(InputStream inputStream) throws IOException {
    FileOutputStream fos = new FileOutputStream(new File(savePath), true); // 以追加模式打开文件
    byte[] buffer = new byte[4096];
    int bytesRead;

    while ((bytesRead = inputStream.read(buffer)) != -1) {
        fos.write(buffer, 0, bytesRead); // 写入文件
        downloadedBytes += bytesRead; // 更新已下载字节数
    }

    fos.close(); // 关闭输出流
}

4. 实现断点续传逻辑

在下载之前，您可以检查文件是否存在及其大小，以决定是否需要继续下载。

public void startDownload() {
    File file = new File(savePath);
    if (file.exists()) {
        downloadedBytes = file.length(); // 确定当前已下载大小
    }

    try {
        Response response = makeRequest();
        if (response.isSuccessful()) {
            writeToFile(response.body().byteStream());
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}

5. 监听下载进度

为了让用户了解下载进度，您可以在writeToFile方法中添加进度更新逻辑。

int totalBytes = (int) response.body().contentLength();
int progress = (int) ((downloadedBytes / (float) totalBytes) * 100);
updateProgress(progress); // 更新UI进度

6. 提供用户反馈

可以添加一个简单的状态回调，使用Android的Handler或LiveData 更新UI。

private void updateProgress(int progress) {
    // 这里可以通过Handler或LiveData来更新UI
    handler.post(() -> progressBar.setProgress(progress)); // 假设您有一个进度条
}

类图

classDiagram
    class DownloadManager {
        +String downloadUrl
        +String savePath
        +long downloadedBytes
        +void startDownload()
        +void writeToFile(InputStream)
    }

关系图

erDiagram
    DOWNLOAD_MANAGER {
        string downloadUrl
        string savePath
        long downloadedBytes
    }
    FILE {
        string filePath
        long fileSize
    }
    DOWNLOAD_MANAGER ||--o| FILE : manages

结尾

通过以上步骤，您已经学会了如何在Android中实现断点续传。希望您在实践中应用这些知识，能够顺利开发出功能完善的应用。在调试和测试过程中，确保检查所有边界情况，保持良好的用户体验。祝您在开发之路上越走越远！