如何用Runnable回调实现AsyncTask进度更新(不使用协程/第三方库)
自定义异步任务框架补充进度更新能力的实现方案
这套实现完全保留你现有代码的运行逻辑,不需要引入协程或第三方库,1:1对齐AsyncTask的publishProgress()/onProgressUpdate()线程规则与使用体验。
核心适配思路
完全复刻原AsyncTask的进度链路:
- 后台任务执行过程中,主动调用
publishProgress()传递当前进度值 - 进度值通过主线程Handler投递切线程,最终在UI线程触发
onProgressUpdate()回调 - 不阻塞后台任务的正常执行
第一步:调整基础接口定义
给原有的MyCallable增加进度类型泛型与进度回调方法,与原AsyncTask的Progress泛型能力对齐:
public interface MyCallable<P, R> extends Callable<R>{ // 原有的UI线程回调保留 void setDataAfterLoading(R result); void setUiForLoading(); // 新增:UI线程执行的进度回调,对标原AsyncTask的onProgressUpdate void onProgressUpdate(P progress); }
如果兼容API <24的低版本Android,java.util.function.Consumer不可用,可自定义1个简单的接口替代,无第三方依赖:
// 自定义轻量进度发布接口 public interface ProgressPoster<P> { void post(P progress); }
第二步:给MyTask类增加进度发布能力
在抽象的MyTask类中补充可供后台线程调用的publishProgress()方法,以及Runner注入进度发布通道的入口,完全不改动原有方法的执行线程约定:
public abstract class MyTask<P, R> implements MyCallable<P, R> { // 由MyTaskRunner注入的进度发布通道 private ProgressPoster<P> progressPoster; // 供子类在call()后台方法中直接调用,完全对标AsyncTask的publishProgress protected void publishProgress(P progress) { if (progressPoster != null) { progressPoster.post(progress); } } // Runner执行任务时调用,完成通道注入 public void setProgressPoster(ProgressPoster<P> poster) { this.progressPoster = poster; } // 保留原有方法的实现约定 @Override public void setUiForLoading() { // UI线程运行 } @Override public void setDataAfterLoading(R result) { // UI线程运行 } @Override public R call() throws Exception { // 后台线程运行,可直接调用publishProgress上报进度 return null; } }
第三步:调整MyTaskRunner的执行逻辑
在原有执行流程中补全进度通道的注入逻辑,完全保留原有的线程切换逻辑、异常捕获逻辑:
public class MyTaskRunner { private final Handler handler = new Handler(Looper.getMainLooper()); private final Executor executor = Executors.newCachedThreadPool(); public <P, R> void executeAsync(MyTask<P, R> task) { try { // 原有前置逻辑:执行UI加载状态回调 task.setUiForLoading(); // 注入进度发布通道:收到后台的进度值后,通过handler切到UI线程触发回调 task.setProgressPoster(progress -> { handler.post(() -> task.onProgressUpdate(progress)); }); // 原有后台执行逻辑保留 executor.execute(new RunnableTask<P, R>(handler, task)); } catch (Exception e) { // 原有异常处理逻辑保留 } } public static class RunnableTask<P, R> implements Runnable{ private final Handler handler; private final MyTask<P, R> task; public RunnableTask(Handler handler, MyTask<P, R> task) { this.handler = handler; this.task = task; } @Override public void run() { try { final R result = task.call(); handler.post(new RunnableTaskForHandler<>(task, result)); } catch (Exception e) { // 原有异常处理逻辑保留 } } } public static class RunnableTaskForHandler<P, R> implements Runnable{ private final MyTask<P, R> task; private final R result; public RunnableTaskForHandler(MyTask<P, R> task, R result) { this.task = task; this.result = result; } @Override public void run() { task.setDataAfterLoading(result); } } }
使用示例
和原有MyTask的使用方式完全一致,仅在后台逻辑中增加进度上报:
MyTaskRunner runner = new MyTaskRunner(); // 示例:下载任务,进度用Integer表示百分比,结果为下载完成的文件路径 runner.executeAsync(new MyTask<Integer, String>() { @Override public void onProgressUpdate(Integer progress) { // UI线程:直接更新进度条 progressBar.setProgress(progress); } @Override public void setUiForLoading() { // UI线程:显示加载控件 progressBar.setVisibility(View.VISIBLE); } @Override public void setDataAfterLoading(String result) { // UI线程:隐藏加载控件,展示下载完成状态 progressBar.setVisibility(View.GONE); Toast.makeText(context, "下载完成,文件路径:" + result, Toast.LENGTH_SHORT).show(); } @Override public String call() throws Exception { // 后台线程:执行下载逻辑 for (int current = 0; current <= 100; current++) { // 每完成一步,上报当前进度 publishProgress(current); // 模拟下载耗时 Thread.sleep(50); } return "/sdcard/download/target_file.apk"; } });
注意事项
- 线程规则完全与AsyncTask对齐:
publishProgress()仅可在后台线程的call()方法中调用,onProgressUpdate()固定运行在UI线程,可直接操作UI控件 - 高频进度上报可能导致主线程消息队列堆积:如果短时间内大量调用
publishProgress(),可在进度发布通道中增加简单节流逻辑(比如两次上报间隔小于50ms则跳过投递),避免主线程卡顿 - 如果需要对齐原AsyncTask的串行执行特性,只需把Runner中的
Executors.newCachedThreadPool()替换为Executors.newSingleThreadExecutor()即可,无需改动其他逻辑
内容的提问来源于stack exchange,提问作者AndreaF
相关产品推荐
相关产品推荐

