ContentProvider 認識:
Content providers負責管理結構化數據的訪問,Content providers封裝數據並且提供一套定義數據安全的機制。
Content providers是一套在不同進程間進行數據訪問的接口。
Content providers為數據跨進程訪問提供了一套安全的訪問機制,對數據組織和安全訪問提供了可靠的保證。
Content Providers的使用的:
通過Content Providers訪問數據時,在應用程序的上下文(Context)中使用ContentResolver對象最為客戶端(client)與 provider進行交互。
ContentResolver對象通過實現抽象類ContentProvider的一個實例來訪問provider。
Provider對象從客戶端(client)接收數據請求,執行請求操作並且返回請求結果。
Android通過Content Provider來管理數據諸如音頻、視頻、圖片和通訊錄等。
還可以通過ContentProvider來訪問SQLite數據庫等,下面來看看Content Provider的基本使用
在以下情況下你需要使用Content Providers:
1.你想為其他應用程序提供復雜數據或文件;
2.你想允許用戶從你的應用程序中拷貝復雜數據到其他的應用中
3.你想使用搜索框架提供自定義的查詢建議功能
一、使用ContentProvider(內容提供者)共享數據
ContentProvider在android中的作用是對外共享數據, 也就是說你可以通過ContentProvider把應用中的數據共享給其他應用訪問,其他應用可以通過ContentProvider對你應用中的數據 進行添刪改查。關於數據共享,以前我們學習過文件操作模式,知道通過指定文件的操作模式為Context.MODE_WORLD_READABLE或 Context.MODE_WORLD_WRITEABLE同樣也可以對外共享數據。那么,這里為何要使用ContentProvider對外共享數據 呢?是這樣的,如果采用文件操作模式對外共享數據,數據的訪問方式會因數據存儲的方式而不同,導致數據的訪問方式無法統一,如:采用xml文件對外共享數 據,需要進行xml解析才能讀取數據;采用sharedpreferences共享數據,需要使用sharedpreferences API讀取數據。
使用ContentProvider對外共享數據的好處是統一了數據的訪問方式。
當應用需要通過ContentProvider對外共享數據時,第一步需要繼承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 就是他的域名:
<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 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 resultUri = ContentUris.withAppendedId(uri, 10);
//生成后的Uri為:content://com.ljq.provider.personprovider/person/10
parseId(uri)方法用於從路徑中獲取ID部分:
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中的數據進行添加、刪除、修改和查詢操作:
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 Uri insert(Uri uri, ContentValues values) {
db.insert("person", "personid", values);
getContext().getContentResolver().notifyChange(uri, null);
}
}
如果ContentProvider的訪問者需要得到數據變化通知,必須使用ContentObserver對數據(數據采用uri描述)進行監聽,當監聽到數據變化通知時,系統就會調用ContentObserver的onChange()方法:
true, new PersonObserver(new Handler()));
public class PersonObserver extends ContentObserver{
public PersonObserver(Handler handler) {
super(handler);
}
public void onChange(boolean selfChange) {
//此處可以進行相應的業務處理
}
}
- public class PersonContentProvider extends ContentProvider{
- private DataBaseOpenHelper dataBaseOpenHelper;
- private static final int ALLPERSON=1;
- private static final int PERSON=2;
- private static final UriMatcher uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);
- static{
- uriMatcher.addURI("com.gao.provider.personprovider", "person", ALLPERSON);
- uriMatcher.addURI("com.gao.provider.personprovider", "person/#", PERSON);
- }
- @Override
- public int delete(Uri uri, String selection, String[] selectionArgs) {
- SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();
- int count=0;
- switch (uriMatcher.match(uri)) {
- case ALLPERSON://content://com.gao.provider.personprovider/person
- count=database.delete("person", selection, selectionArgs);
- break;
- case PERSON://content://com.gao.provider.personprovider/person/100
- long id=ContentUris.parseId(uri);
- String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
- String[] params=new String[]{String.valueOf(id)};
- if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {
- params=new String[selectionArgs.length+1];
- for (int i = 0; i < selectionArgs.length; i++) {
- params[i]=selectionArgs[i];
- }
- params[selectionArgs.length+1]=String.valueOf(id);
- }
- count=database.delete("person", where, selectionArgs);
- break;
- default:
- throw new IllegalArgumentException("Unkonw uri:"+uri);
- }
- return count;
- }
- @Override
- public String getType(Uri uri) {
- switch (uriMatcher.match(uri)) {
- case ALLPERSON:
- return "vnd.android.cursor.dir/personprovider.person";
- case PERSON:
- return "vnd.android.cursor.item/personprovider.person";
- default:
- break;
- }
- return null;
- }
- @Override
- public Uri insert(Uri uri, ContentValues values) {
- SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();
- long id=0;
- switch (uriMatcher.match(uri)) {
- case ALLPERSON://content://com.gao.provider.personprovider/person
- id=database.insert("person", "name", values);//返回記錄的行號,主鍵是int,實際上就是主鍵值
- return ContentUris.withAppendedId(uri, id);
- case PERSON://content://com.gao.provider.personprovider/person/100
- id=database.insert("person", "name", values);
- String path=uri.toString();
- return Uri.parse(path.substring(0, path.lastIndexOf("/"))+"id");
- default:
- throw new IllegalArgumentException("Unkonw uri:"+uri);
- }
- }
- @Override
- public boolean onCreate() {
- dataBaseOpenHelper=new DataBaseOpenHelper(this.getContext());
- return false;
- }
- @Override
- public Cursor query(Uri uri, String[] projection, String selection,
- String[] selectionArgs, String sortOrder) {
- SQLiteDatabase database=dataBaseOpenHelper.getReadableDatabase();
- switch (uriMatcher.match(uri)) {
- case ALLPERSON:
- database.query("person", projection, selection, selectionArgs, null, null, sortOrder);
- break;
- case PERSON:
- long id=ContentUris.parseId(uri);
- String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
- String[] params=new String[]{String.valueOf(id)};
- if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {
- params=new String[selectionArgs.length+1];
- for (int i = 0; i < selectionArgs.length; i++) {
- params[i]=selectionArgs[i];
- }
- params[selectionArgs.length+1]=String.valueOf(id);
- }
- database.query("person", projection, where, params, null, null, sortOrder);
- break;
- default:
- break;
- }
- return null;
- }
- //update("content://com.gao.provider.personprovider/person/100",values,"name like ? and ...",new String[]{"%gao%"});
- @Override
- public int update(Uri uri, ContentValues values, String selection,
- String[] selectionArgs) {
- SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();
- int count=0;
- switch (uriMatcher.match(uri)) {
- case ALLPERSON://content://com.gao.provider.personprovider/person
- count=database.update("person", values, selection,selectionArgs);
- break;
- case PERSON://content://com.gao.provider.personprovider/person/100
- long id=ContentUris.parseId(uri);
- String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
- String[] params=new String[]{String.valueOf(id)};
- if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {
- params=new String[selectionArgs.length+1];
- for (int i = 0; i < selectionArgs.length; i++) {
- params[i]=selectionArgs[i];
- }
- params[selectionArgs.length+1]=String.valueOf(id);
- }
- count=database.update("person", values, where,params);
- break;
- default:
- throw new IllegalArgumentException("Unkonw uri:"+uri);
- }
- return count;
- }
- }
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- ContentResolver contentResolver=this.getContentResolver();
- Uri allUri=Uri.parse("content://com.gao.provider.personprovider/person");
- ContentValues values=new ContentValues();
- values.put("name", "GGGGG");
- values.put("age", 19);
- contentResolver.insert(uri, values);
- values.put("name", "CCCCCC");
- values.put("age", 100);
- Uri uri=Uri.parse("content://com.gao.provider.personprovider/person/9");
- // contentResolver.update(uri, values, null, null);
- //contentResolver.delete(uri, null, null);
- Cursor cursor=contentResolver.query(uri, new String[]{"personid","name","age"}, null, null, "personid desc");
- while (cursor.moveToNext()) {
- Log.i(TAG, "psrsonid:"+cursor.getInt(0)+",name:"+cursor.getString(1)+",age"+cursor.getInt(2));
- }
- cursor.close();