萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android ContentProvider 與 ContentResolver:跨應用資料共享核心機制深度解析

Android 系統為了安全性,預設每個應用獨立運行於各自的 Dalvik/ART 虛擬機與沙箱中,資料預設私有不可跨應用存取。若需實現應用間資料共享,唯一標準途徑即為 ContentProvider 搭配 ContentResolver。

核心概念

  • ContentProvider(資料提供者):封裝資料存取邏輯,以「資料表」形式對外暴露資料,支援 insert()、delete()、query()、update() 四大基本操作。提供者不關心資料底層是 SQLite、檔案還是網路獲取,呼叫端只見統一介面。
  • ContentResolver(資料解析器):消費端透過它與 Provider 溝通,根據 URI 定位目標 Provider 並發起 CRUD 請求。
  • URI(Uniform Resource Identifier):跨應用資料定位的關鍵,格式為 content://authority/path/id。
    authority(授權碼)對應 AndroidManifest.xml 中 <provider> 的 android:authorities 屬性,必須唯一(慣用完整包名)。
    path 區分資料類型(如 contacts/phones),id 若存在則針對單筆記錄,否則針對整張表。

URI 結構拆解範例

content://com.example.transportationprovider/trains/123
│           │                              │        │
│           │                              │        └─ D: 記錄 ID (可省略)
│           │                              └─ C: 路徑 (資料類型)
│           └─ B: Authority (Provider 唯一標識)
└─ A: 固定前綴 content://

Android 提供輔助常數簡化 URI 使用,如 ContactsContract.Contacts.CONTENT_URI。

ContentResolver 主要 API

回傳型別方法簽名說明
Uriinsert(Uri url, ContentValues values)插入一列資料,回傳新列的 URI
intdelete(Uri url, String where, String[] selectionArgs)刪除符合條件的列,回傳影響列數
Cursorquery(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)查詢資料,回傳 Cursor 游標
intupdate(Uri uri, ContentValues values, String where, String[] selectionArgs)更新符合條件的列,回傳影響列數

用法與 SQLiteDatabase 極為相似,差別在於操作對象是跨進程的 Provider。

取得 ContentResolver 實例

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" />

執行驗證

  1. 啟動模擬器,在「聯絡人」App 新增兩筆測試資料。
  2. 返回 Home 執行本範例 App,即可看到剛新增的聯絡人名單。

補充: Android 6.0 (API 23) 起引入執行時權限,除在 Manifest 宣告外,尚需在程式碼中動態請求 READ_CONTACTS 權限,否則查詢會回傳空游標或拋出 SecurityException。

copyright © 萬盛學電腦網 all rights reserved