Android学习之ContentProvider

最近做项目，用到了这个东西，可是因为太久没有使用了，很多细节忘了，所以现在给自己总结总结

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这里不说

// 设置URIUri 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、子类型 = htmltext/csstext/xmlapplication/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()来获得ContentResolverContentResolver resolver =  getContentResolver(); // 设置ContentProvider的URIUri 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追加一个idUri uri = Uri.parse("content://cn.scu.myprovider/user") Uri resultUri = ContentUris.withAppendedId(uri, 7);  // 最终生成后的Uri为：content://cn.scu.myprovider/user/7// parseId（）作用：从URL中获取IDUri 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：

本文来源：http://upload-images.jianshu.io/upload_images/944365-16b20971852ee5c6.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240