上一章講到怎么使用ContentResolver訪問系統提供的數據接口讀取聯系人信息,那么系統程序是怎樣對外建立并開放這些數據接口的呢?好多時候我們自己應用程序也需要數據共享的功能,以便于其他程序訪問我們的數據,那么我們該怎么實現我們自己的數據接口,接下來讓我們來一起學習。
其實把我們程序的數據提供給其他應用程序使用有好多方式,比如我們把數據寫到一個文件里面,讓其他程序讀取我們的文件。但是這樣并不能很好地保證數據安全性和永久性。官方推薦我們的方式就是使用提供器,可以新建一個類去繼承ContentProvider的方式創建一個自己的內容提供器。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()
初始化內容提供器的時候調用,通常會在這里完成對數據庫的創建和升級操作,返回 true 表示內容提供器初試化成功,返回 false則表示失敗。注意,只有當存在ContentResolver嘗試訪問我們的程序中的數據時,內容提供器才會被初始化。 - query()
從內容提供器中查詢數據。使用 uri 參數來確定查詢那張表,projection參數用于確定查詢哪些列,selection 和 selectionArgs參數用于約束查詢哪些行,sortOrder 參數用于對結果經行排序,查詢的結果存放在 Cursor 對象中返回。 - insert()
向內容提供器中添加一條數據。使用 uri 參數確定要添加到的表,待添加的數據保存在 values 中。添加完成后,返回一個用于表示該條新記錄的URI。 - update()
更新內容提供器中已有的數據。使用 uri 參數確定要更新哪一張表里面的數據,新數據保存在values參數中,selection 和 selectionArgs 參數用于約束更新哪些行,受影響的行數據將作為返回值返回。 - delete()
從內容提供器中刪除數據。使用 uri 參數確定刪除哪張表的數據,selection 和 selectionArgs 參數用來約束刪除哪些行,被刪除的行數將作為返回值返回。 - getType()
根據出入的內容 uri 來返回相應的 MIME 類型。
我們再來回顧一下前面關于內容 Uri 的知識。
我們上一章提到,一個標準的內容 Uri 寫成是這樣的:
content://com.example.app.provider/table1
這就表示了我們想要訪問的是 com.example.app 這個應用下的 table1 這張表。除此之外我們還可以在最后面加上一個id。如下:
content://com.example.app.provider/table1/1
這就表示了我們想要訪問的是 com.example.app 這個應用下的 table1 這張表中 id 為 1 的數據。
內容Uri就這兩種類型,一種是一路徑結尾的,表明的是要訪問表里面所有的數據;另一種就是以id結尾的,表明的是要訪問相應id的數據。我們可以用通配符的方式來分別表示這兩種類型,規則如下:
1. *:表示匹配任意長度的任意字符
2. #:表示匹配任意長度的數字
所以一個能夠匹配任意表的內容uri就可以寫成:
content://com.example.app.provider/*
一個能夠匹配table1表中的所有數據的內容uri就可以寫成:
content://com.example.app.provider/table1/#
在這里我們可以借助 UriMatcher 類來輕松的實現匹配內容Uri的功能。 UriMatcher 中提供了一個 addURI() 方法,這個方法接受三個參數,分別是我們能容Uri的權限、路徑和一個Code(int)。當我們調用 UriMatcher 的 match() 方法時,就可以傳入一個Uri,返回值則是對應這個Uri所對應匹配的 Code。利用這個Code我們就能夠判斷調用方期望的是哪張表中的數據了。具體操作如下:
public class MyProvider extends ContentProvider {
private SQLiteDatabase db;
private static UriMatcher uriMatcher;
private static final int TABLE_DIR = 0;//表明要訪問table1中的所有數據
private static final int TABLE_ITEM = 1;//表明要訪問table1中的某行數據
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中的所有數據相應的操作
break;
case TABLE_ITEM:
String Id = uri.getPathSegments().get(1);
cursor = db.query("table1",projection,"id=?",new String[]{Id},null,null,sortOrder);
//。。。訪問table1中某行數據相應的操作
break;
}
return cursor;
}
........
}
我們可以看到我們利用UriMatcher來判斷調用者的訪問意圖,并按意圖用switch分開處理。在這里數據庫的操作就不再多加解釋,相信大家應該已經能夠靈活掌握。重點來說一下 uri.getPathSegments().get(1) 的用法。
uri.getPathSegments().get(int)這個方法用來獲取uri中的路徑部分,并以'/'為分隔符來給路徑從零標號。比如 content://com.example.app.provider/table1/1 這個uri,我們使用uri.getPathSegments().get(0)返回的結果則是"table1",同理uri.getPathSegments().get(1)返回的是"1"。
其實其他增、刪、改操作跟查詢是一樣的道理,就不再堆多余代碼了。除此之外還有一個比較陌生的getType()方法。
它是所有內容提供器都必須提供的一個方法,用于獲取Uri對象所對應的MIME類型。MIME字符串主要有三部分組成,Android對這三部分做了如下格式規定。
1. 必須以 vnd 開頭。
2. 如果Uri以路徑為結尾,則后接 android.cursor.dir/,如果Uri以id為結尾,則后接 android.cursor.item/.
3. 最后接上 vnd.<anthority>.<path>.
所以對于 content://com.example.app.provider/table1 這個內容 Uri,它所對應的MIME類型就可以寫成:
vnd.android.coursor.dir/vnd.com.example.app.provider.table1
相應的 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;
}
我們把其他方法補充完整后我們的內容提供器就寫好了,但是現在其他應用程序還不能調用。我們要在 AndroidManifest.xml 的<appliction> 標簽中添加如下代碼:
<provider
android:name="com.example.app.MyProvider"
android:authorities="com.example.app.provider"
android:exported="true"/>
android:name屬性中制定了類的全名,android:authorities指定了該內容提供器的權限(為了避免與其他應用沖突,盡量以 包名.provider 來命名)。android:exported屬性制定了內容提供器是可以被其他應用訪問的。
到現在我們的內容提供器就編寫完成了,我們可以通過權限為 com.example.app.provider 的內容Uri 來訪問我們的內容提供器,至于要訪問的表自己可以通過數據庫的知識建立一個數據庫來存放數據。