ContentProvider

以下内容整理自互联网，仅用于个人学习

1. ContentProvider介绍

ContentProvider（内容提供者）是Android的四大组件之一，管理android以结构化方式存放的数据，以相对安全的方式封装数据（表）并且提供简易的处理机制和统一的访问接口供其他程序调用。

2. URI

URI（统一资源标识符）代表要操作的数据，可以用来标识每个ContentProvider，这样你就可以通过指定的URI找到想要的ContentProvider,从中获取或修改数据。

Android中URI的格式：
content://com.example.app.provider/table/1

content://： schema，已经由Android所规定为：content://

com.example.app.provider：权限（Authority），是URI的授权部分，是唯一标识符，用来定位ContentProvider。
table：指向一个对象集合，一般用表的名字，如果没有指定后面“1”部分，则返回全部记录。
1：指向特定的记录。

通配符：

*：匹配的任意长度的任何有效字符的字符串。
＃：匹配的任意长度的数字字符的字符串。

content://com.example.app.provider/* 匹配provider的任何内容uri
content://com.example.app.provider/table1/# 匹配table3的所有行

MIME

MIME是指定某个扩展名的文件用一种应用程序来打开，就像你用浏览器查看PDF格式的文件，浏览器会选择合适的应用来打开一样。Android中的工作方式跟HTTP类似，ContentProvider会根据URI来返回MIME类型，ContentProvider会返回一个包含两部分的字符串。

text/html

text/css
text/xml
application/pdf

一个内容URI所对应的MIME字符串主要由三个部分组成，Android对这三个部分做了格式规范：

必须以vnd开头

如果内容URI以路径结尾，则后接android.cursor.dir/，如果内容URI以id结尾，则接android.cursor.item/
最后接上vnd..

每个内容类型的Android MIME类型有两种形式：多条记录（集合）和单条记录。

//集合记录 
vnd.android.cursor.dir/自定义 
 
//单条记录  
vnd.android.cursor.item/自定义

vnd表示这些类型和子类型具有非标准的、供应商特定的形式。Android中类型已经固定好了，不能更改，只能区别是集合还是单条具体记录，子类型可以按照格式自己填写。

Android系统提供了两个用于操作Uri的工具类：ContentUris和UriMatcher。

ContentUris

ContetnUris包含一个便利的函数withAppendedId()来向URI追加一个id。

Uri uri = Uri.parse("content://cn.scu.myprovider/user") 
Uri resultUri = ContentUris.withAppendedId(uri, 7);  
//生成后的Uri为：content://cn.scu.myprovider/user/7

同时提供parseId(uri)方法用于从URI中获取ID

Uri uri = Uri.parse("content://cn.scu.myprovider/user/7") 
long personid = ContentUris.parseId(uri); 
//获取的结果为:7

UriMatcher

UriMatcher本质上是一个文本过滤器，用在contentProvider中帮助我们过滤，分辨出查询者想要查询哪个数据表。

使用UriMatcher主要步骤：

初始化

UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH); 
//常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码

注册Uri

//USER 和 USER_ID是两个int型数据 
matcher.addURI("cn.scu.myprovider", "user", USER); 
matcher.addURI("cn.scu.myprovider", "user/#",USER_ID); 
//如果match()方法匹配content://cn.scu.myprovider/user路径，返回匹配码为USER

匹配已经注册的Uri

/*  
 * 如果操作集合，则必须以vnd.android.cursor.dir开头  
 * 如果操作非集合，则必须以vnd.android.cursor.item开头  
 * */   
@Override   
public String getType(Uri uri) {   
Uri uri = Uri.parse("content://" + "cn.scu.myprovider" + "/user");   
    switch(matcher.match(uri)){   
    case USER:   
        return "vnd.android.cursor.dir/user";   
    case USER_ID:   
        return "vnd.android.cursor.item/user";   
    }   
}

3. ContentProvider的主要方法

//ContentProvider创建后或打开系统后其它应用第一次访问该ContentProvider时调用。 
public boolean onCreate() 
 
//外部应用向ContentProvider中添加数据。 
public Uri insert(Uri uri, ContentValues values) 
　　 
//外部应用从ContentProvider删除数据。 
public int delete(Uri uri, String selection, String[] selectionArgs) 
 
//外部应用更新ContentProvider中的数据。 
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)： 
 
//供外部应用从ContentProvider中获取数据。 
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,  
                    String sortOrder)　 
　　 
//该方法用于返回当前Url所代表数据的MIME类型。 
public String getType(Uri uri)

4. ContentResolver

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

//添加 
public Uri insert(Uri uri, ContentValues values)　 
//删除 
public int delete(Uri uri, String selection, String[] selectionArgs)　 
//更新 
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)　 
//获取 
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

示例代码

ContentResolver resolver =  getContentResolver(); 
Uri uri = Uri.parse("content://cn.scu.myprovider/user"); 
 
//添加一条记录 
ContentValues values = new ContentValues(); 
values.put("name", "fanrunqi"); 
values.put("age", 24); 
resolver.insert(uri, values);   
 
//获取user表中所有记录 
Cursor cursor = resolver.query(uri, null, null, null, "userid desc"); 
while(cursor.moveToNext()){ 
   //操作 
} 
 
//把id为1的记录的name字段值更改新为finch 
ContentValues updateValues = new ContentValues(); 
updateValues.put("name", "finch"); 
Uri updateIdUri = ContentUris.withAppendedId(uri, 1); 
resolver.update(updateIdUri, updateValues, null, null); 
 
//删除id为2的记录 
Uri deleteIdUri = ContentUris.withAppendedId(uri, 2); 
resolver.delete(deleteIdUri, null, null);

5. ContentObserver

ContentObserver(内容观察者)，目的是观察特定Uri引起的数据库的变化，继而做一些相应的处理，它类似于数据库技术中的触发器(Trigger)，当ContentObserver所观察的Uri发生变化时，便会触发它。

下面给出一个监听短信的例子

public class MainActivity extends Activity { 
 
    @Override 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_main); 
 
//注册观察者Observser     
this.getContentResolver().registerContentObserver(Uri.parse("content://sms"),true,new SMSObserver(new Handler())); 
 
    } 
 
    private final class SMSObserver extends ContentObserver { 
 
        public SMSObserver(Handler handler) { 
            super(handler); 
 
        } 
 
 
        @Override 
        public void onChange(boolean selfChange) { 
 
 Cursor cursor = MainActivity.this.getContentResolver().query( 
Uri.parse("content://sms/inbox"), null, null, null, null); 
 
            while (cursor.moveToNext()) { 
                StringBuilder sb = new StringBuilder(); 
 
                sb.append("address=").append( 
                        cursor.getString(cursor.getColumnIndex("address"))); 
 
                sb.append(";subject=").append( 
                        cursor.getString(cursor.getColumnIndex("subject"))); 
 
                sb.append(";body=").append( 
                        cursor.getString(cursor.getColumnIndex("body"))); 
 
                sb.append(";time=").append( 
                        cursor.getLong(cursor.getColumnIndex("date"))); 
 
                System.out.println("--------has Receivered SMS::" + sb.toString()); 
  
            } 
        }  
    } 
}

同时可以在ContentProvider发生数据变化时调用 getContentResolver().notifyChange(uri, null)来通知注册在此URI上的访问者。

public class UserContentProvider extends ContentProvider { 
   public Uri insert(Uri uri, ContentValues values) { 
      db.insert("user", "userid", values); 
      getContext().getContentResolver().notifyChange(uri, null); 
   } 
}