Android content provider

检索数据

1、content provider basics

2、检索content provider

3、修改content provider数据

4、创建自己的content provider

 

1、content provider basics

所有的content provider都会实现一个公共的接口

，可以实现对content provider的增删改查

在activity中需要通过接口函数getContentResolver()方法获取

ContentResolver 对象，

 

content provider数据模型

 

content provider的访问

通过content provider的Uri可以访问到数据集，掌管多个数据集（多个数据表）的content provider为每个数据集都提供不同的Uri，所有的Uri都已content://开头，表明该数据由一个content provider掌管。如果定义了一个contentprovider，那么一般要为该content provider的Uri定义一个常量，例如在android平台中为存储联系人电话号码和联系人图片的Uri常量CONTENT_URI，定义的常量值分别为

android.provider.Contacts.Phones.CONTENT_URI 
android.provider.Contacts.Photos.CONTENT_URI

这两个Uri都被 Contacts content provider掌管

Uri常量也是 ContentResolver函数的第一个参数，指明需要访问的目标provider和目标content provider的哪个表，

 

2、检索content provider

检索provider需要的信息

              |---Uri(数据表)

              |---字段名

              |---字段的数据类型

如果指定查询行，需要改行的id

查询content provider可以使用下面两个函数

 ContentResolver.query()

 Activity.managedQuery()

这两个函数参数相同，而且都返回Cursor对象

managedQuery()方法会使activity管理Cursor的生命周期

 

两个函数的参数

第一个参数：provider URI 

如果指定某一条记录，可以将该条记录的_id添加到Uri的后面，例如某条记录的id是123，那么该Uri是

content://. . . ./123

 

有两个助手函数

 ContentUris.withAppendedId() 和 Uri.withAppendedPath()

可以实现在Uri后面添加id，

 

Both arestatic methods that return a Uri object with the ID added

// Use the ContentUris method to produce the base URI for the contact with _ID == 23.
Uri myPerson = ContentUris.withAppendedId(People.CONTENT_URI, 23);

// Alternatively, use the Uri method to produce the base URI.
// It takes a string rather than an integer.
Uri myPerson = Uri.withAppendedPath(People.CONTENT_URI, "23");

// Then query for this specific record:
Cursor cur = managedQuery(myPerson, null, null, null, null);

第二个参数：

字段名：null代表所有字段，否则只会返回字段名指定的字段，android系统为其自己的

Content provider的字段名都提供了常量

第三个参数：

过滤条件：null代表返回所有

第四个参数: Selection arguments

第五个参数：指定返回数据的排序方式，null代表按照默认顺序返回，可能是无序的

一个完整例子

import android.provider.Contacts.People;
import android.database.Cursor;

// Form an array specifying which columns to return. 
String[] projection = new String[] {
                             People._ID,
                             People._COUNT,
                             People.NAME,
                             People.NUMBER
                          };

// Get the base URI for the People table in the Contacts content provider.
Uri contacts =  People.CONTENT_URI;

// Make the query. 
Cursor managedCursor = managedQuery(contacts,
                         projection, // Which columns to return 
                         null,       // Which rows to return (all rows)
                         null,       // Selection arguments (none)
                         // Put the results in ascending order by name
                         People.NAME + " ASC");

返回的结果

读取返回的数据

返回的Cursor对象可能没有数据或者一行或者多行

如果想得到返回结果某行某个字段的值，必须知道该字段的数据类型，

However, for most types, if you call the methodfor reading strings, the Cursor object will give you the String representationof the data

因为返回的Cursor对象对不同的数据类型需要用不同的方法getString(), getInt(), and getFloat(). 读取，方法的参数为整型的字段索引，可以通过getColumnIndex函数根据字段名获得在返回结果中的索引，取得结果示例

import android.provider.Contacts.People;

private void getColumnData(Cursor cur){ 
    if (cur.moveToFirst()) {

        String name; 
        String phoneNumber; 
        int nameColumn = cur.getColumnIndex(People.NAME); 
        int phoneColumn = cur.getColumnIndex(People.NUMBER);
        String imagePath; 
    
        do {
            // Get the field values
            name = cur.getString(nameColumn);
            phoneNumber = cur.getString(phoneColumn);
           
            // Do something with the values. 
            ... 

        } while (cur.moveToNext());

    }
}

ModifyingData

Data kept by a content provider can be modified by:

Adding new records

Adding new values to existing records

Batch updating existing records

Deleting records

 

数据修改是通过ContentResolver中的方法，有时候某个 content providers在写入数据比读取数据需要更严格的权限控制 ，如果没有对content provider的操作权限，函数执行失败

 

 content providers 

主要分为两步：

       |---创建一个map集合对象 ContentValues，并将给该集合赋值，

    |--调用ContentResolver.insert() ，将content provider的Uri和ContentValues集合对象传入，该函数返回插入记录的Uri，即包含了该插入行的id的Uri

import android.provider.Contacts.People;
import android.content.ContentResolver;
import android.content.ContentValues; 

ContentValues values = new ContentValues();

// Add Abraham Lincoln to contacts and make him a favorite.
values.put(People.NAME, "Abraham Lincoln");
// 1 = the new contact is added to favorites
// 0 = the new contact is not added to favorites
values.put(People.STARRED, 1);

Uri uri = getContentResolver().insert(People.CONTENT_URI, values);

 

 

Addingnew values to existing records

对于存在的一条记录，可以给该记录添加新的字段值或者之直接修改字段值，例如为人员记录添加email地址，修改phoneNumber