Android Telephony分析（五）--- TelephonyRegistry 详解

原文出处：http://blog.csdn.net/linyongan/article/details/52126969

本文紧接着上一篇文章Android Telephony分析（四）--- TelephonyManager 详解 的1.4小节。
从TelephonyRegistry的大部分方法中:

可以看出TelephonyRegistry主要的功能是上报消息，有两种方式：
1. 通过notifyXXX方法。
2. 通过发送broadcast。

至于发广播没什么好说的了，我们看看notifyXXX方法吧，以notifyCallStateForPhoneId()方法为例

    public void notifyCallStateForPhoneId(int phoneId, int subId, int state,
                String incomingNumber) {
        //先检测权限
        if (!checkNotifyPermission("notifyCallState()")) {
            return;
        }
        //1.mRecords是什么？
        synchronized (mRecords) {
            int phoneId = SubscriptionManager.getPhoneId(subId);
            if (validatePhoneId(phoneId)) {
                mCallState[phoneId] = state;
                mCallIncomingNumber[phoneId] = incomingNumber;
                //遍历mRecords列表
                for (Record r : mRecords) {
                    //取出注册监听"LISTEN_CALL_STATE"这种事件的Record对象
                    if (r.matchPhoneStateListenerEvent(PhoneStateListener.LISTEN_CALL_STATE) &&
                            (r.subId == subId) &&
                            (r.subId != SubscriptionManager.DEFAULT_SUBSCRIPTION_ID)) {
                        try {
                            String incomingNumberOrEmpty = getCallIncomingNumber(r, phoneId);
                            //2.Record.callback又是什么？
                            r.callback.onCallStateChanged(state, incomingNumberOrEmpty);
                        } catch (RemoteException ex) {
                            mRemoveList.add(r.binder);
                        }
                    }
                }
            }
            handleRemoveListLocked();
        }
        //同时调用发广播的方法
        broadcastCallStateChanged(state, incomingNumber, phoneId, subId);
    }

通过初步分析notifyCallState()方法，你会发现有两个疑问：
1. mRecords是什么？
2. Record.callback又是什么？
好了，带着上面两种疑问，我们继续分析代码吧。

接着你会发现mRecords是由Record对象组成的List集合

    private final ArrayList<Record> mRecords = new ArrayList<Record>();

而Record是TelephonyRegistry中的内部类，TelephonyRegistry会把监听者的信息封装成一个Record对象，并且放进mRecords列表中管理。

class TelephonyRegistry extends ITelephonyRegistry.Stub {

    private static class Record {
        String callingPackage;
        IBinder binder;
        //Record.callback是实现了IPhoneStateListener接口的类，
        //也就是继承了或者重写了PhoneStateListener的类
        IPhoneStateListener callback;
        IOnSubscriptionsChangedListener onSubscriptionsChangedListenerCallback;
        int callerUserId;
        //存储用来记录监听的事件
        int events;
        int subId = SubscriptionManager.INVALID_SUBSCRIPTION_ID;
        int phoneId = SubscriptionManager.INVALID_PHONE_INDEX;
        boolean canReadPhoneState;
        boolean matchPhoneStateListenerEvent(int events) {
            return (callback != null) && ((events & this.events) != 0);
        }
        boolean matchOnSubscriptionsChangedListener() {
            return (onSubscriptionsChangedListenerCallback != null);
        }
    }

在TelephonyRegistry.Java的listen方法中，管理并维护着mRecords列表：

    public void listenForSubscriber(int subId, String pkgForDebug, IPhoneStateListener callback,
            int events, boolean notifyNow) {
        listen(pkgForDebug, callback, events, notifyNow, subId);
    }

    private void listen(String callingPackage, IPhoneStateListener callback, int events,
            boolean notifyNow, int subId) {
            ...
            synchronized (mRecords) {
                // register
                Record r;
                find_and_add: {
                    //得到监听者的信息
                    IBinder b = callback.asBinder();
                    //遍历mRecords列表
                    for (int i = 0; i < N; i++) {
                        r = mRecords.get(i);
                        if (b == r.binder) {
                            //退出循环
                            break find_and_add;
                        }
                    }
                    //如果监听者还没有被加到mRecords列表中
                    r = new Record();
                    r.binder = b;
                    //新建一个Record对象并且加入mRecords列表中
                    mRecords.add(r);
                    if (DBG) log("listen: add new record");
                }
                //存储监听者
                r.callback = callback;
                ...
                //存储监听者所监听的事件
                r.events = events;
                //如果需要现在发通知的话
                if (notifyNow && validatePhoneId(phoneId)) {
                    if ((events & PhoneStateListener.LISTEN_SERVICE_STATE) != 0) {
                        try {
                            //注册之后，马上通知一次监听者
                            r.callback.onServiceStateChanged(
                                    new ServiceState(mServiceState[phoneId]));
                        } catch (RemoteException ex) {
                            remove(r.binder);
                        }
                    }
                ...
    }

常见的注册监听和发通知的流程，以监听Call状态变化为例：

总体看分成3步：
1. 根据需要监听的事件，重写PhoneStateListener中对应的方法，如果需要监听LISTEN_CALL_STATE，那么需要重写 onCallStateChanged()方法；如果需要监听LISTEN_SERVICE_STATE，则需要重写onServiceStateChanged()方法。（步骤1）
2. 调用TelephonyManager的listen()方法，传递PhoneStateListener对象和events。到这里监听的操作一直执行到步骤4就结束了。
3. 当有Call状态变化消息上来时，通知上报的路径：
RILJ—>CallTracker—>Phone—>DefaultPhoneNotifier—>TelephonyRegistry—>监听者
最后也是来到监听者重写的PhoneStateListener的那个方法中，整个过程也是一个回调。

其他需要说明的是：
1. DefaultPhoneNotifier是TelephonyRegistry最常用的客户端，它继承自

public class DefaultPhoneNotifier implements PhoneNotifier {

在它构造方法中：

    protected DefaultPhoneNotifier() {
        //通过ServiceManager得到了TelephonyRegistry的代理对象
        mRegistry = ITelephonyRegistry.Stub.asInterface(ServiceManager.getService(
                    "telephony.registry"));
    }

所以DefaultPhoneNotifier中大部分方法都依靠TelephonyRegistry对象来实现。

2 . 如何知道我需要监听的事件以及对应要重写的方法？
所有的可以监听的事件都定义在PhoneStateListener.java (frameworks\base\telephony\java\Android\telephony)中，

需要重写的方法，初始都定义在IPhoneStateListener.aidl(frameworks/base/telephony/java/com/android/internal/telephony)中

接着由PhoneStateListener初步重写了IPhoneStateListener.aidl接口中的方法：

    /**
     * The callback methods need to be called on the handler thread where
     * this object was created.  If the binder did that for us it'd be nice.
     */
    IPhoneStateListener callback = new IPhoneStateListener.Stub() {
        public void onServiceStateChanged(ServiceState serviceState) {
            Message.obtain(mHandler, LISTEN_SERVICE_STATE, 0, 0, serviceState).sendToTarget();
        }
        ...
    }

在这里就可以找到某个事件对应的方法是什么。
当然可以自己新增事件以及在IPhoneStateListener.aidl中新增对应的接口，再实现该接口就可以了。