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 类名 |
exported | 为 true 则表示导出。不设置或设置为 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 使用的主要内容,如果未能解决你的问题,请参考以下文章