Loading...
墨滴

帅次

2021/07/08  阅读:189  主题:全栈蓝

Android-ContentProvider详解

Android提供了5种方式来让用户保存持久化应用程序数据。根据自己的需求来做选择,比如数据是否是应用程序私有的,是否能被其他程序访问,需要多少数据存储空间等,分别是:

  1. 使用SharedPreferences存储数据
  2. 文件存储数据
  3. SQLite数据库存储数据
  4. 使用ContentProvider存储数据
  5. 网络存储数据

咱们今天就来学习一下ContentProvider。作为Android四大巨头之一的他有点名不副实,因为在一般的开发过程中,使用的次数比较少。大部分应用的数据缓存用SharedPreferences就能搞定了。

ContentProvider(数据提供者)是应用程序之间共享数据的一种接口机制,是一种更为高级的数据共享方法。

ContentProvider可以指定需要共享的数据,而其他应用程序则可以在不知道数据来源、路径的情况下,对共享数据进行增删改查等操作。

在Android系统中,许多Android系统内置的数据也是通过ContentProvider提供给用户使用,例如通讯录、音视频文件和图像文件等。

什么是ContentProvider

  • ContentProvider是Android的四大组件之一,以标准化的方式在Android 应用间共享数据。
  • ContentProvider封装的数据存储以及增删改查等,并且必须实现一个对外统一的接口(Uri)。

什么是Uri

Uri(通用资源标识符 Universal Resource Identifer),代表数据操作的地址,每一个ContentProvider都会有唯一的地址。

ContentProvider使用的Uri语法结构如下:

content://authority/data_path/id
  • content:// 是通用前缀,表示该Uri用于ContentProvider定位资源。
  • authority 是授权者名称,用来确定具体由哪一个ContentProvider提供资源。因此一般authority都由类的小写全称组成,以保证唯一性。
  • data_path 是数据路径,用来确定请求的是哪个数据集。
  • id 是数据编号,用来请求单条数据。如果是多条这个字段忽略。

样例:

content://com.scc.userprovider/user多条
content://com.scc.userprovider/user/10单条

什么是ContentResolver

  • ContentResolver是数据调用者,ContentProvider将数据发布出来,通过ContentResolver对象结合Uri进行调用。
  • 一般来说ContentProvider是单例模式,多个应用可通过ContentResolver调用ContentProvider的增删改查操作数据,ContentResolver调用的数据操作会让同一个ContentProvider处理。

创建ContentProvider

  1. 创建一个类让其继承ContentProvider,并重载6个函数

需要实现的主要方法是:

  • insert()delete()update()query():用于对数据集的增删改查操作。
  • onCreate():一般用来初始化底层数据集和建立数据连接等工作
  • getType():用来返回指定Uri的MIME数据类型,
    • 若Uri是单条数据,则返回的MIME数据类型以vnd.Android.cursor.item开头;
    • 若Uri是多条数据,则返回的MIME数据类型以vnd.android.cursor.dir/开头。

数据访问方法如insert(Uri,ContentValues)和update(Uri,ContentValues,Bundle) 可以同时从多个线程调用,并且必须是线程安全的。其他方法如onCreate() 仅从应用程序主线程调用,并且必须避免执行冗长的操作。请参阅其预期线程行为的方法描述。

  1. 声明Uri规则,实现UriMatcher

咱先来看看UriMatcher是干嘛的,UriMatcher本质上是一个文本过滤器,有助于解析Uri,用在ContentProvider中帮助我们过滤,分辨出查询者想要查询哪个数据表。

UriMatcher的构造函数中,UriMatcher.NO_MATCH是Uri无匹配时的返回代码,值为-1。addUri()方法用来添加新的匹配项,语法为:

public void addUri(String authority, String path, int code)
  • authority表示匹配的授权者名称;
  • path表示数据路径;
  • code表示返回代码。

下面咱搞个实例:

//这里的名称必须与AndroidManifest.xml中android:authorities保持一致
public static final String AUTHORITY = "com.scc.userprovider";
//数据路径
public static final String PATH_USERS = "user";
//访问ContentProvider的URL
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/" + PATH_USERS);
//返回代码
public static final int USER_INFO = 1;
//创建UriMatcher对象
private static UriMatcher uriMatcher;
//创建静态代码块
static {
    //实例化UriMatcher对象
    uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    //参数1:authority;参数2:路径;参数3:自定义代码
    uriMatcher.addURI(UserInfoContent.AUTHORITY, UserInfoContent.PATH_USERS, USER_INFO);
}
  1. 注册ContentProvider

在AndroidManifest.xml文件中的 application节点下使用标签注册。样例:

<!--
android:name指定ContentProvider实现的类名
android:authorities指定ContentProvider对应Uri(相当于ContentProvider分配一个域名)
android:exported指定ContentProvider是否允许其他应用调用。
如果将该属性设置为true,则允许其他应用调用-->
<android:authorities="com.scc.userprovider"
    android:name=".UserProvider"
    android:exported="true"/>

使用ContentProvider

  1. 通过insert()方法添加单条数据
ContentValues cv = new ContentValues();
cv.put(UserInfoContent._ID, bean.get_id());
cv.put(UserInfoContent.USER_NAME, bean.getName());
cv.put(UserInfoContent.USER_AGE, bean.getAge());
cv.put(UserInfoContent.USER_UPDATE_TIME, bean.getUpdate_time());
Uri uri = getContentResolver().insert(UserInfoContent.CONTENT_URI, cv);
Log.e(getClass().getName(), "insert:" + uri);
  • 通过bulkInsert()方法添加多条数据
ContentValues[] arrayValues = new ContentValues[10];
//实例化每一个ContentValues...
int count = getContentResolver().bulkInsert(UserInfoContent.CONTENT_URI, arrayValues);
  1. 指定ID删除单条数据
int delete = getContentResolver().delete(UserInfoContent.CONTENT_URI, "_id=12"null);
Log.e(getClass().getName(), "delete(失败返回-1):" + delete);
  • 通过selection语句删除多条数据
String selection = UserInfoContent._ID + ">12";
int result = getContentResolver().delete(UserInfoContent.CONTENT_URI, selection, null);
  1. 修改数据
UserInfoBean bean = new UserInfoBean("蚩尤"32"12:00");
ContentValues cv = new ContentValues();
cv.put(UserInfoContent.USER_NAME, bean.getName());
cv.put(UserInfoContent.USER_AGE, bean.getAge());
cv.put(UserInfoContent.USER_UPDATE_TIME, bean.getUpdate_time());
getContentResolver().update(UserInfoContent.CONTENT_URI, cv, "_id=18"null);
  1. 查询数据
Cursor cursor = getContentResolver().query(UserInfoContent.CONTENT_URI, null, selection, nullnull);
//循环取出游标指向的每条用户记录
while (cursor.moveToNext()) {
    UserInfoBean user = new UserInfoBean();
    user.name = cursor.getString(cursor.getColumnIndex(UserInfoContent.USER_NAME));
    user.age = cursor.getInt(cursor.getColumnIndex(UserInfoContent.USER_AGE));
    user._id = cursor.getString(cursor.getColumnIndex(UserInfoContent._ID));
    user.update_time = cursor.getString(cursor.getColumnIndex(UserInfoContent.USER_UPDATE_TIME));
    userList.add(user); //添加到用户信息列表
}
cursor.close(); //关闭数据库游标
Log.e(getClass().getName(), "Query用户:" + String.format("当前共找到%d个用户", userList.size()));

跨应用使用ContentProvider

跨应用和本应用使用ContentProvider一样的方法,这边就不做复制了。

例5的Uri是拼接字段,但是拼接后的结果 content://com.scc.userprovider/user。

跨平台使用getContentResolver().方法 的第一个参数:

Uri uricontent = Uri.parse("content://com.scc.userprovider/user");

  1. 新增数据+查找数据

  2. 修改数据+删除数据

java.lang.SecurityException: Permission Denial: opening provider com.scc.cp.UserProvider from ProcessRecord

解决方案:

在AndroidManifest.xml文件中的 application节点下使用 标签注册时android:exported="false"时,不允许其他应用调用。所以其他和应用使用ContentProvider会崩溃报错。将exported改为:android:exported="true"即可。

帅次

2021/07/08  阅读:189  主题:全栈蓝

作者介绍

帅次

公众号:帅次