Android開發之ContentProvider

ContentProvider在android中的作用是對外共享數據，也就是說你可以通過ContentProvider把應用中的數據共享給其他應用訪問，其他應用可以通過ContentProvider對你應用中的數據進行添刪改查。使用ContentProvider對外共享數據的好處是統一了數據的訪問方式。

當應用需要通過ContentProvider對外共享數據時，第一步需要繼承ContentProvider並重寫下面方法：

public class PersonContentProvider extends ContentProvider{
   public boolean onCreate()
   public Uri insert(Uri uri, ContentValues values)
   public int delete(Uri uri, String selection, String[] selectionArgs)
   public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
   public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
   public String getType(Uri uri)
}

第二步需要在AndroidManifest.xml使用<provider>對該ContentProvider進行配置，爲了能讓其他應用找到該ContentProvider ，ContentProvider採用了authorities（主機名/域名）對它進行唯一標識，你可以把ContentProvider看作是一個網站（想想，網站也是提供數據者），authorities 就是他的域名：

<manifest.... >
   <application android:icon="@drawable/icon" android:label="@string/app_name">
      <provider android:name=".PersonContentProvider" 
           android:authorities="com.ljq.providers.personprovider"/>
   </application>
</manifest>

二、Uri介紹

Uri代表了要操作的數據，Uri主要包含了兩部分信息：1》需要操作的ContentProvider ，2》對ContentProvider中的什麼數據進行操作，一個Uri由以下幾部分組成：          

                 

ContentProvider（內容提供者）的scheme已經由Android所規定， scheme爲：content://
主機名（或叫Authority）用於唯一標識這個ContentProvider，外部調用者可以根據這個標識來找到它。
路徑（path）可以用來表示我們要操作的數據，路徑的構建應根據業務而定，如下:
要操作person表中id爲10的記錄，可以構建這樣的路徑:/person/10
要操作person表中id爲10的記錄的name字段， person/10/name
要操作person表中的所有記錄，可以構建這樣的路徑:/person
要操作xxx表中的記錄，可以構建這樣的路徑:/xxx
當然要操作的數據不一定來自數據庫，也可以是文件、xml或網絡等其他存儲方式，如下:
要操作xml文件中person節點下的name節點，可以構建這樣的路徑：/person/name
如果要把一個字符串轉換成Uri，可以使用Uri類中的parse()方法，如下：
Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person")

三、UriMatcher類使用介紹

因爲Uri代表了要操作的數據，所以我們經常需要解析Uri，並從Uri中獲取數據。Android系統提供了兩個用於操作Uri的工具類，分別爲UriMatcher和ContentUris 。掌握它們的使用，會便於我們的開發工作。
UriMatcher類用於匹配Uri，它的用法如下：
首先第一步把你需要匹配Uri路徑全部給註冊上，如下：

//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼 UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH); //如果match()方法匹配content://com.ljq.provider.personprovider/person路徑，返回匹配碼爲1 sMatcher.addURI("com.ljq.provider.personprovider", "person", 1);//添加需要匹配uri，如果匹配就會返回匹配碼 //如果match()方法匹配content://com.ljq.provider.personprovider/person/230路徑，返回匹配碼爲2 sMatcher.addURI("com.ljq.provider.personprovider", "person/#", 2);//#號爲通配符 switch (sMatcher.match(Uri.parse("content://com.ljq.provider.personprovider/person/10"))) { case 1 break; case 2 break; default://不匹配 break; }

註冊完需要匹配的Uri後，就可以使用sMatcher.match(uri)方法對輸入的Uri進行匹配，如果匹配就返回匹配碼，匹配碼是調用addURI()方法傳入的第三個參數，假設匹配content://com.ljq.provider.personprovider/person路徑，返回的匹配碼爲1 

四、ContentUris類使用介紹

ContentUris類用於操作Uri路徑後面的ID部分，它有兩個比較實用的方法：
withAppendedId(uri, id)用於爲路徑加上ID部分：

Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person") Uri resultUri = ContentUris.withAppendedId(uri, 10); //生成後的Uri爲：content://com.ljq.provider.personprovider/person/10

parseId(uri)方法用於從路徑中獲取ID部分：

Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person/10") long personid = ContentUris.parseId(uri);//獲取的結果爲:10

          

              

五、使用ContentProvider共享數據

ContentProvider類主要方法的作用：
public boolean onCreate()：該方法在ContentProvider創建後就會被調用，Android開機後，ContentProvider在其它應用第一次訪問它時纔會被創建。
public Uri insert(Uri uri, ContentValues values)：該方法用於供外部應用往ContentProvider添加數據。
public int delete(Uri uri, String selection, String[] selectionArgs)：該方法用於供外部應用從ContentProvider刪除數據。
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)：該方法用於供外部應用更新ContentProvider中的數據。
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)：該方法用於供外部應用從ContentProvider中獲取數據。
public String getType(Uri uri)：該方法用於返回當前Url所代表數據的MIME類型。

如果操作的數據屬於集合類型，那麼MIME類型字符串應該以vnd.android.cursor.dir/開頭，

例如：要得到所有person記錄的Uri爲content://com.ljq.provider.personprovider/person，那麼返回的MIME類型字符串應該爲："vnd.android.cursor.dir/person"。

如果要操作的數據屬於非集合類型數據，那麼MIME類型字符串應該以vnd.android.cursor.item/開頭，

例如：得到id爲10的person記錄，Uri爲content://com.ljq.provider.personprovider/person/10，那麼返回的MIME類型字符串爲："vnd.android.cursor.item/person"。

              

                

六、使用ContentResolver操作ContentProvider中的數據

當外部應用需要對ContentProvider中的數據進行添加、刪除、修改和查詢操作時，可以使用ContentResolver 類來完成，要獲取ContentResolver 對象，可以使用Activity提供的getContentResolver()方法。 ContentResolver 類提供了與ContentProvider類相同簽名的四個方法：
public Uri insert(Uri uri, ContentValues values)：該方法用於往ContentProvider添加數據。
public int delete(Uri uri, String selection, String[] selectionArgs)：該方法用於從ContentProvider刪除數據。
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)：該方法用於更新ContentProvider中的數據。
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)：該方法用於從ContentProvider中獲取數據。

這些方法的第一個參數爲Uri，代表要操作的ContentProvider和對其中的什麼數據進行操作，

假設給定的是：Uri.parse("content://com.ljq.providers.personprovider/person/10")，那麼將會對主機名爲com.ljq.providers.personprovider的ContentProvider進行操作，操作的數據爲person表中id爲10的記錄。

使用ContentResolver對ContentProvider中的數據進行添加、刪除、修改和查詢操作：

ContentResolver resolver = getContentResolver(); Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person"); //添加一條記錄 ContentValues values = new ContentValues(); values.put("name", "linjiqin"); values.put("age", 25); resolver.insert(uri, values); //獲取person表中所有記錄 Cursor cursor = resolver.query(uri, null, null, null, "personid desc"); while(cursor.moveToNext()){ Log.i("ContentTest", "personid="+ cursor.getInt(0)+ ",name="+ cursor.getString(1)); } //把id爲1的記錄的name字段值更改新爲zhangsan ContentValues updateValues = new ContentValues(); updateValues.put("name", "zhangsan"); Uri updateIdUri = ContentUris.withAppendedId(uri, 2); resolver.update(updateIdUri, updateValues, null, null); //刪除id爲2的記錄 Uri deleteIdUri = ContentUris.withAppendedId(uri, 2); resolver.delete(deleteIdUri, null, null);

            

               

七、監聽ContentProvider中數據的變化

如果ContentProvider的訪問者需要知道ContentProvider中的數據發生變化，可以在ContentProvider發生數據變化時調用getContentResolver().notifyChange(uri, null)來通知註冊在此URI上的訪問者，例子如下：

public class PersonContentProvider extends ContentProvider { public Uri insert(Uri uri, ContentValues values) { db.insert("person", "personid", values); getContext().getContentResolver().notifyChange(uri, null); } }

如果ContentProvider的訪問者需要得到數據變化通知，必須使用ContentObserver對數據（數據採用uri描述）進行監聽，當監聽到數據變化通知時，系統就會調用ContentObserver的onChange()方法：

getContentResolver().registerContentObserver(Uri.parse("content://com.ljq.providers.personprovider/person"), true, new PersonObserver(new Handler())); public class PersonObserver extends ContentObserver{ public PersonObserver(Handler handler) { super(handler); } public void onChange(boolean selfChange) { //此處可以進行相應的業務處理 } }