Uicc之UiccController（转）

来源：互联网发布：php函数手册 pdf 编辑：程序博客网时间：2024/05/18 01:09

UiccController是整个UICC事务处理的入口，负责对外提供IccRecords、IccFileHandler、UiccCardApplication等对象，并完成整个UICC系统的初始化工作。

一、UiccController提供的主要功能

我们通过其提供的public方法来看他的主要功能：

[java] view plaincopypublic UiccCard getUiccCard() {}  public UiccCardApplication getUiccCardApplication(int family) {}  public IccRecords getIccRecords(int family) {}  public IccFileHandler getIccFileHandler(int family) {}  public void registerForIccChanged(Handler h, int what, Object obj) {}

从上面提供的方法可以知道，UiccController的主要作用体现在两个方面：

1、创建并向外提供UiccCard、UiccCardApplication、IccRecords、IccFileHandler等对象

2、提供对SIM状态的监听

二、UiccController的创建过程

我们先来看一下UiccController是在哪里被创建的。

我们知道，Phone对象是在Phone模块的初始化中通过PhoneFactory创建的：

@PhoneGlobals.java  public void onCreate() {      if (phone == null) {          //创建Phone对象          PhoneFactory.makeDefaultPhones(this);          //得到Phone对象          phone = PhoneFactory.getDefaultPhone();      }  }

然后看makeDefaultPhones()的过程：

@PhoneFactory.java  public static void makeDefaultPhones(Context context) {      makeDefaultPhone(context);  }  public static void makeDefaultPhone(Context context) {       //获取RILJ      sCommandsInterface = new RIL(context, networkMode, cdmaSubscription);      //创建UiccController      UiccController.make(context, sCommandsInterface);      //得到phone的Type      int phoneType = TelephonyManager.getPhoneType(networkMode);      //创建PhoneProxy对象      if (phoneType == PhoneConstants.PHONE_TYPE_GSM) {          sProxyPhone = new PhoneProxy(new GSMPhone(context, sCommandsInterface, sPhoneNotifier));      } else if (phoneType == PhoneConstants.PHONE_TYPE_CDMA) {          switch (TelephonyManager.getLteOnCdmaModeStatic()) {

            case PhoneConstants.LTE_ON_CDMA_TRUE:                  sProxyPhone = new PhoneProxy(new CDMALTEPhone(context, sCommandsInterface, sPhoneNotifier));                  break;              case PhoneConstants.LTE_ON_CDMA_FALSE:              default:                  sProxyPhone = new PhoneProxy(new CDMAPhone(context, sCommandsInterface, sPhoneNotifier));                  break;          }      }  }

这里看到，在new完RIL对象之后，就通过UiccController的make()方法对UiccController进行创建，而且传递进去的两个参数，其中一个是Context类型对象，另一个是CommandsInterface类型的RIL对象。
接下来我们通过UiccController的make()方法来看具体的创建过程：

@UiccController.java  public static UiccController make(Context c, CommandsInterface ci) {      synchronized (mLock) {          if (mInstance != null) {              throw new RuntimeException("UiccController.make() should only be called once");          }          mInstance = new UiccController(c, ci);          return mInstance;      }  }

这里需要注意，UiccController的make()方法只能调用一次，也就是说，在整个全局中，只存在一个UiccController对象。

private UiccController(Context c, CommandsInterface ci) {      mContext = c;      mCi = ci;      mCi.registerForIccStatusChanged(this, EVENT_ICC_STATUS_CHANGED, null);      mCi.registerForOn(this, EVENT_ICC_STATUS_CHANGED, null);  }

我们看到，在UiccController的构造函数中，只完成了一件事情，就是注册了两个监听器：registerForIccStatusChanged和registerForOn。这两个监听器监听的是SIM卡和Radio的状态，他们是UiccController更新的触发器。

三、UiccController更新机制

刚才讲到，UiccController的初始化过程主要向RILJ注册了两个监听器，而这两个监听器就是UiccController更新机制的触发点，当监听的事件发生时，UiccController就会启动整个UICC框架的更新机制。

下面来看具体的更新过程。

3.1、监听器所监听的事件

3.1.1、registerForIccStatusChanged监听器

对于registerForIccStatusChanged这个注册的动作，并没有直接调用到RIL类里面，而是调用到了RIL的父类BaseCommands中：

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

我们看到，这里的注册过程其实就是在mIccStatusChangedRegistrants对象List中添加当前的注册对象，然后当以下两种事件发生时就会遍历该List中的监听者进行通知：
1、输入错误的PIN或PUK时：

        private RILRequest processSolicited (Parcel p) {            switch (rr.mRequest) {                case RIL_REQUEST_ENTER_SIM_PUK:                case RIL_REQUEST_ENTER_SIM_PUK2:                    if (mIccStatusChangedRegistrants != null) {                        mIccStatusChangedRegistrants.notifyRegistrants();                    }                    break;            }        }

2、当SIM卡状态发生改变时：

        private void processUnsolicited (Parcel p) {            switch(response) {                case RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED:                    if (mIccStatusChangedRegistrants != null) {                        mIccStatusChangedRegistrants.notifyRegistrants();                    }                    break;            }        }

3.1.2、registerForOn监听器

与registerForIccStatusChanged类似，registerForOn()也是在BaseCommands中被实现的：

        @BaseCommands.java        public void registerForOn(Handler h, int what, Object obj) {            Registrant r = new Registrant (h, what, obj);            synchronized (mStateMonitor) {                //将注册信息保存在mOnRegistrants列表中                mOnRegistrants.add(r);                if (mState.isOn()) {                    r.notifyRegistrant(new AsyncResult(null, null, null));                }            }        }

注册的过程就是把监听者信息保存在mOnRegistrants变量的List列表中，然后当以下两种事件发生时就会遍历该List并通知监听者：
1、Radio状态发生改变时：

        private void processUnsolicited (Parcel p) {            switch(response) {                case RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED:                    RadioState newState = getRadioStateFromInt(p.readInt());                    switchToRadioState(newState);                    break;            }        }        private void switchToRadioState(RadioState newState) {            setRadioState(newState);        }        protected void setRadioState(RadioState newState) {            synchronized (mStateMonitor) {                //通知监听者                mRadioStateChangedRegistrants.notifyRegistrants();            }        }

2、RILJ与RILC通道断开时

class RILReceiver implements Runnable {      @Override      public void run() {          //Socket通道断开，设置Radio状态为unavailable状态          setRadioState (RadioState.RADIO_UNAVAILABLE);      }  }

经过上面的分析，我们可以看到，当发生以下事件时，RIL就会对当前的UiccController发起通知：
1、输入错误的PIN、PUK码
2、SIM卡状态发生改变
3、Radio状态发生改变
4、Socket通道断开

接下来我们查看当上述情况发生时，UiccController的动作：

3.2、UiccController对监听事件的处理流程

由于UiccController注册以上两种监听器时所使用的what参数均为“EVENT_ICC_STATUS_CHANGED”，因此上述监听的事件发生时，都会进入同一个EVENT_ICC_STATUS_CHANGED的case分支：

        @UiccController.java        public void handleMessage (Message msg) {            synchronized (mLock) {                switch (msg.what) {                    case EVENT_ICC_STATUS_CHANGED:                        //无论是SIM卡的状态或者Radio的状态发生改变，都会进入该case中                        mCi.getIccCardStatus(obtainMessage(EVENT_GET_ICC_STATUS_DONE));                        break;                    case EVENT_GET_ICC_STATUS_DONE:                        AsyncResult ar = (AsyncResult)msg.obj;                        onGetIccCardStatusDone(ar);                        break;                    default:                        Rlog.e(LOG_TAG, " Unknown Event " + msg.what);                }            }        }

然后就会调用RIL.java的getIccCardStatus()方法，去查询最新的SIM和Radio状态。
当RILJ获取到getIccCardStatus()的请求后，就会向Modem发起请求查询当前的SIM卡状态：

        @RIL.java        public void getIccCardStatus(Message result) {            //向Modem发送请求，获取当前的SIM卡状态            RILRequest rr = RILRequest.obtain(RIL_REQUEST_GET_SIM_STATUS, result);            send(rr);        }

然后获取到最新状态后，将结果反馈给发起请求的对象，当前就是UiccController：

        private RILRequest processSolicited (Parcel p) {            switch (rr.mRequest) {                case RIL_REQUEST_GET_SIM_STATUS:                     //根据Modem得到的返回值构建IccCardStatus对象                    ret =  responseIccCardStatus(p); break;            }            if (rr.mResult != null) {                AsyncResult.forMessage(rr.mResult, ret, null);                //将结果返回给UiccController                rr.mResult.sendToTarget();            }        }

接下来，UiccController就再次通过handleMessage()方法来处理接下来的流程，只不过这次进入的是EVENT_GET_ICC_STATUS_DONE的case流程：

        @UiccController.java        public void handleMessage (Message msg) {            synchronized (mLock) {                switch (msg.what) {                    case EVENT_ICC_STATUS_CHANGED:                        //得到状态改变通知，发起请求                        mCi.getIccCardStatus(obtainMessage(EVENT_GET_ICC_STATUS_DONE));                        break;                    case EVENT_GET_ICC_STATUS_DONE:                        //获取最新的SIM卡状态                        AsyncResult ar = (AsyncResult)msg.obj;                        onGetIccCardStatusDone(ar);                        break;                    default:                        Rlog.e(LOG_TAG, " Unknown Event " + msg.what);                }            }        }

继续看UiccController对最新状态的处理：

        private synchronized void onGetIccCardStatusDone(AsyncResult ar) {            if (ar.exception != null) {                return;            }            //拿到RIL中创建的IccCardStatus对象            IccCardStatus status = (IccCardStatus)ar.result;            //创建或更新UiccCard            if (mUiccCard == null) {                mUiccCard = new UiccCard(mContext, mCi, status);            } else {                mUiccCard.update(mContext, mCi , status);            }            //继续向其他对象派发消息            mIccChangedRegistrants.notifyRegistrants();        }

到这里我们看到，UiccController获取到最新的SIM卡状态之后，做了两件事情：1、创建或更新UiccCard;2、通知其他子监听对象。
而且我们获取到两个信息：1、UiccCard对象是在UiccController更新SIM卡状态时创建的;2、其他对象可以通过registerForIccChanged()方法向UiccController申请监听SIM卡状态监听。
至此，UiccController的分析结束，下一章将会介绍UiccCard对象。

原博文地址：http://blog.csdn.net/u010961631/article/details/38322299

0 0