查詢SIM卡聯絡人

查詢SIM卡中的聯絡人使用的方法為 query( ) 方法，與操作資料庫中的查詢方法極其類似，使用方式與如下類似：

getContentResolver().query("content://icc/adn/subId/1", null, null, null, null);

那麼我們就來探究一下該方法的流程。

流程

• IccProvider.java —— query( )

@Override
public Cursor query(Uri url, String[] projection, String selection,
       String[] selectionArgs, String sort) {
    switch
 
 (URL_MATCHER.match(url)) {
        case ADN:
            return loadFromEf(IccConstants.EF_ADN, mSubscriptionManager.getDefaultSubId());

        case ADN_SUB:
            return loadFromEf(IccConstants.EF_ADN, getRequestSubId(url));
    //……省略其它程式碼……//
    }
}

從 IccProvider 中的 query 方法開始。我們首先匹配到的是 ADN 的情況，並且由於是雙卡，所以下一步需要執行第二種情況的 loadFromEf 方法。該方法中可以看到 IccConstants.EF_ADN 值為6F3A，這就是SIM卡上的地址。

• IccProvider.java —— loadFromEf( )

private MatrixCursor loadFromEf(int efType, int subId) {
    List<AdnRecord> adnRecords = null;
    try {
        IIccPhoneBook iccIpb = getIccPhbService();
        if (iccIpb != null) {
            adnRecords = iccIpb.getAdnRecordsInEfForSubscriber(subId, efType);
        }
    } 
    //……省略其它程式碼……//
 

    return new MatrixCursor(ADDRESS_BOOK_COLUMN_NAMES);
}

可以看到接下來就是 IIccPhoneBook 中的 getAdnRecordsInEfForSubscriber 方法。實際上接下來執行的是 IccPhoneBookManager.java 中的 getAdnRecordInEf 方法，其中經過了 IIccPhoneBook.java –> UiccPhoneBookController.java –> IccPhoneBookManager.java 的跳轉與轉換，使用了 Binder 和 AIDL 實現跨程序通訊以及使用了代理模式（Proxy Pattern）控制訪問，如果不瞭解這兩方面的知識，就會有點看不懂程式碼的意圖與具體實現的內涵，關於這兩點，在文章最後進行簡單的描述。

• IccPhoneBookManager.java —— getAdnRecordsInEf( )

public synchronized List<AdnRecord> getAdnRecordsInEf(int efid) {
    //……省略其它程式碼……//
    efid = updateEfForIccType(efid);// Check if we are trying to read ADN records
    //……省略其它程式碼……//
    synchronized (mLock) {
        checkThread();
        AtomicBoolean status = new AtomicBoolean(false);
        Message response = mBaseHandler.obtainMessage(EVENT_LOAD_DONE, status);
        if (mAdnCache != null) {
            mAdnCache.requestLoadAllAdnLike(efid, mAdnCache.extensionEfForEf(efid), response);
            waitForResult(status);
        } else {
            loge("Failure while trying to load from SIM due to uninitialised adncache");
        }
    }
    return mRecords;
}

在該方法中，首先先檢查 efid 是否是 IccConstants.EF_ADN，判斷一下下面的 efid 是使用 IccConstants.EF_ADN 還是 IccConstants.EF_PBR。然後就是執行 requestLoadAllAdnLike 方法，可以看到從該方法開始，使用了 Message 來通知獲取結果。

• AdnRecordCache.java —— requestLoadAllAdnLike( )

 public void requestLoadAllAdnLike (int efid, int extensionEf, Message response) {
        ArrayList<Message> waiters;
        ArrayList<AdnRecord> result;
        if (efid == EF_PBR) {
            result = mUsimPhoneBookManager.loadEfFilesFromUsim();
        } else {
            result = getRecordsIfLoaded(efid);
        }

        // Have we already loaded this efid?
        if (result != null) {
            if (response != null) {
                AsyncResult.forMessage(response).result = result;
                response.sendToTarget();
            }

            return;
        }
    //……省略其它程式碼……//
    }

這裡我們需要看的是 loadEfFilesFromUsim 方法，可以看到先對各種情況進行判斷，如果已經存在紀錄，剛只需要 refresh 一下，否則迴圈讀取。

• UsimPhoneBookManager.java —— loadEfFilesFromUsim( )

 public ArrayList<AdnRecord> loadEfFilesFromUsim() {
    //……省略其它程式碼……//
    int numRecs = mPbrFile.mFileIds.size();
    // read adn by CPBR, not by read record from EF , So we needn't read
    // for every pbr record.
    if (mFh instanceof CsimFileHandler) { //fzl add for Uicc card start
        // fzl comment: UICC card need CRSM, not CPBR. and need read for every pbr record.
        for (int i = 0; i < numRecs; i++) {
            Rlog.d(LOG_TAG, "readAdnFileAndWaitForUicc: numRecs = " + i);
            readAdnFileAndWaitForUICC(i);
        }
    } else {
        readAdnFileAndWait(0);
    }  //fzl add for Uicc card end
    //……省略其它程式碼……//
    mAasForAnrRec.clear();
    for (int i = 0; i < numRecs; i++) {
        readAASFileAndWait(i);
        readSneFileAndWait(i);
        readAnrFileAndWait(i);
        readEmailFileAndWait(i);
    }
    readGrpIdsAndWait();
    // All EF files are loaded, post the response.

    return mPhoneBookRecords;
}

這個方法的再接著往下跳轉可以看到 RIL.java 檔案裡的 iccIO 方法，在 IO 方法中可以找到一個 TAG，根據這個 TAG 可以在 Reference-ril.c 檔案中找到處理這個 Case 的分支，因為對於這種 IO 指令不瞭解，大概就只能看個熱鬧了。

AIDL跨程序通訊

loadFromEf( ) 方法中呼叫了 IIccPhoneBook.java 中的方法，事實上，這是用了 AIDL 方式生成的類。

通過新增 IIccPhoneBook.aidl 檔案，描述了方法介面，然後編譯生成了 IIccPhoneBook.java 檔案，然後 UiccPhoneBookController.java 繼承於 IIccPhoneBook.Stub。一般而言，繼承於 Stub 的稱之為 Binder。

這種方式可以實現跨程序通訊，在 Android 中的 Binder 機制是一個龐大的體系模組，而 Android 考慮到了邏輯的複雜性，提供了一個簡便的方式即 AIDL （Android Interface Description Language）來生成所需要的檔案。

代理模式

代理模式適用於無法或不想直接訪問某個物件或者訪問某個物件有困難時可以通過一個代理物件來間接訪問。

在這裡我們可以看一下原始碼中是怎麼實現代理模式的。
首先定義一個介面 Phone.java

public interface Phone {
    // ……省略程式碼
}   

然後 PhoneBase.java 實現介面

public abstract class PhoneBase extends Handler implements Phone {
    // ……省略程式碼 
}

然後幾種不同制式的SIM卡手機繼承了 PhoneBase.java。比如 CDMAPhone.java 、GSMPhone.java 等。
最後定義一個代理類來整合繼承於 PhoneBase.java 的類。

public class PhoneProxy extends Handler implements Phone {
    // ……省略程式碼 
    private IccPhoneBookInterfaceManagerProxy mIccPhoneBookInterfaceManagerProxy;
    // ……省略程式碼 
    public PhoneProxy(PhoneBase phone) {
        mActivePhone = phone;
        mResetModemOnRadioTechnologyChange = SystemProperties.getBoolean(
                TelephonyProperties.PROPERTY_RESET_ON_RADIO_TECH_CHANGE, false);
        mIccPhoneBookInterfaceManagerProxy = new IccPhoneBookInterfaceManagerProxy(
                phone.getIccPhoneBookInterfaceManager());
        mPhoneSubInfoProxy = new PhoneSubInfoProxy(phone.getPhoneSubInfo());
        // ……省略程式碼 
    }
}

以上三個類的構造是代理模式常用的實現：一個公共介面、一個被代理類、一個代理類。

可以看到，在 PhoneProxy 代理類中還包含了其他的代理類，比如流程中所用的 IccPhoneBookInterfaceManagerProxy。事實上 UiccPhoneBookController.java 就是通過 IccPhoneBookInterfaceManagerProxy 來訪問 IccPhoneBookInterfaceManager 中的 getAdnRecordsInEf( ) 方法，而在這個方法中：

public synchronized List<AdnRecord> getAdnRecordsInEf(int efid) {

    if (mPhone.getContext().checkCallingOrSelfPermission(
            android.Manifest.permission.READ_CONTACTS)
            != PackageManager.PERMISSION_GRANTED) {
        throw new SecurityException(
                "Requires android.permission.READ_CONTACTS permission");
    }
    //……省略其它程式碼……//
            mAdnCache.requestLoadAllAdnLike(efid, mAdnCache.extensionEfForEf(efid), response);
   //……省略其它程式碼……//         
    return mRecords;
}

可以看到除了業務邏輯之外還呼叫了 PhoneBase 的方法來檢查許可權問題。

由此可以看出代理模式的優點和其使用方式，通過代理來控制對原始物件的訪問，而在訪問原始物件時執行一些自己的附加操作，實現了代理類與被代理類之間的解耦，符合面向物件原則。