UiccController是整个UICC事务处理的入口,负责对外提供IccRecords、IccFileHandler、UiccCardApplication等对象,并完成整个UICC系统的初始化工作。
我们通过其提供的public方法来看他的主要功能:
然后看makeDefaultPhones()的过程:
这里看到,在new完RIL对象之后,就通过UiccController的make()方法对UiccController进行创建,而且传递进去的两个参数,其中一个是Context类型对象,另一个是CommandsInterface类型的RIL对象。
接下来我们通过UiccController的make()方法来看具体的创建过程:
这里需要注意,UiccController的make()方法只能调用一次,也就是说,在整个全局中,
只存在一个UiccController对象。
我们看到,这里的注册过程其实就是在mIccStatusChangedRegistrants对象List中添加当前的注册对象,然后当以下两种事件发生时就会遍历该List中的监听者进行通知:
1、输入错误的PIN或PUK时:
2、当SIM卡状态发生改变时:
注册的过程就是把监听者信息保存在mOnRegistrants变量的List列表中,然后当以下两种事件发生时就会遍历该List并通知监听者:
1、Radio状态发生改变时:
2、RILJ与RILC通道断开时
经过上面的分析,我们可以看到,当发生以下事件时,RIL就会对当前的UiccController发起通知:
1、输入错误的PIN、PUK码
2、SIM卡状态发生改变
3、Radio状态发生改变
4、Socket通道断开
然后就会调用RIL.java的getIccCardStatus()方法,去查询最新的SIM和Radio状态。
当RILJ获取到getIccCardStatus()的请求后,就会向Modem发起请求查询当前的SIM卡状态:
然后获取到最新状态后,将结果反馈给发起请求的对象,当前就是UiccController:
接下来,UiccController就再次通过handleMessage()方法来处理接下来的流程,只不过这次进入的是EVENT_GET_ICC_STATUS_DONE的case流程:
继续看UiccController对最新状态的处理:
到这里我们看到,UiccController获取到最新的SIM卡状态之后,做了两件事情:
1、创建或更新UiccCard;2、通知其他子监听对象。
而且我们获取到两个信息:1、UiccCard对象是在UiccController更新SIM卡状态时创建的;2、其他对象可以通过registerForIccChanged()方法向UiccController申请监听SIM卡状态监听。
至此,UiccController的分析结束,下一章将会介绍 UiccCard对象。
一、UiccController提供的主要功能
- public 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();
- }
- }
- @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;
- }
- }
- }
接下来我们通过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;
- }
- }
- 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);
- }
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;
- }
- }
- 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));
- }
- }
- }
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();
- }
- }
- 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);
- }
- }
- }
当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);
- }
- 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.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);
- }
- }
- }
- 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();
- }
而且我们获取到两个信息:1、UiccCard对象是在UiccController更新SIM卡状态时创建的;2、其他对象可以通过registerForIccChanged()方法向UiccController申请监听SIM卡状态监听。
至此,UiccController的分析结束,下一章将会介绍 UiccCard对象。