Android 数据存储04之Content Provider

Content Provider

版本	修改内容	日期	修改人
V1.0	原始版本	2013/2/25	skywang

 

 

 

 

1 URI

通用资源标志符（Universal Resource Identifier, 简称"URI"）。

URI由许多部分所组成，示例及解说如下：

 

 

2 Content URIs

Content URIs就是Android遵照URI的标准，定义的一种专用的URI。Android提供了ContentUris、UriMatcher类来操作Content URIs。

 

2.1 Content URIs说明

Content URIs的语法如下：

content://authority/path/id

 

Content URIs的示例及说明如下：

 

 

content:

Content URIs前缀，它对应与标准URI的scheme。它的值为ContentResolver.SCHEME_CONTENT(即，content://)。

authority

一个唯一的标识符，Google建议使用类的全名来作为authority。外部调用者可以根据这个标识来找到它。

path

它可以用来表示我们要操作的数据，外部调用者根据这个路径信息来判断要返回什么类型的数据。这个后缀路径可以自由定义。

id

唯一的数字标识符。它表示要具体操作的数据类型中的具体某一项。

 

2.2 Content URIs API说明

 

 

2.3示例

参考“3.3示例”

 

3 UriMatcher

3.1 UriMatcher介绍

UriMatcher用于匹配Uri。
用法如下：
（01）把你需要匹配Uri路径全部给注册上。
（02）注册后，就可以使用sMatcher.match(uri)方法对输入的Uri进行匹。如果匹配就返回匹配码，匹配码是注册时调用 addURI()方法传入的第三个参数；否则，返回-1(即UriMatcher.NO_MATCH)。

 

3.2 UriMatcher API说明

 

 

3.3 示例

package com.yarin.Android.HelloAndroid; 
 
import android.util.Log; 
import android.app.Activity; 
import android.content.ContentUris;   
import android.content.UriMatcher;   
import android.content.ContentResolver; 
import android.net.Uri;   
import android.os.Bundle;   
 
public class HelloAndroid extends Activity { 
           
    private static final String TAG = "skywang-->HelloAndroid"; 
 
    private static final String AUTHORITY = "com.yarin.Android.HelloAndroid";   
    private static final String SCHEME_CONTENT = ContentResolver.SCHEME_CONTENT + "://" ; 
    private static final int PEOPLE = 1;   
    private static final int PEOPLE_ID = 2;   
       
    //NO_MATCH表示不匹配任何路径的返回码   
    private static final UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);   
 
    static   
    {   
        uriMatcher.addURI(AUTHORITY, "people", PEOPLE); 
           
        //这里的#代表匹配任意数字，另外还可以用*来匹配任意文本   
        uriMatcher.addURI(AUTHORITY, "people/#", PEOPLE_ID); 
    }   
       
    @Override   
    protected void onCreate(Bundle savedInstanceState) {   
        super.onCreate(savedInstanceState);   
           
        Uri uri = Uri.parse(SCHEME_CONTENT+ AUTHORITY + "/people"); 
        Uri uriAP = uri; 
        Log.d(TAG, "Uri=" + uri); 
        Log.d(TAG, "Uri.type=" + getType(uri)); 
           
        uri = Uri.parse(SCHEME_CONTENT + AUTHORITY + "/people" + "/2");   
        Log.d(TAG, "Uri=" + uri); 
        Log.d(TAG, "Uri.type=" + getType(uri)); 
           
        // 添加ID 
        uri = ContentUris.withAppendedId(uriAP, 15);   
        Log.d(TAG, "Uri=" + uri); 
        // 获取ID   
        long id = ContentUris.parseId(uri);   
        Log.d(TAG, "Uri ID: " + id);   
    }   
       
    private String getType(Uri uri) {   
        int match = uriMatcher.match(uri);   
        switch (match)   
        {   
            case PEOPLE:   
                return "vnd.android.cursor.dir/person";   
            case PEOPLE_ID:   
                return "vnd.android.cursor.item/person";   
            default:   
                return null;   
        }   
    }   
} 

打印信息如下：

D/skywang-->HelloAndroid( 2131): Uri=content://com.yarin.Android.HelloAndroid/people

D/skywang-->HelloAndroid( 2131): Uri.type=vnd.android.cursor.dir/person

D/skywang-->HelloAndroid( 2131): Uri=content://com.yarin.Android.HelloAndroid/people/2

D/skywang-->HelloAndroid( 2131): Uri.type=vnd.android.cursor.item/person

D/skywang-->HelloAndroid( 2131): Uri=content://com.yarin.Android.HelloAndroid/people/15

D/skywang-->HelloAndroid( 2131): Uri ID: 15

 

4 Content Provider

4.1 Content Provider介绍

如何将应用程序的数据暴露出去？ Android提供了ContentProvider，一个程序可以通过实现一个Content provider的抽象接口将自己的数据完全暴露出去，而且Content providers是以类似数据库中表的方式将数据暴露。

如何通过一套标准及统一的接口获取其他应用程序暴露的数据？Android提供了ContentResolver，外界的程序可以通过ContentResolver接口访问ContentProvider提供的数据。

 

ContentResolver是通过URI来查询ContentProvider中提供的数据。除了URI以外，还必须知道需要获取的数据段的名称，以及此数据段的数据类型。如果你需要获取一个特定的记录，你就必须知道当前记录的ID，也就是URI中ID部分。

 

4.2 Content Provider示例

代码地址：http://pan.baidu.com/share/link?shareid=305825&uk=3993336582

说明：

代码包括两部分（继承Content Provider的类的实现 和 它对应的测试类）

第一部分源码：MyProvider/src/com/skywang/myProvider/MyProvider.java

                   MyProvider/src/com/skywang/myProvider/utils/Util.java

第二部分源码：MyProvider/tests/src/com/test/MyProviderTests.java

打印信息如下：

D/skywang-->MyProvider( 3016): open/create table skywang_myprovider.db

D/skywang-->MyProvider( 3016): insert uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): insert uri=content://com.skywang.myProvider/table_01/1

D/skywang-->MyProvider( 3016): insert uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): insert uri=content://com.skywang.myProvider/table_01/2

D/skywang-->MyProvider( 3016): insert uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): insert uri=content://com.skywang.myProvider/table_01/3

D/skywang-->MyProvider( 3016): insert uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): insert uri=content://com.skywang.myProvider/table_01/4

D/skywang-->MyProviderTests( 3003): print all value!

D/skywang-->MyProvider( 3016): query ITEM uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): printAll--0--, email=Jimmy20020201@126.com, username=Jimmy, date=20020201, sex=MAIL

D/skywang-->MyProviderTests( 3003): printAll--1--, email=kate20030104@163.com, username=Kate, date=20030104, sex=FEMAIL

D/skywang-->MyProviderTests( 3003): printAll--2--, email=lilei20101124@gmail.com, username=Li Lei, date=20021124, sex=MAIL

D/skywang-->MyProviderTests( 3003): printAll--3--, email=lucy20101124@gmail.com, username=Lucy, date=20010624, sex=FEMAIL

D/skywang-->MyProvider( 3016): query ITEM_ID id=2, uri=content://com.skywang.myProvider/table_01/2

D/skywang-->MyProviderTests( 3003): querySecondItem--0--, email=kate20030104@163.com, username=Kate, date=20030104, sex=FEMAIL

D/skywang-->MyProvider( 3016): update ITEM_ID uri=content://com.skywang.myProvider/table_01/1, count=1

D/skywang-->MyProviderTests( 3003): print all value!

D/skywang-->MyProvider( 3016): query ITEM uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): printAll--0--, email=update_email, username=update_name, date=update_date, sex=update_sex

D/skywang-->MyProviderTests( 3003): printAll--1--, email=kate20030104@163.com, username=Kate, date=20030104, sex=FEMAIL

D/skywang-->MyProviderTests( 3003): printAll--2--, email=lilei20101124@gmail.com, username=Li Lei, date=20021124, sex=MAIL

D/skywang-->MyProviderTests( 3003): printAll--3--, email=lucy20101124@gmail.com, username=Lucy, date=20010624, sex=FEMAIL

D/skywang-->MyProviderTests( 3003): delete uri=content://com.skywang.myProvider/table_01/1

D/skywang-->MyProvider( 3016): delete ITEM_ID id=1, uri=content://com.skywang.myProvider/table_01/1, count=1

D/skywang-->MyProviderTests( 3003): print all value!

D/skywang-->MyProvider( 3016): query ITEM uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): printAll--0--, email=kate20030104@163.com, username=Kate, date=20030104, sex=FEMAIL

D/skywang-->MyProviderTests( 3003): printAll--1--, email=lilei20101124@gmail.com, username=Li Lei, date=20021124, sex=MAIL

D/skywang-->MyProviderTests( 3003): printAll--2--, email=lucy20101124@gmail.com, username=Lucy, date=20010624, sex=FEMAIL

D/skywang-->MyProvider( 3016): delete ITEM uri=content://com.skywang.myProvider/table_01, count=1

D/skywang-->MyProviderTests( 3003): print all value!

D/skywang-->MyProvider( 3016): query ITEM uri=content://com.skywang.myProvider/table_01

D/skywang-->MyProviderTests( 3003): printAll--0--, email=lilei20101124@gmail.com, username=Li Lei, date=20021124, sex=MAIL

D/skywang-->MyProviderTests( 3003): printAll--1--, email=lucy20101124@gmail.com, username=Lucy, date=20010624, sex=FEMAIL

D/skywang-->MyProviderTests( 3003): delete all value!

D/skywang-->MyProvider( 3016): delete ITEM uri=content://com.skywang.myProvider/table_01, count=2

D/skywang-->MyProviderTests( 3003): print all value!

D/skywang-->MyProvider( 3016): query ITEM uri=content://com.skywang.myProvider/table_01

 

 参考文献：

1，Android API文档

2，contentprovider的学习实例总结：http://www.cnblogs.com/chenglong/articles/1892029.html

3，Android实现数据存储技术：http://www.cnblogs.com/hanyonglu/archive/2012/03/01/2374894.html