追踪Android源码，理解Registrant运行机制

前言：我的第一篇博客诞生啦！祝愿自己2017年更加优秀！

好了，不感慨了，进入主题，今天想为大家带来的是我对Registrant运行机制的理解。由于本人非科班出身，语言叙述会比较大白话，没有那么多的专业术语，见谅哈！

Android源码很多地方都用到了Registrant这个类，那么本文呢，以RIL层为背景来去理解Registrant运行机制。

SIM卡、服务状态、数据连接、短彩信、电话等业务都需要和RIL打交道，因而RIL层要很好地处理这些业务的查询、请求就至关重要。

RIL.java继承自BaseCommands.java并实现了CommandsInterface.java的接口。

在UiccController.java的构造方法里，有这样一句代码mCis[i].registerForIccStatusChanged(this, EVENT_ICC_STATUS_CHANGED, index);

mCis[i]是两张SIM卡中的一张所对应的RIL对象，即该行代码调用了RIL里面的方法。这句代码的意思是向RIL层注册了一个事件，即当这个事件发生时，需要把消息汇报给UiccController。

首先是注册消息：

在BaseCommands.java中重写了该方法，源码如下：

@Override
public void registerForIccStatusChanged(Handler h, int what, Object obj) {
Registrant r = new Registrant (h, what, obj);
mIccStatusChangedRegistrants.add(r);
}

该方法中创建了一个Registrant对象，该构造方法源码如下：

public
Registrant(Handler h, int what, Object obj)
{
refH = new WeakReference(h);
this.what = what;
userObj = obj;
}

该构造方法中将Handler h, int what, Object obj这三个对象分别给了该Registrant对象的三个成员变量。并且，将该Registrant对象加入到mIccStatusChangedRegistrants的动态数组中去。

mIccStatusChangedRegistrants是什么？请见下面的源码：

protected RegistrantList mIccStatusChangedRegistrants = new RegistrantList();

mIccStatusChangedRegistrants.add(r);会执行RegistrantList.java中方法：

public synchronized void
add(Registrant r)
{
removeCleared();
registrants.add(r);
}

其中，registrants为ArrayList   registrants = new ArrayList();      // of Registrant

在执行完成mCis[i].registerForIccStatusChanged(this, EVENT_ICC_STATUS_CHANGED, index)方法后，表明UiccController已经向注册了一个SIM卡的信息发生改变的消息。

接下来是返回消息：

当modem侧上报过来RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED消息时，说明SIM卡的信息发送了改变。那么就需要汇报给UiccController这个对象，怎么汇报呢？

在RIL.java中执行了下面的代码：

if (mIccStatusChangedRegistrants != null) {
mIccStatusChangedRegistrants.notifyRegistrants();
}

继续在RegistrantList.java中追踪该代码的执行情况，如下：

public /*synchronized*/ void
notifyRegistrants()
{
internalNotifyRegistrants(null, null);
}

private synchronized void
internalNotifyRegistrants (Object result, Throwable exception)
{
for (int i = 0, s = registrants.size(); i < s ; i++) {
Registrant  r = (Registrant) registrants.get(i);
r.internalNotifyRegistrant(result, exception);
}
}

到此为止，可以看到遍历了mIccStatusChangedRegistrants中成员遍历动态数组中的Registrant。

继续追踪Registrant.java中的执行情况，如下：

/*package*/ void
internalNotifyRegistrant (Object result, Throwable exception)
{
Handler h = getHandler();

if (h == null) {
clear();
} else {
Message msg = Message.obtain();

msg.what = what;

msg.obj = new AsyncResult(userObj, result, exception);

h.sendMessage(msg);
}
}

public Handler
getHandler()
{
if (refH == null)
return null;

return (Handler) refH.get();
}

到此为止，应该很清晰了，利用了Handler，将消息返回给UiccController，这里的getHandler()方法就是去获得UiccController这个对象的（UiccController集成Handler），而msg.what就是EVENT_ICC_STATUS_CHANGED。

Handler的运行机制的源码追踪分析网络很多，这里就不再班门弄斧了。

Best Regards！