上一章講到怎么使用ContentResolver訪問系統(tǒng)提供的數(shù)據(jù)接口讀取聯(lián)系人信息或链，那么系統(tǒng)程序是怎樣對外建立并開放這些數(shù)據(jù)接口的呢惫恼？好多時候我們自己應(yīng)用程序也需要數(shù)據(jù)共享的功能，以便于其他程序訪問我們的數(shù)據(jù)澳盐，那么我們該怎么實現(xiàn)我們自己的數(shù)據(jù)接口祈纯，接下來讓我們來一起學(xué)習(xí)。
其實把我們程序的數(shù)據(jù)提供給其他應(yīng)用程序使用有好多方式叼耙，比如我們把數(shù)據(jù)寫到一個文件里面盆繁，讓其他程序讀取我們的文件。但是這樣并不能很好地保證數(shù)據(jù)安全性和永久性旬蟋。官方推薦我們的方式就是使用提供器油昂，可以新建一個類去繼承ContentProvider的方式創(chuàng)建一個自己的內(nèi)容提供器。ContentProvider類中有六個抽象方法倾贰。我們在使用子類繼承他的時候冕碟，需要將這六個方法重寫，接下來我們新建我們的MyProvider繼承自ContentProvider匆浙，代碼如下：
public class MyProvider extends ContentProvider{
@Override
public boolean onCreate() {
return false;
}
@Nullable
@Override
public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String sortOrder) {
return null;
}
@Nullable
@Override
public String getType(@NonNull Uri uri) {
return null;
}
@Nullable
@Override
public Uri insert(@NonNull Uri uri, @Nullable ContentValues values) {
return null;
}
@Override
public int delete(@NonNull Uri uri, @Nullable String selection, @Nullable String[] selectionArgs) {
return 0;
}
@Override
public int update(@NonNull Uri uri, @Nullable ContentValues values, @Nullable String selection, @Nullable String[] selectionArgs) {
return 0;
}
}
簡單介紹一下這幾個方法：
- onCreate()
初始化內(nèi)容提供器的時候調(diào)用安寺，通常會在這里完成對數(shù)據(jù)庫的創(chuàng)建和升級操作，返回 true 表示內(nèi)容提供器初試化成功首尼，返回 false則表示失敗挑庶。注意，只有當(dāng)存在ContentResolver嘗試訪問我們的程序中的數(shù)據(jù)時软能，內(nèi)容提供器才會被初始化迎捺。 - query()
從內(nèi)容提供器中查詢數(shù)據(jù)。使用 uri 參數(shù)來確定查詢那張表查排，projection參數(shù)用于確定查詢哪些列凳枝，selection 和 selectionArgs參數(shù)用于約束查詢哪些行，sortOrder 參數(shù)用于對結(jié)果經(jīng)行排序跋核，查詢的結(jié)果存放在 Cursor 對象中返回岖瑰。 - insert()
向內(nèi)容提供器中添加一條數(shù)據(jù)叛买。使用 uri 參數(shù)確定要添加到的表，待添加的數(shù)據(jù)保存在 values 中蹋订。添加完成后率挣，返回一個用于表示該條新記錄的URI。 - update()
更新內(nèi)容提供器中已有的數(shù)據(jù)露戒。使用 uri 參數(shù)確定要更新哪一張表里面的數(shù)據(jù)椒功，新數(shù)據(jù)保存在values參數(shù)中，selection 和 selectionArgs 參數(shù)用于約束更新哪些行玫锋，受影響的行數(shù)據(jù)將作為返回值返回蛾茉。 - delete()
從內(nèi)容提供器中刪除數(shù)據(jù)讼呢。使用 uri 參數(shù)確定刪除哪張表的數(shù)據(jù)撩鹿，selection 和 selectionArgs 參數(shù)用來約束刪除哪些行，被刪除的行數(shù)將作為返回值返回悦屏。 - getType()
根據(jù)出入的內(nèi)容 uri 來返回相應(yīng)的 MIME 類型节沦。
我們再來回顧一下前面關(guān)于內(nèi)容 Uri 的知識。
我們上一章提到础爬，一個標(biāo)準(zhǔn)的內(nèi)容 Uri 寫成是這樣的：
content://com.example.app.provider/table1
這就表示了我們想要訪問的是 com.example.app 這個應(yīng)用下的 table1 這張表甫贯。除此之外我們還可以在最后面加上一個id。如下：
content://com.example.app.provider/table1/1
這就表示了我們想要訪問的是 com.example.app 這個應(yīng)用下的 table1 這張表中 id 為 1 的數(shù)據(jù)看蚜。
內(nèi)容Uri就這兩種類型叫搁，一種是一路徑結(jié)尾的，表明的是要訪問表里面所有的數(shù)據(jù)供炎；另一種就是以id結(jié)尾的渴逻，表明的是要訪問相應(yīng)id的數(shù)據(jù)。我們可以用通配符的方式來分別表示這兩種類型音诫，規(guī)則如下：
1. *：表示匹配任意長度的任意字符
2. #：表示匹配任意長度的數(shù)字
所以一個能夠匹配任意表的內(nèi)容uri就可以寫成：
content://com.example.app.provider/*
一個能夠匹配table1表中的所有數(shù)據(jù)的內(nèi)容uri就可以寫成：
content://com.example.app.provider/table1/#
在這里我們可以借助 UriMatcher 類來輕松的實現(xiàn)匹配內(nèi)容Uri的功能惨奕。 UriMatcher 中提供了一個 addURI() 方法，這個方法接受三個參數(shù)竭钝，分別是我們能容Uri的權(quán)限梨撞、路徑和一個Code(int)。當(dāng)我們調(diào)用 UriMatcher 的 match() 方法時香罐，就可以傳入一個Uri卧波，返回值則是對應(yīng)這個Uri所對應(yīng)匹配的 Code。利用這個Code我們就能夠判斷調(diào)用方期望的是哪張表中的數(shù)據(jù)了庇茫。具體操作如下：
public class MyProvider extends ContentProvider {
private SQLiteDatabase db;
private static UriMatcher uriMatcher;
private static final int TABLE_DIR = 0;//表明要訪問table1中的所有數(shù)據(jù)
private static final int TABLE_ITEM = 1;//表明要訪問table1中的某行數(shù)據(jù)
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI("com.example.app.provider", "table1", TABLE_DIR);
uriMatcher.addURI("com.example.app.provider", "table1/#", TABLE_ITEM);
}
@Override
public boolean onCreate() {
db = SQLiteDatabase.openOrCreateDatabase(flie, factory);
return true;
}
@Nullable
@Override
public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String sortOrder) {
Cursor cursor = null;
switch (uriMatcher.match(uri)) {
case TABLE_DIR:
cursor = db.query("table1",projection,selection,selectionArgs,null,null,sortOrder);
//幽勒。。港令。訪問table1中的所有數(shù)據(jù)相應(yīng)的操作
break;
case TABLE_ITEM:
String Id = uri.getPathSegments().get(1);
cursor = db.query("table1",projection,"id=?",new String[]{Id},null,null,sortOrder);
//啥容。锈颗。。訪問table1中某行數(shù)據(jù)相應(yīng)的操作
break;
}
return cursor;
}
........
}
我們可以看到我們利用UriMatcher來判斷調(diào)用者的訪問意圖咪惠，并按意圖用switch分開處理击吱。在這里數(shù)據(jù)庫的操作就不再多加解釋，相信大家應(yīng)該已經(jīng)能夠靈活掌握遥昧。重點來說一下 uri.getPathSegments().get(1) 的用法覆醇。
uri.getPathSegments().get(int)這個方法用來獲取uri中的路徑部分，并以'/'為分隔符來給路徑從零標(biāo)號炭臭。比如 content://com.example.app.provider/table1/1 這個uri永脓，我們使用uri.getPathSegments().get(0)返回的結(jié)果則是"table1",同理uri.getPathSegments().get(1)返回的是"1"。
其實其他增鞋仍、刪常摧、改操作跟查詢是一樣的道理，就不再堆多余代碼了威创。除此之外還有一個比較陌生的getType()方法落午。
它是所有內(nèi)容提供器都必須提供的一個方法，用于獲取Uri對象所對應(yīng)的MIME類型肚豺。MIME字符串主要有三部分組成溃斋，Android對這三部分做了如下格式規(guī)定。
1. 必須以 vnd 開頭吸申。
2. 如果Uri以路徑為結(jié)尾梗劫，則后接 android.cursor.dir/,如果Uri以id為結(jié)尾，則后接 android.cursor.item/.
3. 最后接上 vnd.<anthority>.<path>.
所以對于 content://com.example.app.provider/table1 這個內(nèi)容 Uri截碴，它所對應(yīng)的MIME類型就可以寫成：
vnd.android.coursor.dir/vnd.com.example.app.provider.table1
相應(yīng)的 content://com.example.app.provider/table1/1 就可以寫成：
vnd.android.coursor.item/vnd.com.example.app.provider.table1
修改getType()方法如下：
@Override
public String getType(@NonNull Uri uri) {
switch (uriMatcher.match(uri)) {
case TABLE_DIR:
return "vnd.android.coursor.dir/vnd.com.example.app.provider.table1";
break;
case TABLE_ITEM:
return "vnd.android.coursor.item/vnd.com.example.app.provider.table1";
break;
}
return null;
}
我們把其他方法補充完整后我們的內(nèi)容提供器就寫好了梳侨，但是現(xiàn)在其他應(yīng)用程序還不能調(diào)用。我們要在 AndroidManifest.xml 的<appliction> 標(biāo)簽中添加如下代碼：
<provider
android:name="com.example.app.MyProvider"
android:authorities="com.example.app.provider"
android:exported="true"/>
android:name屬性中制定了類的全名隐岛，android:authorities指定了該內(nèi)容提供器的權(quán)限（為了避免與其他應(yīng)用沖突猫妙，盡量以 包名.provider 來命名）。android:exported屬性制定了內(nèi)容提供器是可以被其他應(yīng)用訪問的聚凹。
到現(xiàn)在我們的內(nèi)容提供器就編寫完成了割坠，我們可以通過權(quán)限為 com.example.app.provider 的內(nèi)容Uri 來訪問我們的內(nèi)容提供器，至于要訪問的表自己可以通過數(shù)據(jù)庫的知識建立一個數(shù)據(jù)庫來存放數(shù)據(jù)妒牙。
