一、ContentProvider共享數據
當應用繼承ContentProvider類,並重寫該類用於提供數據和存儲數據的方法,就可以向其他應用共享其數據。雖然使用其他方法也可以對外共享數據,但數據訪問方式會因數據存儲的方式而不同,如:採用文件方式對外共享數據,需要進行文件操作讀寫數據;採用sharedpreferences共享數據,需要使用sharedpreferences API讀寫數據。而使用ContentProvider共享數據的好處是統一了數據訪問方式。
當應用需要通過ContentProvider對外共享數據時,第一步需要繼承ContentProvider並重寫下面方法:
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 就是他的域名:
<manifest .... >
<application android:icon="@drawable/icon" android:label="@string/app_name">
<provider android:name=".PersonContentProvider" android:authorities="cn.itcast.provider.personprovider"/>
</application>
</manifest>
注意:一旦應用繼承了ContentProvider類,後面我們就會把這個應用稱爲ContentProvider(內容提供者)。
二、Uri介紹
Uri代表了要操作的數據,Uri主要包含了兩部分信息:1》需要操作的ContentProvider ,2》對ContentProvider中的什麼數據進行操作,一個Uri由以下幾部分組成:
l
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文件中person節點下的name節點,可以構建這樣的路徑:/person/name
如果要把一個字符串轉換成Uri,可以使用Uri類中的parse()方法,如下:
Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person")
三、UriMatcher類使用
因爲Uri代表了要操作的數據,所以我們很經常需要解析Uri,並從Uri中獲取數據。Android系統提供了兩個用於操作Uri的工具類,分別爲UriMatcher 和ContentUris 。掌握它們的使用,會便於我們的開發工作。
UriMatcher類用於匹配Uri,它的用法如下:
首先第一步把你需要匹配Uri路徑全部給註冊上,如下:
//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼
UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH);
//如果match()方法匹配content://cn.itcast.provider.personprovider/person路徑,返回匹配碼爲1
sMatcher.addURI(“cn.itcast.provider.personprovider”, “person”, 1);//添加需要匹配uri,如果匹配就會返回匹配碼
//如果match()方法匹配content://cn.itcast.provider.personprovider/person/230路徑,返回匹配碼爲2
sMatcher.addURI(“cn.itcast.provider.personprovider”, “person/#”, 2);//#號爲通配符
switch (sMatcher.match(Uri.parse("content://cn.itcast.provider.personprovider/person/10"))) {
case 1
break;
case 2
break;
default://不匹配
break;
}
註冊完需要匹配的Uri後,就可以使用sMatcher.match(uri)方法對輸入的Uri進行匹配,如果匹配就返回匹配碼,匹配碼是調用addURI()方法傳入的第三個參數,假設匹配content://cn.itcast.provider.personprovider/person路徑,返回的匹配碼爲1
四、ContentUris類使用
ContentUris類用於獲取Uri路徑後面的ID部分,它有兩個比較實用的方法:
withAppendedId(uri, id)用於爲路徑加上ID部分:
Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person")
Uri resultUri = ContentUris.withAppendedId(uri, 10);
//生成後的Uri爲:content://cn.itcast.provider.personprovider/person/10
parseId(uri)方法用於從路徑中獲取ID部分:
Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person/10")
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://cn.itcast.provider.personprovider/person,那麼返回的MIME類型字符串應該爲:“vnd.android.cursor.dir/person”。如果要操作的數據屬於單一數據,那麼MIME類型字符串應該以vnd.android.cursor.item/開頭,例如:得到id爲10的person記錄,Uri爲content://cn.itcast.provider.personprovider/person/10,那麼返回的MIME類型字符串應該爲:“vnd.android.cursor.item/person”。
六、使用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://cn.itcast.provider.personprovider/person/10”),那麼將會對主機名爲cn.itcast.provider.personprovider的ContentProvider進行操作,操作的數據爲person表中id爲10的記錄
使用ContentResolver操作ContentProvider中的數據:
使用ContentResolver對ContentProvider中的數據進行添加、刪除、修改和查詢操作:
ContentResolver resolver = getContentResolver();
Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person");
//添加一條記錄
ContentValues values = new ContentValues();
values.put("name", "itcast");
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字段值更改新爲liming
ContentValues updateValues = new ContentValues();
updateValues.put("name", "liming");
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);
七、應用實例
[java] view plaincopy
1. public class PersonContentProvider extends ContentProvider{
2. private DataBaseOpenHelper dataBaseOpenHelper;
3. private static final int ALLPERSON=1;
4. private static final int PERSON=2;
5. private static final UriMatcher uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);
6. static{
7. uriMatcher.addURI("com.gao.provider.personprovider", "person", ALLPERSON);
8. uriMatcher.addURI("com.gao.provider.personprovider", "person/#", PERSON);
9.
10. }
11. @Override
12. public int delete(Uri uri, String selection, String[] selectionArgs) {
13. SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();
14. int count=0;
15. switch (uriMatcher.match(uri)) {
16. case ALLPERSON://content://com.gao.provider.personprovider/person
17. count=database.delete("person", selection, selectionArgs);
18. break;
19. case PERSON://content://com.gao.provider.personprovider/person/100
20. long id=ContentUris.parseId(uri);
21. String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
22. String[] params=new String[]{String.valueOf(id)};
23. if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {
24. params=new String[selectionArgs.length+1];
25. for (int i = 0; i < selectionArgs.length; i++) {
26. params[i]=selectionArgs[i];
27. }
28. params[selectionArgs.length+1]=String.valueOf(id);
29. }
30. count=database.delete("person", where, selectionArgs);
31. break;
32. default:
33. throw new IllegalArgumentException("Unkonw uri:"+uri);
34. }
35. return count;
36. }
37. @Override
38. public String getType(Uri uri) {
39. switch (uriMatcher.match(uri)) {
40. case ALLPERSON:
41. return "vnd.android.cursor.dir/personprovider.person";
42. case PERSON:
43. return "vnd.android.cursor.item/personprovider.person";
44. default:
45. break;
46. }
47. return null;
48. }
49. @Override
50. public Uri insert(Uri uri, ContentValues values) {
51. SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();
52. long id=0;
53. switch (uriMatcher.match(uri)) {
54. case ALLPERSON://content://com.gao.provider.personprovider/person
55. id=database.insert("person", "name", values);//返回記錄的行號,主鍵是int,實際上就是主鍵值
56. return ContentUris.withAppendedId(uri, id);
57. case PERSON://content://com.gao.provider.personprovider/person/100
58. id=database.insert("person", "name", values);
59. String path=uri.toString();
60. return Uri.parse(path.substring(0, path.lastIndexOf("/"))+"id");
61. default:
62. throw new IllegalArgumentException("Unkonw uri:"+uri);
63. }
64. }
65. @Override
66. public boolean onCreate() {
67. dataBaseOpenHelper=new DataBaseOpenHelper(this.getContext());
68. return false;
69. }
70. @Override
71. public Cursor query(Uri uri, String[] projection, String selection,
72. String[] selectionArgs, String sortOrder) {
73. SQLiteDatabase database=dataBaseOpenHelper.getReadableDatabase();
74. switch (uriMatcher.match(uri)) {
75. case ALLPERSON:
76. database.query("person", projection, selection, selectionArgs, null, null, sortOrder);
77. break;
78. case PERSON:
79. long id=ContentUris.parseId(uri);
80. String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
81. String[] params=new String[]{String.valueOf(id)};
82. if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {
83. params=new String[selectionArgs.length+1];
84. for (int i = 0; i < selectionArgs.length; i++) {
85. params[i]=selectionArgs[i];
86. }
87. params[selectionArgs.length+1]=String.valueOf(id);
88. }
89. database.query("person", projection, where, params, null, null, sortOrder);
90. break;
91. default:
92. break;
93. }
94. return null;
95. }
96. //update("content://com.gao.provider.personprovider/person/100",values,"name like ? and ...",new String[]{"%gao%"});
97. @Override
98. public int update(Uri uri, ContentValues values, String selection,
99. String[] selectionArgs) {
100. SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();
101. int count=0;
102. switch (uriMatcher.match(uri)) {
103. case ALLPERSON://content://com.gao.provider.personprovider/person
104. count=database.update("person", values, selection,selectionArgs);
105. break;
106. case PERSON://content://com.gao.provider.personprovider/person/100
107. long id=ContentUris.parseId(uri);
108. String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
109. String[] params=new String[]{String.valueOf(id)};
110. if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {
111. params=new String[selectionArgs.length+1];
112. for (int i = 0; i < selectionArgs.length; i++) {
113. params[i]=selectionArgs[i];
114. }
115. params[selectionArgs.length+1]=String.valueOf(id);
116. }
117. count=database.update("person", values, where,params);
118. break;
119. default:
120. throw new IllegalArgumentException("Unkonw uri:"+uri);
121. }
122. return count;
123. }
124. }
AndroidManifest.xml:
<provider android:name="PersonContentProvider"
android:authorities="com.gao.provider.personprovider" />
在另一個程序ContentProviderUser中使用上面的內容提供者:
[java] view plaincopy
1. public void onCreate(Bundle savedInstanceState) {
2. super.onCreate(savedInstanceState);
3. setContentView(R.layout.main);
4. ContentResolver contentResolver=this.getContentResolver();
5. Uri allUri=Uri.parse("content://com.gao.provider.personprovider/person");
6. ContentValues values=new ContentValues();
7. values.put("name", "GGGGG");
8. values.put("age", 19);
9. contentResolver.insert(uri, values);
10. values.put("name", "CCCCCC");
11. values.put("age", 100);
12. Uri uri=Uri.parse("content://com.gao.provider.personprovider/person/9");
13. // contentResolver.update(uri, values, null, null);
14. //contentResolver.delete(uri, null, null);
15. Cursor cursor=contentResolver.query(uri, new String[]{"personid","name","age"}, null, null, "personid desc");
16. while (cursor.moveToNext()) {
17. Log.i(TAG, "psrsonid:"+cursor.getInt(0)+",name:"+cursor.getString(1)+",age"+cursor.getInt(2));
18. }
19. cursor.close();