Android四大组件之ContentProvider最新总结

1、定义

ContentProvider内容提供者，是 Android 四大组件之一

2、作用

进程间通讯，数据交互和数据共享

3、原理

ContentProvider底层采用Android的Binder机制

4、具体使用

4.1 URI(统一资源标识符)

	作用：外界进程通过URI找到对应的ContentProvider中的数据，然后对数据进行操作

URI分为 系统预置 & 自定义，分别对应系统内置的数据（如通讯录、日程表等等）和自定义数据库

自定义URI=content://com.example.provider/table/1
                    主题名            授权信息                表名   记录
 主题（schema）:URI前缀，固定
 授权信（Auto）信息：唯一标识
 表名（Path）：指向数据库中的某个表名
 记录（ID）:表中某个记录（若无指定，则返回全部记录）

4.2MIME数据类型

作用：指定某个扩展名的文件用某种应用程序来打开
如指定.html文件采用text应用程序打开、指定.pdf文件采用flash应用程序打开

4.3 ContentProvider

进程间共享数据的本质是：添加、删除、获取 、更新数据。

ContentProvider类并不会直接与外部进程交互，而是通过ContentResolver 类

<-- 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类型

4.4 ContentResolver类

1、作用

作用：统一管理不同 ContentProvider间的操作；
1）、即通过 URI 即可操作 不同的ContentProvider 中的数据
2）、外部进程通过 ContentResolver类 从而与ContentProvider类进行交互

2、 为什么要使用通过ContentResolver类从而与ContentProvider类进行交互，而不直接访问ContentProvider类？
答：
一般来说，一款应用要使用多个ContentProvider，若需要了解每个ContentProvider的不同实现从而再完成数据交互，操作成本高 & 难度大
所以再ContentProvider类上加多了一个 ContentResolver类对所有的ContentProvider进行统一管理。

3、具体使用
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)

Android 提供了3个用于辅助ContentProvide的工具类：
ContentUris

// 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

ContentObserver
观察 Uri引起 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类进行解除

5、实例

由于ContentProvider不仅常用于进程间通信，同时也适用于进程内通信
所以本实例会采用ContentProvider讲解：
进程内通信
进程间通信
实例说明：采用的数据源是Android中的SQLite数据库

5.1 进程内通信

步骤说明：

创建数据库类
自定义 ContentProvider 类
注册 创建的 ContentProvider类
进程内访问 ContentProvider的数据
具体使用

步骤1：创建数据库类

public class DBHelper extends SQLiteOpenHelper {

    // 数据库名
    private static final String DATABASE_NAME = "finch.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)   {

    }
}
``
步骤2：自定义 ContentProvider 类

public class MyProvider extends ContentProvider {

private Context mContext;
DBHelper mDbHelper = null;
SQLiteDatabase db = null;

public static final String AUTOHORITY = "cn.scu.myprovider";
// 设置ContentProvider的唯一标识

public static final int User_Code = 1;
public static final int Job_Code = 2;

// UriMatcher类使用:在ContentProvider 中注册URI
private static final UriMatcher mMatcher;
static{
    mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    // 初始化
    mMatcher.addURI(AUTOHORITY,"user", User_Code);
    mMatcher.addURI(AUTOHORITY, "job", Job_Code);
    // 若URI资源路径 = content://cn.scu.myprovider/user ，则返回注册码User_Code
    // 若URI资源路径 = content://cn.scu.myprovider/job ，则返回注册码Job_Code
}

// 以下是ContentProvider的6个方法

/**
 * 初始化ContentProvider
 */
@Override
public boolean onCreate() {

    mContext = getContext();
    // 在ContentProvider创建时对数据库进行初始化
    // 运行在主线程，故不能做耗时操作,此处仅作展示
    mDbHelper = new DBHelper(getContext());
    db = mDbHelper.getWritableDatabase();

    // 初始化两个表的数据(先清空两个表,再各加入一个记录)
    db.execSQL("delete from user");
    db.execSQL("insert into user values(1,'Carson');");
    db.execSQL("insert into user values(2,'Kobe');");

    db.execSQL("delete from job");
    db.execSQL("insert into job values(1,'Android');");
    db.execSQL("insert into job values(2,'iOS');");

    return true;
}

/**
 * 添加数据
 */

@Override
public Uri insert(Uri uri, ContentValues values) {

    // 根据URI匹配 URI_CODE，从而匹配ContentProvider中相应的表名
    // 该方法在最下面
    String table = getTableName(uri);

    // 向该表添加数据
    db.insert(table, null, values);

    // 当该URI的ContentProvider数据发生变化时，通知外界（即访问该ContentProvider数据的访问者）
    mContext.getContentResolver().notifyChange(uri, null);

// 通过ContentUris类从URL中获取ID
long personid = ContentUris.parseId(uri);
System.out.println(personid);

    return uri;
    }

/**
 * 查询数据
 */
@Override
public Cursor query(Uri uri, String[] projection, String selection,
                    String[] selectionArgs, String sortOrder) {
    // 根据URI匹配 URI_CODE，从而匹配ContentProvider中相应的表名
    // 该方法在最下面
    String table = getTableName(uri);

// 通过ContentUris类从URL中获取ID
long personid = ContentUris.parseId(uri);
System.out.println(personid);

    // 查询数据
    return db.query(table,projection,selection,selectionArgs,null,null,sortOrder,null);
}

/**
 * 更新数据
 */
@Override
public int update(Uri uri, ContentValues values, String selection,
                  String[] selectionArgs) {
    // 由于不展示,此处不作展开
    return 0;
}

/**
 * 删除数据
 */
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
    // 由于不展示,此处不作展开
    return 0;
}

@Override
public String getType(Uri uri) {

    // 由于不展示,此处不作展开
    return null;
}

/**
 * 根据URI匹配 URI_CODE，从而匹配ContentProvider中相应的表名
 */
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;
    }
}

步骤3：注册 创建的 ContentProvider类
AndroidManifest.xml

步骤4：进程内访问 ContentProvider中的数据

MainActivity.java

public class MainActivity extends AppCompatActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    /**
     * 对user表进行操作
     */

    // 设置URI
    Uri uri_user = Uri.parse("content://cn.scu.myprovider/user");

    // 插入表中数据
    ContentValues values = new ContentValues();
    values.put("_id", 3);
    values.put("name", "Iverson");


    // 获取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://cn.scu.myprovider/job");
    
    // 插入表中数据
    ContentValues values2 = new ContentValues();
    values2.put("_id", 3);
    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();
    // 关闭游标
}
}

5.2进程间进行数据共享

使用步骤如下：

创建数据库类

自定义 ContentProvider 类
注册 创建的 ContentProvider 类
前2个步骤同上例相同，此处不作过多描述，此处主要讲解步骤3.

步骤3：注册 创建的 ContentProvider类
AndroidManifest.xml

<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：声明可访问的权限
AndroidManifest.xml

    // 声明本应用可允许通信的权限（全权限）
    <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中设置的权限对应

步骤2：访问 ContentProvider的类

6、优点

6.1 安全

ContentProvider为应用间的数据交互提供了一个安全的环境：允许把自己的应用数据根据需求开放给 其他应用 进行 增、删、改、查，而不用担心因为直接开放数据库权限而带来的安全问题

6.2 访问简单、高效，解耦

对比于其他对外共享数据的方式，数据访问方式会因数据存储的方式而不同：

采用 文件方式 对外共享数据，需要进行文件操作读写数据；
采用 Sharedpreferences 共享数据，需要使用sharedpreferences API读写数据
这使得访问数据变得复杂 & 难度大。

而采用ContentProvider方式，其 解耦了 底层数据的存储方式，使得无论底层数据存储采用何种方式，外界对数据的访问方式都是统一的，这使得访问简单 & 高效

对于内容使用者来说不需要关注数据源，若数据源发生改变也不会影响现有逻辑；