萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 多線程斷點下載完整實現:HTTP Range 請求、隨機訪問文件、進度持久化、暫停恢復與錯誤重試

大文件下載必須支援斷點續傳。本文實現基於 HttpURLConnection 的多線程斷點下載器,涵蓋 Range 請求、RandomAccessFile 並發寫入、進度持久化至 SQLite/SharedPreferences、暫停/恢復/取消、指數退避重試,並提供線程安全的回調接口。

一、核心數據模型

// 下載任務實體 (持久化)
@Entity(tableName = "download_task")
public class DownloadTask {
    @PrimaryKey String url;           // 唯一標識
    String filePath;                  // 本地文件路徑
    long totalSize;                   // 總大小 (-1 未知)
    long downloadedSize;              // 已下載總量
    int threadCount;                  // 線程數
    String etag;                      // 服務端 ETag,校驗文件變更
    int status;                       // RUNNING, PAUSED, COMPLETED, FAILED
    long createdAt, updatedAt;
}

// 線程分塊信息
public class Block {
    int threadId;
    long startOffset, endOffset;      // [start, end] 閉區間
    long currentOffset;               // 當前寫入位置
    boolean completed;
}

二、下載引擎核心邏輯

public class MultiThreadDownloader {
    private final ExecutorService executor = Executors.newFixedThreadPool(4);
    private final OkHttpClient client = new OkHttpClient.Builder()
        .retryOnConnectionFailure(true)
        .build();

    public void start(DownloadTask task, DownloadCallback callback) {
        // 1. HEAD 請求獲取總大小、支援 Range、ETag
        Request headReq = new Request.Builder().url(task.url).head().build();
        try (Response headRes = client.newCall(headReq).execute()) {
            if (!headRes.isSuccessful()) throw new IOException("HEAD failed: " + headRes.code());
            task.totalSize = headRes.header("Content-Length", -1);
            task.etag = headRes.header("ETag");
            boolean acceptRanges = "bytes".equalsIgnoreCase(headRes.header("Accept-Ranges"));
            if (!acceptRanges || task.totalSize <= 0) {
                // 不支援範圍請求,退回單線程
                singleThreadDownload(task, callback);
                return;
            }
        }

        // 2. 初始化/恢復分塊
        List blocks = loadBlocks(task); // 從 DB 恢復 currentOffset
        if (blocks.isEmpty()) blocks = splitBlocks(task.totalSize, task.threadCount);

        // 3. 启動下載線程
        CountDownLatch latch = new CountDownLatch(blocks.size());
        AtomicBoolean cancelled = new AtomicBoolean(false);

        for (Block block : blocks) {
            executor.submit(() -> downloadBlock(task, block, cancelled, callback, latch));
        }

        // 4. 等待完成或取消
        executor.submit(() -> {
            try { latch.await(); }
            catch (InterruptedException ignored) {}
            if (!cancelled.get()) {
                mergeBlocks(task, blocks, callback);
            }
        });
    }

    private void downloadBlock(DownloadTask task, Block block,
                               AtomicBoolean cancelled, DownloadCallback callback,
                               CountDownLatch latch) {
        RandomAccessFile raf = null;
        try {
            raf = new RandomAccessFile(task.filePath, "rwd");
            raf.seek(block.currentOffset);

            Request req = new Request.Builder()
                .url(task.url)
                .addHeader("Range", "bytes=" + block.currentOffset + "-" + block.endOffset)
                .build();

            try (Response res = client.newCall(req).execute()) {
                if (!res.isSuccessful() && res.code() != 206) throw new IOException("Range request failed: " + res.code());
                try (InputStream is = res.body().byteStream()) {
                    byte[] buffer = new byte[8192];
                    int len;
                    while ((len = is.read(buffer)) != -1) {
                        if (cancelled.get()) return;
                        raf.write(buffer, 0, len);
                        block.currentOffset += len;
                        task.downloadedSize += len;
                        // 節流回調進度 (如每 500ms)
                        callback.onProgress(task);
                        persistBlock(block); // 異步持久化
                    }
                    block.completed = true;
                }
            }
        } catch (IOException e) {
            // 指數退避重試邏輯 (略)
            block.completed = false;
        } finally {
            closeQuietly(raf);
            latch.countDown();
        }
    }
    // ... mergeBlocks, persistBlock, loadBlocks, singleThreadDownload 略
}

三、回調接口與 UI 綁定

public interface DownloadCallback {
    void onProgress(DownloadTask task);      // 下載中,UI 更新進度條
    void onCompleted(DownloadTask task);     // 完成
    void onFailed(DownloadTask task, Exception e); // 失敗
    void onPaused(DownloadTask task);        // 暫停
}

四、關鍵細節與避坑指南

  • 文件預分配: raf.setLength(totalSize) 避免寫入時擴展文件導致碎片/失敗。
  • 線程安全計數: AtomicLong 累加 downloadedSize,避免競態。
  • 持久化策略: 內存緩衝 + 定時刷盤 (每 1s) + 關鍵節點強制刷盤,平衡性能與數據安全。
  • ETag/Last-Modified 校驗: 恢復前發送 HEAD 對比,文件已變更則重頭下載。
  • 網絡變化監聽: 註冊 ConnectivityManager.NetworkCallback,斷網自動暫停、復網自動恢復。
  • 前台服務保活: 長時間下載必須在 Foreground Service 中運行,並顯示進度通知。

五、現代替代方案

  • WorkManager + DownloadWorker:系統調度、自動重試、電池優化友好。
  • DownloadManager (系統服務):簡單場景一行代碼,但定製性差、無進度回調。
  • PRDownloader / Downloader (開源庫):封裝完善、支援多任務隊列、斷點續傳。

自研下載器適合極度定製需求;常規業務優先選用成熟庫或系統服務,專注業務邏輯創新。

copyright © 萬盛學電腦網 all rights reserved