Android 源码分析01_AsyncTask

/*
* Copyright (C) 2008 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*      http://www.apache.org/licenses/LICENSE-2.0 *
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

package android.os;

import java.util.ArrayDeque;
import java.util.concurrent.BlockingQueue;
import java.util.concurrent.Callable;
import java.util.concurrent.CancellationException;
import java.util.concurrent.Executor;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.FutureTask;
import java.util.concurrent.LinkedBlockingQueue;
import java.util.concurrent.ThreadFactory;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.atomic.AtomicInteger;

public abstract class AsyncTask<Params, Progress, Result> {
private static final String LOG_TAG = "AsyncTask";

//获取当前的cpu核心数
private static final int CPU_COUNT = Runtime.getRuntime().availableProcessors();
//线程池核心容量
private static final int CORE_POOL_SIZE = CPU_COUNT + 1;
//线程池最大容量
private static final int MAXIMUM_POOL_SIZE = CPU_COUNT * 2 + 1;
//过剩的空闲线程的存活时间
private static final int KEEP_ALIVE = 1;
//ThreadFactory 线程工厂，通过工厂方法newThread来获取新线程
private static final ThreadFactory sThreadFactory = new ThreadFactory() {
//原子整数，可以在超高并发下正常工作
private final AtomicInteger mCount = new AtomicInteger(1);

public Thread newThread(Runnable r) {
return new Thread(r, "AsyncTask #" + mCount.getAndIncrement());
}
};
//静态阻塞式队列，用来存放待执行的任务，初始容量：128个
private static final BlockingQueue<Runnable> sPoolWorkQueue =
new LinkedBlockingQueue<Runnable>(128);

/**
* 静态并发线程池，可以用来并行执行任务，尽管从3.0开始，AsyncTask默认是串行执行任务
* 但是我们仍然能构造出并行的AsyncTask
*/
public static final Executor THREAD_POOL_EXECUTOR
= new ThreadPoolExecutor(CORE_POOL_SIZE, MAXIMUM_POOL_SIZE, KEEP_ALIVE,
TimeUnit.SECONDS, sPoolWorkQueue, sThreadFactory);

/**
* 静态串行任务执行器，其内部实现了串行控制，
* 循环的取出一个个任务交给上述的并发线程池去执行
*/
public static final Executor SERIAL_EXECUTOR = new SerialExecutor();
//消息类型：发送结果
private static final int MESSAGE_POST_RESULT = 0x1;
//消息类型：更新进度
private static final int MESSAGE_POST_PROGRESS = 0x2;
/**静态Handler，用来发送上述两种通知，采用UI线程的Looper来处理消息
* 这就是为什么AsyncTask必须在UI线程调用，因为子线程
* 默认没有Looper无法创建下面的Handler，程序会直接Crash
*/
private static final InternalHandler sHandler = new InternalHandler();
//默认任务执行器，被赋值为串行任务执行器，就是它，AsyncTask变成串行的了
private static volatile Executor sDefaultExecutor = SERIAL_EXECUTOR;
//如下两个变量我们先不要深究，不影响我们对整体逻辑的理解
private final WorkerRunnable<Params, Result> mWorker;
private final FutureTask<Result> mFuture;
//任务的状态 默认为挂起，即等待执行，其类型标识为易变的（volatile）
private volatile Status mStatus = Status.PENDING;
//原子布尔型，支持高并发访问，标识任务是否被取消
private final AtomicBoolean mCancelled = new AtomicBoolean();
//原子布尔型，支持高并发访问，标识任务是否被执行过
private final AtomicBoolean mTaskInvoked = new AtomicBoolean();

/*串行执行器的实现，我们要好好看看，它是怎么把并行转为串行的
*目前我们需要知道，asyncTask.execute(Params ...)实际上会调用
*SerialExecutor的execute方法，这一点后面再说明。也就是说：当你的asyncTask执行的时候，
*首先你的task会被加入到任务队列，然后排队，一个个执行
*/
private static class SerialExecutor implements Executor {
//线性双向队列，用来存储所有的AsyncTask任务
final ArrayDeque<Runnable> mTasks = new ArrayDeque<Runnable>();
//当前正在执行的AsyncTask任务
Runnable mActive;

public synchronized void execute(final Runnable r) {
//将新的AsyncTask任务加入到双向队列中
mTasks.offer(new Runnable() {
public void run() {
try {
//执行AsyncTask任务
r.run();
} finally {
//当前AsyncTask任务执行完毕后，进行下一轮执行，如果还有未执行任务的话
//这一点很明显体现了AsyncTask是串行执行任务的，总是一个任务执行完毕才会执行下一个任务
scheduleNext();
}
}
});
//如果当前没有任务在执行，直接进入执行逻辑
if (mActive == null) {
scheduleNext();
}
}

protected synchronized void scheduleNext() {
//从任务队列中取出队列头部的任务，如果有就交给并发线程池去执行
if ((mActive = mTasks.poll()) != null) {
THREAD_POOL_EXECUTOR.execute(mActive);
}
}
}

/**
* 任务的三种状态
*/
public enum Status {
/**
* 任务等待执行
*/
PENDING,
/**
* 任务正在执行
*/
RUNNING,
/**
* 任务已经执行结束
*/
FINISHED,
}

/** 隐藏API：在UI线程中调用，用来初始化Handler */
public static void init() {
sHandler.getLooper();
}

/** 隐藏API：为AsyncTask设置默认执行器 */
public static void setDefaultExecutor(Executor exec) {
sDefaultExecutor = exec;
}

/**
* Creates a new asynchronous task. This constructor must be invoked on the UI thread.
*/
public AsyncTask() {
mWorker = new WorkerRunnable<Params, Result>() {
public Result call() throws Exception {
mTaskInvoked.set(true);

Process.setThreadPriority(Process.THREAD_PRIORITY_BACKGROUND);
//noinspection unchecked
return postResult(doInBackground(mParams));
}
};

mFuture = new FutureTask<Result>(mWorker) {
@Override
protected void done() {
try {
postResultIfNotInvoked(get());
} catch (InterruptedException e) {
android.util.Log.w(LOG_TAG, e);
} catch (ExecutionException e) {
throw new RuntimeException("An error occured while executing doInBackground()",
e.getCause());
} catch (CancellationException e) {
postResultIfNotInvoked(null);
}
}
};
}

private void postResultIfNotInvoked(Result result) {
final boolean wasTaskInvoked = mTaskInvoked.get();
if (!wasTaskInvoked) {
postResult(result);
}
}
//doInBackground执行完毕，发送消息
private Result postResult(Result result) {
@SuppressWarnings("unchecked")
Message message = sHandler.obtainMessage(MESSAGE_POST_RESULT,
new AsyncTaskResult<Result>(this, result));
message.sendToTarget();
return result;
}

/**
* 返回任务的状态
*/
public final Status getStatus() {
return mStatus;
}

/**
* 这个方法是我们必须要重写的，用来做后台计算
* 所在线程：后台线程
*/
protected abstract Result doInBackground(Params... params);

/**
* 在doInBackground之前调用，用来做初始化工作
* 所在线程：UI线程
*/
protected void onPreExecute() {
}

/**
* 在doInBackground之后调用，用来接受后台计算结果更新UI
* 所在线程：UI线程
*/
protected void onPostExecute(Result result) {
}

/**
* Runs on the UI thread after {@link #publishProgress} is invoked.
/**
* 在publishProgress之后调用，用来更新计算进度
* 所在线程：UI线程
*/
protected void onProgressUpdate(Progress... values) {
}

/**
* cancel被调用并且doInBackground执行结束，会调用onCancelled，表示任务被取消
* 这个时候onPostExecute不会再被调用，二者是互斥的，分别表示任务取消和任务执行完成
* 所在线程：UI线程
*/
@SuppressWarnings({"UnusedParameters"})
protected void onCancelled(Result result) {
onCancelled();
}

protected void onCancelled() {
}

public final boolean isCancelled() {
return mCancelled.get();
}

public final boolean cancel(boolean mayInterruptIfRunning) {
mCancelled.set(true);
return mFuture.cancel(mayInterruptIfRunning);
}

public final Result get() throws InterruptedException, ExecutionException {
return mFuture.get();
}

public final Result get(long timeout, TimeUnit unit) throws InterruptedException,
ExecutionException, TimeoutException {
return mFuture.get(timeout, unit);
}

/**
* 这个方法如何执行和系统版本有关，在AsyncTask的使用规则里已经说明，如果你真的想使用并行AsyncTask，
* 也是可以的，只要稍作修改
* 必须在UI线程调用此方法
*/
public final AsyncTask<Params, Progress, Result> execute(Params... params) {
//串行执行
return executeOnExecutor(sDefaultExecutor, params);
//如果我们想并行执行，这样改就行了，当然这个方法我们没法改
//return executeOnExecutor(THREAD_POOL_EXECUTOR, params);
}

/**
* 通过这个方法我们可以自定义AsyncTask的执行方式，串行or并行，甚至可以采用自己的Executor
* 为了实现并行，我们可以在外部这么用AsyncTask：
* asyncTask.executeOnExecutor(AsyncTask.THREAD_POOL_EXECUTOR, Params... params);
* 必须在UI线程调用此方法
*/
public final AsyncTask<Params, Progress, Result> executeOnExecutor(Executor exec,
Params... params) {
if (mStatus != Status.PENDING) {
switch (mStatus) {
case RUNNING:
throw new IllegalStateException("Cannot execute task:"
+ " the task is already running.");
case FINISHED:
throw new IllegalStateException("Cannot execute task:"
+ " the task has already been executed "
+ "(a task can be executed only once)");
}
}

mStatus = Status.RUNNING;
//这里#onPreExecute会最先执行
onPreExecute();

mWorker.mParams = params;
//然后后台计算#doInBackground才真正开始
exec.execute(mFuture);
//接着会有#onProgressUpdate被调用，最后是#onPostExecute

return this;
}

/**
* 这是AsyncTask提供的一个静态方法，方便我们直接执行一个runnable
*/
public static void execute(Runnable runnable) {
sDefaultExecutor.execute(runnable);
}

/**
* 打印后台计算进度，onProgressUpdate会被调用
*/
protected final void publishProgress(Progress... values) {
if (!isCancelled()) {
sHandler.obtainMessage(MESSAGE_POST_PROGRESS,
new AsyncTaskResult<Progress>(this, values)).sendToTarget();
}
}

//任务结束的时候会进行判断，如果任务没有被取消，则onPostExecute会被调用
private void finish(Result result) {
if (isCancelled()) {
onCancelled(result);
} else {
onPostExecute(result);
}
mStatus = Status.FINISHED;
}

//AsyncTask内部Handler，用来发送后台计算进度更新消息和计算完成消息
private static class InternalHandler extends Handler {
@SuppressWarnings({"unchecked", "RawUseOfParameterizedType"})
@Override
public void handleMessage(Message msg) {
AsyncTaskResult result = (AsyncTaskResult) msg.obj;
switch (msg.what) {
case MESSAGE_POST_RESULT:
// There is only one result
result.mTask.finish(result.mData[0]);
break;
case MESSAGE_POST_PROGRESS:
result.mTask.onProgressUpdate(result.mData);
break;
}
}
}

private static abstract class WorkerRunnable<Params, Result> implements Callable<Result> {
Params[] mParams;
}

@SuppressWarnings({"RawUseOfParameterizedType"})
private static class AsyncTaskResult<Data> {
final AsyncTask mTask;
final Data[] mData;

AsyncTaskResult(AsyncTask task, Data... data) {
mTask = task;
mData = data;
}
}
}

/**
* 本类修改自 The Android Open SourceProject<br>
* 使用高并发的线程池并发执行异步任务，用于替换Android自带的AsyncTask，达到多线程执行的最大效率<br>
* 使用适配器设计思想如果开发者需要使用串行执行Task任务，可手动调用
* setDefaultExecutor(KJTaskExecutor.mSerialExecutor)方法<br>
*
* <b>优化点：</b>采用并发替代了系统的串行执行,同时修复了2.3之前并行执行大量数据是FC的问题。<br>
* <b>创建时间</b> 2014-2-28 <br>
* <b>修改时间</b> 2014-10-24 <br>
*
* @param <Params>
*            启动参数类型
* @param <Progress>
*            进度返回类型
* @param <Result>
*            结果返回类型
* @author kymjs (https://github.com/kymjs)
* @version 1.2
*/
public abstract class KJAsyncTask<Params, Progress, Result> {

private static final int CPU_COUNT = Runtime.getRuntime().availableProcessors();
private static final int CORE_POOL_SIZE = CPU_COUNT;// 长期保持活的跃线程数。
private static final int MAXIMUM_POOL_SIZE = Integer.MAX_VALUE;// 线程池最大容量
// 当前线程数大于活跃线程数时，此为终止多余的空闲线程等待新任务的最长时间
private static final int KEEP_ALIVE = 10;

private static final int MESSAGE_POST_RESULT = 0x1;// 消息类型：发送结果
private static final int MESSAGE_POST_PROGRESS = 0x2;// 消息类型：更新进度
private static final int MESSAGE_POST_FINISH = 0x3;// 消息类型：异步执行完成
// 用来发送结果和进度通知，采用UI线程的Looper来处理消息 这就是为什么Task必须在UI线程调用
private static final InternalHandler mHandler = new InternalHandler();

// 工作线程
private final WorkerRunnable<Params, Result> mWorker;
// 待执行的runnable
private final FutureTask<Result> mFuture;
// 静态阻塞式队列，用来存放待执行的任务，初始容量：8个
private static final BlockingQueue<Runnable> mPoolWorkQueue = new LinkedBlockingQueue<>(8);
// 原子布尔型，支持高并发访问，标识任务是否被取消
private final AtomicBoolean mCancelled = new AtomicBoolean();
// 原子布尔型，支持高并发访问，标识任务是否被使用过
private final AtomicBoolean mTaskInvoked = new AtomicBoolean();

private static OnFinishedListener finishedListener;

// 任务的状态 默认为挂起，即等待执行，其类型标识为易变的（volatile）
private volatile Status mStatus = Status.PENDING;

// 任务的三种状态
public enum Status {
/** 任务等待执行 */
PENDING,
/** 任务正在执行 */
RUNNING,
/** 任务已经执行结束 */
FINISHED
}

// ThreadFactory，通过工厂方法newThread来获取新线程
private static final ThreadFactory mThreadFactory = new ThreadFactory() {
// 原子级整数，可以在超高并发下正常工作
private final AtomicInteger mCount = new AtomicInteger(1);

@Override
public Thread newThread(Runnable r) {
return new Thread(r, "KJLibrary->KJTaskExecutor #" + mCount.getAndIncrement());
}
};
/************************** 三种任务执行器的定义 *******************************/

/**
* 并发线程池任务执行器，它实际控制并执行线程任务，与mSerialExecutor（串行）相对应<br>
* <b> 优化：</b> 不限制并发总线程数!让任务总能得到执行,且高效执行少量(不大于活跃线程数)的异步任务。<br>
* 线程完成任务后保持10秒销毁，这段时间内可重用以应付短时间内较大量并发，提升性能。
*/
public static final ThreadPoolExecutor mThreadPoolExecutor = new ThreadPoolExecutor(
CORE_POOL_SIZE, MAXIMUM_POOL_SIZE, KEEP_ALIVE, TimeUnit.SECONDS,
mPoolWorkQueue, mThreadFactory);

/**
* 并发量控制: 根据cpu能力控制一段时间内并发数量，并发过量大时采用Lru方式移除旧的异步任务，默认采用LIFO策略调度线程运作，
* 开发者可选调度策略有LIFO、FIFO。
*/
public static final Executor mLruSerialExecutor = new SmartSerialExecutor();

/**
* 串行任务执行器，其内部实现了串行控制， 循环的取出一个个任务交给上述的并发线程池去执行<br>
* 与mThreadPoolExecutor（并行）相对应
*/
public static final Executor mSerialExecutor = new SerialExecutor();

// 设置默认任务执行器为并行执行
private static volatile Executor mDefaultExecutor = mLruSerialExecutor;

/** 为KJTaskExecutor设置默认执行器 */
public static void setDefaultExecutor(Executor exec) {
mDefaultExecutor = exec;
}

/**
* 创建一个asynchronous task，这个构造器必须运行于UI线程
*/
public KJAsyncTask() {
mWorker = new WorkerRunnable<Params, Result>() {
@Override
public Result call() throws Exception {
mTaskInvoked.set(true);
// 设置线程优先级
android.os.Process.setThreadPriority(android.os.Process.THREAD_PRIORITY_BACKGROUND);
return postResult(doInBackground(mParams));
}
};

mFuture = new FutureTask<Result>(mWorker) {
@Override
protected void done() {
try {
if (!mTaskInvoked.get()) {
postResult(get());
}
} catch (InterruptedException e) {
} catch (ExecutionException e) {
throw new RuntimeException("An error occured while executing doInBackground()", e.getCause());
} catch (CancellationException e) {
if (!mTaskInvoked.get()) {
postResult(null);
}
}
}
};
}

/**
* doInBackground执行完毕，发送消息
*
* @param result
* @return
*/
private Result postResult(Result result) {
@SuppressWarnings("unchecked")
Message message = mHandler.obtainMessage(MESSAGE_POST_RESULT, new KJTaskResult<Result>(this, result));
message.sendToTarget();
return result;
}

/*********************** method ***************************/

/**
* 耗时执行监听器
*
* @return
*/
public OnFinishedListener getFinishedListener() {
return finishedListener;
}

/**
* 设置耗时执行监听器
*
* @param finishedListener
*/
public static void setOnFinishedListener(OnFinishedListener finishedListener) {
KJAsyncTask.finishedListener = finishedListener;
}

/**
* 返回任务的状态
*/
public final Status getStatus() {
return mStatus;
}

/**
* 返回该线程是否已经被取消
*
* @see #cancel(boolean)
*/
public final boolean isCancelled() {
return mCancelled.get();
}

/**
* 如果task已经执行完成，或被某些其他原因取消，再调用本方法将返回false；<br>
* 当本task还没有启动就调用cancel(boolean),那么这个task将从来没有运行，此时会返回true。<br>
* 如果任务已经启动，则由参数决定执行此任务是否被中断。<br>
*
* @param mayInterruptIfRunning
*            <tt>true</tt> 表示取消task的执行
* @return 如果线程不能被取消返回false, 比如它已经正常完成
*/
public final boolean cancel(boolean mayInterruptIfRunning) {
mCancelled.set(true);
return mFuture.cancel(mayInterruptIfRunning);
}

/**
* Waits if necessary for the computation to complete, and then retrieves
* its result.
*
* @return The computed result.
*
* @throws CancellationException
*             If the computation was cancelled.
* @throws ExecutionException
*             If the computation threw an exception.
* @throws InterruptedException
*             If the current thread was interrupted while waiting.
*/
public final Result get() throws InterruptedException, ExecutionException {
return mFuture.get();
}

/**
* Waits if necessary for at most the given time for the computation to
* complete, and then retrieves its result.
*
* @param timeout
*            Time to wait before cancelling the operation.
* @param unit
*            The time unit for the timeout.
*
* @return The computed result.
*
* @throws CancellationException
*             If the computation was cancelled.
* @throws ExecutionException
*             If the computation threw an exception.
* @throws InterruptedException
*             If the current thread was interrupted while waiting.
* @throws TimeoutException
*             If the wait timed out.
*/
public final Result get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException {
return mFuture.get(timeout, unit);
}

/*********************** start 一个完整的执行周期 ***************************/

/**
* 在doInBackground之前调用，用来做初始化工作 所在线程：UI线程
*/
protected void onPreExecute() {}

/**
* 这个方法是我们必须要重写的，用来做后台计算 所在线程：后台线程
*/
protected abstract Result doInBackground(Params... params);

/**
* 打印后台计算进度，onProgressUpdate会被调用<br>
* 使用内部handle发送一个进度消息，让onProgressUpdate被调用
*/
protected final void publishProgress(Progress... values) {
if (!isCancelled()) {
mHandler.obtainMessage(MESSAGE_POST_PROGRESS, new KJTaskResult<Progress>(this, values)).sendToTarget();
}
}

/**
* 在publishProgress之后调用，用来更新计算进度 所在线程：UI线程
*/
protected void onProgressUpdate(Progress... values) {}

/**
* 任务结束的时候会进行判断：如果任务没有被取消，则调用onPostExecute;否则调用onCancelled
*/
private void finish(Result result) {
if (isCancelled()) {
onCancelled(result);
if (finishedListener != null) {
finishedListener.onCancelled();
}
} else {
onPostExecute(result);
if (finishedListener != null) {
finishedListener.onPostExecute();
}
}
mStatus = Status.FINISHED;
}

/**
* 在doInBackground之后调用，用来接受后台计算结果更新UI 所在线程：UI线程
*/
protected void onPostExecute(Result result) {}

/**
* 所在线程：UI线程<br>
* doInBackground执行结束并且{@link #cancel(boolean)} 被调用。<br>
* 如果本函数被调用则表示任务已被取消，这个时候onPostExecute不会再被调用。
*/
protected void onCancelled(Result result) {}

/*********************** end 一个完整的执行周期 ***************************/
/*********************** core method ***************************/

/**
* 这个方法必须在UI线程中调用<br>
* Note:这个函数将按照任务队列去串行执行后台线程或并发执行线程，这依赖于platform
* version,从1.6到3.0是并行，3.0以后为串行（为了避免AsyncTask所带来的并发错误）， 如果你一定要并行执行，你可以调用
* {@link #executeOnExecutor}替代这个方法，并将默认的执行器改为{@link #mThreadPoolExecutor}
*
* @param params
*            The parameters of the task.
* @return This instance of KJTaskExecutor.
* @throws IllegalStateException
*             If {@link #getStatus()} returns either
*/
public final KJAsyncTask<Params, Progress, Result> execute(Params... params) {
return executeOnExecutor(mDefaultExecutor, params);
}

/**
* 必须在UI线程调用此方法<br>
* 通过这个方法我们可以自定义KJTaskExecutor的执行方式，串行or并行，甚至可以采用自己的Executor 为了实现并行，
* asyncTask.executeOnExecutor(KJTaskExecutor.mThreadPoolExecutor, params);
*/
public final KJAsyncTask<Params, Progress, Result> executeOnExecutor(
Executor exec, Params... params) {
if (mStatus != Status.PENDING) {
switch (mStatus) {
case RUNNING:
throw new IllegalStateException("Cannot execute task: the task is already running.");
case FINISHED:
throw new IllegalStateException("Cannot execute task: the task has already been executed(a task can be executed only once)");
default:
break;
}
}
mStatus = Status.RUNNING;
onPreExecute();
mWorker.mParams = params;
exec.execute(mFuture);// 原理{@link #execute(Runnable runnable)}
// 接着会有#onProgressUpdate被调用，最后是#onPostExecute
return this;
}

/**
* 提供一个静态方法，方便在外部直接执行一个runnable<br>
* 用于瞬间大量并发的场景，比如，假设用户拖动ListView时如果需要启动大量异步线程，而拖动过去时间很久的用户已经看不到，允许任务丢失。
*/
public static void execute(Runnable runnable) {
mDefaultExecutor.execute(runnable);
}

/**
* KJTaskExecutor内部Handler，用来发送后台计算进度更新消息和计算完成消息
*/
private static class InternalHandler extends Handler {
@Override
@SuppressWarnings({ "unchecked", "rawtypes" })
public void handleMessage(Message msg) {
KJTaskResult result = (KJTaskResult) msg.obj;
switch (msg.what) {
case MESSAGE_POST_RESULT:
result.mTask.finish(result.mData[0]);
break;
case MESSAGE_POST_PROGRESS:
result.mTask.onProgressUpdate(result.mData);
break;
case MESSAGE_POST_FINISH:
if (finishedListener != null) {
finishedListener.onPostExecute();
}
break;
}
}
}

private static abstract class WorkerRunnable<Params, Result> implements Callable<Result> {
Params[] mParams;
}

private static class KJTaskResult<Data> {
final Data[] mData;
final KJAsyncTask<?, ?, ?> mTask;

KJTaskResult(KJAsyncTask<?, ?, ?> task, Data... data) {
mTask = task;
mData = data;
}
}

/**
* 串行执行器的实现<br>
* 如果采用串行执行，asyncTask.execute(Params ...)实际上会调用 SerialExecutor的execute方法。
* {@link #executeOnExecutor}
*/
private static class SerialExecutor implements Executor {
// 线性双向队列，用来存储所有的AsyncTask任务
final ArrayDeque<Runnable> mTasks = new ArrayDeque<Runnable>();
/** 当前正在执行的AsyncTask任务 */
Runnable mActive = null;

@Override
public synchronized void execute(final Runnable r) {
// 将task任务加入到SerialExecutor的双向队列中，也就是让task排队执行
mTasks.offer(new Runnable() {
@Override
public void run() {
try {
r.run();
} finally {
// 当前task执行完毕后，安排下一个执行
scheduleNext();
}
}
});
// 如果当前没有任务在执行，直接进入执行逻辑
if (mActive == null) {
scheduleNext();
}
}

/**
* 类似适配器设计模式，如果是并行执行任务就不调用上面的方法而直接使用并发执行者执行任务<br>
* 如果是串行执行任务， 就配合上面的函数将原本是并发执行的代码转换成串行执行
*/
protected synchronized void scheduleNext() {
// 从任务队列中取出队列头部的任务，如果有就交给并发线程池去执行
if ((mActive = mTasks.poll()) != null) {
mThreadPoolExecutor.execute(mActive);
}
}
}

/**
* 用于替换掉原生的mThreadPoolExecutor，可以大大改善Android自带异步任务框架的处理能力和速度。
* 默认使用LIFO（后进先出）策略来调度线程，可将最新的任务快速执行，当然你自己可以换为FIFO调度策略。
* 这有助于用户当前任务优先完成（比如加载图片时，很容易做到当前屏幕上的图片优先加载）。
*/
private static class SmartSerialExecutor implements Executor {
/**
* 这里使用{@link ArrayDeque}作为栈比{@link Stack}性能高
*/
private final ArrayDeque<Runnable> mQueue = new ArrayDeque<Runnable>(serialMaxCount);
private final ScheduleStrategy mStrategy = ScheduleStrategy.LIFO;

private enum ScheduleStrategy {
LIFO, FIFO
}

/**
* 一次同时并发的数量，根据处理器数量调节 <br>
* cpu count : 1 2 3 4 8 16 32 <br>
* once(base*2): 1 2 3 4 8 16 32 <br>
* 一个时间段内最多并发线程个数： 双核手机：2 四核手机：4 ... 计算公式如下：
*/
private static int serialOneTime;
/**
* 并发最大数量，当投入的任务过多大于此值时，根据Lru规则，将最老的任务移除（将得不到执行） <br>
* cpu count : 1 2 3 4 8 16 32 <br>
* base(cpu+3) : 4 5 6 7 11 19 35 <br>
* max(base*16): 64 80 96 112 176 304 560 <br>
*/
private static int serialMaxCount;

private void reSettings(int cpuCount) {
serialOneTime = cpuCount;
serialMaxCount = (cpuCount + 3) * 16;
}

public SmartSerialExecutor() {
reSettings(CPU_COUNT);
}

@Override
public synchronized void execute(final Runnable command) {
Runnable r = new Runnable() {
@Override
public void run() {
command.run();
next();
mHandler.sendEmptyMessage(MESSAGE_POST_FINISH);
}
};
if ((mThreadPoolExecutor).getActiveCount() < serialOneTime) {
// 小于单次并发量直接运行
mThreadPoolExecutor.execute(r);
} else {
// 如果大于并发上限，那么移除最老的任务
if (mQueue.size() >= serialMaxCount) {
mQueue.pollFirst();
}
// 新任务放在队尾
mQueue.offerLast(r);
}
}

public synchronized void next() {
Runnable mActive;
switch (mStrategy) {
case LIFO:
mActive = mQueue.pollLast();
break;
case FIFO:
mActive = mQueue.pollFirst();
break;
default:
mActive = mQueue.pollLast();
break;
}
if (mActive != null) {
mThreadPoolExecutor.execute(mActive);
}
}
}

public static abstract class OnFinishedListener {
public void onCancelled() {}

public void onPostExecute() {}
}
}