Android 系統為了安全性,預設每個應用獨立運行於各自的 Dalvik/ART 虛擬機與沙箱中,資料預設私有不可跨應用存取。若需實現應用間資料共享,唯一標準途徑即為 ContentProvider 搭配 ContentResolver。
insert()、delete()、query()、update() 四大基本操作。提供者不關心資料底層是 SQLite、檔案還是網路獲取,呼叫端只見統一介面。content://authority/path/id。authority(授權碼)對應 AndroidManifest.xml 中 <provider> 的 android:authorities 屬性,必須唯一(慣用完整包名)。path 區分資料類型(如 contacts/phones),id 若存在則針對單筆記錄,否則針對整張表。content://com.example.transportationprovider/trains/123
│ │ │ │
│ │ │ └─ D: 記錄 ID (可省略)
│ │ └─ C: 路徑 (資料類型)
│ └─ B: Authority (Provider 唯一標識)
└─ A: 固定前綴 content://
Android 提供輔助常數簡化 URI 使用,如 ContactsContract.Contacts.CONTENT_URI。
| 回傳型別 | 方法簽名 | 說明 |
|---|---|---|
Uri | insert(Uri url, ContentValues values) | 插入一列資料,回傳新列的 URI |
int | delete(Uri url, String where, String[] selectionArgs) | 刪除符合條件的列,回傳影響列數 |
Cursor | query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) | 查詢資料,回傳 Cursor 游標 |
int | update(Uri uri, ContentValues values, String where, String[] selectionArgs) | 更新符合條件的列,回傳影響列數 |
用法與 SQLiteDatabase 極為相似,差別在於操作對象是跨進程的 Provider。
ContentResolver cr = getContentResolver(); // 在 Activity/Service/Application 內可用
public class ShowContactActivity extends ListActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 查詢電話號碼欄位
Cursor c = getContentResolver().query(
ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null, null, null, null);
startManagingCursor(c); // Activity 管理 Cursor 生命週期(API 級較低時使用)
ListAdapter adapter = new SimpleCursorAdapter(this,
android.R.layout.simple_list_item_2, c,
new String[]{ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
ContactsContract.CommonDataKinds.Phone.NUMBER},
new int[]{android.R.id.text1, android.R.id.text2});
setListAdapter(adapter);
}
}
在 AndroidManifest.xml 的 <application> 標籤前加入:
<uses-permission android:name="android.permission.READ_CONTACTS" />
補充: Android 6.0 (API 23) 起引入執行時權限,除在 Manifest 宣告外,尚需在程式碼中動態請求
READ_CONTACTS權限,否則查詢會回傳空游標或拋出SecurityException。