標籤:android contentprovider contentresolver 內容提供者 sqlite
這篇文章將全面地介紹ContentProvider,從最基礎的知識講到最重要,最核心的知識,大家可以根據目錄選擇性閱讀,大神請見諒。下文設計SQLite操作,沒有詳細解說,只要簡介ContentProvider在跨進程的使用。
初探Uri
Uri代表了要操作的資料,主要包含了兩部分資訊:1.需要操作的ContentProvider ,2.對ContentProvider中的什麼資料進行操作,一個Uri由以下幾部分組成:
content://com.gdut.yummylau/person/10
scheme
ContentProvider(內容提供者)的scheme已經由Android所規定為:content://。
主機名稱(或Authority)
用於唯一標識這個ContentProvider,外部調用者可以根據這個標識來找到它。
路徑(path)
可以用來表示我們要操作的資料,路徑的構建應根據業務而定,如下:
? 要操作person表中id為10的記錄,可以構建這樣的路徑:/person/10
? 要操作person表中id為10的記錄的name欄位, person/10/name
? 要操作person表中的所有記錄,可以構建這樣的路徑:/person
如果要把一個字串轉換成Uri,可以使用Uri類中的parse()方法,如:Uri uri = Uri.parse("content://com.gdut.yummylau/contact")
因為Uri代表了要操作的資料,所以我們很經常需要解析Uri,並從Uri中擷取資料。Android系統提供了兩個用於操作Uri的工具類,分別為UriMatcher 和ContentUris 。掌握它們的使用,會便於我們的開發工作。
UriMatcher:(先看代碼)
//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼 UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH); //如果match()方法匹配content://<span style="font-family: Arial, Helvetica, sans-serif; font-size: 12px;">com.gdut.yummylau</span>/person路徑,返回匹配碼為1,匹配Uri註冊如下: sMatcher.addURI("com.gdut.yummylau", person", 1);//添加需要匹配uri,如果匹配就會返回匹配碼 //如果match()方法匹配content://<span style="font-family: Arial, Helvetica, sans-serif; font-size: 12px;">com.gdut.yummylau</span>/person/230路徑,返回匹配碼為2,配Uri註冊如下: sMatcher.addURI("com.gdut.yummylau", "person/#", 2);//#號為萬用字元 //傳入Uri,進行匹配 switch (sMatcher.match(Uri.parse("content://com.gdut.yummylau/person/10"))) { case 1 break; case 2 break; default://不匹配 break; }從上述代碼可以看到,步驟大致為:
1.首先把你需要匹配Uri路徑全部給註冊上,如下:
//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼(-1)。
UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
//如果match()方法匹配content://com.gdut.yummylau/contact路徑,返回匹配碼為1
uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact”, 1);//添加需要匹配uri,如果匹配就會返回匹配碼
//如果match()方法匹配 content://com.gdut.yummylau/contact/230路徑,返回匹配碼為2
uriMatcher.addURI(“com.gdut.yummylau”, “contact/#”, 2);//#號為萬用字元
2.註冊完需要匹配的Uri後,就可以使用uriMatcher.match(uri)方法對輸入的Uri進行匹配,如果匹配就返回匹配碼,匹配碼是調用addURI()方法傳入的第三個參數,假設匹配
content://com.gdut.yummylau/contact路徑,返回的匹配碼為1。
ContentUris(先看代碼)
Uri uri = Uri.parse("content://com.gdut.yummylau/person") Uri resultUri = ContentUris.withAppendedId(uri, 10); //產生後的Uri為:content://com.gdut.yummylau/person/10 parseId(uri)用於從路徑中擷取Id,如下: Uri uri = Uri.parse("content://com.gdut.yummylau/person/10") long personid = ContentUris.parseId(uri);//擷取的結果為:10 上述的代碼用於擷取Uri路徑後面的ID部分,它有兩個比較實用的方法:
? withAppendedId(uri, id)用於為路徑加上ID部分
? parseId(uri)方法用於從路徑中擷取ID部分
再探ContentProvider可能有些朋友還不自知道上面介紹的Uri類到底用來做什麼。其實在android系統中,為儲存和擷取資料提供統一的介面,可以在不同的應用程式之間共用資料。Android才誕生ContentProvider。當應用繼承ContentProvider類,並重寫該類用於提供資料和儲存資料的方法,就可以向其他應用共用其資料。雖然使用其他方法也可以對外共用資料,但資料訪問方式會因資料存放區的方式而不同,如:採用檔案方式對外共用資料,需要進行檔案操作讀寫資料;採用sharedpreferences共用資料,需要使用sharedpreferences API讀寫資料。而使用ContentProvider共用資料的好處是統一了資料訪問方式。先認識下自訂ContentProvider需要繼承哪些基本的方法(講代碼)
import android.content.ContentProvider;import android.content.ContentValues;import android.database.Cursor;import android.net.Uri;public class MyContentProvider extends ContentProvider{@Overridepublic boolean onCreate() {// TODO Auto-generated method stubreturn false;}@Overridepublic Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) {// TODO Auto-generated method stubreturn null;}@Overridepublic String getType(Uri uri) {// TODO Auto-generated method stubreturn null;}@Overridepublic Uri insert(Uri uri, ContentValues values) {// TODO Auto-generated method stubreturn null;}@Overridepublic int delete(Uri uri, String selection, String[] selectionArgs) {// TODO Auto-generated method stubreturn 0;}@Overridepublic int update(Uri uri, ContentValues values, String selection,String[] selectionArgs) {// TODO Auto-generated method stubreturn 0;}}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.gdut.yummylau/person,那麼返回的MIME類型字串應該為:"vnd.android.cursor.dir/person"。
如果要操作的資料屬於非集合類型資料,那麼MIME類型字串應該以vnd.android.cursor.item/開頭,
例如:得到id為10的person記錄,Uri為content://com.gudt.yummylau/person/10,那麼返回的MIME類型字串為:"vnd.android.cursor.item/person"。
重寫上述方法(涉及資料的增刪更查及其反饋資料類型)後,還需要在AndroidManifest.xml使用<provider>對該ContentProvider進行配置,為了能讓其他應用找到該ContentProvider ,ContentProvider採用了authorities(主機名稱/網域名稱)對它進行唯一標識,你可以把ContentProvider看作是一個網站,authorities 就是他的網域名稱:
<manifest.... > <application android:icon="@drawable/icon" android:label="@string/app_name"> <provider android:name=".MyContentProvider" android:authorities="com.gdut.yummylau"/> </application></manifest>
內容接受者ContentResolver有了內容的提供者,對於外部的應用需要有內容的接收者才行。當外部應用需要對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.gdut.yummylau/person/10"),那麼將會對主機名稱為com.gdut.yummylau的ContentProvider進行操作,操作的資料為person表中id為10的記錄。
使用ContentResolver對ContentProvider中的資料進行添加、刪除、修改和查詢操作:(見代碼)
ContentResolver resolver = getContentResolver();Uri uri = Uri.parse("content://<span style="font-size:14px;">com.gdut.yummylau</span>/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欄位值更改新為zhangsanContentValues updateValues = new ContentValues();updateValues.put("name", "zhangsan");Uri updateIdUri = ContentUris.withAppendedId(uri, 1);resolver.update(updateIdUri, updateValues, null, null);//刪除id為2的記錄Uri deleteIdUri = ContentUris.withAppendedId(uri, 2);resolver.delete(deleteIdUri, null, null);
如果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://<span style="font-size:14px;">com.gdut.yummylau</span>/person"), true, new PersonObserver(new Handler()));public class PersonObserver extends ContentObserver{ public PersonObserver(Handler handler) { super(handler); } public void onChange(boolean selfChange) { //此處可以進行相應的業務處理 }}
小結使用ContentProvider的好處在於系統屏蔽了所有想要暴露的資料的儲存方式,以統一的暴露資料的介面供開發人員使用,開發人員可以用ContentProvider實現android上不同儲存方式下的資料跨進程共用。而ContentResolver 接受內容都是借ContentProvider之手,保證了資料的處理唯一性。
android四大組件之ContentProvider