Android有用的任务管理器—tractor

在平时的android开发工作中，我们常常须要运行耗时操作，有时为了用户体验还须要显示个等待框，我之前的做法都是开一个线程，然后用handler发消息进行显示和关闭等待框以及相关的ui操作。假设任务比較多的话,频繁的new Thread会让代码看上去比較混乱，并且还不好管理，针对这样的情况我写了tractor。

tractor基本的作用有：

1. 代码变得整洁。不用在到处new Thread和new Handler。

2. 能够监控任务的运行情况，能够随时取消一个或多个任务；

3. 封装了okhttp。支持大文件上传，多线程断点下载。get,post以及其它的网络请求

效果图

使用说明

类图

结构事实上非常easy。没有多少东西。

普通任务

//当LoadListenerImpl构造函数传入context，则显示progressdialog
 doNormalTask(new LoadListenerImpl(this) {
          @Override
          public void onStart(Object result) {
                  super.onStart(result);
                  setMessage("任务開始运行");
          }

          @Override
          public void onSuccess(Object result) {
                 super.onSuccess(result);
                 String response = (String) result;
                 setMessage("任务结束");
          }

          @Override
          public void onFail(Object result) {
                 super.onFail(result);
                 String response = (String) result;
                 setMessage(response);
          }

          @Override
          public void onLoading(Object result) {
                super.onLoading(result);
                //以后不用写handler了，这样就能够处理了
                int response = (int) result;
                switch (response) {
                    case 1:
                        setMessage("正在运行 response=" + response);
                        break;
                    case 2:
                        setMessage("正在运行 response=" + response);
                       break;
                    case 3:
                        setMessage("正在运行 response=" + response);
                        break;
                    default:
                        break;
                 }
                    }

          @Override
          public void onCancel(Object result) {
                  super.onCancel(result);
                  setMessage("任务被取消了");
          }

          @Override
          public void onCancelClick() {
              super.onCancelClick();
              TaskPool.getInstance().cancelTask(MainActivity.this);
          }
  }, this);

在上面的代码块中，LoadListenerImpl是LoadListener的实现类，用于监听任务载入的整个过程，使用LoadListenerImpl而不是LoadListener的优点有两点：

1.能够不实现全部的方法，仅仅要依据自己的须要来实现对应的方法即可了；‘

2.LoadListenerImpl中能够管理ProgressDialog。ProgressDialog能够用tractor中自带的，也能够自定义。

LoadListenerImpl 部分源代码：

public class LoadListenerImpl implements LoadListener {
    private WeakReference<Context> context;
    private ProgressDialog mProgressDialog;
    private String mMessage = "载入中...";
    private long mDismissTime = 500;

    /**
     * 不显示progressdialog
     */
    public LoadListenerImpl() {
    }

    /**
     * 显示progressdialog。其上显示的文字是默认的
     * @param context
     */
    public LoadListenerImpl(Context context) {
        init(context, null);
    }

    /**
     * 显示progressdialog,其上显示的文字是message
     * @param context
     * @param message
     */
    public LoadListenerImpl(Context context, String message) {
        init(context, message);
    }
    /**
     * 设置自定义的progressdialog，假设不设置则使用tractor自带的
     * @param progressDialog
     */
    public void setProgressDialog(ProgressDialog progressDialog) {
        mProgressDialog = progressDialog;
    }
    ......
}

当然了，你也能够自己实现LoadListener。毕竟是面向接口编程。

doNarmalTask方法的详细实现

 /**
     * 发起个普通的任务
     *
     * @param listener
     * @param tag
     */
    public void doNormalTask(LoadListener listener, Object tag) {
        TaskPool.getInstance().execute(new Task(tag, listener) {
            @Override
            public void onRun() {
                SystemClock.sleep(500);
                notifyLoading(1);
                SystemClock.sleep(500);
                notifyLoading(2);
                SystemClock.sleep(500);
                notifyLoading(3);
                SystemClock.sleep(500);
                Random random = new Random();
                //任务是模拟的，所以随机下
                if (random.nextBoolean()) {
                //notifySuccess(null);
                } else {
                    notifyFail("糟糕，任务失败了");
                }
            }

            @Override
            public void cancelTask() {

            }
        });
    }

TaskPool.getInstance().execute()方法终于是把task交由线程池来运行。TaskPool仅仅负责加入和取消任务。接下来说Task，在上面的类图中有说明，Task是实现了Runnable接口，并重写run(),所以线程池能够运行Task，我们看下run()方法是怎么实现的:

public abstract class Task implements Runnable {
    ......
    @Override
    public final void run() {
        start();
        onRun();
        finish();
    }
     ......
     private void start() {
      notifyStart(null);
       ......
    }
    /**
     * 实现这种方法来运行详细的任务
     */
    public abstract void onRun();
    private void finish() {
        if (isRunning()) {
            // 默认载入成功
            mStatus = Status.SUCCESS;
            notifySuccess(null);
        }
        clear();
    }

run()中分别运行了start(),onRun()和finish()，start()方法中调用了notifyStart(null)，finish()中调用了notifySuccess(null)，也就是说在開始的时候会通知ui线程任务開始，结束的时候默认通知ui线程任务结束。

onRun()是抽象方法，是给任务调用者来实现运行详细的任务的。在运行的过程中能够通过notifyLoading(result)来通知ui任务的进度。notifySuccess(result)和notifyFail(result)通知ui任务成功和失败，并把须要的数据result作为參数传给ui线程。

至于Task中的cancelTask()放到后面取消任务的时候再说。

超时任务

 doTimeoutTask(500, new LoadListenerImpl() {
                    @Override
                    public void onStart(Object result) {
                        super.onStart(result);
                        toast("超时任务開始运行");
                    }

                    @Override
                    public void onSuccess(Object result) {
                        super.onSuccess(result);
                        toast("超时任务运行成功");
                    }

                    @Override
                    public void onTimeout(Object result) {
                        super.onTimeout(result);
                        toast("任务超时");
                    }
                }, this);
  .......
  public void doTimeoutTask(long timeout, LoadListener listener, Object tag) {
        TaskPool.getInstance().execute(new Task(timeout, tag, listener) {
            @Override
            public void onRun() {
                SystemClock.sleep(1000);
            }

            @Override
            public void cancelTask() {

            }
        });
    }

能够看到。超时任务相较于普通任务来说仅仅是Task构造函数多了个timeout參数。这个timeout參数的含义就是任务运行的时间限制。假设超过这个限制就回调onTimeout()方法。

取消任务

在平时的开发过程中，有时开了一个超耗时的操作，在耗时操作未返回的时候页面就被关闭了。当页面关闭以后耗时操作才有了返回，这时候须要操作控件的话就有可能会报null或者其它的一些异常，为了避免异常，我们通常须要进行一些页面是否处于激活状态的推断，但是这样总是非常麻烦的。tractor攻克了这个问题，能够调用取消任务的方法，就像这样：

//取消任务的方法，參数能够是任务的tag，也能够是task。假设是tag，则取消tag相关的全部任务。是task则取消指定的task。
//能够在onDestroy()中调用
TaskPool.getInstance().cancelTask(tag|task);

这样调用以后会调用notifyCancel(null),在ui上显示给用户任务已取消的效果，tractor有个特性：当任务有结果时（已经取消，超时，成功和失败），兴许的notifyXXX()就都不会通知到ui线程了，所以假设任务在运行取消任务代码以后，当任务有结果返回的时候。ui回调也不会被运行。那么上面说的那个问题也就不存在了，就省的自己去加推断了。

前面也有提到，取消任务的代码仅仅能在保证ui上有取消的效果，但是任务实际上还是在运行的。尽管用户看不到但是资源还是在损耗，所以还不行。

从类图中能看到Task有onRun()和cancelTask()两个抽象方法,onRun()是运行详细任务的，cancelTask()则是运行详细的取消任务的操作。他是在非ui线程中运行的。详细怎么停止任务是由你来决定的。

网络请求部分

为了让任务管理器看起来更实用些。我封装了网络框架，实现是okhttp，能够支持head,get,post,多线程下载，大文件上传以及其它一些http请求。因为是面向接口编程，所以假设以后有更合适的库，能够非常方便的就换掉okhttp。这部分的样例我就不贴出来了，感兴趣能够自己看代码，非常easy，代码全在demo module的MainActivity里。

下载：

上传打文件：

最后

假设你有什么问题和建议能够留言或者给我发邮件。tractor是托管在github上，点击此处获取源代码。欢迎star or follow!

时间： 2024-08-05 11:58:17

Android有用的任务管理器—tractor的相关文章

android有用代码片段(一)

有时候,需要一些小的功能,找到以后,就把它贴到了博客下面,作为留言,查找起来很不方便,所以就整理一下,方便自己和他人. 一.  获取系统版本号: PackageInfo info = this.getPackageManager().getPackageInfo(this.getPackageName(), 0); int versionCode=nfo.versionCode string versionName=info.versionNam 二.获取系统信息: <span style=&quo

Android 有用的快捷键

The powerful Android Studio 08 Jun 2016 Android Studio is the official tool for Android development these days. Being developed at the top of project IntelliJ IDEA, takes into advantage (almost in its entirety) features of edition, debugging, analysi

android源码大放送（实战开发必备）,免费安卓demo源码,例子大全文件详细列表

免费安卓demo源码,例子大全文件详细列表 本列表源码永久免费下载地址:http://www.jiandaima.com/blog/android-demo 卷 yunpan 的文件夹 PATH 列表 卷序列号为 0000-73EC E:. │ jiandaima.com文件列表生成.bat │ 例子大全说明.txt │ 本例子永久更新地址~.url │ 目录列表2016.03.10更新.txt │ ├─前台界面 │ ├─3D标签云卡片热门 │ │ Android TagCloudView云标签

Android 程序员必须知道的 53 个知识点

1. android 单实例运行方法 我们都知道 Android 平台没有任务管理器,而内部 App 维护者一个 Activity history stack 来实现窗口显示和销毁,对于常规从快捷方式运行来看都是 startActivity 可能会使用 FLAG_ACTIVITY_NEW_TASK 标记来打开一个新窗口,比如 Launcher,所以考虑单任务的实现方法比较简单,首先 Android123 纠正下大家一种错误的方法就是直接在androidmanifest.xml 的 applica

Android开发网上的一些重要知识点[经验分享]

1. android单实例运行方法 我们都知道Android平台没有任务管理器,而内部App维护者一个Activity history stack来实现窗口显示和销毁,对于常规从快捷方式运行来看都是startActivity可能会使用FLAG_ACTIVITY_NEW_TASK标记来打开一个新窗口,比如Launcher,所以考虑单任务的实现方法比较简单,首先Android123纠正下大家一种错误的方法就是直接在androidmanifest.xml的application节点中加入android

闹钟AlarmAndMusic 滑动调整时间和页面旋转风车效果《IT蓝豹》

闹钟AlarmAndMusic 滑动调整时间和页面旋转风车效果 闹钟AlarmAndMusic 和支持播放音乐效果的,上下滑动调整时间和页面旋转风车效果,由于制作的gif有些问题,效果不明显,欢迎下载使用看看真实的效果.本例子主要由AlertActivity和AlarmService和AlarmAlertWakeLock三个类完成.AlarmAlertWakeLock主要代码:public class AlarmAlertWakeLock {    private static PowerMan

FlipViewPager 对item实现左右对折滑动翻页效果《IT蓝豹》

FlipViewPager 对item实现左右对折滑动翻页效果 <FlipViewPager 对每一条item实现左右对折滑动翻页效果>,解决左右滑动和上下滑动的事件分发处理机制.内部实现如下:用ListView试下,对listview设置adapter,这个adapter继承BaseFlipAdapter<Friend>,然后对每一个item进行view处理,部分代码如下:class FriendsAdapter extends BaseFlipAdapter<Friend

哪位大兄弟有用 cMake 开发Android ndk的

一直用 Android studio 开发ndk,但是gradle支持的不是很好,只有experimental 版本支持 配置各种蛋疼.主要每次新建一个module都要修改配置半天.之前也看到过google 开发文档有提到 cmake 但是一直没用.哪位大兄弟用过,说下经验 哪位大兄弟有用 cMake 开发Android ndk的 >> android 这个答案描述的挺清楚的:http://www.goodpm.net/postreply/android/1010000007205830/哪位

【开源框架】Android之史上最全最简单最有用的第三方开源库收集整理，有助于快速开发，欢迎各位...

[转]http://www.tuicool.com/articles/jyA3MrU Android开源库 自己一直很喜欢Android开发,就如博客签名一样, 我是程序猿,我为自己代言 . 在摸索过程中,GitHub上搜集了很多很棒的Android第三方库,推荐给在苦苦寻找的开发者,而且我会 不定期的更新 这篇文章. Android下的优秀开发库数不胜数,在本文中,我列举的多是开发流程中最常用的一些.如果你还想了解更多的Android开源库,可以关注我的博客,每一个库都是我认真查看或者编译运行