ContentProvider(內容提供者)用法詳解

轉自http://blog.csdn.net/blogxiaofei/article/details/6580263

1、 ContentProvider簡介

當應用繼承ContentProvider類,並重寫該類用於提供數據和存儲數據的方法,就可以向其他應用共享其數據。雖然使用其他方法也可以對外共享數據,但數據訪問方式會因數據存儲的方式而不同。

如:採用文件方式對外共享數據,需要進行文件操作讀寫數據;採用sharedpreferences共享數據,需要使用sharedpreferences API讀寫數據。

而使用ContentProvider共享數據的好處是統一了數據訪問方式

2、通過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(主機名/域名)對它進行唯一標識。

<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(內容提供者)。

 

 3、URI

每Uri代表了要操作的數據,Uri主要包含了兩部分信息:

1>需要操作的ContentProvider

2>對ContentProvider中的什麼數據進行操作

一個Uri由以下幾部分組成:

 content://com.<公司名>.provider.應用程序名/person/10

主機名(或叫Authority)用於唯一標識這個ContentProvider,外部調用者可以根據這個標識來找到它。android:authority採取類似網站域名來給它賦值。一般這樣來定義authority:

com.<公司名>.provider.應用程序名

路徑(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:// com.<公司名>.provider.應用程序名/數據路徑 ")

把一個字符串轉化爲Uri

4、 UriMatcher類使用介紹(public classUriMatcher)

因爲Uri代表了要操作的數據,所以我們很經常需要解析Uri,並從Uri中獲取數據,Android系統提供了兩個用於操作Uri的工具類

A、public class UriMatcher

B、publicclass ContentUris

首先第一步把你需要匹配Uri路徑全部給註冊上,如下:

//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼

UriMatcher  sMatcher = newUriMatcher(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"))){

   case1

   break;

  case 2

   break;

  default://不匹配

    break;

}

註冊完需要匹配的Uri後,就可以使用sMatcher.match(uri)方法對輸入的Uri進行匹配,如果匹配就返回匹配碼,匹配碼是調用addURI()方法傳入的第三個參數,假設匹配content://cn.itcast.provider.personprovider/person路徑,返回的匹配碼爲1

代碼如下:

private static final UriMatcher uriMatcher;

static{

     uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);

   uriMatcher.addURI(“com.<公司名>.provider.應用程序名”,”items”,1);

   uriMatcher.addURI(“com.<公司名>.provider.應用程序名”,”items/#”,2);

}

 

5、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

6、public abstract class ContentProvider

ContentProvider類主要方法的作用:

public boolean onCreate()

該方法在ContentProvider創建後就會被調用, Android在系統啓動時就會創建ContentProvider。

public Uri insert(Uri uri, ContentValuesvalues)

該方法用於供外部應用往ContentProvider添加數據。

public int delete(Uri uri, Stringselection, String[] selectionArgs)

該方法用於供外部應用從ContentProvider刪除數據。

public int update(Uri uri, ContentValuesvalues, 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”。

7、使用ContentResolver操作ContentProvider中的數據

當外部應用需要對ContentProvider中的數據進行添加、刪除、修改和查詢操作時,可以使用ContentResolver 類來完成,要獲取ContentResolver對象,可以使用Activity提供的getContentResolver()方法。 ContentResolver 類提供了與ContentProvider類相同簽名的四個方法:

public Uri insert(Uri uri, ContentValuesvalues)

該方法用於往ContentProvider添加數據。

public int delete(Uri uri, Stringselection, String[] selectionArgs)

該方法用於從ContentProvider刪除數據。

public int update(Uri uri, ContentValuesvalues, 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的記錄。

使用方法:

1>得到ContentResolver對象。

2>定義一個Uri,ContentValues對象。

3>調用ContentResolver對象的方法。

使用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);

 

 


發佈了0 篇原創文章 · 獲贊 3 · 訪問量 4萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章