Android之内容提供者（ContentProvider）

追梦的鱼儿

于 2024-08-17 00:04:05 发布

阅读量1k

点赞数 19

文章标签： android ContentProvider 内容提供者

本文链接：https://blog.csdn.net/Sh_12345/article/details/141253441

版权

内容提供者（ContentProvider）是Android四大组件之一，用于在不同应用之间共享数据。内容提供者通过统一资源标识符（URI）来标识数据，并使用一套标准的接口来访问和操作数据。它是Android系统中实现跨应用数据共享的主要方式。

作用

数据共享：允许不同应用之间共享数据，例如联系人、媒体文件等。
数据封装：提供统一的接口来访问和操作数据，隐藏底层数据存储的实现细节。
权限控制：通过权限机制控制数据的访问，确保数据的安全性。

基本结构

内容提供者通过继承ContentProvider类来实现，主要包括以下几个方法：

onCreate()：初始化内容提供者。
query()：查询数据。
insert()：插入数据。
update()：更新数据。
delete()：删除数据。
getType()：返回数据的MIME类型。

示例

实现一个简单的内容提供者

1. 创建内容提供者类

public class MyContentProvider extends ContentProvider {

    private static final String AUTHORITY = "com.example.mycontentprovider";
    private static final String PATH = "mydata";
    public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/" + PATH);

    private SQLiteDatabase database;

    @Override
    public boolean onCreate() {
        // 初始化数据库或其他数据存储
        MyDatabaseHelper dbHelper = new MyDatabaseHelper(getContext());
        database = dbHelper.getWritableDatabase();
        return database != null;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        // 查询数据
        return database.query("mytable", projection, selection, selectionArgs, null, null, sortOrder);
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // 插入数据
        long id = database.insert("mytable", null, values);
        return ContentUris.withAppendedId(CONTENT_URI, id);
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
        // 更新数据
        return database.update("mytable", values, selection, selectionArgs);
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // 删除数据
        return database.delete("mytable", selection, selectionArgs);
    }

    @Override
    public String getType(Uri uri) {
        // 返回数据的MIME类型
        return "vnd.android.cursor.dir/vnd.com.example.mycontentprovider.mydata";
    }
}

2.在AndroidManifest.xml中声明内容提供者

<provider
    android:name=".MyContentProvider"
    android:authorities="com.example.mycontentprovider"
    android:exported="true" />

使用内容提供者

其他应用或组件可以通过ContentResolver来访问内容提供者的数据。

查询数据

Cursor cursor = getContentResolver().query(
    MyContentProvider.CONTENT_URI,
    null, // projection
    null, // selection
    null, // selectionArgs
    null  // sortOrder
);

if (cursor != null) {
    while (cursor.moveToNext()) {
        // 处理查询结果
    }
    cursor.close();
}

插入数据

ContentValues values = new ContentValues();
values.put("column_name", "value");
Uri newUri = getContentResolver().insert(MyContentProvider.CONTENT_URI, values);

更新数据

ContentValues values = new ContentValues();
values.put("column_name", "new_value");
int rowsUpdated = getContentResolver().update(MyContentProvider.CONTENT_URI, values, "column_name = ?", new String[]{"old_value"});

删除数据

int rowsDeleted = getContentResolver().delete(MyContentProvider.CONTENT_URI, "column_name = ?", new String[]{"value"});

内容提供者的URI

内容提供者通过URI来标识和访问数据。URI的结构通常如下：

content://<authority>/<path>/<id>

authority：内容提供者的唯一标识符，通常是应用包名。
path：数据的路径，表示数据的类型或表名。
id：可选，用于标识特定的数据项。

3.权限设置

声明权限

AndroidManifest.xml文件中声明权限，以限制对内容提供者的访问。可以声明读权限、写权限或两者兼有。

<provider
    android:name=".MyContentProvider"
    android:authorities="com.example.mycontentprovider"
    android:exported="true"
    android:readPermission="com.example.mycontentprovider.READ"
    android:writePermission="com.example.mycontentprovider.WRITE" />

在上述示例中，android:readPermission和android:writePermission属性用于指定读和写权限。只有声明了这些权限的应用程序才能访问内容提供者的数据。

定义权限

在AndroidManifest.xml文件中定义自定义权限：

<permission
    android:name="com.example.mycontentprovider.READ"
    android:protectionLevel="normal" />
<permission
    android:name="com.example.mycontentprovider.WRITE"
    android:protectionLevel="normal" />

protectionLevel属性定义了权限的保护级别。常见的保护级别包括：

normal：普通权限，系统会自动授予这些权限。
dangerous：危险权限，用户需要显式授予这些权限。
signature：签名权限，只有与内容提供者应用具有相同签名的应用才能获得这些权限。

在代码中检查权限

在内容提供者的代码中，可以使用checkCallingPermission()方法来检查调用应用是否具有所需的权限。

@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
    if (getContext().checkCallingPermission("com.example.mycontentprovider.READ") != PackageManager.PERMISSION_GRANTED) {
        throw new SecurityException("Permission denied to read data");
    }
    // 执行查询操作
    return database.query("my_table", projection, selection, selectionArgs, null, null, sortOrder);
}

@Override
public Uri insert(Uri uri, ContentValues values) {
    if (getContext().checkCallingPermission("com.example.mycontentprovider.WRITE") != PackageManager.PERMISSION_GRANTED) {
        throw new SecurityException("Permission denied to write data");
    }
    // 执行插入操作
    long id = database.insert("my_table", null, values);
    return ContentUris.withAppendedId(CONTENT_URI, id);
}

动态权限请求

对于危险权限，调用应用需要在运行时请求权限。

// 请求读权限
if (ContextCompat.checkSelfPermission(this, "com.example.mycontentprovider.READ") != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{"com.example.mycontentprovider.READ"}, REQUEST_CODE);
}

// 请求写权限
if (ContextCompat.checkSelfPermission(this, "com.example.mycontentprovider.WRITE") != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{"com.example.mycontentprovider.WRITE"}, REQUEST_CODE);
}

处理权限请求结果

在调用应用中，处理权限请求结果：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    if (requestCode == REQUEST_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限授予，执行相应操作
        } else {
            // 权限被拒绝，显示提示信息
        }
    }
}