[移动开发]使用Content Provider实现数据共享

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

1 Content Provider概述

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

ContentResolver resolver = getContentResolver();

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

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

(1)数据模型

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

查询返回一个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个抽象方法：

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

(2)声明Content Provider

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

<provider
    android: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如下：

代码如下：
MainActivity.java

public class MainActivity extends AppCompatActivity {
    private final String TAG = "ContentProvider";
    // 希望获得姓名
    private String columns = ContactsContract.Contacts.DISPLAY_NAME;


    @Override
    protected 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");
        }
        // 关闭Cursor
        cursor.close();
        Log.d(TAG, "2 sb:" + sb);
        return sb.toString();
    }
}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns: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">


    <TextView
        android: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">


    <application
        android: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>