10min了解ContentProvider

我们学的Android 数据持久化的技术包括文件存储、SharedPreferences 存储、以及数据库存储。不知道你有没有发现，使用这些持久化技术所保存的数据都只能在当前应用程序中访问。虽然文件和SharedPreferences 存储中提供了MODE_WORLD_READABLE和MODE_WORLD_WRITEABLE 这两种操作模式，用于供给其他的应用程序访问当前应用的数据，但这两种模式在Android 4.2 版本中都已被废弃了。为什么呢？因为Android 官方已经不再推荐使用这种方式来实现跨程序数据共享的功能，而是应该使用更加安全可靠的内容提供器技术。

可能你会有些疑惑，为什么要将我们程序中的数据共享给其他程序呢？当然，这个要视情况而定的，比如说账号和密码这样的隐私数据显然是不能共享给其他程序的，不过一些可以让其他程序进行二次开发的基础性数据，我们还是可以选择将其共享的。例如系统的电话簿程序，它的数据库中保存了很多的联系人信息，如果这些数据都不允许第三方的程序进行访问的话，恐怕很多应用的功能都要大打折扣了。除了电话簿之外，还有短信、媒体库等程序都实现了跨程序数据共享的功能，而使用的技术当然就是内容提供器了，下面我们就来对这一技术进行深入的探讨。

内容提供器简介
内容提供器（Content Provider）主要用于在不同的应用程序之间实现数据共享的功能，它提供了一套完整的机制，允许一个程序访问另一个程序中的数据，同时还能保证被访数据的安全性。目前，使用内容提供器是Android 实现跨程序共享数据的标准方式。不同于文件存储和SharedPreferences 存储中的两种全局可读写操作模式，内容提供器可
以选择只对哪一部分数据进行共享，从而保证我们程序中的隐私数据不会有泄漏的风险。内容提供器的用法一般有两种，一种是使用现有的内容提供器来读取和操作相应程序中的数据，另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口。那么接下来我们就一个一个开始学习吧，首先从使用现有的内容提供器开始。

访问其他程序中的数据
当一个应用程序通过内容提供器对其数据提供了外部访问接口，任何其他的应用程序就都可以对这部分数据进行访问。Android 系统中自带的电话簿、短信、媒体库等程序都提供了类似的访问接口，这就使得第三方应用程序可以充分地利用这部分数据来实现更好的功能。下面我们就来看一看，内容提供器到底是如何使用的。

ContentResolver 的基本用法
对于每一个应用程序来说，如果想要访问内容提供器中共享的数据，就一定要借助ContentResolve 类，可以通过Context 中的getContentResolver()方法获取到该类的实例。ContentResolver 中提供了一系列的方法用于对数据进行CRUD 操作，其中insert()方法用于添加数据，update()方法用于更新数据，delete()方法用于删除数据，query()方法用于查询数据。有没有似曾相识的感觉？没错，SQLiteDatabase 中也是使用的这几个方法来进行CRUD操作的，只不过它们在方法参数上稍微有一些区别。不同于SQLiteDatabase，ContentResolver 中的增删改查方法都是不接收表名参数的，而是使用一个Uri 参数代替，这个参数被称为内容URI。内容URI 给内容提供器中的数据建立了唯一标识符，它主要由两部分组成，权限（authority）和路径（path）。权限是用于对不同的应用程序做区分的，一般为了避免冲突，都会采用程序包名的方式来进行命名。比如某个程序的包名是com.example.app，那么该程序对应的权限就可以命名为com.example.app.provider。路径则是用于对同一应用程序中不同的表做区分的，通常都会添加到权限的后面。比如某个程序的数据库里存在两张表，table1 和table2，这时就可以将路径分别命名为/table1和/table2，然后把权限和路径进行组合，内容URI 就变成了com.example.app.provider/table1和com.example.app.provider/table2。不过，目前还很难辨认出这两个字符串就是两个内容URI，我们还需要在字符串的头部加上协议声明。因此，内容URI 最标准的格式写法如下：
content://com.example.app.provider/table1
content://com.example.app.provider/table2
有没有发现，内容URI 可以非常清楚地表达出我们想要访问哪个程序中哪张表里的数据。也正是因此ContentResolver 中的增删改查方法才都接收Uri 对象作为参数，因为使用表名的话系统将无法得知我们期望访问的是哪个应用程序里的表。在得到了内容URI 字符串之后，我们还需要将它解析成Uri 对象才可以作为参数传入。
解析的方法也相当简单，代码如下所示：
Uri uri = Uri.parse("content://com.example.app.provider/table1")
只需要调用Uri.parse()方法，就可以将内容URI 字符串解析成Uri 对象了。

现在我们就可以使用这个Uri 对象来查询table1 表中的数据了，代码如下所示：
Cursor cursor = getContentResolver().query(uri,projection,selection,selectionArgs,sortOrder);
这些参数和SQLiteDatabase 中query()方法里的参数很像，但总体来说要简单一些，毕竟这是在访问其他程序中的数据，没必要构建过于复杂的查询语句。下表对使用到的这部分参数进行了详细的解释。

查询完成后返回的仍然是一个Cursor 对象，这时我们就可以将数据从Cursor 对象中逐个读取出来了。读取的思路仍然是通过移动游标的位置来遍历Cursor 的所有行，然后再取出每一行中相应列的数据，代码如下所示：
if (cursor != null) {
while (cursor.moveToNext()) {
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
掌握了最难的查询操作，剩下的增加、修改、删除操作就更不在话下了。我们先来看看如何向table1 表中添加一条数据，代码如下所示：
ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2", 1);
getContentResolver().insert(uri, values);
可以看到，仍然是将待添加的数据组装到ContentValues 中，然后调用ContentResolver的insert()方法，将Uri 和ContentValues 作为参数传入即可。

现在如果我们想要更新这条新添加的数据， 把column1 的值清空， 可以借助ContentResolver 的update()方法实现，代码如下所示：
ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new
String[] {"text", "1"});
注意上述代码使用了selection 和selectionArgs 参数来对想要更新的数据进行约束，以防止所有的行都会受影响。
最后，可以调用ContentResolver 的delete()方法将这条数据删除掉，代码如下所示：getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });
到这里为止，我们就把ContentResolver 中的增删改查方法全部学完了。是不是感觉非常简单？因为这些知识在学习SQLiteDatabase 的时候就已经掌握了，所需特别注意的就只有uri 这个参数而已。那么接下来，我们就利用目前所学的知识，看一看如何读取系统电话簿中的联系人信息。

读取系统联系人
由于我们之前一直使用的都是模拟器，电话簿里面并没有联系人存在，所以现在需要自己手动添加几个，以便稍后进行读取。打开电话簿程序，界面如图所示。

这样准备工作就做好了，现在新建一个Modu，让我们开始动手吧。
首先还是来编写一下布局文件，这里我们希望读取出来的联系人信息能够在ListView 中显示，因此，修改activity_main.xml 中的代码，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="match_parent" >    <ListView        android:id="@+id/contacts_lv_main"        android:layout_width="match_parent"        android:layout_height="match_parent" >    </ListView></LinearLayout>

简单起见，LinearLayout 里就只放置了一个ListView。接着修改MainActivity 中的代码，如下所示：

import android.database.Cursor;import android.provider.ContactsContract;import android.support.v7.app.AppCompatActivity;import android.os.Bundle;import android.widget.ArrayAdapter;import android.widget.ListView;import java.util.ArrayList;import java.util.List;public class MainActivity extends AppCompatActivity {    private ListView contacts_lv_main;    private ArrayAdapter<String> arrayAdapter;    private List<String> contactsList = new ArrayList<String>();    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        contacts_lv_main = (ListView) findViewById(R.id.contacts_lv_main);        arrayAdapter = new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,contactsList);        contacts_lv_main.setAdapter(arrayAdapter);        readContacts();    }    private void readContacts(){        Cursor cursor = null;        try {            cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,null,null,null);            while (cursor.moveToNext()){                String name = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));                String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));                contactsList.add(name + "\n" + number);            }        }catch (Exception e){            e.printStackTrace();        }finally {            if (cursor != null){                cursor.close();            }        }    }}

在onCreate()方法中，我们首先获取了ListView 控件的实例，并给它设置好了适配器，然后就去调用readContacts()方法。下面重点看下readContacts()方法，可以看到，这里使用了ContentResolver 的query()方法来查询系统的联系人数据。不过传入的Uri 参数怎么有些奇怪啊， 为什么没有调用Uri.parse() 方法去解析一个内容URI 字符串呢？ 

这是因为ContactsContract.CommonDataKinds.Phone类已经帮我们做好了封装，提供了一个CONTENT_URI常量，而这个常量就是使用Uri.parse()方法解析出来的结果。接着我们对Cursor 对象进行遍历， 将联系人姓名和手机号这些数据逐个取出， 联系人姓名这一列对应的常量是ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME，联系人手机号这一列对应的常量是ContactsContract.CommonDataKinds.Phone.NUMBER。两个数据都取出之后，将它们进行拼接，并且中间加上换行符，然后将拼接后的数据添加到ListView 里。最后千万不要忘记将Cursor 对象关闭掉。
这样就结束了吗？还差一点点，读取系统联系人也是需要声明权限的，因此修改AndroidManifest.xml 中的代码，如下所示：

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

加入了android.permission.READ_CONTACTS权限，这样我们的程序就可以访问到系统的联系人数据了。现在才算是大功告成，让我们来运行一下程序吧，效果如图所示。