Android CarrierConfig 参数项和正则匹配逻辑

背景

在编写CarrierConfig的时候经常出现配置不生效的情况，比如运营商支持大范围的imsi，或者是测试人员写卡位数的问题等等，因此就需要模式匹配（包含但不限于正则表达式）。

1. 基本概念:

   • 模式匹配涉及定义一个“模式”，该模式可以是一个字符串、正则表达式或其他结构。系统将此模式应用于目标数据，找出符合该模式的部分。

2. 应用场景:

   • 字符串匹配: 查找特定字符序列或模式，例如在文本中查找单词或短语。
   • 数据解析: 分析和提取数据，例如从 JSON 或 XML 文档中提取信息。
   • 正则表达式: 使用正则表达式进行复杂的字符串匹配和替换操作。
   • 逻辑匹配: 例如在函数式编程中，使用模式匹配来简化条件语句。

3. 编程语言中的模式匹配实现:

   很多编程语言都支持模式匹配的特性，例如：
   • Haskell: 强大的模式匹配功能，可用于列表、元组等数据结构。        
   • Scala: 提供内置的模式匹配语法，用于匹配类型和结构。
   • Java: 使用 Pattern 和 Matcher 类进行正则表达式匹配。
   • Python: 使用 re 模块进行正则表达式匹配。

解析逻辑

packages/apps/CarrierConfig/src/com/android/carrierconfig/DefaultCarrierConfigService.java

详细代码

1. 参数解析:

   • xmlImsi: 这是从 XML 资源中获取的 IMSI 表达式，它可能是一个正则表达式。
   • id: 这是一个 CarrierIdentifier 对象，提供了当前的 IMSI。

2. 获取当前 IMSI:

   • String currentImsi = id.getImsi();: 该行代码从 CarrierIdentifier 对象中获取当前的 IMSI 字符串。

3. 正则表达式匹配:

   • Pattern imsiPattern = Pattern.compile(xmlImsi, Pattern.CASE_INSENSITIVE);: 这行代码将 XML 中的 IMSI 表达式编译成正则表达式模式，并设置为不区分大小写（尽管在 IMSI 字符串中通常不涉及大小写问题）。
   • Matcher matcher = imsiPattern.matcher(currentImsi);: 这行代码创建一个 Matcher 对象，用于比较当前 IMSI。

4. 执行匹配:

   • matchFound = matcher.matches();: 这个方法检查当前 IMSI 是否与正则表达式匹配。

参数检查 

checkFilters检查的参数包含：

如下代码可见，支持正则匹配的只有imsi和sp。

    /*** Checks to see if an XML node matches carrier filters.** <p>This iterates over the attributes of the current tag pointed to by {@code parser} and* checks each one against {@code id} or {@link Build.DEVICE} or {@link R.string#sku_filter} or* {@link Build.BOARD}. Attributes that are not specified in the node will not be checked, so a* node with no attributes will always return true. The supported filter attributes are,* <ul>*   <li>mcc: {@link CarrierIdentifier#getMcc}</li>*   <li>mnc: {@link CarrierIdentifier#getMnc}</li>*   <li>gid1: {@link CarrierIdentifier#getGid1}</li>*   <li>gid2: {@link CarrierIdentifier#getGid2}</li>*   <li>spn: {@link CarrierIdentifier#getSpn}</li>*   <li>imsi: {@link CarrierIdentifier#getImsi}</li>*   <li>device: {@link Build.DEVICE}</li>*   <li>vendorSku: {@link SystemConfig.VENDOR_SKU_PROPERTY}</li>*   <li>hardwareSku: {@link SystemConfig.SKU_PROPERTY}</li>*   <li>board: {@link Build.BOARD}</li>*   <li>cid: {@link CarrierIdentifier#getCarrierId()}*   or {@link CarrierIdentifier#getSpecificCarrierId()}</li>*   <li>sku: {@link R.string#sku_filter} "sku_filter" that OEM customizable filter</li>* </ul>* </p>** <p>* The attributes imsi and spn can be expressed as regexp to filter on patterns.* The spn attribute can be set to the string "null" to allow matching against a SIM* with no spn set.* </p>** @param parser an XmlPullParser pointing at a START_TAG with the attributes to check.* @param id the carrier details to check against.* @param sku a filter to be customizable.* @return false if any XML attribute does not match the corresponding value.*/static boolean checkFilters(XmlPullParser parser, @Nullable CarrierIdentifier id, String sku) {String vendorSkuProperty = SystemProperties.get("ro.boot.product.vendor.sku", "");String hardwareSkuProperty = SystemProperties.get("ro.boot.product.hardware.sku", "");for (int i = 0; i < parser.getAttributeCount(); ++i) {boolean result = true;String attribute = parser.getAttributeName(i);String value = parser.getAttributeValue(i);switch (attribute) {case "mcc":result = (id == null) || value.equals(id.getMcc());break;case "mnc":result = (id == null) || value.equals(id.getMnc());break;case "gid1":result = (id == null) || value.equalsIgnoreCase(id.getGid1());break;case "gid2":result = (id == null) || value.equalsIgnoreCase(id.getGid2());break;case "spn":result = (id == null) || matchOnSP(value, id);break;case "imsi":result = (id == null) || matchOnImsi(value, id);break;case "device":result = value.equalsIgnoreCase(Build.DEVICE);break;case "vendorSku":result = value.equalsIgnoreCase(vendorSkuProperty);break;case "hardwareSku":result = value.equalsIgnoreCase(hardwareSkuProperty);break;case "board":result = value.equalsIgnoreCase(Build.BOARD);break;case "cid":result = (id == null) || (Integer.parseInt(value) == id.getCarrierId())|| (Integer.parseInt(value) == id.getSpecificCarrierId());break;case "name":// name is used together with cid for readability. ignore for filter.break;case "sku":result = value.equalsIgnoreCase(sku);break;default:Log.e(TAG, "Unknown attribute " + attribute + "=" + value);result = false;break;}if (!result) {return false;}}return true;}

IMSI的匹配逻辑

1. 参数解析:

   • xmlImsi: 这是从 XML 资源中获取的 IMSI 表达式，它可能是一个正则表达式。
   • id: 这是一个 CarrierIdentifier 对象，提供了当前的 IMSI。

2. 获取当前 IMSI:

   • String currentImsi = id.getImsi();: 该行代码从 CarrierIdentifier 对象中获取当前的 IMSI 字符串。

3. 正则表达式匹配:

   • Pattern imsiPattern = Pattern.compile(xmlImsi, Pattern.CASE_INSENSITIVE);: 这行代码将 XML 中的 IMSI 表达式编译成正则表达式模式，并设置为不区分大小写（尽管在 IMSI 字符串中通常不涉及大小写问题）。
   • Matcher matcher = imsiPattern.matcher(currentImsi);: 这行代码创建一个 Matcher 对象，用于比较当前 IMSI。

4. 执行匹配:

   • matchFound = matcher.matches();: 这个方法检查当前 IMSI 是否与正则表达式匹配。

    /*** Check to see if the IMSI expression from the XML matches the IMSI of the* Carrier.** @param xmlImsi IMSI expression fetched from the resource XML* @param id Id of the evaluated CarrierIdentifier* @return true if the XML IMSI matches the IMSI of CarrierIdentifier, false*         otherwise.*/static boolean matchOnImsi(String xmlImsi, CarrierIdentifier id) {boolean matchFound = false;String currentImsi = id.getImsi();// If we were able to retrieve current IMSI, see if it matches.if (currentImsi != null) {//使用 Pattern 和 Matcher 接口，//使用正则表达式来匹配 xmlImsi 与 currentImsi。//这允许 xmlImsi 采用正则表达式的形式，从而支持更复杂的匹配逻辑，比如匹配特定模式的 IMSI 字符串。Pattern imsiPattern = Pattern.compile(xmlImsi, Pattern.CASE_INSENSITIVE);Matcher matcher = imsiPattern.matcher(currentImsi);matchFound = matcher.matches();}return matchFound;}

资料

• 展讯平台参考：CarrierConfig配置使用和加载流程简介-CSDN博客
• AOSP：【Telephony】CarrierConfig加载流程解析&运营商ims配置增删查改(AOSP)-CSDN博客