Android - base - ContentProvider

四大组件之内容提供器
提供一个外部访问接口，让其他APP访问到我们这个APP的数据。

大纲

• 内容提供器简介
• 核心类
• 内容URI
• 访问其他APP中的数据
• 提供自己的内容提供器

---

#内容提供器简介

内容提供器 Content Provider 主要用于在不同的APP之间实现数据共享。

---

#核心类

ContentResolver 类：访问其他APP数据的工具类，内置CRUD方法。

获取：Context 类的 getContentResolver() 方法。

---

#内容URI

内容URI给内容提供器中的数据建立唯一的标识符，同时也是ContentResolver类进行CURD操作的所需参数之一。

内容URI由两部分组成：

• 权限<authority>：用于对不同的应用程序进行区分。一般情况下，都会采用程序的包名进行区分
• 路径<path>：用于对同一应用程序中不同的表做区分，添加在去权限的后面。一般情况下，使用表名

再在字符串的头部加上协议声明，故内容URI的标准格式如下：
content:/com.example.cheng.android_contentprovider/book
我们可以在内容URI的后面加上一个id：
content://com.example.cheng.android_contentprovider/book/1
表示调用方期望访问的是 com.example.cheng.android_contentprovider 这个应用的
book 表中 id 为 1 的数据。

两种格式的内容 URI：

• 以路径结尾就表示期望访问该表中所有的数据
• 以id结尾表示期望访问该表中拥有响应id的数据

可以使用通配符的方式来分别匹配这两种格式的内容 URI：

• "*" ：表示匹配任意长度的任意字符
• "#"：表示匹配任意长度的数字

例：

一个能匹配任意表的内容 URI 格式就可以写成：
content://com.example.cheng.android_contentprovider/*
一个能匹配 book 表中任意一行数据的内容 URI 就可以写成：
content://com.example.cheng.android_contentprovider/book/#

得到了内容URI字符串，我们需要将之解析成Uri对象才可以做为参数传入：

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

---

访问其他APP中的数据

获取联系人数据 需要运行时权限处理

if (ContextCompat.checkSelfPermission(this, READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[] {READ_CONTACTS}, READ_CONTACTS_REQUEST);
} else {
    Cursor result = getContentResolver().query(
            ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
            null,
            null,
            null,
            null);

    if (result != null) {
        while(result.moveToNext()) {
            String name = result.getString(result.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
            String phone = result.getString(result.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
            
            Toast.makeText(this, name + ":" + phone, Toast.LENGTH_SHORT).show();
        }
    }
}

和SQLite操作很相似，但访问外部数据传入的不是表名而是 URL ，query() 方法参数也少了几个。

query

/*
 * @param uri 内容uri "content://com.example.cheng.android_contentprovider/book"
 * @param projection 查询的列
 * @param selection 条件
 * @param selectionArgs 占位值
 * @param sortOrder 排序
 */
public final Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

其他三个方法的用法类似，不作赘述。

• 访问外部资源前提是得知道外部资源的内容URI

---

#提供自己的内容提供器

1. 创建类继承 ContentProvider 类并实现6个方法。
2. 在 onCreate() 方法内完成初始化操作。
3. 将提供给外部访问的 URI 封装到 UriMatcher 对象

// 标识
public static final int BOOK_DIR = 0;
public static final int BOOK_ITEM = 1;
public static final int CATEGORY_DIR = 2;
public static final int CATEGORY_ITEM = 3;

// 包名
public static final String authority = "com.example.cheng.android_contentprovider";

private static UriMatcher uriMatcher;

static {
    uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    uriMatcher.addURI(authority, "book", BOOK_DIR);
    uriMatcher.addURI(authority, "book/#", BOOK_ITEM);
    uriMatcher.addURI(authority, "category", CATEGORY_DIR);
    uriMatcher.addURI(authority, "category/#", CATEGORY_ITEM);
}

这些 URI 只是给其他APP访问的，并不能直接访问数据安全。我们的内容提供器的CRUD方法被调用时会经过 uriMatcher.match(uri) 方法得到 封装进去的标记，然后我们根据标记写逻辑。

4. 在 getType() 方法内将 URI 转成 MIME 类型

/*
 * 转成URI对应的MIME类型
 * @param uri
 * @return
 */
@Nullable
@Override
public String getType(@NonNull Uri uri) {
    switch (uriMatcher.match(uri)) {
        case BOOK_DIR:
            return "vnd.android.cursor.dir/vnd.com.example.cheng.android_contentprovider.book";
        case BOOK_ITEM:
            return "vnd.android.cursor.item/vnd.com.example.cheng.android_contentprovider.book";
        case CATEGORY_DIR:
            return "vnd.android.cursor.dir/vnd.com.example.cheng.android_contentprovider.category";
        case CATEGORY_ITEM:
            return "vnd.android.cursor.item/vnd.com.example.cheng.android_contentprovider.category";
        }
        return null;
    }

内容 URI 转 MIME 规则

• 必须以 vnd. 开头。
• 如果内容 URI 以路径结尾，则后接 android.cursor.dir/，如果内容 URI 以
• 结尾，则后接 android.cursor.item/。
• 最后接上 vnd.<authority>.<path>。

内容URI：content://com.example.cheng.android_contentprovider/book
MIME：android.cursor.dir/vnd.com.example.cheng.android_contentprovider.book
vnd. 开头
android.cursor.dir/ 路径结尾
vnd.com.example.cheng.android_contentprovider.book vnd.<authority>.<path>

query

// uri.getPathSegments().get(1)：将路径 "/" 前后切割 1索引是id值
@Nullable
@Override
public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String order) {
    Cursor result = null;
    
    // 根据标记得知用户想操作哪张表。
    switch (uriMatcher.match(uri)) {
        case BOOK_DIR:
            result = database.query("book", projection, selection, selectionArgs, null, null, order);
            break;
        case BOOK_ITEM:
            String bid = uri.getPathSegments().get(1);
            result = database.query("book", projection, "id = ?", new String[] {bid}, null, null, order);
            break;
        case CATEGORY_DIR:
            result = database.query("category", projection, selection, selectionArgs, null, null, order);
            break;
        case CATEGORY_ITEM:
            String cid = uri.getPathSegments().get(1);
            result = database.query("category", projection, "id = ?", new String[] {cid}, null, null, order);
            break;
            default:
        }
        return result;
    }

方法内是数据库操作，但是我们不能让外部程序 乱搞 套了一层 壳 让外部程序只能访问到我们想提供的数据 数据安全。

CRUD剩余方法

/*
 * @param uri 内容uri
 * @param contentValues 存值对象
 * @return 插入数据的 内容uri   "content://com.example.cheng.android_contentprovider/1"
 */
public Uri insert(@NonNull Uri uri, @Nullable ContentValues contentValues)

/*
 * @param uri 内容uri
 * @param selection 条件
 * @param selectionArgs 占位值
 * @return 影响数据行数
 */
public int delete(@NonNull Uri uri, @Nullable String selection, @Nullable String[] selectionArgs)


/*
 * @param uri 内容uri
 * @param contentValues 存值对象
 * @param selection 条件
 * @param selectionArgs 占位值
 * @return 影响数据行数
 */
public int update(@NonNull Uri uri, @Nullable ContentValues contentValues, @Nullable String selection, @Nullable String[] selectionArgs)

• 最后别忘了注册内容提供器

---