ContentProvider介紹及與ContentResolver使用

在Android 應用程式之間資料共享—-ContentResolver中，已經說明了Android是如何實作應用程式之間資料共享的，并詳細解析了如何擷取其他應用程式共享的資料。ContentProviders存儲和檢索資料，通過它可以讓所有的應用程式通路到，這也是應用程式之間唯一共享資料的方法。那麼如何将應用程式的資料暴露出去？

通過以前文章的學習，知道ContentResolver是通過ContentProvider來擷取其他與應用程式共享的資料，那麼ContentResolver與ContentProvider的接口應該差不多的。

其中ContentProvider負責

組織應用程式的資料；
向其他應用程式提供資料；

ContentResolver則負責

擷取ContentProvider提供的資料；
修改/添加/删除更新資料等；

ContentProvider 是如何向外界提供資料的？

Android提供了ContentProvider，一個程式可以通過實作一個ContentProvider的抽象接口将自己的資料完全暴露出去，而且ContentProviders是以類似資料庫中表的方式将資料暴露，也就是說ContentProvider就像一個“資料庫”。那麼外界擷取其提供的資料，也就應該與從資料庫中擷取資料的操作基本一樣，隻不過是采用URI來表示外界需要通路的“資料庫”。至于如何從URI中識别出外界需要的是哪個“資料庫”，這就是Android底層需要做的事情了，不在此詳細說。簡要分析下ContentProvider向外界提供資料操作的接口：

query(Uri, String[], String, String[], String)

insert(Uri, ContentValues)

update(Uri, ContentValues, String, String[])

delete(Uri, String, String[])

這些操作與資料庫的操作基本上完全一樣，在此不詳細說，具體的解析可以參考Android Sqlite解析篇中的詳細說明。需要特殊說明的地方是URI：

在URI的D部分可能包含一個_ID ，這個應該出現在SQL語句中的，可以以種特殊的方式出現，這就要求我們在提供資料的時候，需要來額外關注這個特殊的資訊。Android SDK推薦的方法是：在提供資料表字段中包含一個ID，在建立表時INTEGER PRIMARY KEY AUTOINCREMENT辨別此ID字段。

ContentProvider 是如何組織資料的？

組織資料主要包括：存儲資料，讀取資料，以資料庫的方式暴露資料。資料的存儲需要根據設計的需求，選擇合适的存儲結構，首選資料庫，當然也可以選擇本地其他檔案，甚至可以是網絡上的資料。資料的讀取，以資料庫的方式暴露資料這就要求，無論資料是如何存儲的，資料最後必須以資料的方式通路。

可能還有2個問題，是需要關注的。

ContentProvider是什麼時候建立的，是誰建立的？通路某個應用程式共享的資料，是否需要啟動這個應用程式？這個問題在Android SDK中沒有明确說明，但是從資料共享的角度出發，ContentProvider應該是Android在系統啟動時就建立了，否則就談不上資料共享了。這就要求在AndroidManifest.XML中使用<provider>元素明确定義。
可能會有多個程式同時通過ContentResolver通路一個ContentProvider，會不會導緻像資料庫那樣的“髒資料”？這個問題一方面需要資料庫通路的同步，尤其是資料寫入的同步，在AndroidManifest.XML中定義ContentProvider的時候，需要考慮是<provider>元素multiprocess屬性的值；另外一方面Android在ContentResolver中提供了notifyChange()接口，在資料改變時會通知其他ContentObserver，這個地方應該使用了觀察者模式，在ContentResolver中應該有一些類似register，unregister的接口。

至此，已經對ContentProvider提供了比較全面的分析，至于如何建立ContentProvider，可通過2種方法：建立一個屬于你自己的ContentProvider或者将你的資料添加到一個已經存在的ContentProvider中，當然前提是有相同資料類型并且有寫入Content provider的權限。在Android SDK的sample中提供的Notepad具體執行個體中去看源代碼！

使用 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 （内容提供者）。 l

Uri介紹： Uri代表了要操作的資料， Uri主要包含了兩部分資訊： 1》需要操作的ContentProvider ，2》對ContentProvider中的什麼資料進行操作，一個 Uri由以下幾部分組成： l

ContentProvider介紹及與ContentResolver使用

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

l 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 l 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 l使用 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 ”。 l使用 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://cn.itcast.provider.personprovider/person/10”)，那麼将會對主機名為 cn.itcast.provider.personprovider的 ContentProvider進行操作，操作的資料為 person表中 id為 10的記錄

l使用 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 plain copy

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;
}
}

AndroidManifest.xml： <provider android:name="PersonContentProvider" android:authorities="com.gao.provider.personprovider" /> 在另一個程式ContentProviderUser中使用上面的内容提供者： [java] view plain copy

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();

ContentProvider介紹及與ContentResolver使用

ContentProvider 是如何向外界提供資料的？

ContentProvider 是如何組織資料的？

繼續閱讀

專訪鄧凡平：深入了解Android

與專家面對面：Android開發入門問與答

Android MVP架構MVCMVP

mvp初探

Android常用工具類簡介目錄

android常用工具類轉載自：http://www.trinea.cn/android/android-common-utils/Android常用工具類

Android常用工具類ToastUtilsSizeUtilsLogUtilsRetrofitManagerAnimUtil

Android Studio 0.8.0解決 Failure [INSTALL_FAILED_OLDER_SDK] 問題

Android – ListView 中添加按鈕，動态删除添加ItemView的操作

Kotlin的ListView與RecyclerView的簡單應用

關于公司的那些坑：Android Studio篇

android SQLite事務和kotlin協程

無法正常編譯錯誤Compilation failed to complete

關于Gradle配置的小結

AOP程式設計_Android優雅權限架構(1)概念基礎，2021金三銀四前言正文大綱正文

Android APK檔案反編譯Android APK檔案反編譯