contentprovider使用方法

数据库和ContentProvider已经折磨我好久了，我今天得把它拿下，至少让他不再影响我工作了。

涉及到的类包括：ContentProvider、 Content Provider、 ContentReslover 、ContentValues、Cursor 等，以及前面谈到的数据库等。

ContentValues是用于存储ContentResolver处理的值。如，Contentvalues.put(String key,String value),将一个字符串值存入键中，形成键值中，同理，可以将一个record的各个列的数据存入ContentValue，然后插入到provider的表中。同样，可以进行其他操作，如取出对应键的值get（)。详见SDk。

ContentResolver用于访问content模型，其实就是访问和操作contentprovider。contentProvider一般不直接对其访问，而是间接地通过ContentResolver访问。有对provider的操作方法：insert、getType、delete、query、update等。

Cursor类，游标。应用时一般通过查询query得到。可进行行之间或列之间操作，说白一点，就是能够指到数据库的任何位置。

最后详细讲content Provider。它最大的特点是应用之间共享数据的唯一方式，如果不是共享，大可不必用，而用其他如file、SQLite等。Android的Content Provider也已定义了很多现有的provider，在android.provider包中。

使用时首先获取Content Resolver：

ContentResolver cr = getContentResolver();

然后再使用contentResolver的方法与provider交互。

URIs 字面意思是统一资源标识符。即为一种资源分配一个标识符，唯一的，跟身份证一样。分为三部分

第一部分，content://，机制，表示是provider的Uri。

第二部分，authority，标识了provider，此provider的鉴权，在AndroidManifest中会用到。当有client应用要访问此provider时，如果authority不同时，是不能访问的。如，MediaStore，authority就是media，就说说content://media就可以找到MediaStore。

provider下面可以包括很多表，即包括很多类型的表格，这就需要path。

第三部分，path。SDK中定义path是 the content provider uses to determine what kind of data isbeing requested。还是以MediaStore为例，playlist类MediaStore.Audio.playlist的Path为content://media/external/audio/playlist，数据类型即表格的MIME为 "vnd.android.cursor.dir/playlist" 。每一种表格对应着一种CONTENT_TYPE。

第四部分，ID。对应着每一个record记录，也就是表的每一行。

其实根据SDK的介绍，Android defines CONTENT_URI constants for all the providers that come with the platform，每个表格都是一个provider。

查询------

查询一个provider，可以使用ContentResolver.query()或 Activity.managedQuery()方法。这里只介绍前一种吧。

query的参数：

第一个参数是要查询的provider的Uri。


如果只查询一个record，在path后面跟上record的id，如content://. . . ./23。有两种方法 ContentUris.withAppendedId() and Uri.withAppendedPath()，举例说明

import android.provider.Contacts.People;
import android.content.ContentUris;
import android.net.Uri;
import android.database.Cursor;

// 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。可以理解为对列的过滤。

第三个参数可以理解为对行的过滤。相当于sql的where语句，如果返回全部行，置为null。

第四个参数，selection argment。

第五个参数，对返回行的排序。举例说明

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,                //uri
                         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，返回一个或多个数据库记录。从Cursor对象中读取返回的数据。

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());

    }
 //这里发现了一点麻烦之处，即先根据列名获得索引，然后根据索引获得相关列的值。

如果返回的是二进制数据，如image、audio或video，此列的值可能是二进制数据，或者是Uri，指向具体的流数据。

修改数据--------

包括：添加新的记录

给已有记录

删除记录

批更新已有数据

添加新的纪录：

使用ContentValues。将各个列的值put到里面去，然后用ContentResolver.insert()，参数是provider的uri和contentvalues map。此方法返回新纪录的Uri — that is, the provider's URI with the appended ID for the new record.举例：

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);

批更新：

调用ContentResolver.update()

删除：

调用{ContentResolver.delete() ，with the URI of a specific row.

而如果要删除多个记录，调用ContentResolver.delete()， with the URI of the type of record to delete