[2021.11.20]使用ContentProvider实现数据共享

Content Provider用于在不同的应用程序之间实现数据共享。应用程序使用一个ContentResolver对象去操作指定数据。

1 Content Provider概述

Content Provider实现一组通用的方法，用来提供数据的增、删、改、查功能。
应用程序通过调用Activity或其他组件类的getContentResolver()方法来获得ContentResolver对象。例如：

ContentResolver resolver = getContentResolver();

通常，ContentProvider仅有一个实例，该实例能与不同应用程序(不同进程)的多个ContentResolver类对象通信。

使用Content Provider时，通常会用到以下两个概念：

(1)数据模型

使用基于数据库模型的简单表格来记录数据。例如：

_ID	NAME	NUMBER
001	xxx	187xxxxxxxx
002	yyy	156yyyyyyy
003	zzz	131zzzzzzz

查询返回一个Cursor对象，它能遍历各行各列来读取各个字段的值。

(2)URI

每个Content Provider提供URI以唯一标识其数据集。
每个ContentResolver方法使用URI作为其第一个参数，它标识ContentResolver应该使用哪个provider及其中的哪个表格。
下面是Content URI组成：

content://com.android.contacts/contacts/001

[1]content:
标准前缀，表示该数据由Content Provider管理
[2]com.android.contacts:
URI的权限部分，不同应用程序不同。
[3]contacts/001:
用于指定要操作的数据，001表示被请求的特定记录的ID。

2 创建Content Provider

要创建Content Provider，需要：
(1)继承ContentProvider类来提供数据访问方式。
(2)在应用程序的AndroidManifest文件中声明Content Provider。

(1)继承ContentProvider类

意味着要实现ContentProvider类的6个抽象方法：

方法	说明
onCreate()	用于初始化provider
query()	返回数据给调用者
insert()	插入新数据
update()	更新数据
delete()	删除数据
getType()	返回数据MIME类型

由于这些ContentProvider方法能被不同线程或进程的ContentResolver对象调用，所以它们必须以线程安全的方式实现。

(2)声明Content Provider

即在AndroidManifest.xml中定义<provider>元素：

<providerandroid:name = "com.hyh.TestProvider"android.authorities = "com.hyh.testprovider".../>
</provider>

name属性的值是ContentProvider类的子类的名称。
authorities属性是provider定义的content:URI中的authority部分。

3 使用Content Provider

Android系统为常用数据类型提供了预定义的Content Provider，它们大都位于android.provider包中。常见Content Provider如下：

名称	说明
Browser	浏览器信息
CallLog	通话历史信息
Contacts	联系人信息
LiveFolders	由ContentProvider提供内容的特定文件夹
MediaStore	多媒体信息(声音，视频，图片)
Setting	系统设置
SearchRecentSuggestions	为应用程序创建简单的查询建议
UserDictionary	在可预测文本输入时，提供用户定义的单词给输入法使用

代码如下：
MainActivity.java

public class MainActivity extends AppCompatActivity {private final String TAG = "ContentProvider";// 希望获得姓名private String columns = ContactsContract.Contacts.DISPLAY_NAME;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);if(ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED){ActivityCompat.requestPermissions(MainActivity.this, new String[]{ Manifest.permission.READ_CONTACTS}, 1);}setContentView(R.layout.activity_main);// 获得布局文件中的TextView组件TextView tv = (TextView) findViewById(R.id.result);// 为TextView设置数据tv.setText(getQueryData());// Textview添加滚动条tv.setMovementMethod(ScrollingMovementMethod.getInstance());}// 创建getQueryData()方法，实现获取通讯录信息private CharSequence getQueryData() {// 用于保存字符串StringBuilder sb = new StringBuilder();// 获得ContentResolver对象ContentResolver resolver = getContentResolver();// 查询记录Cursor cursor = resolver.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);// 获得姓名记录的索引值int displayNameIndex = cursor.getColumnIndex(columns);// 迭代全部记录for (cursor.moveToFirst(); !cursor.isAfterLast(); cursor.moveToNext()) {String displayName = cursor.getString(displayNameIndex);sb.append(displayName + "\n");}// 关闭Cursorcursor.close();Log.d(TAG, "2 sb:" + sb);return sb.toString();}
}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayoutxmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><TextViewandroid:id="@+id/result"android:layout_width="wrap_content"android:layout_height="wrap_content"android:textSize="@dimen/textSize"android:lineSpacingExtra="@dimen/lineSpacingExtra"android:paddingLeft="@dimen/paddingLeft"android:paddingTop="@dimen/paddingTop"android:scrollbars="vertical"android:singleLine="false"/></RelativeLayout>

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.hyh.contentprovider"><applicationandroid:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:roundIcon="@mipmap/ic_launcher_round"android:supportsRtl="true"android:theme="@style/Theme.ContentProvider"><activity android:name=".MainActivity"><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity></application><uses-permission android:name="android.permission.READ_CONTACTS"/></manifest>