Pro Android学习笔记（六）：了解Content Provider（中）

Content Provider的架构

Authority类似web中的域名，每个content provider会通过AndroidManifest.xml向系统注册authority，如下。其中name是类名，即如何找寻这个content provider。可以省去AndroidManifest.xml中package name，不需要写完整的类名。如android:name=".BookProvider"。

<provider android:name="SomeProvider"  android:authorities="com.your-company.SomeProvider" />
<provider android:name="NotePadProvider" android:authorities="com.google.provider.NotePad" />

和web的URL域名类似，content provider进行数据访问的URL为content://authority/......，例如content://com.your-company.SomeProvider/。对于Android自己提供的content provider，有时会写的比较简单，例如用contacts来代替com.google.android.contacts，如content://contacts/……。

有时注册的provider会比较复杂，例如Android的联系人信息，其uri为content://com.android.contacts/contacts，其源代码信息为如下，该provider需要读写权限。

<provider android:name="ContactsProvider2"
    android:authorities="contacts;com.android.contacts"
    android:label="@string/provider_label"
    android:multiprocess="false"
    android:readPermission="android.permission.READ_CONTACTS"
    android:writePermission="android.permission.WRITE_CONTACTS">
    <path-permission
            android:pathPrefix="/search_suggest_query"
            android:readPermission="android.permission.GLOBAL_SEARCH"/>
    <path-permission
            android:pathPrefix="/search_suggest_shortcut"
            android:readPermission="android.permission.GLOBAL_SEARCH"/>
    <path-permission
            android:pathPattern="/contacts/.*/photo"
            android:readPermission="android.permission.GLOBAL_SEARCH"/>
    <grant-uri-permission android:pathPattern=".*" />
</provider>

Content URI的结构。Android通过Content URI来获取数据，并返回具有行列结构的游标cursor。content UI的格式为：

content://<authority-name>/<path-segment1>/<path-segment2>/etc…
例子：content://com.google.provider.NotePad/notes/23

例子的/notes表示collection，或理解为一个目录，称为path segment，而/23表示特定的item，是具体的index，content provider提供的是二维数据，这就是该row的_id值。

MIME Type。HTTP响应会带有MIME Type，最长江就是text/html，告知body的数据类型。Content Provider也一样，可以用方法获得MIME。MIME由两部分组成：type/subtype，具体可以参考rfc2046。type和subtype的定义可以在IANA中查到。下面是MIME的几个例子：

text/xml
application/rtf
application/vnd.ms-excel  //vnd是vendeor-specific，厂家自定义格式，如此处的微软excel格式
application/x-tar                //x-表示自定义的私有格式

在Content Provider中可以存在多层目录，即存在item和collection，相应地分别有item的MIME tye和collection的MIME type。Android采用namespace的方式定义type和subtype。如下：

vnd.android.cursor.item/vnd.<yourcompanyname.contenttype> 是item的MIME type
vnd.android.cursor.dir/vnd.<yourcompanyname.contenttype>是collection的MIME type

从上面的格式可以看到，type已指定，开发者只能对subtype进行设置。

定义清晰描述。我们应该为所创建的content provider提供清晰的定义或描述，可通过所使用的Uri进行constant的预定义。例如MediaStore.Images.Media.INTERNETAL_CONTENT_URI表示content://media/internal/images。同时我们也应为个列

小例子：读取联系人信息。Provider通过uri去访问，返回游标（cursor），我们将通过下面的小例子进行验证，先进行Uri的了解，然后对cursor进行二次轮询，一次采用while，一次采用for方式。正如前面的contact provider在xml的定义所示，有读写权限限制，因此在XML中应赋予相应的权限：<uses-permission android:name="android.permission.READ_CONTACTS" />

private void contentProviderTest(){         /* Contact的内容很多，我们只选取部分列名字，相当于SELECT xxxx FROM ....中的xxxx。如果是自己创建创建的Content Provider，也应当采用constant的方式了明晰表示每项的内容*/         String[] contactProjection = new String[]{                 Contacts._ID,    /* 每一行都有一个唯一的_id来表示 */                 Contacts.DISPLAY_NAME_PRIMARY         };                /* 下面是一些uri的操作，作为测试，通过provider的Uri都会提供constant的方式 */         Uri peopleBaseUri = ContactsContract.Contacts.CONTENT_URI;         showInfo(peopleBaseUri.toString());  //showInfo( )信息显示，我将在TextView中呈现内容         Uri myPersonUri = Uri.withAppendedPath(peopleBaseUri, "1");         showInfo(myPersonUri.toString());                   /* managedQuery( )从Content Provider读取数据，返回Cursor          * 第1参数：Uri uri表示URI；           * 第2参数：String[] projection表示所需读取的信息；          * 第3参数：String selection数是限制条件，类似SQL中的WHERE，但去掉了“WHERE”；          * 第4参数：String[] selectionArgs和第3个参数配合使用，具体描述第三个参数中的“？”为何；          * 第5参数：String sortOrder，类似于SQL中的ORDER BY */         @SuppressWarnings("deprecation") //在API Level 11，也就是Android3.0后由CursorLoader替代，为了不使Eclipse报警告，我们先在此禁止警告。看到Eclipse有个小三角的告警说明，觉得不舒服，干掉它。^_^         Cursor cur = managedQuery(ContactsContract.Contacts.CONTENT_URI,                                 contactProjection,                                 null,                                 null,                                 null);         showInfo("query Contacts get cursor : " + cur);        showInfo("cursor has " + cur.getCount() + " rows.");                 // 轮询方式一：  通过while         showInfo("read from cursor");         //游标是rows的集合，首先需要使用moveToFirst()，因为query后游标是位于第一行的前面。返回false，表示为空。         if(!cur.moveToFirst()){             showInfo("no rows. It's empty");             cur.close();             return;         }                 //游标可以前后移动，去可以查看不同行的数据，还可以指定特定的行，它的移动非常灵活。游标对数据的获取是基于column number，可通过列名来获取。          int nameColumnIndex = cur.getColumnIndex(Contacts.DISPLAY_NAME_PRIMARY);          showInfo("\t Name: " + cur.getString(nameColumnIndex));         while(cur.moveToNext()){              showInfo("\t Name: " + cur.getString(nameColumnIndex));         }                 //轮询方式二：通过for          showInfo("read from cursor again");         for(cur.moveToFirst(); !cur.isAfterLast(); cur.moveToNext()){             String name = cur.getString(nameColumnIndex);             showInfo("\t Name: " + name);         }                 cur.close();     }

Where条件的用法。查找特定的数据，可以利用Uri，也可以利用manageQuery()方法的参数。例如希望查询select * from notes where _id=23，利用Uri，可以设置为

String noteUri = “content://com.google.progider.NotePad/notes/23”;

利用manageQuery( )中的selection擦数，同样可以表达为

managedQuery(uri, //为"content://com.google.provider.NotePad/notes"
                          null, 
                          "_id=?" ,
                          new String[] {23} , 
                          null);

增加、修改、删除数据。增删改查是数据读写的四大功能，我们将在后面的小例子中给出详细的说明。

相关链接： 我的Android开发相关文章