Android四大组件之内容提供器

内容提供器（Content Provider）主要用于在不同的应用程序之间实现数据共享的功能，它提供了一套完整的机制，允许一个程序访问另一个程序中的数据，同时还能保证被访数据的安全性。

不同于文件存储和 SharedPreferences 存储中的两种全局可读写操作模式， 内容提供器可以选择只对哪一部分数据进行共享，从而保证我们程序中的隐私数据不会有泄漏的风险。

内容提供器的用法一般有两种， 一种是使用现有的内容提供器来读取和操作相应程序中的数据，另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口。

核心简述：

1）借助getContentResolver获取ContentResolver的实例

对于每一个应用程序来说，如果想要访问内容提供器中共享的数据，就一定要借助ContentResolver类,因为该类提供了一系列的方法用于对数据进行 CRUD 操作。

2）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

3）解析URI——>uri对象

Uri uri = Uri.parse("content://com.example.app.provider/table1")

4）CURD操作演示

1、查询数据

Cursor cursor = getContentResolver().query(uri,projection,selection,selectionArgs,sortOrder);

之后进行数据的读取

if (cursor != null) {
while (cursor.moveToNext()) {
//逐行按照列进行遍历
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}

2、添加数据

ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2", 1);
getContentResolver().insert(uri, values);

3、更新数据（将where条件对应行的column1列的值清空）

ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new
String[] {"text", "1"});

4、删除数据

getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });

用以上所学演示获取系统联系人
layout

<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_view"
android:layout_width="match_parent"
android:layout_height="match_parent" >
</ListView>
</LinearLayout>

activity

public class MainActivity extends Activity {
ListView contactsView;
ArrayAdapter<String> adapter;
List<String> contactsList = new ArrayList<String>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
contactsView = (ListView) findViewById(R.id.contacts_view);
adapter = new ArrayAdapter<String>(this, android.R.layout.
simple_list_item_1, contactsList);
contactsView.setAdapter(adapter);
readContacts();
}
private void readContacts() {
Cursor cursor = null;
try {
// 查询联系人数据
cursor = getContentResolver().query(
ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null, null, null, null);
while (cursor.moveToNext()) {
// 获取联系人姓名
String displayName = cursor.getString(cursor.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
// 获取联系人手机号
String number = cursor.getString(cursor.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.NUMBER));
contactsList.add(displayName + "\n" + number);
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (cursor != null) {
cursor.close();
}
}
}
}

注意：ContactsContract.CommonDataKinds.Phone.CONTENT_URI是解析后的uri的常量表示，DISPLAY_NAME

与NUMBER是对应name和number的解析

记得注册读取权限：

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

图示：

设置数据：



显示结果：



创建自己的内容提供器

可以通过新建一个类去继承 ContentProvider 的方式来创建一个自己的内容提供器。

ContentProvider 类中有六个抽象方法，我们在使用子类继承它的时候，需要将这六个方法全部重写。新建 MyProvider 继承自 ContentProvider，代码如下所示：

public class MyProvider extends ContentProvider {
@Override
public boolean onCreate() {
return false;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
return null;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
return null;
}
@Override
public int update(Uri uri, ContentValues values, String selection,
String[] selectionArgs) {
return 0;
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
return 0;
}
@Override
public String getType(Uri uri) {
return null;
}
}

1. onCreate()

初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作，

返回 true 表示内容提供器初始化成功，返回 false 则表示失败。注意，只有当存在

ContentResolver 尝试访问我们程序中的数据时，内容提供器才会被初始化。

2. query()

从内容提供器中查询数据。使用 uri 参数来确定查询哪张表，projection 参数用于确

定查询哪些列，selection 和 selectionArgs 参数用于约束查询哪些行，sortOrder 参数用于

对结果进行排序，查询的结果存放在 Cursor 对象中返回。

3. insert()

向内容提供器中添加一条数据。使用 uri 参数来确定要添加到的表，待添加的数据

保存在 values 参数中。添加完成后，返回一个用于表示这条新记录的 URI。

4. update()

更新内容提供器中已有的数据。使用 uri 参数来确定更新哪一张表中的数据，新数

据保存在 values 参数中，selection 和 selectionArgs 参数用于约束更新哪些行，受影响的

行数将作为返回值返回。

5. delete()

从内容提供器中删除数据。使用 uri 参数来确定删除哪一张表中的数据，selection

和 selectionArgs 参数用于约束删除哪些行，被删除的行数将作为返回值返回。

6. getType()

根据传入的内容 URI 来返回相应的 MIME 类型。

一个标准的内容 URI 写法是这样的：

content://com.example.app.provider/table1

这就表示调用方期望访问的是 com.example.app 这个应用的 table1 表中的数据。除此之外，我们还可以在这个内容 URI 的后面加上一个 id，如下所示：

content://com.example.app.provider/table1/1

这就表示调用方期望访问的是 com.example.app 这个应用的 table1 表中 id 为 1 的数据。

内容 URI 的格式主要就只有以上两种，以路径结尾就表示期望访问该表中所有的数据，以 id 结尾就表示期望访问该表中拥有相应 id 的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容 URI，规则如下。

1. *：表示匹配任意长度的任意字符

2. #：表示匹配任意长度的数字

所以，一个能够匹配任意表的内容 URI 格式就可以写成：

content://com.example.app.provider/*

而一个能够匹配 table1 表中任意一行数据的内容 URI 格式就可以写成：

content://com.example.app.provider/table1/#

接着， 我们再借助UriMatcher这个类就可以轻松地实现匹配内容URI的功能。 UriMatcher

中提供了一个 addURI()方法，这个方法接收三个参数，可以分别把权限、路径和一个自定义

代码传进去。这样，当调用 UriMatcher 的 match()方法时，就可以将一个 Uri 对象传入，返

回值是某个能够匹配这个 Uri 对象所对应的自定义代码，利用这个代码，我们就可以判断出

调用方期望访问的是哪张表中的数据了。修改 MyProvider 中的代码，如下所示：

public class MyProvider extends ContentProvider {
public static final int TABLE1_DIR = 0;
public static final int TABLE1_ITEM = 1;
public static final int TABLE2_DIR = 2;
public static final int TABLE2_ITEM = 3;
private static UriMatcher uriMatcher;
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
uriMatcher.addURI("com.example.app.provider ", "table1/#", TABLE1_ITEM);
uriMatcher.addURI("com.example.app.provider ", "table2", TABLE2_ITEM);
uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM);
}
@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
switch (uriMatcher.match(uri)) {
case TABLE1_DIR:
//  查询table1 表中的所有数据
break;
case TABLE1_ITEM:
//  查询table1 表中的单条数据
break;
case TABLE2_DIR:
//  查询table2 表中的所有数据
break;
case TABLE2_ITEM:
//  查询table2 表中的单条数据
break;
default:
break;
}
}
}

getType()方法，它是所有的内容提供器都必须提供的一个方法，用于获取
Uri
对象所对应的
MIME
类型，一个内容
URI
所对应的
MIME字符串主要由三部分组分。

1.
必须以 vnd 开头。

2. 如果内容 URI 以路径结尾，则后接 android.cursor.dir/，如果内容 URI 以 id 结尾，

则后接 android.cursor.item/。

3. 最后接上 vnd.<authority>.<path>。

所以，对于 content://com.example.app.provider/table1 这个内容 URI，它所对应的 MIME

类型就可以写成：

vnd.android.cursor.dir/vnd.com.example.app.provider.table1

对于 content://com.example.app.provider/table1/1 这个内容 URI，它所对应的 MIME 类型

就可以写成：

vnd.android.cursor.item/vnd. com.example.app.provider.table1

现在我们可以继续完善 MyProvider 中的内容了，这次来实现 getType()方法中的逻辑，

代码如下所示：

public class MyProvider extends ContentProvider {
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case TABLE1_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider.
table1";
case TABLE1_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider.
table1";
case TABLE2_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider.
table2";
case TABLE2_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider.
table2";
default:
break;
}
return null;
}
}