Handler是用来发送和处理Message
和Runnable
的,每个Handler
实例都是与一个线程和该线程的消息队列相关联的,如果当前线程没有创建Looper
有可能会抛异常。有可能的意思是有两种情况:
- 当前线程没有创建
Looper
,直接调用无参构造Handler()
则会抛异常;- 当前线程没有创建
Looper
,调用Looper.loop()
则会抛异常。
创建Handler、Looper和MessageQueue
public Handler() {
this(null, false);
}
public Handler(Callback callback) {
this(callback, false);
}
复制代码
这两个构造器都是在当前线程创建Handler,我们通常会使用第一个方法创建Handler
;第二个是设置一个处理Message
的Callback
接口。
public Handler(Callback callback, boolean async) {
...
mLooper = Looper.myLooper();
if (mLooper == null) {
throw new RuntimeException(
"Can't create handler inside thread that has not called Looper.prepare()");
}
mQueue = mLooper.mQueue;
//处理消息的回调,可以为空
mCallback = callback;
//是否异步,默认false
mAsynchronous = async;
}
复制代码
上面两个构造器最终都会执行这个构造器,mLooper
是使用Looper.myLooper()
赋值的,如果为空会抛出RuntimeException
,然后将Looper
的mQueue
赋值给Handler
的mQueue
,mQueue
就是消息队列。再看一下Looper.myLooper()
:
public static @Nullable Looper myLooper() {
return sThreadLocal.get();
}
复制代码
可以看到Looper
是通过ThreadLocal<Looper> sThreadLocal
获取到的,这里先介绍一下ThreadLocal
的两个主要方法,过多细节不介绍:
public void set(T value) {
//获取当前线程
Thread t = Thread.currentThread();
//根据t获取ThreadLocalMap,key是ThreadLocal类型
ThreadLocalMap map = getMap(t);
if (map != null)
//如果map不为空,直接设置
map.set(this, value);
else
//如果map为空,创建新的map,再把value放进去,本篇放的值是Looper对象
createMap(t, value);
}
public T get() {
Thread t = Thread.currentThread();
ThreadLocalMap map = getMap(t);
if (map != null) {
ThreadLocalMap.Entry e = map.getEntry(this);
if (e != null) {
@SuppressWarnings("unchecked")
T result = (T)e.value;
return result;
}
}
return setInitialValue();
}
复制代码
上面代码挺简单的就不做解释了,具体介绍一下 ThreadLocal: 这个类提供线程局部变量,ThreadLocal
为每个使用该变量的线程提供独立的变量副本,所以每一个线程都可以独立地改变自己的副本,而不会影响其它线程所对应的副本。 话又说回来,那么什么时候把Looper
设置到ThreadLocal<Looper> sThreadLocal
里的?其实是在app启动的时候就设置了,下面是ActivityThread
的main
方法:
public static void main(String[] args) {
...
Looper.prepareMainLooper();
...
Looper.loop();
throw new RuntimeException("Main thread loop unexpectedly exited");
}
复制代码
这里调用了Looper.prepareMainLooper()
,然后又会调用prepare(false)
,创建新的Looper
,并将它设置到sThreadLocal
里。这里主线程的Looper
就创建完成了,接着调用Looper.loop()
开始轮询,这个后面再讲。
public static void prepareMainLooper() {
//主线程Looper不允许退出
prepare(false);
synchronized (Looper.class) {
if (sMainLooper != null) {
//因为一个线程只能有一个Looper
throw new IllegalStateException("The main Looper has already been prepared.");
}
sMainLooper = myLooper();
}
}
private static void prepare(boolean quitAllowed) {
if (sThreadLocal.get() != null) {
throw new RuntimeException("Only one Looper may be created per thread");
}
//将新的Looper设置到ThreadLocal里
sThreadLocal.set(new Looper(quitAllowed));
}
private Looper(boolean quitAllowed) {
//创建消息队列
mQueue = new MessageQueue(quitAllowed);
mThread = Thread.currentThread();
}
复制代码
这里注意一下上面的quitAllowed
参数,这个参数在主线程里是false
,表示Looper
不允许退出,否则抛出IllegalStateException("Main thread not allowed to quit.")
。到了这里,主线程创建Looper
,Handler
和MessageQueue
就介绍完了。
public Handler(Looper looper) {
this(looper, null, false);
}
public Handler(Looper looper, Callback callback) {
this(looper, callback, false);
}
复制代码
这两个构造器可以在任意线程创建Handler,主线程使用Looper.myLooper()
,子线程使用Looper.prepare()
。
public static void prepare() {
//这里的quitAllowed参数是true,表示Looper允许退出
prepare(true);
}
复制代码
public Handler(Looper looper, Callback callback, boolean async) {
mLooper = looper;
mQueue = looper.mQueue;
mCallback = callback;
mAsynchronous = async;
}
复制代码
这里比较简单就是进行赋值,创建完不要忘记调用Looper.loop()
开始轮询。注意:不使用时要调用Looper.quit()
或Looper.quitSafely()
,前者是移除消息队列中所有消息,后者是移除未触发的消息。否则Looper
会处于等待状态。
发送消息
public boolean sendMessageAtTime(Message msg, long uptimeMillis) {
MessageQueue queue = mQueue;
if (queue == null) {
RuntimeException e = new RuntimeException(
this + " sendMessageAtTime() called with no mQueue");
Log.w("Looper", e.getMessage(), e);
return false;
}
return enqueueMessage(queue, msg, uptimeMillis);
}
public final boolean sendMessageAtFrontOfQueue(Message msg) {
MessageQueue queue = mQueue;
if (queue == null) {
RuntimeException e = new RuntimeException(
this + " sendMessageAtTime() called with no mQueue");
Log.w("Looper", e.getMessage(), e);
return false;
}
return enqueueMessage(queue, msg, 0);
}
复制代码
无论调用哪一种发送消息的方法都会走到这两个方法,只是第二个方法的uptimeMillis
为0,表示需要立即执行。下面看一下enqueueMessage
:
private boolean enqueueMessage(MessageQueue queue, Message msg, long uptimeMillis) {
msg.target = this;
if (mAsynchronous) {
//设置异步
msg.setAsynchronous(true);
}
return queue.enqueueMessage(msg, uptimeMillis);
}
复制代码
这里注意msg.target
就是Handler
,然后交给MessageQueue
的enqueueMessage
插入消息队列。
插入消息
boolean enqueueMessage(Message msg, long when) {
if (msg.target == null) {
//如果Handler为空抛出异常
throw new IllegalArgumentException("Message must have a target.");
}
if (msg.isInUse()) {
//消息已经被使用
throw new IllegalStateException(msg + " This message is already in use.");
}
synchronized (this) {
//只有调用Looper.quit()时为true
if (mQuitting) {
IllegalStateException e = new IllegalStateException(
msg.target + " sending message to a Handler on a dead thread");
Log.w(TAG, e.getMessage(), e);
//消息回收
msg.recycle();
return false;
}
//标记消息已经被使用
msg.markInUse();
//设置消息的运行时间
msg.when = when;
//设置当前的消息
Message p = mMessages;
boolean needWake;
if (p == null || when == 0 || when < p.when) {
// 当前消息队列为空或when == 0或运行时间小于p的运行时间就插入到头部.
msg.next = p;
mMessages = msg;
//needWake需要根据mBlocked的情况考虑是否触发
needWake = mBlocked;
} else {
//当前消息队列不为空,并且不需要立即运行,并且当前运行时间>=p的运行时间
//插入队列中间,我们不必唤醒事件队列,除非队列头部存在障碍并且消息是队列中最早的异步消息。
needWake = mBlocked && p.target == null && msg.isAsynchronous();
Message prev;
//开始循环直到当前消息为空,或者运行时间小于p的运行时间
for (;;) {
prev = p;
p = p.next;
if (p == null || when < p.when) {
break;
}
if (needWake && p.isAsynchronous()) {
//因为消息队列之前还剩余消息,所以这里不用调用nativeWakeup
needWake = false;
}
}
// 将msg按照时间顺序插入消息队列,p - msg - next
msg.next = p;
prev.next = msg;
}
if (needWake) {
//调用nativeWake,以触发nativePollOnce函数结束等待
nativeWake(mPtr);
}
}
return true;
}
复制代码
MessageQueue
是按照Message
触发时间的先后顺序排列的,队头的消息是将要最早触发的消息。当有消息需要加入消息队列时,会从队列头开始遍历,直到找到消息应该插入的合适位置,以保证所有消息的时间顺序。那么插入到队列中的消息是如何取出来的呢?当然是Looper.loop()
啦,
取出消息
public static void loop() {
final Looper me = myLooper();
if (me == null) {
//如果当前线程没有Looper抛出异常
throw new RuntimeException("No Looper; Looper.prepare() wasn't called on this thread.");
}
final MessageQueue queue = me.mQueue;
...
for (;;) {
// 通过next方法取出消息,这里是关键,我们后面分析,先说一点next没有消息会一直处于阻塞状态,
// 所以不会往下走
Message msg = queue.next();
if (msg == null) {
// 没有消息表明消息队列正在退出。
return;
}
...
//分发取出的消息,这里msg.target就是Handler
msg.target.dispatchMessage(msg);
...
//处理过之后要把消息回收
msg.recycleUnchecked();
}
}
复制代码
接下来我们去看看MessageQueue
的next()
:
Message next() {
// 如果消息队列执行了quit或dispose就会返回空的消息
final long ptr = mPtr;
if (ptr == 0) {
return null;
}
int pendingIdleHandlerCount = -1; // 循环迭代的首次为-1
//如果为-1,则表示无限等待,直到有事件发生为止。如果值为0,则无需等待立即返回
int nextPollTimeoutMillis = 0;
for (;;) {
if (nextPollTimeoutMillis != 0) {
Binder.flushPendingCommands();
}
//阻塞操作,当到了nextPollTimeoutMillis时长,或者消息队列被唤醒,都会返回
//这里底层做了大量的工作,水平有限就不细究了
nativePollOnce(ptr, nextPollTimeoutMillis);
synchronized (this) {
// 尝试检索下一条消息, 如果找到则返回。
final long now = SystemClock.uptimeMillis();
Message prevMsg = null;
Message msg = mMessages;
if (msg != null && msg.target == null) {
//当消息Handler为空时,查询MessageQueue中的下一条异步消息msg并退出循环。
do {
prevMsg = msg;
msg = msg.next;
} while (msg != null && !msg.isAsynchronous());
}
if (msg != null) {
if (now < msg.when) {
//当异步消息触发时间大于当前时间,则设置下一次轮询的超时时长
nextPollTimeoutMillis = (int) Math.min(msg.when - now, Integer.MAX_VALUE);
} else {
// 获取一个消息并返回,把msg.next设置成当前消息.
//如果取到了消息mBlocked为false,没取到就是
mBlocked = false;
if (prevMsg != null) {
prevMsg.next = msg.next;
} else {
mMessages = msg.next;
}
msg.next = null;
if (DEBUG) Log.v(TAG, "Returning message: " + msg);
//标记msg的使用状态
msg.markInUse();
return msg;
}
} else {
// 没有找到消息.
nextPollTimeoutMillis = -1;
}
// 如果消息正在推出,返回null.
if (mQuitting) {
dispose();
return null;
}
if (pendingIdleHandlerCount < 0
&& (mMessages == null || now < mMessages.when)) {
//第一次迭代,并且消息队列为空或者是第一个消息
pendingIdleHandlerCount = mIdleHandlers.size();
}
if (pendingIdleHandlerCount <= 0) {
// 没有 idle handlers 需要执行. 处于等待状态并跳过这次迭代.
mBlocked = true;
continue;
}
...
//重置idle handler个数为0,以保证不会再次重复运行
pendingIdleHandlerCount = 0;
//当调用一个空闲handler时,一个新message能够被分发,因此无需等待可以直接查询pending message.
nextPollTimeoutMillis = 0;
}
}
复制代码
这样消息就被取出来了,接下来看看是如何处理消息的。
处理消息
public void dispatchMessage(Message msg) {
if (msg.callback != null) {
handleCallback(msg);
} else {
if (mCallback != null) {
if (mCallback.handleMessage(msg)) {
return;
}
}
handleMessage(msg);
}
}
复制代码
如果msg
的callback
不为空,则执行handleCallback(msg)
;否则看Handler
的mCallback
是否为空,不为空则执行mCallback.handleMessage(msg)
,若mCallback.handleMessage(msg)
返回true则直接退出方法,否则执行handleMessage(msg)
,handleMessage(msg)
是个空方法,需要我们自己来实现。