【Android Developers Training】 99. 获取联系人详细信息
注：本文翻译自Google官方的Android Developers Training文档，译者技术一般，由于喜爱安卓而产生了翻译的念头，纯属个人兴趣爱好。
原文链接：http://developer.android.com/training/contacts-provider/retrieve-details.html
这节课将会展示如何获取一个联系人的详细数据，比如电子邮件地址，电话号码，等等。当用户获得一个联系人后，他会想要查看他的详细信息。你可以展示给他们所有的信息，或者只展示某一特定类型的信息，比如电子邮件地址。
这节课中，我们假设你已经有了用户选择的一行ContactsContract.Contacts联系人数据。在上一节课中（博客链接：http://www.cnblogs.com/jdneo/p/3674830.html）我们已经讲解了如何获取联系人列表的知识。
一）. 获取一个联系人的详细信息
要获得一个联系人的所有信息，需要搜索ContactsContract.Data表的每一行，看是否包含有联系人的LOOKUP_KEY。这一列可在ContactsContract.Data中获得，因为Contacts Provider在ContactsContract.Contacts表和ContactsContract.Data表之间执行了一个隐式的连接。列LOOKUP_KEY的详细信息在上一节课中（博客链接：http://www.cnblogs.com/jdneo/p/3674830.html）已经讲授过了。
Note：
获取某一个联系人的所有信息会降低设备的性能，因为它需要获取ContactsContract.Data表中所有列的数据。在你使用这一方法前要考虑到它对性能的影响。
请求权限
要从Contacts Provider中读取数据，你的应用必须具有READ_CONTACTS权限。要请求这一权限，在清单文件的<manifest>标签中添加如下子标签：
<uses-permission android:name="android.permission.READ_CONTACTS" />
配置一个投影
根据每一行所包含的的数据类型，它可能使用一些列或很多列。另外，数据类型的不同会导致数据再不同的列中。要保证你能获得对于所有可能数据类型所对应的所有可能的列，你需要添加所有的列名到你的投影中。同时，如果要把结果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 };
这一投影会为ContactsContract.Data表的一行获取所有的列，使用在ContactsContract.Data类中所定义的列名。
或者，你也可以是用在ContactsContract.Data类中定义或者从它继承的其它列常量。注意，列SYNC1到列SYNC4是被同步适配器使用的，所以他们的数据对我们现在的应用场景而言没有用。
定义选择标准
为你的选择语句定义一个常量，它是一个保存选择语句的数组，以及一个保存对应值的变量。使用Contacts.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注入攻击。
定义排列顺序
为结果Cursor定义你期望的排列顺序。要让某一类型数据的所有行根据Data.MIMETYPE来排列。这一语句会让所有email的行放在一起，所有电话号码的行放在一起，等等。例如：
/* * Defines a string that specifies a sort order of MIME type */ private static final String SORT_ORDER = Data.MIMETYPE;
Note：
一些数据类型不使用子类，所以你不能用子类型来排序。相反的，你需要再返回的Cursor中进行迭代，确定当前行的数据类型，然后将使用子类型的行的数据保存起来。当你完成读cursor后，之后你就可以通过子类型排序并显示结果。
初始化加载器
通常，我们在后台线程从Contacts Provider（以及其它所有的内容提供器）获取数据。使用由LoaderManager类，以及LoaderManager.LoaderCallbacks接口所定义的加载器框架来执行后台的获取操作。
当你准备好获取行后，通过调用initLoader()初始化加载器框架。将一个整形标识传递给该方法；这一标志会传递给LoaderManager.LoaderCallbacks方法。它可以帮助你区分这些加载器，从而在一个应用中使用多个加载器。
下面的代码样例展示了如何初始化这个加载器框架：
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()
实现onCreateLoader()方法，它会在你调用了initLoader()后被加载器框架调用。该方法返回一个CursorLoader。因为你在搜索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 ); ... }
实现onLoadFinished()和onLoaderReset()
实现onLoadFinished()方法。当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()方法会被调用，此时，将所有存在的Cursor引用设置成null来移除它们。如果你不这么做，加载器框架不会销毁老的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，和检索所有的详细数据类似，你需要做的改变仅仅是实现课程Retrieve All Details for a Contact（博客链接：http://www.cnblogs.com/jdneo/p/3674830.html）中列出的代码：
投影
修改你的投影，使得列对应于特定的要搜索的数据类型。同时修改投影，使用在ContactsContract.CommonDataKinds子类中对应于数据类型的列常量名。
选择
修改选择语句，搜索对应于你的数据类型的MIMETYPE值。
排列顺序
因为你值使用单一的详细数据类型，所以不需要根据Data.MIMETYPE将返回的Cursor分类。
这些修改在下列章节中描述。
定义一个投影
定义你要获取的列，使用ContactsContract.CommonDataKinds子类中对应于数据类型的列常量名。如果你想要将Cursor绑定到一个ListView上，要确保获取“_ID”列。例如，要获取email数据，定义下列投影：
private static final String[] PROJECTION = { Email._ID, Email.ADDRESS, Email.TYPE, Email.LABEL };
注意这一投影使用ContactsContract.CommonDataKinds.Email类中定义的列名，而不是在类ContactsContract.Data中定义的列名。使用email的特定列名可以增加代码的可读性。
在投影中，你也可以使用在ContactsContract.CommonDataKinds子类中定义的其它列。
定义选择标准
定义一个搜索表达式，它获取你想要的特定联系人的LOOKUP_KEY和Data.MIMETYPE行数据。对于MIMETYPE的值对应的常量，用单引号（'）将它括起来；否则，提供器会把常量认为是一个变量名而不是一个字符串值。你不需要为它使用一个占位符，因为你使用的是一个常量而不是一个用户提供的值。例如：
/* * 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 = { "" };
定义排列顺序
为返回的Cursor定义一个排列顺序。因为你获得的是一个特定的数据类型，所以略过对MIMETYPE排序。另外，如果你正在搜索的详细数据包含有一个子类型，可以对他排序。例如，对于Email数据你可以根据Email.TYPE来排序：
private static final String SORT_ORDER = Email.TYPE + " ASC ";
