編寫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的處理，其大致框架爲：

[code]
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:
[/code]

UriMatch中包含2個通配符：#用於匹配數字、*用於任何字符。

3、還是關於URI，URI分爲三部分：content/authority/subpath，authority非常重要，它除了有效地區分URI外，還用於在AndroidManifest.xml中註冊content provider。

4、在AndroidManifest.xml中註冊content provider：
[code]
<provider name=".TransportationProvider" authorities="com.example.transportationprovider" . . . >
[/code]

5、實現getType，爲數據標識MIME，這個可以使用統一的形式：
[code]
vnd.android.cursor.item/vnd.yourcompanyname.contenttype
vnd.android.cursor.dir/vnd.yourcompanyname.contenttype
[/code]
分別表示單個數據和多個數據，這裏的yourcompanyname可以使用之前URI中的authority字符串。

6、當然，爲了方便使用者使用，最好在content provider中預先定義好各種列名、以及CONTENT_URI。

[color=red]
1.5.2011 update
[/color]
昨天寫了個例子，使用數據庫做存儲。基本上，寫一個簡單可用的content provider比較簡單：
1、派生SQLiteOpenHelper，在onCreate裏創建所需要的表；在onUpgrade裏面一般先刪了整張表，然後再重新創建：
[code]
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);
}
}
[/code]

然後在content provider的onCreate裏創建該對象：
[code]
@Override
public boolean onCreate() {
mOpenHelper = new DatabaseHelper(getContext());
return true;
}
[/code]

2、實現了content provider後，會有個文件定義了諸如該content provider的URI，各個列的名字，或者其他信息；這個文件並非必須，[color=red]使用者可以自己定義這些URI來使用，例如content://sms[/color]

3、content provider編寫好後，可以像一般的程序一樣安裝到系統裏面，雖然它沒界面；然後使用者就可以使用之。

例子見附件