ContentProvider和Uri詳解

 

 

 

問題引出: "/getScrollData" 的使用, java

public static final Uri INBOX_CONTENT_URI_SCROLLDATA = Uriandroid

.parse("content://" + SMS_CONFIG_AUTHORITY + "/"數據庫

+ SMS_INBOX_TABLE_NAME + "/getScrollData");網絡

Cursor cursor = cr.query(app

SystemSMSInboxConfig.INBOX_CONTENT_URI_SCROLLDATA, null, null,ide

new String[] { String.valueOf(start), String.valueOf(end) },工具

SystemSMSInboxConfig._ID + " desc ");學習

這個查詢是查詢整張表, 仍是隻查詢剩餘ID的一張表。網站

看provider實現, spa

case TYPE_SYSTEM_EVENT_LOG_LIMIT:
			return db.rawQuery("select * from "
					+ SystemSMSInboxConfig.SMS_INBOX_TABLE_NAME + " order by "
					+ sortOrder + " limit ?,? ", selectionArgs);

結論是:

使用了ID, 依然是基於整張表的,因此,能夠先過濾表中數據,而後在得到指定ID值的行。

 




1、使用ContentProvider(內容提供者)共享數據

ContentProvider在android中的做用是對外共享數據, 也就是說你能夠經過ContentProvider把應用中的數據共享給其餘應用訪問,其餘應用能夠經過ContentProvider對你應用中的數據 進行添刪改查。關於數據共享,之前咱們學習過文件操做模式,知道經過指定文件的操做模式爲Context.MODE_WORLD_READABLE或 Context.MODE_WORLD_WRITEABLE一樣也能夠對外共享數據。那麼,這裏爲什麼要使用ContentProvider對外共享數據 呢?是這樣的,若是採用文件操做模式對外共享數據,數據的訪問方式會因數據存儲的方式而不一樣,致使數據的訪問方式沒法統一,如:採用xml文件對外共享數 據,須要進行xml解析才能讀取數據;採用sharedpreferences共享數據,須要使用sharedpreferences API讀取數據。
使用ContentProvider對外共享數據的好處是統一了數據的訪問方式。
當應用須要經過ContentProvider對外共享數據時,第一步須要繼承ContentProvider並重寫下面方法:


  1. public class PersonContentProvider extends ContentProvider{
  2. public boolean onCreate()
  3. public Uri insert(Uri uri, ContentValues values)
  4. public int delete(Uri uri, String selection, String[] selectionArgs)
  5. public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
  6. public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
  7. public String getType(Uri uri)
  8. }
複製代碼
第二步須要在AndroidManifest.xml使用對該ContentProvider進行配置,爲了能讓 其餘應用找到該ContentProvider ,ContentProvider採用了authorities(主機名/域名)對它進行惟一標識,你能夠把ContentProvider看做是一個網 站(想一想,網站也是提供數據者),authorities 就是他的域名:
  1. <manifest.... >
  2.    <application android:icon="@drawable/icon" android:label="@string/app_name">
  3.       <provider android:name=".PersonContentProvider" 
  4.            android:authorities="com.ljq.providers.personprovider"/>
  5.    </application>
  6. </manifest>
複製代碼

2、Uri介紹

Uri表明了要操做的數據,Uri主要包含了兩部分信息:1》須要操做的ContentProvider ,2》對ContentProvider中的什麼數據進行操做,一個Uri由如下幾部分組成:         

2011052823392991.png

                 

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



3、UriMatcher類使用介紹

由於Uri表明了要操做的數據,因此咱們常常須要解析Uri,並從Uri中獲取數據。Android系統提供了兩個用於操做Uri的工具類,分別爲UriMatcher和ContentUris 。掌握它們的使用,會便於咱們的開發工做。
UriMatcher類用於匹配Uri,它的用法以下:
首先第一步把你須要匹配Uri路徑所有給註冊上,以下:


  1. //常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼
  2. UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH);
  3. //若是match()方法匹配content://com.ljq.provider.personprovider/person路徑,返回匹配碼爲1
  4. sMatcher.addURI("com.ljq.provider.personprovider", "person", 1);//添加須要匹配uri,若是匹配就會返回匹配碼
  5. //若是match()方法匹配content://com.ljq.provider.personprovider/person/230路徑,返回匹配碼爲2
  6. sMatcher.addURI("com.ljq.provider.personprovider", "person/#", 2);//#號爲通配符
  7. switch (sMatcher.match(Uri.parse("content://com.ljq.provider.personprovider/person/10"))) { 
  8. case 1
  9. break;
  10. case 2
  11. break;
  12. default://不匹配
  13. break;
  14. }
複製代碼

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



4、ContentUris類使用介紹

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


  1. Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person")
  2. Uri resultUri = ContentUris.withAppendedId(uri, 10); 
  3. //生成後的Uri爲:content://com.ljq.provider.personprovider/person/10
複製代碼
parseId(uri)方法用於從路徑中獲取ID部分:

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

5、使用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"。



6、使用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中的數據進行添加、刪除、修改和查詢操做:


  1. ContentResolver resolver = getContentResolver();
  2. Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person");
  3. //添加一條記錄
  4. ContentValues values = new ContentValues();
  5. values.put("name", "linjiqin");
  6. values.put("age", 25);
  7. resolver.insert(uri, values); 
  8. //獲取person表中全部記錄
  9. Cursor cursor = resolver.query(uri, null, null, null, "personid desc");
  10. while(cursor.moveToNext()){
  11. Log.i("ContentTest", "personid="+ cursor.getInt(0)+ ",name="+ cursor.getString(1));
  12. }
  13. //把id爲1的記錄的name字段值更改新爲zhangsan
  14. ContentValues updateValues = new ContentValues();
  15. updateValues.put("name", "zhangsan");
  16. Uri updateIdUri = ContentUris.withAppendedId(uri, 2);
  17. resolver.update(updateIdUri, updateValues, null, null);
  18. //刪除id爲2的記錄
  19. Uri deleteIdUri = ContentUris.withAppendedId(uri, 2);
  20. resolver.delete(deleteIdUri, null, null);
複製代碼

7、監聽ContentProvider中數據的變化

若是ContentProvider的訪問者須要知道ContentProvider中的數據發生變化,能夠在ContentProvider發生 數據變化時調用getContentResolver().notifyChange(uri, null)來通知註冊在此URI上的訪問者,例子以下:


  1. public class PersonContentProvider extends ContentProvider {
  2. public Uri insert(Uri uri, ContentValues values) {
  3. db.insert("person", "personid", values);
  4. getContext().getContentResolver().notifyChange(uri, null);
  5. }
  6. }
複製代碼
若是ContentProvider的訪問者須要獲得數據變化通知,必須使用ContentObserver對數據(數據採用uri描述)進行監聽,當監聽到數據變化通知時,系統就會調用ContentObserver的onChange()方法:

  1. getContentResolver().registerContentObserver(Uri.parse("content://com.ljq.providers.personprovider/person"),
  2. true, new PersonObserver(new Handler()));
  3. public class PersonObserver extends ContentObserver{
  4. public PersonObserver(Handler handler) {
  5. super(handler);
  6. }
  7. public void onChange(boolean selfChange) {
  8. //此處能夠進行相應的業務處理
  9. }
  10. }
相關文章
相關標籤/搜索