第 7 章 跨程序共享數(shù)據(jù)，探究內(nèi)容提供器
一：ContentResolver 的基本用法
- 如果想要訪問內(nèi)容提供器中共享的數(shù)據(jù)掺喻，就一定要借助ContentResolve類笨使，可以通過Context中的getContentResolver()方法獲取到該類的實(shí)例
- 內(nèi)容 URI最標(biāo)準(zhǔn)的格式寫法如下：
content://com.example.app.provider/table1 (這就表示調(diào)用方期望訪問的是 com.example.app 這個(gè)應(yīng)用的 table1 表中的數(shù)據(jù)棠笑。)
content://com.example.app.provider/table1/1 (這就表示調(diào)用方期望訪問的是 com.example.app 這個(gè)應(yīng)用的 table1表中 id 為 1 的數(shù)據(jù)容劳。)
-
我們可以使用通配符的方式來分別匹配這兩種格式的內(nèi)容 URI，規(guī)則如下
- *：表示匹配任意長度的任意字符
- '#：表示匹配任意長度的數(shù)字
content://com.example.app.provider/* (所以必孤，一個(gè)能夠匹配任意表的內(nèi)容 URI格式就可以寫成：)
content://com.example.app.provider/table1/# (而一個(gè)能夠匹配 table1表中任意一行數(shù)據(jù)的內(nèi)容 URI格式就可以寫成：)
- 查詢數(shù)據(jù)
- 調(diào)用 Uri.parse()方法猾骡，就可以將內(nèi)容 URI字符串解析成 Uri 對(duì)象了
Uri uri = Uri.parse("content://com.example.app.provider/table1")
2. 現(xiàn)在我們就可以使用這個(gè) Uri對(duì)象來查詢 table1 表中的數(shù)據(jù)了，(查詢完成后返回的仍然是一個(gè) Cursor 對(duì)象)
Cursor cursor = getContentResolver().query(
uri,
projection,
selection,
selectionArgs,
sortOrder);
2. 這時(shí)我們就可以將數(shù)據(jù)從 Cursor 對(duì)象中逐個(gè)讀取出來了(遍歷 Cursor 的所有行)
if (cursor != null) {
while (cursor.moveToNext()) {
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
- 添加數(shù)據(jù)
- 仍然是將待添加的數(shù)據(jù)組裝到 ContentValues 中敷搪，
- 然后調(diào)用 ContentResolver的 insert()方法兴想，將 Uri 和 ContentValues作為參數(shù)傳入即可。
ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2", 1);
getContentResolver().insert(uri, values);
- 更新數(shù)據(jù)
- 仍然是將待添加的數(shù)據(jù)組裝到 ContentValues 中赡勘，
- 然后調(diào)用 ContentResolver的 insert()方法嫂便，將 Uri 和 ContentValues作為參數(shù)傳入即可。
ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});
- 刪除數(shù)據(jù)（調(diào)用 ContentResolver 的 delete()方法將這條數(shù)據(jù)刪除掉）
getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });
二：讀取聯(lián)系人 (使用listview顯示)
1. 添加權(quán)限
<uses-permission android:name="android.permission.READ_CONTACTS" />
2. ContactsContract.CommonDataKinds.Phone類已經(jīng)幫我們做好了封裝闸与，提供了一個(gè)CONTENT_URI常量毙替，而這個(gè)常量就是使用Uri.parse()方法解析出來的結(jié)果
Cursor cursor = null;
try {
// 查詢聯(lián)系人數(shù)據(jù)
cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, null, null, null);
while (cursor.moveToNext()) {
// 獲取聯(lián)系人姓名
String displayName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
// 獲取聯(lián)系人手機(jī)號(hào)
String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
contactsList.add(displayName + "\\n" + number);
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (cursor != null) {
cursor.close();
}
}
三：創(chuàng)建自己的內(nèi)容提供器
public class MyProvider extends ContentProvider {
public static final int TABLE1_DIR = 0;
public static final int TABLE1_ITEM = 1;
public static final int TABLE2_DIR = 2;
public static final int TABLE2_ITEM = 3;
private static UriMatcher uriMatcher;
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
uriMatcher.addURI("com.example.app.provider ", "table1/#", TABLE1_ITEM);
uriMatcher.addURI("com.example.app.provider ", "table2", TABLE2_ITEM);
uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM);
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
switch (uriMatcher.match(uri)) { //借助UriMatcher這個(gè)類就可以輕松地實(shí)現(xiàn)匹配內(nèi)容URI的功能
case TABLE1_DIR:
// 查詢table1 表中的所有數(shù)據(jù)
break;
case TABLE1_ITEM:
// 查詢table1 表中的單條數(shù)據(jù)
break;
case TABLE2_DIR:
// 查詢table2 表中的所有數(shù)據(jù)
break;
case TABLE2_ITEM:
// 查詢table2 表中的單條數(shù)據(jù)
break;
default: break;
}
}
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case TABLE1_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider.table1";
case TABLE1_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider.table1";
case TABLE2_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2";
case TABLE2_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider.table2";
default: break;
}
return null;
}
}
- 實(shí)現(xiàn)跨程序數(shù)據(jù)共享 /跨程序訪問時(shí)我們不能直接使用Toast/
- 首先在類的一開始，同樣是定義了四個(gè)常量践樱，分別用于表示訪問Book表中的所有數(shù)據(jù)厂画、訪問Book表中的單條數(shù)據(jù)、訪問Category表中的所有數(shù)據(jù)和訪問Category表中的單條數(shù)據(jù)拷邢。
- 然后在靜態(tài)代碼塊里對(duì) UriMatcher進(jìn)行了初始化操作袱院，將期望匹配的幾種 URI格式添加了進(jìn)去。
- 接下來就是每個(gè)抽象方法的具體實(shí)現(xiàn)了，
- query()方法坑填，在這個(gè)方法中先獲取到了SQLiteDatabase的實(shí)例抛人，然后根據(jù)傳入的Uri參數(shù)判斷出用戶想要訪問哪張表，再調(diào)用SQLiteDatabase 的 query()進(jìn)行查詢脐瑰，并將 Cursor 對(duì)象返回就好了。
- 再往后就是 insert()方法廷臼， 同樣它也是先獲取到了 SQLiteDatabase的實(shí)例苍在，然后根據(jù)傳入的Uri參數(shù)判斷出用戶想要往哪張表里添加數(shù)據(jù)， 再調(diào)用 SQLiteDatabase 的 insert()方法進(jìn)行添加就可以了荠商。
- 接下來就是 update()方法了寂恬，也是先獲取SQLiteDatabase的實(shí)例，然后根據(jù)傳入的Uri參數(shù)判斷出用戶想要更新哪張表里的數(shù)據(jù)莱没，再調(diào)用SQLiteDatabase的 update()方法進(jìn)行更新就好了初肉，受影響的行數(shù)將作為返回值返回。
- 下面是 delete()方法饰躲，這里仍然是先獲取到 SQLiteDatabase 的實(shí)例牙咏，然后根據(jù)傳入的Uri參數(shù)判斷出用戶想要?jiǎng)h除哪張表里的數(shù)據(jù)，再調(diào)用 SQLiteDatabase 的 delete()方法進(jìn)行刪除就好了嘹裂，被刪除的行數(shù)將作為返回值返回妄壶。
- 最后是 getType()方法，這個(gè)方法中的代碼完全是按照上一節(jié)中介紹的格式規(guī)則編寫的寄狼，相信已經(jīng)沒有什么解釋的必要了丁寄。
- 在 AndroidManifest.xml文件中注冊內(nèi)容提供器
<provider
android:name="com.example.databasetest.DatabaseProvider"
android:authorities="com.example.databasetest.provider" >
</provider>
public class DatabaseProvider extends ContentProvider {
public static final int BOOK_DIR = 0;
public static final int BOOK_ITEM = 1;
public static final int CATEGORY_DIR = 2;
public static final int CATEGORY_ITEM = 3;
public static final String AUTHORITY = "com.example.databasetest.provider";
private static UriMatcher uriMatcher;
private MyDatabaseHelper dbHelper;
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI(AUTHORITY, "book", BOOK_DIR);
uriMatcher.addURI(AUTHORITY, "book/#", BOOK_ITEM);
uriMatcher.addURI(AUTHORITY, "category", CATEGORY_DIR);
uriMatcher.addURI(AUTHORITY, "category/#", CATEGORY_ITEM);
}
@Override
public boolean onCreate() {
dbHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2);
return true;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
SQLiteDatabase db = dbHelper.getReadableDatabase();
Cursor cursor = null;
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
cursor = db.query("Book", projection, selection, selectionArgs, null, null, sortOrder);
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
cursor = db.query("Book", projection, "id = ?", new String[] { bookId }, null, null,
sortOrder);
break;
case CATEGORY_DIR:
cursor = db.query("Category", projection, selection, selectionArgs, null, null,
sortOrder);
break;
case CATEGORY_ITEM:
String categoryId = uri.getPathSegments().get(1);
cursor = db.query("Category", projection, "id = ?", new String[] { categoryId }, null,
null, sortOrder);
break;
default:
break;
}
return cursor;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
SQLiteDatabase db = dbHelper.getWritableDatabase();
Uri uriReturn = null;
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
case BOOK_ITEM:
long newBookId = db.insert("Book", null, values);
uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);
break;
case CATEGORY_DIR:
case CATEGORY_ITEM:
long newCategoryId = db.insert("Category", null, values);
uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + newCategoryId);
break;
default:
break;
}
return uriReturn;
}
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
SQLiteDatabase db = dbHelper.getWritableDatabase();
int updatedRows = 0;
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
updatedRows = db.update("Book", values, selection, selectionArgs);
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
updatedRows = db.update("Book", values, "id = ?", new String[] { bookId });
break;
case CATEGORY_DIR:
updatedRows = db.update("Category", values, selection, selectionArgs);
break;
case CATEGORY_ITEM:
String categoryId = uri.getPathSegments().get(1);
updatedRows = db.update("Category", values, "id = ?", new String[] { categoryId });
break;
default:
break;
}
return updatedRows;
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
SQLiteDatabase db = dbHelper.getWritableDatabase();
int deletedRows = 0;
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
deletedRows = db.delete("Book", selection, selectionArgs);
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
deletedRows = db.delete("Book", "id = ?", new String[] { bookId });
break;
case CATEGORY_DIR:
deletedRows = db.delete("Category", selection, selectionArgs);
break;
case CATEGORY_ITEM:
String categoryId = uri.getPathSegments().get(1);
deletedRows = db.delete("Category", "id = ?", new String[] { categoryId });
break;
default:
break;
}
return deletedRows;
}
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
return "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.book";
case BOOK_ITEM:
return "vnd.android.cursor.item/vnd.com.example.databasetest.provider.book";
case CATEGORY_DIR:
return "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.category";
case CATEGORY_ITEM:
return "vnd.android.cursor.item/vnd.com.example.databasetest.provider.category";
}
return null;
}
}
- 實(shí)例
- 添加數(shù)據(jù)
Uri uri = Uri.parse("content://com.example.databasetest.provider/book");
ContentValues values = new ContentValues();
values.put("name", "A Clash of Kings");
values.put("author", "George Martin");
values.put("pages", 1040);
values.put("price", 22.85);
Uri newUri = getContentResolver().insert(uri, values);
newId = newUri.getPathSegments().get(1);
- 查詢數(shù)據(jù)
Uri uri = Uri.parse("content://com.example.databasetest.provider/book");
Cursor cursor = getContentResolver().query(uri, null, null, null, null);
if (cursor != null) {
while (cursor.moveToNext()) {
String name = cursor.getString(cursor.getColumnIndex("name"));
String author = cursor.getString(cursor.getColumnIndex("author"));
int pages = cursor.getInt(cursor.getColumnIndex("pages"));
double price = cursor.getDouble(cursor.getColumnIndex("price"));
Log.d("MainActivity", "book name is " + name);
Log.d("MainActivity", "book author is " + author);
Log.d("MainActivity", "book pages is " + pages);
Log.d("MainActivity", "book price is " + price);
}
cursor.close();
}
- 更新數(shù)據(jù)
Uri uri = Uri.parse("content://com.example.databasetest.provider/book/" + newId);
ContentValues values = new ContentValues();
values.put("name", "A Storm of Swords");
values.put("pages", 1216);
values.put("price", 24.05);
getContentResolver().update(uri, values, null, null);
- 刪除數(shù)據(jù)
Uri uri = Uri.parse("content://com.example.databasetest.provider/book/" + newId);
getContentResolver().delete(uri, null, null);
