Android中的进程通信之Content Provider

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

1. 查询数据
2. 修改数据
3. 添加数据
4. 删除数据

        虽然Content Provider也可以在同一个应用程序中被访问，但这么做并没有什么意义。Content Provider存在的目的向其他应用程序共享数据和允许其他应用程序对数据进行增、删、改操作。
Android系统本身提供了很多Content Provider，例如，音频、视频、联系人信息等等。我们可以通过这些Content Provider获得相关信息的列表。这些列表数据将以Cursor对象返回。因此，从Content Provider返回的数据是二维表的形式。

      对于访问Content Provider的程序，需要使用ContentResolver对象。该对象需要使用getContentResolver方法获得，代码如下：

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方法。实际上调用ContentResolver类的这4个方法就是调用 ContentProvider类中与之要对应的方法。在本文中只介绍query。至于insert、update、delete和query的用法类 似。也是通过Uri传递参数，然后在这些方法中接收这些参数，并做进一步地处理。
2.  在AndroidManifest.xml文件中配置ContentProvider。要想唯一确定一个ContentProvider，需要指定这个 ContentProvider的URI，除此之外，还需要指定URI所对应的ContentProvider类。这有些象Servlet的定义，除了要 指定Servlet对应的Web地址，还要指定这个地址所对应的Servlet类。
现在来看一下Uri的具体格式，先看一下如图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来查词英文单词了。关于英文词典的具体实现细节，读者可以通过如下的地址查看《基于android SDK1.5的英文电子词典的实现》一文。

http://www.ophonesdn.com/article/show/111

在电子词典程序中需要一个DictionaryContentProvider类，该类是ContentProvider的子类。在该类中实现了 query方法，并根据不同的URI来返回不同的结果。让我们先看一下DictionaryContentProvider类，然后再对这些代码做一些解 释。

... ...
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://”开头。

5.  在query方法中建议使用SQLiteDatabase对象的query方法查询。因为query方法的参数正好和DictionaryContentProvider类中的query方法的参数对应，这样使用起来比较方便。
6.  由于安装了ContentProvider的应用程序会先调用ContentProvider的onCreate方法（该方法会在Activity的 onCreate方法之前调用），因此，只需要将打开或复制数据库的方法（openDatabase）放在 DictionaryContentProvider类中，并在onCreate方法中调用即可。
7.  在DictionaryContentProvider类中只实现了query方法。在该方法中判断了其他应用程序发送的是哪一个Uri。并进行相应的处理。这两个Uri一个是查询指定单词的，另外一个是查询以某个字符串开头的所有单词的（用于显示单词列表）。
下面在AndroidManifest.xml文件中配置DictionaryContentProvider类。

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

 OK，现在来看看应用程序如何调用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);
}

 现在来运行本例，会看到如图6所示的界面。当查询单词时会显示如图7所示的单词列表，查询出结果后，会显示如图8所示的界面。