通讯录数据的存取(二）—— 获取通讯录的具体信息

获取通讯录的具体信息

这一节展示如何获取联系人的具体信息，如email地址，电话号码等。首先假设你已经阅读过通讯录数据的存取(一）——获取通讯录列表, 获取了通讯录列表。
分两节：
- 获取联系人的所有信息
- 获取联系人的某类型信息

获取联系人的所有信息

实现方案是搜索ContactsContract.Data表中包含联系人的LOOKUP_KEY的所有行。Contacts Provider会对ContactsContract.Data表和ContactsContract.Contacts表做一个连接，因此LOOKUP_KEY这一列也可以在ContactsContract.Data表中找到。

申请权限：

<uses-permission android:name="android.permission.READ_CONTACTS" />

设置一个规划（projection)

根据数据类型的不同，Data表中的一行可能只使用某些列。数据类型不同，使用的列也不同。为保证获取所有可能的数据类型，需要将所有的列名都添加到规划中。如果需要将结果Cursor与ListView绑定，必须获取Data._ID列。另外需要获取Data.MIMETYPE以用于识别获取的每行数据的类型。如：

private static final String PROJECTION =
            {
                Data._ID,
                Data.MIMETYPE,
                Data.DATA1,
                Data.DATA2,
                Data.DATA3,
                Data.DATA4,
                Data.DATA5,
                Data.DATA6,
                Data.DATA7,
                Data.DATA8,
                Data.DATA9,
                Data.DATA10,
                Data.DATA11,
                Data.DATA12,
                Data.DATA13,
                Data.DATA14,
                Data.DATA15
            };

定义选择标准

定义一个选择预计常量，一个包含搜索参数的数列，一个保存待搜索值的变量。使用LOOKUP_KEY列寻找联系人。代码如下：

   // Defines the selection clause
    private static final String SELECTION = Data.LOOKUP_KEY + " = ?";
    // Defines the array to hold the search criteria
    private String[] mSelectionArgs = { "" };
    /*
     * Defines a variable to contain the selection value. Once you
     * have the Cursor from the Contacts table, and you've selected
     * the desired row, move the row's LOOKUP_KEY value into this
     * variable.
     */
    private String mLookupKey;

使用“？”可以保证搜索通过连接而不是SQL编译来生成，避免恶意SQL注入的可能性。
使用变量来表示待搜索的内容，即SQL中替换“？”的内容。

定义排序方式

定义搜索结果的排序方式。如想让每种类型的数据在一起，可以使用Data.MIME来排序。这样结果中所有的email类型数据的行在一起，所有的电话类型数据的行在一起。如下：

  /*
     * Defines a string that specifies a sort order of MIME type
     */
    private static final String SORT_ORDER = Data.MIMETYPE;

初始化CursorLoader

获取Contacts Provider数据的过程必须在后台线程中进行。使用Loader框架可以实现后台获取。它包含LoaderManager类和LoaderManager.LoaderCallbacks接口.
当准备获取数据时，先通过调用initLoader()初始化loader框架.需要传输一个整型参数给该方法，该参数会传递给LoaderManager.LoaderCallbacks方法。在同一个应用程序包含多个loader的情况下，可以使用该参数区分不同的loader。
代码如下：

public class DetailsFragment extends Fragment implements
        LoaderManager.LoaderCallbacks<Cursor> {
    ...
    // Defines a constant that identifies the loader
    DETAILS_QUERY_ID = 0;
    ...
    /*
     * Invoked when the parent Activity is instantiated
     * and the Fragment's UI is ready. Put final initialization
     * steps here.
     */
    @Override
    onActivityCreated(Bundle savedInstanceState) {
        ...
        // Initializes the loader framework
        getLoaderManager().initLoader(DETAILS_QUERY_ID, null, this);

实现onCreateLoader()

该方法会在我们调用initLoader()后立即被loader框架调用。
因为搜索的是ContactsContract.Data表，使用DATA.CONTENT_URI作为内容URI。代码如下：

   @Override
    public Loader<Cursor> onCreateLoader(int loaderId, Bundle args) {
        // Choose the proper action
        switch (loaderId) {
            case DETAILS_QUERY_ID:
            // Assigns the selection parameter
            mSelectionArgs[0] = mLookupKey;
            // Starts the query
            CursorLoader mLoader =
                    new CursorLoader(
                            getActivity(),
                            Data.CONTENT_URI,
                            PROJECTION,
                            SELECTION,
                            mSelectionArgs,
                            SORT_ORDER
                    );
            ...
    }

其中DETAILS_QUERY_ID正是上一节中传递的整型参数。

实现onLoadFinished()和onLoadReset()

Loader框架在Contacts Provider返回搜索结果时调用onLoadFinished().代码如下：

    public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) {
        switch (loader.getId()) {
            case DETAILS_QUERY_ID:
                    /*
                     * Process the resulting Cursor here.
                     */
                }
                break;
            ...
        }
    }

onLoaderReset()方法会在loader框架发现Cursor结果的数据发生改变时被调用。在该方法中，需要清除所有对上述Cursor的引用，否则loader框架不会回收该Cursor，会引起内地泄漏。

 @Override
    public void onLoaderReset(Loader<Cursor> loader) {
        switch (loader.getId()) {
            case DETAILS_QUERY_ID:
                /*
                 * If you have current references to the Cursor,
                 * remove them here.
                 */
                }
                break;
    }

至此，已经讲完了搜索通信人全部具体信息的所有关键点。

获取联系人的某类型信息

获取联系人的某类型信息，如所有的email,按照上一节的步骤执行，只需修改一下几项：
规划(Projection): 修改只获取某类型的列。 使用ContactsContract.CommonDataKinds的与类型匹配的子类的列名常量。
选择(Selection):添加MIMETYPE值的搜索语句。
排序（Sort order):无需根据Data.MIMETYPE对搜索结果cursor进行排序。

定义一个规划（projection)

使用ContactsContract.CommonDataKinds的与类型匹配的子类的列名常量。如：

  private static final String[] PROJECTION =
            {
                Email._ID,
                Email.ADDRESS,
                Email.TYPE,
                Email.LABEL
            };

上述关于获取Email数据的规划，使用了ContactsContract.CommonDataKinds.Email类定义的列名，而没有使用ContactsContract.Data类的列名，前者可读性更强。

定义选择标准

定义一个使用LOOKUP_KEY和Data.MIMETYPE的搜索语句。 需要使用单引号将搜索数据类型对应的MIMETYPE值括起来，否则provider会把它当作变量名而不是常量。 代码如下：

    /*
     * Defines the selection clause. Search for a lookup key
     * and the Email MIME type
     */
    private static final String SELECTION =
            Data.LOOKUP_KEY + " = ?" +
            " AND " +
            Data.MIMETYPE + " = " +
            "'" + Email.CONTENT_ITEM_TYPE + "'";
    // Defines the array to hold the search criteria
    private String[] mSelectionArgs = { "" };

定义排序方式

忽略根据Data.MIMETYPE对搜索结果cursor进行排序。如果待搜索数据的类型包含子类的话，可以使用该子类来排序。例如以Email.TYPE排序：

    private static final String SORT_ORDER = Email.TYPE + " ASC ";