Android ContentProvider 使用

Posted 牧秦丶

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Android ContentProvider 使用相关的知识,希望对你有一定的参考价值。

android ContentProvider 使用


1、简介

ContentProvider 为存储和获取数据提供统一的接口。可以在不同的应用程序之间共享数据。Android已经为常见的一些数据提供了默认的 ContentProvider。

数据通过唯一的 URI 标识来源。ContentProvider 将数据看作表,查询 / 操作数据的时候,通过类似数据库操作的 insert / delete / query / update 方法来实现增删查改操作。

作为应用间数据交换 / 共享接口,当然需要有一个“桥梁”来连接数据提供方和使用方。数据提供方提供数据,使用方使用 content://authorities/path 类似的 URI 来访问数据。

2、数据提供方

2.1、Provider 声明

数据提供方需要在 Androidmanifest.xml 中声明 ContentProvider 组件。一个 ContentProvider 组件声明如下:

<permission
    android:name="com.straw.providerhost.course.read"
    android:protectionLevel="normal"/>
<permission
    android:name="com.straw.providerhost.course.write"
    android:protectionLevel="normal"/>

<application>
    <provider
        android:authorities="com.straw.course"
        android:name="com.straw.providerhost.CourseContentProvider"
        android:exported="true"
        android:readPermission="com.straw.providerhost.course.read"
        android:writePermission="com.straw.providerhost.course.write"/>
</application>
属性含义
authorities指定 authorieties(类似包名的格式,如 com.xx.xx),访问者通过 content://authorities/path 的形式访问
name这个 Provider 对应的 Java 类名
exportedtrue 则表示导出。不设置或设置为 false 时,其他应用如果使用这个 Provider,则会出现 java.lang.SecurityException: Permission Denial 错误
readPermission读数据者所需声明权限,数据访问者不声明权限则会出现 java.lang.SecurityException: Permission Denial 错误
writePermission写数据者所需声明权限,数据访问者不声明权限则会出现 java.lang.SecurityException: Permission Denial 错误

2.2、其他情况

那两个 App 同时声明相同 authorities 的 ContentProvider 可不可以呢?答案是 不行。如果两个 App 声明了相同 authorities 的 Provider,第二个 App 在安装时会出现 INSTALL_FAILED_CONFLICTING_PROVIDER 错误。错误如下:

2.3、ContentProvider 类

一个具体的 ContentProvider 类需要继承自 android.content.ContentProvider,并且实现 onCreate / getType / insert / delete / update / query 这几个方法。一般我们在 onCreate 方法中打开数据库,在对应的操作方法中根据 URI 的不同,操作不同的数据。

先定义一个帮助类,来声明一些常量。例如:

public class CourseProviders 

    public static final String AUTHORITIES = "com.straw.course";
    public static final String COURSE_PATH = "course";


    public static final Uri BASE_URI = Uri.parse("content://" + AUTHORITIES);
    public static final Uri COURSE_URI = Uri.withAppendedPath(BASE_URI, COURSE_PATH);


    public static class CourseColumn 

        public static final String ID = "id";
        public static final String NAME = "NAME";
        public static final String TEACHER_NAME = "teacher_name";
        public static final String WATCH_COUNT = "watch_count";
        public static final String VIDEO_URL = "video_url";
    

然后实现具体的 ContentProvider:

public class CourseContentProvider extends ContentProvider 

    private CourseSqliteHelper mSqliteHelper;
    private SQLiteDatabase mDatabase;
    private UriMatcher mUriMatcher = new UriMatcher(UriMatcher.NO_MATCH);


    private static final int PROVIDE_COURSE = 1;


    @Override
    public boolean onCreate() 
        mSqliteHelper = new CourseSqliteHelper(getContext());
        mDatabase = mSqliteHelper.getWritableDatabase();

        mUriMatcher.addURI(CourseProviders.AUTHORITIES,
                CourseProviders.COURSE_PATH, PROVIDE_COURSE);
        return true;
    

    @Nullable
    @Override
    public Cursor query(@NonNull Uri uri, String[] projection,
            String selection, String[] selectionArgs, String sortOrder) 

        switch (mUriMatcher.match(uri)) 
            case PROVIDE_COURSE:
                return mDatabase.query(CourseSqliteHelper.COURSE_TABLE_NAME,
                        projection, selection, selectionArgs, null, null, sortOrder);

            default:
                break;
        

        return null;
    

    @Nullable
    @Override
    public String getType(@NonNull Uri uri) 
        return null;
    

    @Nullable
    @Override
    public Uri insert(@NonNull Uri uri, ContentValues values) 
        Uri result = null;
        switch (mUriMatcher.match(uri)) 
            case PROVIDE_COURSE:
                long rowId = mDatabase.insert(
                        CourseSqliteHelper.COURSE_TABLE_NAME, null, values);
                result = ContentUris.withAppendedId(uri, rowId);
                break;

            default:
                break;
        

        return result;
    

    @Override
    public int delete(@NonNull Uri uri, String selection, String[] selectionArgs) 
        switch (mUriMatcher.match(uri)) 
            case PROVIDE_COURSE:
                return mDatabase.delete(CourseSqliteHelper.COURSE_TABLE_NAME,
                        selection, selectionArgs);

            default:
                break;
        

        return 0;
    

    @Override
    public int update(@NonNull Uri uri, ContentValues values, String selection, String[] selectionArgs) 
        switch (mUriMatcher.match(uri)) 
            case PROVIDE_COURSE:
                return mDatabase.update(CourseSqliteHelper.COURSE_TABLE_NAME,
                        values, selection, selectionArgs);

            default:
                break;
        

        return 0;
    

通过 android.content.UriMatcher 提供的 match 方法,很方便的将 content://authorities/path 这样的访问 URI 匹配到正确的数据访问路径。

3、数据访问方

我们可以在本应用内通过 ContentProvider 访问,也可以在其他应用中访问。在 ContentProvider 所在应用外访问时,会拉起 ContentProvider 所在的 App(会拉起 Application,但不会打开任何 Activity)。

3.1、权限声明

首先,在使用方的 AndroidManifest.xml 中需要声明所使用 ContentProvider 的权限,如果只读就声明读权限,如果读写都需要就声明读写权限。如:

<uses-permission android:name="com.straw.providerhost.course.read"/>
<uses-permission android:name="com.straw.providerhost.course.write"/>

3.2、具体使用

private void queryAll() 
    Cursor cursor = context.getContentResolver().query(CourseProviders.COURSE_URI, null, null, null, null);
    if (cursor == null) 
        return;
    

    mCourseInfoList.clear();
    while (cursor.moveToNext()) 
        CourseInfo info = new CourseInfo();
        info.mId = cursor.getString(cursor.getColumnIndex(CourseProviders.CourseColumn.ID));
        info.mName = cursor.getString(cursor.getColumnIndex(CourseProviders.CourseColumn.NAME));
        info.mTeacherName = cursor.getString(cursor.getColumnIndex(CourseProviders.CourseColumn.TEACHER_NAME));
        info.mWatchCount = cursor.getInt(cursor.getColumnIndex(CourseProviders.CourseColumn.WATCH_COUNT));
        info.mVideoUrl = cursor.getString(cursor.getColumnIndex(CourseProviders.CourseColumn.VIDEO_URL));

        mCourseInfoList.add(info);
    

    cursor.close();

    mAdapter.notifyDataSetChanged();

通过 context.getContentResolver 方法获取 ContentResolver,然后使用其提供的 insert / delete / update / query 方法进行 增删改查 操作即可。

以上是关于Android ContentProvider 使用的主要内容,如果未能解决你的问题,请参考以下文章

Android中的ContentProvider源码解析

android-ContentProvider

Android开发实践 ContentProvider和ContentResolver

Android ContentProvider数据共享

Android ContentProvider完整案例

Android ContentProvider 使用