跨进程通讯之Content Provider 篇

Android应用程序可使用文件或SqlLite数据库来存储数据。Content Provider提供了一种在多个应用程序之间数据共享的方式（跨进程共享数据）。

虽然Content Provider也能够在同一个应用程序中被访问，但这么作并无什么意义。Content Provider存在的目的向其余应用程序共享数据和容许其余应用程序对数据进行增、删、改、查操做。

Android系统自己提供了不少Content Provider，例如，音频、视频、联系人信息等等。咱们能够经过这些Content Provider得到相关信息的列表。这些列表数据将以Cursor对象返回。所以，从Content Provider返回的数据是二维表的形式。

对于访问Content Provider的程序，须要使用ContentResolver对象。

ContentResolver cr = getContentResolver();

与Activity同样，Content Provider也须要与一个URI对应。每个Content Provider能够控制多个数据集，在这种状况下，每个数据集会对应一个单独的URI。全部的URI必须以“content://”开头。 为了程序更容易维护，也为了简化程序代码，通常将URI定义成一个常量。例如，下面的常量表示系统的联系人电话号码。

android.provider.Contacts.Phones.CONTENT_URI

下面来看一下Content Provider的具体步骤：

1. 编写一个继承于android.content.ContentProvider的子类。该类是ContentProvider的核心类，在该类中会实现 query、insert、update及delete方法。
2. 在AndroidManifest.xml文件中配置ContentProvider。要想惟一肯定一个ContentProvider，须要指定这个 ContentProvider的URI，除此以外，还须要指定URI所对应的ContentProvider类。 先看一下如图5所示的URI。

下面对图5所示的URI的4个部分作一下解释。

A：Content Provider URI的固定前缀，也就是说，全部的URI必须以content://开头。

B：URI中最重要的部分。该部分是Content Provider的惟一标识。对于第三方应用程序来讲，该部分最后使用完整的类名（包名+类名），以确保URI的惟一性。该部分须要在 AndroidManifest.xml文件中<provider>标签中定义，代码以下：

<provider name=".TransportationProvider" authorities="com.example.transportationprovider"
          . . .  >

C：这部分是URI的路径（path）。表示URI中各类被请求的数据。这部分是可选的， 若是Content Provider仅仅提供一种请求的数据，那么这部分能够省略。若是Content Provider要提供多种请求数据。就须要添加多个路径，甚至是子路径。例如，“land/bus”、“land/train”、“sea/ship” 就指定了3种可能提供的数据。

D：这部分也是可选的。若是要传递一个值给Content Provider，能够经过这部分传递。固然，若是不须要传值，这部分也能够省略，省略后的URI以下所示：

content://com.example.transportationprovider/trains

本例利用了《基于 android SDK1.5的英文电子词典的实现》一文中实现的电子词典程序。经过ContentProvider，将电子词典的查词功能共享成Cursor对象。这样 其余的应用程序就能够经过ContentProvider来查词英文单词了。

... ...
public class DictionaryContentProvider extends ContentProvider
{
    private static UriMatcher uriMatcher;
    private static final String AUTHORITY = "net.blogjava.mobile.dictionarycontentprovider";
    private static final int SINGLE_WORD = 1;
    private static final int PREFIX_WORDS = 2;
    public static final String DATABASE_PATH = android.os.Environment
    .getExternalStorageDirectory().getAbsolutePath()
    + "/dictionary";
    public static final String DATABASE_FILENAME = "dictionary.db";
    private SQLiteDatabase database;
    static
    {
        //  添加访问ContentProvider的Uri
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(AUTHORITY, "single", SINGLE_WORD);
        uriMatcher.addURI(AUTHORITY, "prefix/*", PREFIX_WORDS);
    }
    //  该方法在Activity的onCreate方法以前调用
    @Override
    public boolean onCreate()
    {
        database = openDatabase();
        return true;
    }
    //  在本例中只实现了query方法，其余的方法（insert、update和delete）与query方法的实现
    //  相似
    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
            String[] selectionArgs, String sortOrder)
    {
        Cursor cursor = null;
        switch (uriMatcher.match(uri))
        {
            case SINGLE_WORD:
                //  查找指定的单词
                cursor = database.query("t_words", projection, selection,
                        selectionArgs, null, null, sortOrder);
                break;
            case PREFIX_WORDS:
                String word = uri.getPathSegments().get(1);
                //  查找以指定字符串开头的单词集合
                cursor = database
                        .rawQuery(
                                "select english as _id, chinese from t_words where english like ?",
                                new String[]
                                { word + "%" });
                break;

            default:
                throw new IllegalArgumentException("<" + uri + ">格式不正确.");
        }
        return cursor;
    }
    ... ...
}

关于DictionaryContentProvider类的代码须要作以下的解释。

1. 在DictionaryContentProvider类的开头定义的AUTHORITY是访问ContentProvider的URI的前半部分。
2. 访问ContentProvider的URI的后半部分由uriMatcher.addURI(...)方法指定。该方法的第1个参数就是 AUTHORITY（Uri的前半部分），第2个参数是Uri的后半部分，第3个参数是与第2个参数值对应的代码。当其余的应用程序经过Uri访问 ContentProvider时。系统解析Uri后，将addURI方法的第2个参数值转换成与之对应的代码（第3个参数值）。
3. addURI的第2个参数值可使用通配符。例如，prefix/中的表示全部字符。prefix/abc、prefix/xxx都会匹配成功。
4. 访问ContentProvider的URI是addURI的第1个和第2个参数值的组件，例如，按着DictionaryContentProvider中设置的两个URI，能够分别匹配下面的两个URI

content://net.blogjava.mobile.dictionarycontentprovider/single
content://net.blogjava.mobile.dictionarycontentprovider/prefix/wo

要注意的是，访问ContentProvider的URI必须以“content://”开头。

下面在AndroidManifest.xml文件中配置DictionaryContentProvider类。

<provider android:name="DictionaryContentProvider"
            android:authorities="net.blogjava.mobile.dictionarycontentprovider" />

如今来看看应用程序如何调用ContentProvider。

调用ContentProvider的关键是使用 getContentResolver方法来得到一个ContentResolver对象，并经过ContentResolver对象的query方法来 访问ContentProvider。

首先来定义两个访问ContentProvider的常量。

public final String DICTIONARY_SINGLE_WORD_URI = "content://net.blogjava.mobile.dictionarycontentprovider/single";
public final String DICTIONARY_PREFIX_WORD_URI = "content://net.blogjava.mobile.dictionarycontentprovider/prefix";

而后在查询按钮的单击事件中编写以下的代码来查询单词。

public void onClick(View view)
{
    Uri uri = Uri.parse(DICTIONARY_SINGLE_WORD_URI);
    //  经过ContentProvider查询单词，并返回Cursor对象，而后的操做就和直接从数据中得到
    //  Cursor对象后的操做是同样的了
    Cursor cursor = getContentResolver().query(uri, null, "english=?",
            new String[]{ actvWord.getText().toString() }, null);
    String result = "未找到该单词.";
    if (cursor.getCount() > 0)
    {
        cursor.moveToFirst();
        result = cursor.getString(cursor.getColumnIndex("chinese"));
    }
    new AlertDialog.Builder(this).setTitle("查询结果").setMessage(result)
            .setPositiveButton("关闭", null).show();

}

下面是显示单词列表的代码。

public void afterTextChanged(Editable s)
{
    if ("".equals(s.toString()))
        return;
    Uri uri = Uri.parse(DICTIONARY_PREFIX_WORD_URI + "/" + s.toString());
    //  从ContentProvider中得到以某个字符串开头的全部单词的Cursor对象
    Cursor cursor = getContentResolver().query(uri, null, null, null, null);
    DictionaryAdapter dictionaryAdapter = new DictionaryAdapter(this,
            cursor, true);
    actvWord.setAdapter(dictionaryAdapter);
}