ContentProvider(內容提供者)在android中的作用是對外共享數據,也就是說你可以通過ContentProvider把應用中的數據共享給其他應用訪問,其他應用可以通過ContentProvider對你應用中的數據進行添刪改查
主要方法:
public boolean onCreate()
在創建ContentProvider時調用
public Cursor query(Uri, String[], String, String[], String)
用於查詢指定Uri的ContentProvider,返回一個Cursor
public Uri insert(Uri, ContentValues)
用於添加數據到指定Uri的ContentProvider中
public int update(Uri, ContentValues, String, String[])
用於更新指定Uri的ContentProvider中的數據
public int delete(Uri, String, String[])
用於從指定Uri的ContentProvider中刪除數據
public String getType(Uri)
用於返回指定的Uri中的數據的MIME類型
當外部應用需要對ContentProvider中的數據進行添加、刪除、修改和查詢操作時,可以使用ContentResolver類來完成,要獲取ContentResolver對象,可以使用Context提供的getContentResolver()方法。
ContentResolver cr = getContentResolver();
ContentResolver提供的方法和ContentProvider提供的方法對應的有以下幾個方法。
public Uri insert(Uri uri, ContentValues values)
用於添加數據到指定Uri的ContentProvider中。
public int delete(Uri uri, String selection, String[] selectionArgs)
用於從指定Uri的ContentProvider中刪除數據。
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
用於更新指定Uri的ContentProvider中的數據。
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
用於查詢指定Uri的ContentProvider。
ContentResolver resolver = getContentResolver();
Uri uri = Uri.parse("content://com.bing.provider.personprovider/person");
//添加一條記錄
ContentValues values =
new ContentValues();
values.put("name",
"bingxin");
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);
URI相關介紹:
URI爲系統的每一個資源給其一個名字,指定了將要操作的ContentProvider,每一個ContentProvider都擁有一個公共的URI,這個URI用於表示這個ContentProvider所提供的數據。
"content://cn.bs.testcontentprovider/person/3" //URI
可以將URI分爲4部分:
"content://":標準前綴,用來說明一個Content Provider控制這些數據,無法改變的;
cn.bs.testcontentprovider:URI的標識,用於唯一標識這個ContentProvider,外部調用者可以根據這個標識來找到它。它定義了是哪個Content Provider提供這些數據。對於第三方應用程序,爲了保證URI標識的唯一性,它必須是一個完整的、小寫的類名。這個標識在 元素的 authorities屬性中說明:一般是定義該ContentProvider的包.類的名稱
person: URI 的標識,用於唯一標識這個ContentProvider,外部調用者可以根據這個標識來找到它。它定義了是哪個Content Provider提供這些數據。對於第三方應用程序,爲了保證URI標識的唯一性,它必須是一個完整的、小寫的類名。這個標識在 元素的 authorities屬性中說明:一般是定義該ContentProvider的包.類的名稱
3:記錄ID,如果URI中包含表示需要獲取的記錄的ID;則就返回該id對應的數據,如果沒有ID,就表示返回全部;
路徑(path)可以用來表示我們要操作的數據,路徑的構建應根據業務而定,如下:
1、要操作person表中id爲10的記錄,可以構建這樣的路徑:/person/10
2、要操作person表中id爲10的記錄的name字段, person/10/name
3、要操作person表中的所有記錄,可以構建這樣的路徑:/person
4、要操作xxx表中的記錄,可以構建這樣的路徑:/xxx
5、當然要操作的數據不一定來自數據庫,也可以是文件、xml或網絡等其他存儲方式,如下:
要操作xml文件中person節點下的name節點,可以構建這樣的路徑:/person/name
6、如果要把一個字符串轉換成Uri,可以使用Uri類中的parse()方法,如下:
Uri uri = Uri.parse("content://com.bing.provider.personprovider/person")
UriMatcher類使用介紹
因爲Uri代表了要操作的數據,所以我們經常需要解析Uri,並從Uri中獲取數據。Android系統提供了兩個用於操作Uri的工具類,分別爲UriMatcher和ContentUris 。
UriMatcher類用於匹配Uri,它的用法如下:
首先第一步把你需要匹配Uri路徑全部給註冊上,如下:
UriMatcher sMatcher =
new UriMatcher(UriMatcher.NO_MATCH);//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼
//如果match()方法匹配content://com.bing.procvide.personprovider/person路徑,返回匹配碼爲1
sMatcher.addURI("com.bing.procvide.personprovider",
"person",
1);//添加需要匹配uri,如果匹配就會返回匹配碼
//如果match()方法匹配content://com.bing.provider.personprovider/person/230路徑,返回匹配碼爲2
sMatcher.addURI("com.bing.provider.personprovider",
"person/#",
2);//#號爲通配符
switch(sMatcher.match(Uri.parse("content://com.ljq.provider.personprovider/person/10")))
{
case
1
break;
case
2
break;
default://不匹配
break;
}
addURI()方法是用來增加其他URI匹配路徑的,
註冊完需要匹配的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.bing.provider.personprovider/person")
Uri resultUri = ContentUris.withAppendedId(uri,
10);
//生成後的Uri爲:content://com.bing.provider.personprovider/person/10
parseId(uri)方法用於從路徑中獲取ID部分:如
Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person/10")
long
personid = ContentUris.parseId(uri);//獲取的結果爲:10