编写content provider

Android中content provider提供了一种进程间共享数据的机制。Conetent provider以类似数据库表的机制提供与外部交互的方法。content provider的实现并不对存储形式做要求，可以是数据库、文件、或者网络。要自己编写一个content provider需要注意的事项包括(from official reference)：

1、派生ContentProvider类，实现若干个接口，主要包括：onCreate/query/update/delete/insert/getType；

2、定义好一系列的URI，URI用于指示访问的具体数据，一般可以配合UriMatcher来简化对URI的处理，其大致框架为：

public MyContentProvider extends ContentProvider {
    private static final UriMatcher sURLMatcher =
            new UriMatcher(UriMatcher.NO_MATCH);

    static {
        sURLMatcher.addURI("sms", null, SMS_ALL);
        sURLMatcher.addURI("sms", "#", SMS_ALL_ID);
        sURLMatcher.addURI("sms", "inbox", SMS_INBOX);
        sURLMatcher.addURI("sms", "inbox/#", SMS_INBOX_ID);
    }
}

 ....
    @Override
    public Cursor query(Uri url, String[] projectionIn, String selection,
            String[] selectionArgs, String sort) {
        SQLiteQueryBuilder qb = new SQLiteQueryBuilder();

        // Generate the body of the query.
        int match = sURLMatcher.match(url);
        switch (match) {
            case SMS_ALL:
                constructQueryForBox(qb, Sms.MESSAGE_TYPE_ALL);
                break;

            case SMS_UNDELIVERED:        

UriMatch中包含2个通配符：#用于匹配数字、*用于任何字符。

3、还是关于URI，URI分为三部分：content/authority/subpath，authority非常重要，它除了有效地区分URI外，还用于在AndroidManifest.xml中注册content provider。

4、在AndroidManifest.xml中注册content provider：

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

5、实现getType，为数据标识MIME，这个可以使用统一的形式：

 vnd.android.cursor.item/vnd.yourcompanyname.contenttype
vnd.android.cursor.dir/vnd.yourcompanyname.contenttype

分别表示单个数据和多个数据，这里的yourcompanyname可以使用之前URI中的authority字符串。

6、当然，为了方便使用者使用，最好在content provider中预先定义好各种列名、以及CONTENT_URI。


1.5.2011 update

昨天写了个例子，使用数据库做存储。基本上，写一个简单可用的content provider比较简单：
1、派生SQLiteOpenHelper，在onCreate里创建所需要的表；在onUpgrade里面一般先删了整张表，然后再重新创建：

    private static class DatabaseHelper extends SQLiteOpenHelper {

        DatabaseHelper(Context context) {
            super(context, DATABASE_NAME, null, DATABASE_VERSION);
        }

        @Override
        public void onCreate(SQLiteDatabase db) {
            db.execSQL("CREATE TABLE " + BLACKLIST_TABLE_NAME + " ("
                    + BlackList._ID + " INTEGER PRIMARY KEY,"
                    + BlackList.ADDRESS + " TEXT,"
                    + BlackList.TYPE + " INTEGER,"
                    + BlackList.DATE + " INTEGER"
                    + ");");
        }

        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            Log.w(TAG, "Upgrading database from version " + oldVersion + " to "
                    + newVersion + ", which will destroy all old data");
            db.execSQL("DROP TABLE IF EXISTS " + BLACKLIST_TABLE_NAME);
            onCreate(db);
        }
    }

然后在content provider的onCreate里创建该对象：

    @Override
    public boolean onCreate() {
        mOpenHelper = new DatabaseHelper(getContext());
        return true;
    }

2、实现了content provider后，会有个文件定义了诸如该content provider的URI，各个列的名字，或者其他信息；这个文件并非必须，使用者可以自己定义这些URI来使用，例如content://sms

3、content provider编写好后，可以像一般的程序一样安装到系统里面，虽然它没界面；然后使用者就可以使用之。

例子见附件