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开发相关文章

转自http://blog.csdn.net/flowingflying/article/details/9217431