Android学习之ContentProvider

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

Content Provider Basics

一个内容提供者访问数据的中央资源库。提供者是应用程序的一部分,提供自己的操作数据的URI。然而,内容提供者主要是被其他应用程序引用,通过提供者客户对象访问提供者。提供者和提供者客户端为数据提供一个一致的,标准的接口,也处理进程间的联系和数据安全访问

提供者向应用程序呈现数据就像一个或多张表,就像是在关系数据库里一样,一行显示一些数据类型的实例,列的每行显示实例数据集合的独立数据

例如:一个android平台里内建的提供者是用户词典,用来存储用户想保存的非标准的拼写:

wordapp idfrequencylocale_ID
mapreduceuser1100en_US1
precompileruser14200fr_FR2
appletuser2225fr_CA3
constuser1255pt_BR4
intuser5100en_UK5

在表中,每行的单词都是在标准词典里找不到的。每一列有一些和单词相关的数据,比如它所属的区域。列头是列的名字,引用列的区域,我们可以引用它的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 = 1int 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:
这里写图片描述

本文来源:https://i-blog.csdnimg.cn/blog_migrate/34165fca1200e36c15fc59af3226370c.webp?x-image-process=image/format,png

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值