本文介紹了自訂Content Provider的相關內容,完全解析內容提供者的用法。Content Provider,內容提供者,相信大家對這個組件的名字都不陌生,可能是自己平時做的都是一些簡單的App,所以對於Content Provider的使用並不是很多,也不是特別熟悉。但是這裡還是對Content Provider作個簡單的總結,不是很深入,但是希望能給包括我在內的初學者一點協助,看完這篇能對這個組件有個總體上的瞭解。
一、使用ContentProvider(內容提供者)共用資料
ContentProvider在Android中的作用是對外共用資料,也就是說你可以通過ContentProvider把應用中的資料共用給其他應用訪問,其他應用可以通過ContentProvider對你應用中的資料進行添刪改查。關於資料共用,以前我們學習過檔案操作模式,知道通過指定檔案的操作模式為Context.MODE_WORLD_READABLE或Context.MODE_WORLD_WRITEABLE同樣也可以對外共用資料。那麼,這裡為何要使用ContentProvider對外共用資料呢?是這樣的,如果採用檔案操作模式對外共用資料,資料的訪問方式會因資料存放區的方式而不同,導致資料的訪問方式無法統一,如:採用xml檔案對外共用資料,需要進行xml解析才能讀取資料;採用sharedpreferences共用資料,需要使用sharedpreferences API讀取資料。使用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) { //此處可以進行相應的業務處理 } }
以上就是本文的全部內容,希望對大家的學習有所協助,也希望大家多多支援雲棲社區。