CLASS
Downloader 协调器与 Request / Integrity 模型
线程安全可复用协调器:按 SourceSet 与 Policy 调度多镜像并发分块,失败单块默认至多 6 次(2000ms 退避 + 60s 失败时间预算),配合 .part 与 anabranch-meta/2 实现跨源断点续传及逐块 SHA-256 校验。
查看 Result、Integrity 与探测细节 ↗✅ 能做到
- 纯 Java 8(HttpURLConnection)19 个源文件零 android.* 与三方依赖,Android minSdk 21 免 desugaring 直用
- 支持 probeAll() 预检镜像一致(etagsAgree 仅作参考不阻断跨源),并区分 resumed 与 full 的 transferredBytes
⛔ 明确限制 / 拒绝条件
- Maven Central 发布为手动流程,接入前需确认已发布或直接编译 src/;Source.maxChunks 当前仅为元数据字段,尚未做每源并发硬限
- 采用 Cancellation 轮询而非 Thread.interrupt();无状态库刻意不内置镜像 URL、不持久化全局配置、不解包/安装 APK 也不提供 UI
类字段、方法参数与边界
Request(key, target, integrity, chunks, allowResume)argRequest必填Request.of(...) 省略校验摘要并开启 allowResume=true;有 chunkHashes 时分块大小对齐 integrity.chunkSize。
Builder (defaultChunks / maxConcurrent / chunkRetryBudgetMs)configBuilder可选默认: budget = 60000 mschunkRetryBudgetMs 只累计失败重试时间开销,不惩罚健康慢传;单源连续失败满 3 次即在本轮禁用。
Listener / Cancellationargcallbacks可选默认: NONE / NONEonSpeed 单位严格为 bytes/sec;Cancellation 贯穿读循环、限速与退避睡眠。
返回值与异常边界
Result { totalBytes, etag, chunkVerified, transferredBytes }wholeSha256 与全块就绪原子重命名落盘后返回(etag 永不为 null,缺省为空串 "")
IOException / Cancelled超过重试预算、SHA-256 校验失败或主动取消即中止(保留合法 .part/.meta 待续传)