一、使用ContentProvider(內容提供者)共享數據
ContentProvider在android中的作用是對外共享數據,也就是說你可以通過ContentProvider把應用中的數據共享給其他應用訪問,其他應用可以通過ContentProvider對你應用中的數據進行添刪改查。關於數據共享,以前我們學習過文件操作模式,知道通過指定文件的操作模式爲Context.MODE_WORLD_READABLE或
Context.MODE_WORLD_WRITEABLE同樣也可以對外共享數據。那麼,這裏爲何要使用ContentProvider對外共享數據呢?是這樣的,如果採用文件操作模式對外共享數據,數據的訪問方式會因數據存儲的方式而不同,導致數據的訪問方式無法統一,如:採用xml文件對外共享數據,需要進行xml解析才能讀取數據;採用sharedpreferences共享數據,需要使用sharedpreferences API讀取數據。
使用ContentProvider對外共享數據的好處是統一了數據的訪問方式。
當應用需要通過ContentProvider對外共享數據時,第一步需要繼承ContentProvider並重寫下面方法:
1
2
3
4
5
6
7
8
|
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 就是他的域名:
1
2
3
4
5
6
|
< 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路徑全部給註冊上,如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
//常量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 ); //#號爲通配符
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部分:
1
2
3
|
Uri resultUri = ContentUris.withAppendedId(uri,
10 ); |
parseId(uri)方法用於從路徑中獲取ID部分:
1
2
|
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中的數據進行添加、刪除、修改和查詢操作:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
ContentResolver resolver = getContentResolver();
//添加一條記錄
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上的訪問者,例子如下:
1
2
3
4
5
6
|
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()方法:
1
2
3
4
5
6
7
8
9
10
|
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) { //此處可以進行相應的業務處理
} } |