最近做项目,用到了这个东西,可是因为太久没有使用了,很多细节忘了,所以现在给自己总结总结
Content Provider Basics
一个内容提供者访问数据的中央资源库。提供者是应用程序的一部分,提供自己的操作数据的URI。然而,内容提供者主要是被其他应用程序引用,通过提供者客户对象访问提供者。提供者和提供者客户端为数据提供一个一致的,标准的接口,也处理进程间的联系和数据安全访问
提供者向应用程序呈现数据就像一个或多张表,就像是在关系数据库里一样,一行显示一些数据类型的实例,列的每行显示实例数据集合的独立数据
例如:一个android平台里内建的提供者是用户词典,用来存储用户想保存的非标准的拼写:
word | app id | frequency | locale | _ID |
---|---|---|---|---|
mapreduce | user1 | 100 | en_US | 1 |
precompiler | user14 | 200 | fr_FR | 2 |
applet | user2 | 225 | fr_CA | 3 |
const | user1 | 255 | pt_BR | 4 |
int | user5 | 100 | en_UK | 5 |
在表中,每行的单词都是在标准词典里找不到的。每一列有一些和单词相关的数据,比如它所属的区域。列头是列的名字,引用列的区域,我们可以引用它的locale列。对于提供者来说,自动认为列的_ID是主键
注意:提供者并不是一定需要主键,它不需要使用_ID作为主键的列名
内容提供这个,经常是用于进行数据的交互&共享,即跨进程通信
注:
1。ContentProvider = 中间角色(搬运工),真正存储&操作数据的数据源还是原来存储数据的方法(数据库,文件,xml或者网络)
2。数据源可以是:数据库,文件,XML,网络等
ContentProvider的底层是采用Android中的Binder机制
统一资源标识符(URI)
1,定义:Uniform Resource Identifier,即统一资源标识符
2,作用:唯一标识ContentProvider & 其中的数据
外界进程通过URL找到对应的ContentProvider & 其中的数据,再进行数据的操作
3,具体使用:
URI分为系统预置和自定义,分别对应系统内置的数据(如通讯录,日程表等等)和自定义数据库
关于系统预置的URI这里不说
// 设置URI
Uri uri = Uri.parse("content://com.carson.provider/User/1")
// 上述URI指向的资源是:名为 `com.carson.provider`的`ContentProvider` 中表名 为`User` 中的 `id`为1的数据
// 特别注意:URI模式存在匹配通配符* & #
// *:匹配任意长度的任何有效字符的字符串
// 以下的URI 表示 匹配provider的任何内容
content://com.example.app.provider/*
// #:匹配任意长度的数字字符的字符串
// 以下的URI 表示 匹配provider中的table表的所有行
content://com.example.app.provider/table/#
MIME数据类型
1,作用:指定某个扩展名的文件用某种应用程序来打开
如:指定 .html 文件采用 text应用程序打开,指定.pdf文件采用flash应用程序打开
ContentProvider根据URI返回MIME类型:
ContentProvider.geType(uri) ;
2,MIME类型组成
每种MIME类型由2部分组成 = 类型+子类型
MIME类型是一个包含2部分的字符串
text / html
// 类型 = text、子类型 = html
text/css
text/xml
application/pdf
type有下面的形式:
Text:用于标准化的表示的文本信息,文本信息可以是多种字符集或者多种格式的
Mutipart:用于连接消息体的多个部分构成一个消息,这些部分可以是不同类型的数据
Application:用于传输应用程序数据或者二进制数据
Message:用于包装一个E-mail消息
Image:用于传输静态图片数据
Audio:用于传输音频或者音声数据
Video:用于传输动态影像数据,可是是与音频编辑在一起的视屏数据格式subType用于指定type的详细形式
text/plain:纯文本
text/plain:HTML文档
application/xhtml+xml :XHTML文档
image/gif:gif图像
image/jpeg :jpeg图像
image/png:png图像
video/mpeg:mpeg动画
application/octet-stream(任意的二进制数据)
application/pdf(PDF文档)
application/msword(Microsoft Word文件)
message/rfc822(RFC 822形式)
multipart/alternative(HTML邮件的HTML形式和纯文本形式,相同内容使用不同形式表示)
application/x-www-form-urlencoded(使用HTTP的POST方法提交的表单)
multipart/form-data(同上,但主要用于表单提交时伴随文件上传的场合)
Android中MimeType的用途
Intent-Filter中的有一个mimeType . 它的作用是告诉Android系统本Activity可以处理的文件的类型。如设置为 “text/plain”表示可以处理“.txt”文件。
MIME类型形式:
// 形式1:单条记录
vnd.android.cursor.item/自定义
// 形式2:多条记录(集合)
vnd.android.cursor.dir/自定义
// 注:
// 1. vnd:表示父类型和子类型具有非标准的、特定的形式。
// 2. 父类型已固定好(即不能更改),只能区别是单条还是多条记录
// 3. 子类型可自定义
实例说明
<-- 单条记录 -->
// 单个记录的MIME类型
vnd.android.cursor.item/vnd.yourcompanyname.contenttype
// 若一个Uri如下
content://com.example.transportationprovider/trains/122
// 则ContentProvider会通过ContentProvider.geType(url)返回以下MIME类型
vnd.android.cursor.item/vnd.example.rail
<-- 多条记录 -->
// 多个记录的MIME类型
vnd.android.cursor.dir/vnd.yourcompanyname.contenttype
// 若一个Uri如下
content://com.example.transportationprovider/trains
// 则ContentProvider会通过ContentProvider.geType(url)返回以下MIME类型
vnd.android.cursor.dir/vnd.example.rail
ContentProvider类
1,组织数据方法:主要以表格的形式组织数据
2,主要方法:
进程间共享数据的本质是:添加,删除,获取,修改(更新)数据
<-- 4个核心方法 -->
public Uri insert(Uri uri, ContentValues values)
// 外部进程向 ContentProvider 中添加数据
public int delete(Uri uri, String selection, String[] selectionArgs)
// 外部进程 删除 ContentProvider 中的数据
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
// 外部进程更新 ContentProvider 中的数据
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
// 外部应用 获取 ContentProvider 中的数据
// 注:
// 1. 上述4个方法由外部进程回调,并运行在ContentProvider进程的Binder线程池中(不是主线程)
// 2. 存在多线程并发访问,需要实现线程同步
// a. 若ContentProvider的数据存储方式是使用SQLite & 一个,则不需要,因为SQLite内部实现好了线程同步,若是多个SQLite则需要,因为SQL对象之间无法进行线程同步
// b. 若ContentProvider的数据存储方式是内存,则需要自己实现线程同步
<-- 2个其他方法 -->
public boolean onCreate()
// ContentProvider创建后 或 打开系统后其它进程第一次访问该ContentProvider时 由系统进行调用
// 注:运行在ContentProvider进程的主线程,故不能做耗时操作
public String getType(Uri uri)
// 得到数据类型,即返回当前 Url 所代表数据的MIME类型
ContentResolver类
ContentProvider类并不会直接与外部进程交互,而是通过ContentResolver类
1,作用:统一管理不同ContentProvider间的操作:
即通过URI即可操作不同的ContentProvider中的数据
外部进程通过ContentResolver类从而与ContentProvider类进行交互
2,具体使用:
ContentResolver类提供了与ContentProvider类相同的名字和作用的4个方法:
// 外部进程向 ContentProvider 中添加数据
public Uri insert(Uri uri, ContentValues values)
// 外部进程 删除 ContentProvider 中的数据
public int delete(Uri uri, String selection, String[] selectionArgs)
// 外部进程更新 ContentProvider 中的数据
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
// 外部应用 获取 ContentProvider 中的数据
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
实例说明:
// 使用ContentResolver前,需要先获取ContentResolver
// 可通过在所有继承Context的类中 通过调用getContentResolver()来获得ContentResolver
ContentResolver resolver = getContentResolver();
// 设置ContentProvider的URI
Uri uri = Uri.parse("content://cn.scu.myprovider/user");
// 根据URI 操作 ContentProvider中的数据
// 此处是获取ContentProvider中 user表的所有记录
Cursor cursor = resolver.query(uri, null, null, null, "userid desc");
Android提供了3个辅助ContentProvider的工具类:
- ContentUris
- UriMatcher
- ContentObserver
ContentUris类
1,作用:操作URI
具体使用:
核心方法有两个:withAppendedId()和praseId()
// withAppendedId()作用:向URI追加一个id
Uri uri = Uri.parse("content://cn.scu.myprovider/user")
Uri resultUri = ContentUris.withAppendedId(uri, 7);
// 最终生成后的Uri为:content://cn.scu.myprovider/user/7
// parseId()作用:从URL中获取ID
Uri uri = Uri.parse("content://cn.scu.myprovider/user/7")
long personid = ContentUris.parseId(uri);
//获取的结果为:7
UriMatcher类
1,作用:
在ContentProvider中注册URI
根据URI匹配ContentProvider中对应的数据表
2,具体使用:
// 步骤1:初始化UriMatcher对象
UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
//常量UriMatcher.NO_MATCH = 不匹配任何路径的返回码
// 即初始化时不匹配任何东西
// 步骤2:在ContentProvider 中注册URI(addURI())
int URI_CODE_a = 1;
int URI_CODE_b = 2;
matcher.addURI("cn.scu.myprovider", "user1", URI_CODE_a);
matcher.addURI("cn.scu.myprovider", "user2", URI_CODE_b);
// 若URI资源路径 = content://cn.scu.myprovider/user1 ,则返回注册码URI_CODE_a
// 若URI资源路径 = content://cn.scu.myprovider/user2 ,则返回注册码URI_CODE_b
// 步骤3:根据URI 匹配 URI_CODE,从而匹配ContentProvider中相应的资源(match())
@Override
public String getType(Uri uri) {
Uri uri = Uri.parse(" content://cn.scu.myprovider/user1");
switch(matcher.match(uri)){
// 根据URI匹配的返回码是URI_CODE_a
// 即matcher.match(uri) == URI_CODE_a
case URI_CODE_a:
return tableNameUser1;
// 如果根据URI匹配的返回码是URI_CODE_a,则返回ContentProvider中的名为tableNameUser1的表
case URI_CODE_b:
return tableNameUser2;
// 如果根据URI匹配的返回码是URI_CODE_b,则返回ContentProvider中的名为tableNameUser2的表
}
}
ContentObserver类
定义:内容观察者
作用:观察Uri引起ContentProvider中数据变化和通知外界(即访问该数据访问者)
当ContentProvider中的数据发生变化(增,删,改),就会触发该类
具体使用:
// 步骤1:注册内容观察者ContentObserver
getContentResolver().registerContentObserver(uri);
// 通过ContentResolver类进行注册,并指定需要观察的URI
// 步骤2:当该URI的ContentProvider数据发生变化时,通知外界(即访问该ContentProvider数据的访问者)
public class UserContentProvider extends ContentProvider {
public Uri insert(Uri uri, ContentValues values) {
db.insert("user", "userid", values);
getContext().getContentResolver().notifyChange(uri, null);
// 通知访问者
}
}
// 步骤3:解除观察者
getContentResolver().unregisterContentObserver(uri);
// 同样需要通过ContentResolver类进行解除
实例说明
1:进程间通信:
- 创建数据库类
- 自定义 ContentProvider 类
- 注册 创建的 ContentProvider类
- 进程内访问 ContentProvider的数据
public class DBHelper extends SQLiteOpenHelper{
//数据库名
private static final String DATABASE_NAME = "vivian.db";
//表名
public static final String USER_TABLE_NAME = "user";
public static final String JOB_TABLE_NAME = "job";
//版本号
private static final int DATABASE_VERSION = 1;
public DBHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
@Override
public void onCreate(SQLiteDatabase db) {
// 创建两个表格:用户表 和职业表
db.execSQL("CREATE TABLE IF NOT EXISTS "
+ USER_TABLE_NAME
+ "(_id INTEGER PRIMARY KEY AUTOINCREMENT,"
+ " name TEXT)");
db.execSQL("CREATE TABLE IF NOT EXISTS "
+ JOB_TABLE_NAME
+ "(_id INTEGER PRIMARY KEY AUTOINCREMENT,"
+ " job TEXT)");
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
}
public class MyProvider extends ContentProvider {
private Context mContext;
private DBHelper mDBHelper = null;
private SQLiteDatabase mDb;
public static final String AUTHOURITH = "cn.vivian.myprovider";
//设置唯一标识符
public static final int User_Code = 1;
public static final int Job_Code = 2;
private static final UriMatcher mMatcher;
static {
mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
mMatcher.addURI(AUTHOURITH,"user",User_Code);
mMatcher.addURI(AUTHOURITH,"job",Job_Code);
// 若URI资源路径 = content://cn.vivian.myprovider/user ,则返回注册码User_Code
// 若URI资源路径 = content:/cn.vivian.myprovider/job ,则返回注册码Job_Code
}
@Override
public boolean onCreate() {
mContext = getContext();
mDBHelper = new DBHelper(mContext);
mDb = mDBHelper.getWritableDatabase();
mDb.execSQL("delete from user");
mDb.execSQL("insert into user values(1,\"vivian\")");
mDb.execSQL("insert into user values(2,\"Tom\")");
mDb.execSQL("delete from job");
mDb.execSQL("insert into job values(1,\"android\")");
mDb.execSQL("insert into job values(2,\"IOS\")");
return true;
}
@Nullable
@Override
public String getType(@NonNull Uri uri) {
return mContext.getContentResolver().getType(uri) ;
}
@Nullable
@Override
public Uri insert(@NonNull Uri uri, @Nullable ContentValues values) {
String tableName = getTableName(uri);
if(tableName!=null){
mDb.insert(tableName,null,values);
mContext.getContentResolver().notifyChange(uri,null);
}
return uri;
}
@Override
public int update(@NonNull Uri uri, @Nullable ContentValues values, @Nullable String selection, @Nullable String[] selectionArgs) {
return 0;
}
@Nullable
@Override
public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String sortOrder) {
String tableName = getTableName(uri);
return mDb.query(tableName,projection,selection,selectionArgs,null,null,sortOrder);
}
@Override
public int delete(@NonNull Uri uri, @Nullable String selection, @Nullable String[] selectionArgs) {
return 0;
}
private String getTableName(Uri uri){
String tableName = null;
switch (mMatcher.match(uri)){
case User_Code:
tableName = DBHelper.USER_TABLE_NAME;
break;
case Job_Code:
tableName = DBHelper.JOB_TABLE_NAME;
break;
}
return tableName;
}
}
然后在Main中:
Uri User = Uri.parse("content://"+MyProvider.AUTHOURITH+"/user");
ContentValues values = new ContentValues();
values.put("_id",3);
values.put("name","joe");
ContentResolver resolver = getContentResolver();
resolver.insert(User,values);
Cursor cursor = resolver.query(User,new String[]{"_id","name"},null,null,null);
while (cursor.moveToNext()){
System.out.println("query data"+cursor.getInt(0)+" "+cursor.getString(1));
}
注意,一定要在Mainfest中注册provider
<provider
android:authorities="cn.vivian.myprovider"
android:name=".MyProvider"/>
2,进程间数据共享
实例说明,需要创建两个工程
进程1
使用步骤如下:
1,创建数据库类
2,自定义 ContentProvider 类
3,注册 创建的 ContentProvider 类
前2个步骤同上例相同,此处不作过多描述,此处主要讲解步骤3.
<provider
android:name="MyProvider"
android:authorities="scut.carson_ho.myprovider"
// 声明外界进程可访问该Provider的权限(读 & 写)
android:permission="scut.carson_ho.PROVIDER"
// 权限可细分为读 & 写的权限
// 外界需要声明同样的读 & 写的权限才可进行相应操作,否则会报错
// android:readPermisson = "scut.carson_ho.Read"
// android:writePermisson = "scut.carson_ho.Write"
// 设置此provider是否可以被其他进程使用
android:exported="true"
/>
// 声明本应用 可允许通信的权限
<permission android:name="scut.carson_ho.Read" android:protectionLevel="normal"/>
// 细分读 & 写权限如下,但本Demo直接采用全权限
// <permission android:name="scut.carson_ho.Write" android:protectionLevel="normal"/>
// <permission android:name="scut.carson_ho.PROVIDER" android:protectionLevel="normal"/>
进程一完成
进程2:
步骤1 :声明可访问的权限
// 声明本应用可允许通信的权限(全权限)
<uses-permission android:name="scut.carson_ho.PROVIDER"/>
// 细分读 & 写权限如下,但本Demo直接采用全权限
// <uses-permission android:name="scut.carson_ho.Read"/>
// <uses-permission android:name="scut.carson_ho.Write"/>
// 注:声明的权限必须与进程1中设置的权限对应
// 设置URI
Uri uri_user = Uri.parse("content://scut.carson_ho.myprovider/user");
// 插入表中数据
ContentValues values = new ContentValues();
values.put("_id", 4);
values.put("name", "Jordan");
// 获取ContentResolver
ContentResolver resolver = getContentResolver();
// 通过ContentResolver 根据URI 向ContentProvider中插入数据
resolver.insert(uri_user,values);
// 通过ContentResolver 向ContentProvider中查询数据
Cursor cursor = resolver.query(uri_user, new String[]{"_id","name"}, null, null, null);
while (cursor.moveToNext()){
System.out.println("query book:" + cursor.getInt(0) +" "+ cursor.getString(1));
// 将表中数据全部输出
}
cursor.close();
// 关闭游标
/**
* 对job表进行操作
*/
// 和上述类似,只是URI需要更改,从而匹配不同的URI CODE,从而找到不同的数据资源
Uri uri_job = Uri.parse("content://scut.carson_ho.myprovider/job");
// 插入表中数据
ContentValues values2 = new ContentValues();
values2.put("_id", 4);
values2.put("job", "NBA Player");
// 获取ContentResolver
ContentResolver resolver2 = getContentResolver();
// 通过ContentResolver 根据URI 向ContentProvider中插入数据
resolver2.insert(uri_job,values2);
// 通过ContentResolver 向ContentProvider中查询数据
Cursor cursor2 = resolver2.query(uri_job, new String[]{"_id","job"}, null, null, null);
while (cursor2.moveToNext()){
System.out.println("query job:" + cursor2.getInt(0) +" "+ cursor2.getString(1));
// 将表中数据全部输出
}
cursor2.close();
// 关闭游标
先运行进程1,准备一些数据
然后运行进程2: