数据业务建立流程之DcTracker创建过程

一、DcTracker介绍

        DcTracker是Telephony框架中负责数据业务的核心(类似于GsmCallTracker是通话业务核心，GsmServiceStateTracker是网络CS业务的核心)，所有对数据网络的请求(打开关闭数据开关、切换数据卡、修改APN参数等)都会发送到该处理中心来处理。本节所涉及的大部分代码也都在该对象中。下面我们先来看该对象的初始化流程。

        DcTracker是在Phone对象创建过程中被创建的，确切来说，如果当前使用的是GSMPhone，那么在GSMPhone创建过程中就会创建DcTracker对象：

[java] view plain copy

1. @GSMPhone.java  
2. public GSMPhone (Context context, CommandsInterface ci, PhoneNotifier notifier, boolean unitTestMode) {  
3.     //创建DcTracker对象，传递的参数就是当前的GSMPhone对象  
4.     mDcTracker = new DcTracker(this);  
5. }  

        那么DcTracker是什么属性呢？

[java] view plain copy

1. public final class DcTracker extends DcTrackerBase {}  
2. public abstract class DcTrackerBase extends Handler {}  

        从这里看到，DcTracker的父类是DcTrackerBase，他们的本质都是Handler。
        然后来看DcTracker的初始化过程：

[java] view plain copy

1. @DcTracker.java  
2. public DcTracker(PhoneBase p) {  
3.     super(p);  
4.     mDataConnectionTracker = this;  
5.     //注册监听器  
6.     update();  
7.   
8.   
9.     //监听APN状态  
10.     mApnObserver = new ApnChangeObserver();  
11.     p.getContext().getContentResolver().registerContentObserver(Telephony.Carriers.CONTENT_URI, true, mApnObserver);  
12.   
13.   
14.     //从networkAttributes数组中初始化APN参数  
15.     initApnContexts();  
16.   
17.   
18.     for (ApnContext apnContext : mApnContexts.values()) {  
19.         IntentFilter filter = new IntentFilter();  
20.         filter.addAction(INTENT_RECONNECT_ALARM + '.' + apnContext.getApnType());  
21.         filter.addAction(INTENT_RESTART_TRYSETUP_ALARM + '.' + apnContext.getApnType());  
22.         mPhone.getContext().registerReceiver(mIntentReceiver, filter, null, mPhone);  
23.     }  
24.   
25.   
26.     ConnectivityManager cm = (ConnectivityManager)p.getContext().getSystemService(Context.CONNECTIVITY_SERVICE);  
27.   
28.   
29.     //添加各种网络请求过滤器，用于根据这些过滤器发起不同的数据连接  
30.     mNetworkFilter = new NetworkCapabilities();  
31.     mNetworkFilter.addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR);  
32.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_MMS);  
33.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_SUPL);  
34.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_DUN);  
35.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_FOTA);  
36.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_IMS);  
37.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_CBS);  
38.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_IA);  
39.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_RCS);  
40.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_XCAP);  
41.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_EIMS);  
42.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED);  
43.     mNetworkFilter.addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET);  
44.     //初始化数据网络的NetworkFactory，并设置数据网络的分值为50  
45.     mNetworkFactory = new TelephonyNetworkFactory(this.getLooper(), p.getContext(), "TelephonyNetworkFactory", mNetworkFilter);  
46.     mNetworkFactory.setScoreFilter(50);  
47.     mNetworkFactoryMessenger = new Messenger(mNetworkFactory);  
48.     cm.registerNetworkFactory(mNetworkFactoryMessenger, "Telephony");  
49.   
50.   
51.     //初始化紧急APN  
52.     initEmergencyApnSetting();  
53.     addEmergencyApnSetting();  
54.   
55.   
56.     mProvisionActionName = "com.android.internal.telephony.PROVISION" + p.getPhoneId();  
57. }  

        在上面这个初始化过程中，主要完成了三个任务：
        1、初始化各种监听器；
        2、初始化TelephonyNetworkFactory对象；
        3、初始化一些基本的APN参数；

        下面我们分别详细介绍这三个过程。

二、DcTracker中监听器的初始化

        DcTracker在update()方法中注册了对各种事件的监听，用于触发DcTracker创建APN或者发起数据连接: 

[java] view plain copy

1. public void update() {  
2.      if (isActiveDataSubscription()) {  
3.          //注册各种监听器  
4.          registerForAllEvents();  
5.          //注册SIM卡状态监听器  
6.          onUpdateIcc();  
7.          //mUserDataEnabled就是用户是否打开网络开关的标志位，当为0时，表示当前数据流量被关闭  
8.          mUserDataEnabled = Settings.Global.getInt(mPhone.getContext().getContentResolver(), Settings.Global.MOBILE_DATA, 1) == 1;  
9.          if (mPhone instanceof CDMALTEPhone) {  
10.              ((CDMALTEPhone)mPhone).updateCurrentCarrierInProvider();  
11.              supplyMessenger();  
12.          } else if (mPhone instanceof GSMPhone) {  
13.              ((GSMPhone)mPhone).updateCurrentCarrierInProvider();  
14.              supplyMessenger();  
15.          } else {  
16.              log("Phone object is not MultiSim. This should not hit!!!!");  
17.          }  
18.   
19.   
20.      } else {  
21.          unregisterForAllEvents();  
22.          log("update(): NOT the active DDS, unregister for all events!");  
23.      }  
24.  }  

        在这个方法里面，首先遇到的是isActiveDataSubscription()的判断，该方法定义为：

[java] view plain copy

1. protected boolean isActiveDataSubscription() {  
2.     // FIXME This should have code like  
3.     // return (mPhone.getSubId() == SubscriptionManager.getDefaultDataSubId());  
4.     return true;  
5. }  

        可以看到，其内部直接返回了true，貌似没有什么作用，其实这是Google在为双卡项目预留的判断。
        对于双卡的手机，由于任意时刻只能有一个SIM卡在上网，因此就需要根据用户选择的上网卡来配置不同的APN参数，该方法的原始意图应该是在内部判断当前的DcTracker是否就是用户设置的上网SIM(用户当前使用哪张卡上网可以通过SubscriptionManager.getDefaultDataSubId()方法查询到SIM的SubID)，如果是当前卡的话返回true，否则返回false。但是由于Google并未完善其双卡逻辑，因此这里直接返回了true。
        接下来继续来看判断后的registerForAllEvents()的过程：

[java] view plain copy

1. protected void registerForAllEvents() {  
2.     //监听射频是否打开，没有处理动作  
3.     mPhone.mCi.registerForAvailable(this, DctConstants.EVENT_RADIO_AVAILABLE, null);  
4.     //监听射频是否可用，没有处理动作  
5.     mPhone.mCi.registerForOffOrNotAvailable(this, DctConstants.EVENT_RADIO_OFF_OR_NOT_AVAILABLE, null);  
6.     //监听当前连接状态，没有处理动作  
7.     mPhone.mCi.registerForDataNetworkStateChanged(this, DctConstants.EVENT_DATA_STATE_CHANGED, null);  
8.     //监听当前通话状态，没有处理动作  
9.     mPhone.getCallTracker().registerForVoiceCallEnded (this, DctConstants.EVENT_VOICE_CALL_ENDED, null);  
10.     //监听当前通话状态，没有处理动作  
11.     mPhone.getCallTracker().registerForVoiceCallStarted (this, DctConstants.EVENT_VOICE_CALL_STARTED, null);  
12.     //监听是否PS域Attach状态  
13.     mPhone.getServiceStateTracker().registerForDataConnectionAttached(this, DctConstants.EVENT_DATA_CONNECTION_ATTACHED, null);  
14.     //监听是否PS域Detach状态  
15.     mPhone.getServiceStateTracker().registerForDataConnectionDetached(this, DctConstants.EVENT_DATA_CONNECTION_DETACHED, null);  
16.     //监听漫游状态，没有处理动作  
17.     mPhone.getServiceStateTracker().registerForRoamingOn(this, DctConstants.EVENT_ROAMING_ON, null);  
18.     //监听漫游状态，没有处理动作  
19.     mPhone.getServiceStateTracker().registerForRoamingOff(this, DctConstants.EVENT_ROAMING_OFF, null);  
20.     mPhone.getServiceStateTracker().registerForPsRestrictedEnabled(this, DctConstants.EVENT_PS_RESTRICT_ENABLED, null);  
21.     mPhone.getServiceStateTracker().registerForPsRestrictedDisabled(this, DctConstants.EVENT_PS_RESTRICT_DISABLED, null);  
22.     //监听接入技术状态  
23.     mPhone.getServiceStateTracker().registerForDataRegStateOrRatChanged(this, DctConstants.EVENT_DATA_RAT_CHANGED, null);  
24. }  

        这里注册了大量的监听器，实际上很多都没有对监听动作进行处理(可能是为了扩展后续代码预留的)，但是其中有两个比较重要的监听器，他们将会对上网事件产生影响，分别是：
        EVENT_DATA_CONNECTION_ATTACHED
            ----监听PS的Attach事件，触发时将进入onDataConnectionAttached()
        EVENT_DATA_RAT_CHANGED
            ----监听当前所注册的网络技术(LTE/UMTS/GSM)是否发生改变，触发时将进入setupDataOnConnectableApns()
        然后在update()中还对SIM卡状态进行监听：

[java] view plain copy

1. protected void onUpdateIcc() {  
2.     if (mUiccController == null ) {  
3.         return;  
4.     }  
5.     IccRecords newIccRecords = getUiccRecords(UiccController.APP_FAM_3GPP);  
6.     IccRecords r = mIccRecords.get();  
7.     if (r != newIccRecords) {  
8.         if (r != null) {  
9.             r.unregisterForRecordsLoaded(this);  
10.             mIccRecords.set(null);  
11.         }  
12.         if (newIccRecords != null) {  
13.             mIccRecords.set(newIccRecords);  
14.             //监听SIM各项数据是否载入完毕  
15.             newIccRecords.registerForRecordsLoaded( this, DctConstants.EVENT_RECORDS_LOADED, null);  
16.         }  
17.     }  
18. }  

        这里监听的是SIM卡数据(SPN/FDN/ADN等)是否载入完毕。 
        除了以上的update()和onUpdateIcc()外，在DcTracker的构造方法里面还注册了对APN参数的监听器：

[java] view plain copy

1. public DcTracker(PhoneBase p) {  
2.     update();  
3.     mApnObserver = new ApnChangeObserver();  
4.     p.getContext().getContentResolver().registerContentObserver( Telephony.Carriers.CONTENT_URI, true, mApnObserver);  
5. }  

        这里监听器内容为：

[java] view plain copy

1. private class ApnChangeObserver extends ContentObserver {  
2.     public ApnChangeObserver () {  
3.         super(mDataConnectionTracker);  
4.     }  
5.   
6.   
7.     @Override  
8.     public void onChange(boolean selfChange) {  
9.         sendMessage(obtainMessage(DctConstants.EVENT_APN_CHANGED));  
10.     }  
11. }  

        也就是说，当APN参数的数据库(Telephony.Carriers.CONTENT_URI)发生改动时，将会触发ApnChangeObserver，向DcTracker发送EVENT_APN_CHANGED的消息。

        至此，DcTracker中所有监听器准备就绪，其中比较重要的监听器被触发时所产生的影响我们会在稍后过程中介绍。

三、DcTracker中NetworkFactory的创建过程

        DcTracker初始化中还创建了NetworkFactory的子类对象TelephonyNetworkFactory，从《连接管理中的评分机制》一节中我们知道，该对象的作用就是初始化网络环境，设置当前网络环境的分值，对于数据流量来说，其分值为50：

[java] view plain copy

1. public DcTracker(PhoneBase p) {  
2.     ConnectivityManager cm = (ConnectivityManager)p.getContext().getSystemService(Context.CONNECTIVITY_SERVICE);  
3.     //初始化数据网络的NetworkFactory，并设置数据网络的分值为50  
4.     mNetworkFactory = new TelephonyNetworkFactory(this.getLooper(), p.getContext(), "TelephonyNetworkFactory", mNetworkFilter);  
5.     mNetworkFactory.setScoreFilter(50);  
6.     mNetworkFactoryMessenger = new Messenger(mNetworkFactory);  
7.     cm.registerNetworkFactory(mNetworkFactoryMessenger, "Telephony");  
8. }  

        看一下该TelephonyNetworkFactory定义：

[java] view plain copy

1. private class TelephonyNetworkFactory extends NetworkFactory {  
2.     public TelephonyNetworkFactory(Looper l, Context c, String TAG, NetworkCapabilities nc) {  
3.         super(l, c, TAG, nc);  
4.     }  
5.   
6.   
7.     @Override  
8.     protected void needNetworkFor(NetworkRequest networkRequest, int score) {  
9.         ApnContext apnContext = apnContextForNetworkRequest(networkRequest);  
10.         if (apnContext != null) apnContext.incRefCount();  
11.     }  
12.   
13.   
14.     @Override  
15.     protected void releaseNetworkFor(NetworkRequest networkRequest) {  
16.         ApnContext apnContext = apnContextForNetworkRequest(networkRequest);  
17.         if (apnContext != null) apnContext.decRefCount();  
18.     }  
19. }  

        其中的两个方法分别用来覆盖父类，needNetworkFor()是当其他高分值的网络断开时，用于开启当前数据流量用的，而releaseNetworkFor()是当有更高分值的网络打开时，关闭当前数据流量用的。

        更多的NetworkFactory使用与原理请点击《连接管理中的评分机制》。

四、DcTracker中初始APN的创建过程

        DcTracker初始化过程中还完成了一些初始APN参数的创建，包括预置的APN参数和紧急APN参数的载入：

[java] view plain copy

1. public DcTracker(PhoneBase p) {  
2.     //从networkAttributes数组中初始化APN参数  
3.     initApnContexts();  
4.   
5.   
6.     //初始化紧急APN  
7.     initEmergencyApnSetting();  
8.     addEmergencyApnSetting();  
9. }  

4.1、初始化networkAttributes数组中的APN参数

        我们先来看initApnContexts()的过程，其主要作用就是载入networkAttributes数组中预置的APN参数：
 

[java] view plain copy

1. protected void initApnContexts() {  
2.      //载入networkAttributes数组  
3.      String[] networkConfigStrings = mPhone.getContext().getResources().getStringArray( com.android.internal.R.array.networkAttributes);  
4.      for (String networkConfigString : networkConfigStrings) {  
5.          NetworkConfig networkConfig = new NetworkConfig(networkConfigString);  
6.          ApnContext apnContext = null;  
7.          //根据不同类型创建不同APN参数  
8.          switch (networkConfig.type) {  
9.              case ConnectivityManager.TYPE_MOBILE:  
10.                  apnContext = addApnContext(PhoneConstants.APN_TYPE_DEFAULT, networkConfig);  
11.                  break;  
12.              case ConnectivityManager.TYPE_MOBILE_MMS:  
13.                  apnContext = addApnContext(PhoneConstants.APN_TYPE_MMS, networkConfig);  
14.                  break;  
15.              case ConnectivityManager.TYPE_MOBILE_EMERGENCY:  
16.                  apnContext = addApnContext(PhoneConstants.APN_TYPE_EMERGENCY, networkConfig);  
17.                  break;  
18.              default:  
19.                  log("initApnContexts: skipping unknown type=" + networkConfig.type);  
20.                  continue;  
21.          }  
22.      }  
23.  }  

        这个过程比较简单，就是从networkAttributes数组中获取所有APN字串，然后根据类型分别创建APN参数。

4.2、初始化紧急APN参数

        紧急APN参数就是当没有SIM卡或者当前SIM不可用时使用的APN参数，他的初始化过程分为两步骤：
        1、通过initEmergencyApnSetting()载入紧急APN；
        2、通过addEmergencyApnSetting()将紧急APN添加到APN列表中；
        先来看载入过程：

[java] view plain copy

1. private void initEmergencyApnSetting() {  
2.     String selection = "type=\"emergency\"";  
3.     Cursor cursor = mPhone.getContext().getContentResolver().query( Telephony.Carriers.CONTENT_URI, null, selection, null, null);  
4.     if (cursor != null) {  
5.         if (cursor.getCount() > 0) {  
6.             if (cursor.moveToFirst()) {  
7.                 mEmergencyApn = makeApnSetting(cursor);  
8.             }  
9.         }  
10.         cursor.close();  
11.     }  
12. }  

        这个载入过程其实就是从数据库中搜索条件为"type="emergency""的APN参数，那么这个数据库中的内容是哪里来的呢？
        这些参数是在TelephonyProvider被创建的时候被初始化，下面简单看一下初始化流程：

[java] view plain copy

1. @TelephonyProvider.java  
2. private void initDatabase(SQLiteDatabase db) {  
3.     Resources r = mContext.getResources();  
4.     //从apns文件读取APN参数  
5.     XmlResourceParser parser = r.getXml(com.android.internal.R.xml.apns);  
6.     int publicversion = -1;  
7.     try {  
8.         XmlUtils.beginDocument(parser, "apns");  
9.         //解析该文件  
10.         publicversion = Integer.parseInt(parser.getAttributeValue(null, "version"));  
11.         loadApns(db, parser);  
12.     } catch (Exception e) {  
13.     } finally {  
14.         parser.close();  
15.     }  
16.   
17.   
18.     XmlPullParser confparser = null;  
19.     //从"etc/apns-conf.xml"配置文件读取APN参数  
20.     File confFile = new File(Environment.getRootDirectory(), PARTNER_APNS_PATH);  
21.     FileReader confreader = null;  
22.     try {  
23.         confreader = new FileReader(confFile);  
24.         confparser = Xml.newPullParser();  
25.         confparser.setInput(confreader);  
26.         XmlUtils.beginDocument(confparser, "apns");  
27.   
28.   
29.         int confversion = Integer.parseInt(confparser.getAttributeValue(null, "version"));  
30.         if (publicversion != confversion) {  
31.             throw new IllegalStateException("Internal APNS file version doesn't match " + confFile.getAbsolutePath());  
32.         }  
33.         //将配置文件解析后存入数据库  
34.         loadApns(db, confparser);  
35.     } catch (FileNotFoundException e) {  
36.     } catch (Exception e) {  
37.     } finally {  
38.         try { if (confreader != null) confreader.close(); } catch (IOException e) { }  
39.     }  
40. }  

        从上面可以看到，从com.android.internal.R.xml.apns和"etc/apns-conf.xml"两个路径下读取了APN的配置文件并解析，然后存入了数据库，这些配置文件的配置内容如下：

[java] view plain copy

1. @apns-conf.xml  
2. <?xml version="1.0" encoding="utf-8"?>  
3. <apns version="8">  
4.     <apn carrier="T-Mobile US"  
5.          mcc="310"  
6.          mnc="260"  
7.          apn="epc.tmobile.com"  
8.          user="none"  
9.          server="*"  
10.          password="none"  
11.          mmsc="http://mms.msg.eng.t-mobile.com/mms/wapenc"  
12.     />  
13.     <apn carrier="T-Mobile US 250"  
14.          mcc="310"  
15.          mnc="250"  
16.          apn="epc.tmobile.com"  
17.          user="none"  
18.          server="*"  
19.          password="none"  
20.          mmsc="http://mms.msg.eng.t-mobile.com/mms/wapenc"  
21.     />  
22. </apns>  

        从这个配置文件中可以看到，其每一项数据都包含了某个运营商的PLMN name、MCC、MNC、apn、user、server、password、mmsc等信息。
        上面是数据库初始化的过程，回到DcTracker的紧急APN初始化过程中来，当从数据库中搜索到"type="emergency""的紧急APN参数后，通过initEmergencyApnSetting()方法将这些参数放入mEmergencyApn中，接下来还需要通过addEmergencyApnSetting()方法把这些紧急APN存入统一的APN库中： 

[java] view plain copy

1. private void addEmergencyApnSetting() {  
2.      if(mEmergencyApn != null) {  
3.          if(mAllApnSettings == null) {  
4.              mAllApnSettings = new ArrayList<ApnSetting>();  
5.          } else {  
6.              boolean hasEmergencyApn = false;  
7.              for (ApnSetting apn : mAllApnSettings) {  
8.                  if (ArrayUtils.contains(apn.types, PhoneConstants.APN_TYPE_EMERGENCY)) {  
9.                      //如果之前的SIM APN中已经包含了紧急APN，就无需再次添加  
10.                      hasEmergencyApn = true;  
11.                      break;  
12.                  }  
13.              }  
14.              if(hasEmergencyApn == false) {  
15.                  //将mEmergencyApn添加到APN列表中  
16.                  mAllApnSettings.add(mEmergencyApn);  
17.              } else {  
18.                  log("addEmergencyApnSetting - E-APN setting is already present");  
19.              }  
20.          }  
21.      }  
22.  }  

        通过以上步骤，紧急APN的创建过程就完成了。
        至此，DcTracker所有初始化工作全部完成，在这个过程中注册了监听器、创建了TelephonyNetworkFactory、初始化了紧急APN，接下来就是等待监听器被触发。