追踪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！