第六章 访问ContentProvider共享数据

内容提供器Content Provider       //Provider    n. 供应者；养家者

      主要用于在不同的应用程序之间实现数据共享功能

 

用法:    1.使用现有的内容提供器来读取和操作相应程序中的数据

          

 

      通过ContentResolver实现增删改查。 //resolver  n. 溶剂；[电子] 分解器；下决心者

           ContentResolver contentResolver = context.getContentResolver

 

      通过URI来指明所要操作的数据；

           增删改查方法基本类似与SQLiteDatabase中的增删改差，只不过把第一个参数改为了URI。

 

      查询数据:

           通过ContentResolver的query()方法返回一个Cursor对象

           @Nullable Cursor query(@NonNull Uri uri, @Nullable String[] projection,

            @Nullable String selection, @Nullable String[] selectionArgs,

            @Nullable String sortOrder)

参数:    1. uri 查询某个程序下的某一张表

           2. projection 查询的列名     //projection n. 投射；规划；突出；发射；推测

           3. selection where的约束条件

           4.selectionArgs 为where中的占位符提供具体的值

           5.sortOrder 指定查询结果的排序方式

           返回一个Cursor对象

 

      插入数据:

           @Nullable Uri insert(@NonNull Uri url, @Nullable ContentValues values)

           参数:ContentValues  待插入一个ContentValues对象类型的新纪录

           返回新纪录的Uri

 

      修改数据:

           int update(@NonNull Uri uri, @Nullable ContentValues values,

            @Nullable String where, @Nullable String[] selectionArgs)

           参数:   @Nullable ContentValues values  待修改的记录值

                      @Nullable String where              指定匹配记录的条件

                      @Nullable String[] selectionArgs  指定where中占位符的值

           返回被修改记录的条数

 

      删除数据:

           int delete(@NonNull Uri url, @Nullable String where,

            @Nullable String[] selectionArgs)

           参数:    @Nullable String where                    指定匹配记录的条件

                      @Nullable String[] selectionArgs  指定where中占位符的值

           返回被删除记录的条数

 

 

           读取系统联系人案例代码:

/**
 * 获得联系人信息并放入contactsList
 */
private void readContacts()
{
    Cursor cursor = null;// cusor n. 游标

    /**
     * 查询联系人数据放入cusor中
     *  参数:    1. uri 查询某个程序下的某一张表 
     *      2. projection 查询的列名     //projection n. 投射；规划；突出；发射；推测 
     *      3. selection where的约束条件 
     *      4.selectionArgs 为where中的占位符提供具体的值 
     *      5.sortOrder 指定查询结果的排序方式
     */
    Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
    ContentResolver contentResolver = getContentResolver();
    cursor = contentResolver.query(uri, null, null, null, null);
    try
    {
        while (cursor.moveToNext())
        {
            // 获取联系人姓名
            String name = cursor.getString(cursor.getColumnIndex(
                            ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
            // 获取联系人手机号
            String number = cursor.getString(cursor.getColumnIndex(
                    ContactsContract.CommonDataKinds.Phone.NUMBER));

            contactsList.add(name + " " + number);
        }

    } catch (Exception e)
    {
        e.printStackTrace();
    } finally
    {
        // 关闭cursor
        if (cursor != null)
        {
            cursor.close();
        }
    }
}

 

 

**注意:在AndroidManifest.xml中声明读取系统取联系人权限

<!-- 声明读取系统取联系人权限 -->

<uses-permission android:name="android.permission.READ_CONTACTS"/>

            

 

          

          

          

用法:    2.创建自己的内容提供器给我们程序的数据提供外部接口