ContentProvider的使用

　　为了在应用程序之间交换数据，Android提供了ContentProvider，ContentProvider是不同应用程序之间进行数据交换的标准API，当一个应用程序需要把自己的数据暴露给其他应用程序时，该应用程序就可通过提供Contentprovider来实现；其他应用程序就可通过ContentResolver来操作ContentProvider暴露的数据。

　　ContentProvider是以某种Uri的形式对外提供数据，允许其他应用访问或修改数据；其他应用程序使用ContentResolver根据Uri去访问操作指定数据。使用ContentProvider的步骤如下（假设B应用程序要使用A应用程序中的数据）：

1、在A应用程序中的AndroidManifest.xml文件里的application节点里添加以下代码：

<provider
            android:name="com.gnnuit.provider.PersonProvider"
            android:authorities="com.gnnuit.provider.PersonProvider" >
</provider>

　　其中，android:name是自己编写的provider类的全名；android:authorities是外界访问的名字，就相当于为该ContentProvider指定域名。

2、在A应用程序里新建一个PersonProvider类使其继承ContentProvider基类。

　　为了确定ContentProvider实际能处理的Uri，以及确定每个方法中Uri参数所操作的数据，Android系统提供了UriMatcher工具类。UriMatcher工具类主要提供了以下两个方法：

（1）void arrURI(String authority,String path,int code)：该方法用于向UriMatcher对象注册Uri。其中authority和path组合成一个Uri，而code则代表Uri对应的标识码。

（2）int match(Uri uri)：根据前面注册的Uri来判断指定Uri对应的标识码。如果找不到匹配的标识码，该方法将会返回-1。源码如下：

package com.gnnuit.provider;

import com.gnnuit.dao.PersonDao;
import com.gnnuit.db.MyDbHelper;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.net.Uri;
import android.util.Log;

public class PersonProvider extends ContentProvider {
    private static final int ALL_PERSONS = 1;
    private static final int PERSON = 2;
    private static final int HAHA = 3;
    private static final int INSERT = 4;
    private static final int DELETE = 5;
    private static final int UPDATE = 6;
    private static final String TAG = "PersonProvider";
    private MyDbHelper dbHelper;
    // 创建了一个路径的识别器 uriMatcher 默认的返回值,如果没有找到匹配的类型 返回 -1;
    private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
    static {
        // 指定一个路径的匹配规则
        // 如果路径 满足 content://com.gnnuit.provider.PersonProvider/persons 返回值就是(
        // ALL_PERSONS) 1
        matcher.addURI("com.gnnuit.provider.PersonProvider", "persons",
                ALL_PERSONS);
        // 如果路径 满足 content://com.gnnuit.provider.PersonProvider/person/10 返回值就是(
        // PERSON) 2
        matcher.addURI("com.gnnuit.provider.PersonProvider", "person/#", PERSON);
        matcher.addURI("com.gnnuit.provider.PersonProvider", "haha", HAHA);
        matcher.addURI("com.gnnuit.provider.PersonProvider", "insert", INSERT);
        matcher.addURI("com.gnnuit.provider.PersonProvider", "delete", DELETE);
        matcher.addURI("com.gnnuit.provider.PersonProvider", "update", UPDATE);
    }

    /**
     * PeronProvder 内容提供者第一次被创建的时候 调用的方法
     */
    @Override
    public boolean onCreate() {
        dbHelper = new MyDbHelper(getContext());
        return false;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
            String[] selectionArgs, String sortOrder) {
        int result = matcher.match(uri);
        switch (result) {
        case ALL_PERSONS:
            PersonDao dao = new PersonDao(getContext());
            return dao.getAllByCursor();
        case PERSON:
            SQLiteDatabase db = dbHelper.getReadableDatabase();
            if (db.isOpen()) {
                Cursor cursor = db.query("person", projection, selection,
                        selectionArgs, null, null, null);
                return cursor;
            }
        case HAHA:
            Log.i(TAG, "我是哈哈");
            return null;
        default:
            throw new IllegalArgumentException("URI不合法");
        }
    }

    /**
     * 有的时候 我们需要知道内容提供者返回的数据类型 知道返回的数据 是一个集合呀 还是一个单独的条目
     * 
     * 有的时候 告诉调用者 返回的数据是什么样的类型 MIME的数据类型
     */
    @Override
    public String getType(Uri uri) {
        int result = matcher.match(uri);
        switch (result) {
        // 符合 content://com.gnnuit.provider.PersonProvider/persons 代表的返回所有的数据
        case ALL_PERSONS:
            return "vnd.android.cursor.dir/people";
            // content://com.gnnuit.provider.PersonProvider/person/10
        case PERSON:
            return "vnd.android.cursor.item/people";
        default:
            return null;
        }
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        int result = matcher.match(uri);
        if (result == INSERT) {
            SQLiteDatabase db = dbHelper.getWritableDatabase();
            db.insert("person", null, values);
            // 当数据发生改变的时候
            getContext().getContentResolver().notifyChange(uri, null);
            return uri;
        } else {
            throw new IllegalArgumentException("URI不能被识别");
        }
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        int result = matcher.match(uri);
        if (result == DELETE) {
            SQLiteDatabase db = dbHelper.getWritableDatabase();
            // 当数据发生改变的时候
            getContext().getContentResolver().notifyChange(uri, null);
            return db.delete("person", selection, selectionArgs);
        } else {
            throw new IllegalArgumentException("URI不能被识别");
        }
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,
            String[] selectionArgs) {
        int result = matcher.match(uri);
        if (result == UPDATE) {
            SQLiteDatabase db = dbHelper.getWritableDatabase();
            // 当数据发生改变的时候
            getContext().getContentResolver().notifyChange(uri, null);
            return db.update("person", values, selection, selectionArgs);
        } else {
            throw new IllegalArgumentException("URI不能被识别");
        }
    }

}

　　public String getType(Uri uri)：该方法用于返回当前Uri所代表的MIME类型。如果该Uri对应数据可能包括多条记录，那么MIME类型字符串应该以vnd.android.cursor.dir/开头；如果该Uri对应的数据只包含一条记录，那么返回MIME类型字符串应该以vnd.android.cursor.item/开头。

3、在B应用程序中使用，首先我们要得到一个ContentResolver对象，Context提供了getContentResolver()方法来获取ContentResolver对象。源码如下：

package com.gnnuit.other;

import android.net.Uri;
import android.os.Bundle;
import android.app.Activity;
import android.content.ContentResolver;
import android.database.Cursor;
import android.view.Menu;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ContentResolver resolver = getContentResolver();
        Uri uri = Uri.parse("content://com.gnnuit.provider.PersonProvider/persons");
        Cursor cursor = resolver.query(uri, null, null, null, null);
        if (cursor != null) {
            while (cursor.moveToNext()) {
                String name = cursor.getString(cursor.getColumnIndex("name"));
                String age = cursor.getString(cursor.getColumnIndex("age"));
                System.out.println("姓名：" + name + "年命：" + age);
            }
        } else {
            System.out.println("cursor为空");
        }
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }

}

 4、ContentProvider的Uri简介

　　ContentProvider的Uri类似于HTTP的Uri，例如以下的Uri：

content://com.gnnuit.provider.personprovider/persons

　　它可以分为以下三个部分：

（1）content://：这个部分是Android的ContentProvider规定的，就像http://一样。暴露ContentProvider、访问ContentProvider的协议默认是content://。

（2）com.gnnuit.provider.personprovider：这个部分是ContentProvider的authority。系统就是由这个部分来找到操作哪个ContentProvider。只要访问指定的ContentProvider，这个部分总是固定的。

（3）persons：资源部分，当访问者需要访问不同资源时，这个部分是动态改变的。

5、几种典型的Uri含义：

（1）content://com.gnnuit.provider.personprovider/persons

　　此时它要访问的资源为persons，这意味着访问perosn数据中的所有记录。

（2）content://com.gnnuit.provider.personprovider/person/2

　　此时它要访问的资源为person/2，这意味着访问person数据中ID为2的记录。

（3）content://com.gnnuit.provider.personprovider/person/2/name

　　此时它要访问的资源为person/2/name，这意味着访问perosn数据中ID为2的记录的name字段。

（4）大部分ContentProvider所操作的数据都来自于数据库，但有时这些数据也可来自于文件、XML或网络等其他存储方式，此时的Uri可改为如下形式：

content://com.gnnuit.provider.personprovider/person/name/

　　上面的Uri表示操作person节点下的name节点。

6、将一个字符串转化成Uri的方法：

　　Uri uri=Uri.parse("content://com.gnnuit.provider.personprovider/persons");