詳解Android ContentProvider的基本原理和使用

一、前言

Android 的數據存儲方式總共有五種,分別是:Shared Preferences、網絡存儲、文件存儲、外儲存儲、SQLite。但一般這些存儲都隻是在單獨的一個應用程序之中達到一個數據的共享,有時候我們需要操作其他應用程序的一些數據,就會用到 ContentProvider。而且 Android 為常見的一些數據提供瞭默認的 ContentProvider(包括音頻、視頻、圖片和通訊錄等)。

要實現與其他的 ContentProvider 通信首先要查找到對應的 ContentProvider 進行匹配。Android 中 ContenProvider 借助 ContentResolver 通過 Uri 與其他的 ContentProvider 進行匹配通信。

二、URI(Uniform Resource Identifier)

其它應用可以通過 ContentResolver 來訪問 ContentProvider 提供的數據,而 ContentResolver 通過 uri 來定位自己要訪問的數據,所以我們要先瞭解 uri。URI(Universal Resource Identifier)統一資源定位符,如果您使用過安卓的隱式啟動就會發現,在隱式啟動的過程中我們也是通過 uri 來定位我們需要打開的 Activity 並且可以在 uri 中傳遞參數。

URI 為系統中的每一個資源賦予一個名字,比方說通話記錄。每一個 ContentProvider 都擁有一個公共的 URI,用於表示 ContentProvider 所提供的數據。URI 的格式如下:

// 規則

[scheme:][//host:port][path][?query]

// 示例

content://com.wang.provider.myprovider/tablename/id:

1.標準前綴(scheme)——content://,用來說明一個Content Provider控制這些數據;

2.URI 的標識 (host:port)—— com.wang.provider.myprovider,用於唯一標識這個 ContentProvider,外部調用者可以根據這個標識來找到它。對於第三方應用程序,為瞭保證 URI 標識的唯一性,它必須是一個完整的、小寫的類名。這個標識在元素的authorities屬性中說明,一般是定義該 ContentProvider 的包.類的名稱;

3.路徑(path)——tablename,通俗的講就是你要操作的數據庫中表的名字,或者你也可以自己定義,記得在使用的時候保持一致就可以瞭;

4.記錄ID(query)——id,如果URI中包含表示需要獲取的記錄的 ID,則返回該id對應的數據,如果沒有ID,就表示返回全部;

對於第三部分路徑(path)做進一步的解釋,用來表示要操作的數據,構建時應根據實際項目需求而定。如:

  • 操作tablename表中id為11的記錄,構建路徑:/tablename/11;
  • 操作tablename表中id為11的記錄的name字段:tablename/11/name;
  • 操作tablename表中的所有記錄:/tablename;
  • 操作來自文件、xml或網絡等其他存儲方式的數據,如要操作xml文件中tablename節點下name字段:/ tablename/name;
  • 若需要將一個字符串轉換成Uri,可以使用Uri類中的parse()方法,
Uri uri = Uri.parse("content://com.wang.provider.myprovider/tablename");

再來看一個例子:

http://www.baidu.com:8080/wenku/jiatiao.html?id=123456&name=jack

uri 的各個部分在安卓中都是可以通過代碼獲取的,下面我們就以上面這個 uri 為例來說下獲取各個部分的方法:

  • getScheme():獲取 Uri 中的 scheme 字符串部分,在這裡是 http
  • getHost():獲取 Authority 中的 Host 字符串,即 www.baidu.com
  • getPost():獲取 Authority 中的 Port 字符串,即 8080
  • getPath():獲取 Uri 中 path 部分,即 wenku/jiatiao.html
  • getQuery():獲取 Uri 中的 query 部分,即 id=15&name=du

三、MIME

MIME 是指定某個擴展名的文件用一種應用程序來打開,就像你用瀏覽器查看 PDF 格式的文件,瀏覽器會選擇合適的應用來打開一樣。Android 中的工作方式跟 HTTP 類似,ContentProvider 會根據 URI 來返回 MIME 類型,ContentProvider 會返回一個包含兩部分的字符串。MIME 類型一般包含兩部分,如:

text/html

text/css

text/xml

application/pdf

分為類型和子類型,Android 遵循類似的約定來定義MIME類型,每個內容類型的 Android MIME 類型有兩種形式:多條記錄(集合)和單條記錄。

集合記錄(dir):

vnd.android.cursor.dir/自定義 

單條記錄(item):

vnd.android.cursor.item/自定義 

vnd 表示這些類型和子類型具有非標準的、供應商特定的形式。Android中類型已經固定好瞭,不能更改,隻能區別是集合還是單條具體記錄,子類型可以按照格式自己填寫。

在使用 Intent 時,會用到 MIME,根據 Mimetype 打開符合條件的活動。

四、UriMatcher

Uri 代表要操作的數據,在開發過程中對數據進行獲取時需要解析 Uri,Android 提供瞭兩個用於操作 Uri 的工具類,分別為 UriMatcher 和 ContentUris 。掌握它們的基本概念和使用方法,對一個 Android 開發者來說是一項必要的技能。

UriMatcher 類用於匹配 Uri,它的使用步驟如下:

將需要匹配的Uri路徑進行註冊,代碼如下:

//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼
UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH);
//如果match()方法匹配“content://com.wang.provider.myprovider/tablename”路徑,返回匹配碼為1
sMatcher.addURI("content://com.wang.provider.myprovider", " tablename ", 1);
//如果match()方法匹配content://com.wang.provider.myprovider/tablename/11路徑,返回匹配碼為2
sMatcher.addURI("com.wang.provider.myprovider", "tablename/#", 2);

此處采用 addURI 註冊瞭兩個需要用到的 URI;註意,添加第二個 URI 時,路徑後面的 id 采用瞭通配符形式 “#”,表示隻要前面三個部分都匹配上瞭就 OK。

註冊完需要匹配的 Uri 後,可以使用 sMatcher.match(Uri) 方法對輸入的 Uri 進行匹配,如果匹配就返回對應的匹配碼,匹配碼為調用 addURI() 方法時傳入的第三個參數。

switch (sMatcher.match(Uri.parse("content://com.zhang.provider.yourprovider/tablename/100"))) {
    case 1:
        //match 1, todo something
        break;
    case 2
        //match 2, todo something
        break;
    default:
        //match nothing, todo something
        break;
}

五、ContentUris

ContentUris 類用於操作 Uri 路徑後面的 ID 部分,它有兩個比較實用的方法:withAppendedId(Uri uri, long id) 和 parseId(Uri uri)。

withAppendedId(Uri uri, long id) 用於為路徑加上 ID 部分:

Uri uri = Uri.parse("content://cn.scu.myprovider/user")

//生成後的Uri為:content://cn.scu.myprovider/user/7
Uri resultUri = ContentUris.withAppendedId(uri, 7); 

parseId(Uri uri) 則從路徑中獲取 ID 部分:

Uri uri = Uri.parse("content://cn.scu.myprovider/user/7")

//獲取的結果為:7
long personid = ContentUris.parseId(uri);

ContentProvider 主要方法ContentProvider 是一個抽象類,如果我們需要開發自己的內容提供者我們就需要繼承這個類並復寫其方法,需要實現的主要方法如下:

  • public boolean onCreate():在創建 ContentProvider 時使用
  • public Cursor query():用於查詢指定 uri 的數據返回一個 Cursor
  • public Uri insert():用於向指定uri的 ContentProvider 中添加數據
  • public int delete():用於刪除指定 uri 的數據
  • public int update():用戶更新指定 uri 的數據
  • public String getType():用於返回指定的 Uri 中的數據 MIME 類型

數據訪問的方法 insert,delete 和 update 可能被多個線程同時調用,此時必須是線程安全的。

如果操作的數據屬於集合類型,那麼 MIME 類型字符串應該以 vnd.android.cursor.dir/ 開頭,

要得到所有 tablename 記錄: Uri 為 content://com.wang.provider.myprovider/tablename,那麼返回的MIME類型字符串應該為:vnd.android.cursor.dir/table。

如果要操作的數據屬於非集合類型數據,那麼 MIME 類型字符串應該以 vnd.android.cursor.item/ 開頭,

要得到 id 為 10 的 tablename 記錄,Uri 為 content://com.wang.provider.myprovider/tablename/10,那麼返回的 MIME 類型字符串為:vnd.android.cursor.item/tablename 。

5.1、方法使用示例

使用 ContentResolver 對 ContentProvider 中的數據進行操作的代碼如下:

ContentResolver resolver = getContentResolver();
Uri uri = Uri.parse("content://com.wang.provider.myprovider/tablename");
// 添加一條記錄
ContentValues values = new ContentValues();
values.put("name", "wang1");
values.put("age", 28);
resolver.insert(uri, values); 
// 獲取tablename表中所有記錄
Cursor cursor = resolver.query(uri, null, null, null, "tablename data");
while(cursor.moveToNext()){
   Log.i("ContentTest", "tablename_id="+ cursor.getInt(0)+ ", name="+ cursor.getString(1));
}
// 把id為1的記錄的name字段值更改新為zhang1
ContentValues updateValues = new ContentValues();
updateValues.put("name", "zhang1");
Uri updateIdUri = ContentUris.withAppendedId(uri, 2);
resolver.update(updateIdUri, updateValues, null, null);
// 刪除id為2的記錄,即字段age
Uri deleteIdUri = ContentUris.withAppendedId(uri, 2);
resolver.delete(deleteIdUri, null, null);

5.2、監聽數據變化

如果ContentProvider的訪問者需要知道數據發生的變化,可以在ContentProvider發生數據變化時調用getContentResolver().notifyChange(uri, null)來通知註冊在此URI上的訪問者。隻給出類中監聽部分的代碼:

public class MyProvider extends ContentProvider {
   public Uri insert(Uri uri, ContentValues values) {
      db.insert("tablename", "tablenameid", values);
      getContext().getContentResolver().notifyChange(uri, null);
   }
}

而訪問者必須使用 ContentObserver 對數據(數據采用 uri 描述)進行監聽,當監聽到數據變化通知時,系統就會調用 ContentObserver 的 onChange() 方法:

getContentResolver().registerContentObserver(Uri.parse("content://com.ljq.providers.personprovider/person"),
       true, new PersonObserver(new Handler()));
public class PersonObserver extends ContentObserver{
   public PersonObserver(Handler handler) {
      super(handler);
   }
   public void onChange(boolean selfChange) {
      //to do something
   }
}

六、實例說明

數據源是 SQLite, 用 ContentResolver 操作 ContentProvider。

Constant.java(儲存一些常量)

public class Constant {  
      
    public static final String TABLE_NAME = "user";  
      
    public static final String COLUMN_ID = "_id";  
    public static final String COLUMN_NAME = "name";  
       
       
    public static final String AUTOHORITY = "cn.scu.myprovider";  
    public static final int ITEM = 1;  
    public static final int ITEM_ID = 2;  
       
    public static final String CONTENT_TYPE = "vnd.android.cursor.dir/user";  
    public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/user";  
       
    public static final Uri CONTENT_URI = Uri.parse("content://" + AUTOHORITY + "/user");  
}

DBHelper.java (操作數據庫)

public class DBHelper extends SQLiteOpenHelper {  
  
    private static final String DATABASE_NAME = "finch.db";    
    private static final int DATABASE_VERSION = 1;    
  
    public DBHelper(Context context) {  
        super(context, DATABASE_NAME, null, DATABASE_VERSION);  
    }  
  
    @Override  
    public void onCreate(SQLiteDatabase db)  throws SQLException {  
        //創建表格  
        db.execSQL("CREATE TABLE IF NOT EXISTS "+ Constant.TABLE_NAME + "("+ Constant.COLUMN_ID +" INTEGER PRIMARY KEY AUTOINCREMENT," + Constant.COLUMN_NAME +" VARCHAR NOT NULL);");  
    }  
  
    @Override  
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)  throws SQLException {  
        // 這裡知識簡單刪除並創建表格 
        // 如果需要保留原來的數據,需要先備份再刪除
        db.execSQL("DROP TABLE IF EXISTS "+ Constant.TABLE_NAME+";");  
        onCreate(db);  
    }  
}

MyProvider.java (自定義的 ContentProvider ) 

public class MyProvider extends ContentProvider {    
    
    DBHelper mDbHelper = null;    
    SQLiteDatabase db = null;    
    
    private static final UriMatcher mMatcher;    
    static{    
        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);      // 註冊 uri   
        mMatcher.addURI(Constant.AUTOHORITY,Constant.TABLE_NAME, Constant.ITEM);    
        mMatcher.addURI(Constant.AUTOHORITY, Constant.TABLE_NAME+"/#", Constant.ITEM_ID);    
    }    
    
  
    @Override    
    public String getType(Uri uri) {      // 根據匹配規則返回對應的類型   
        switch (mMatcher.match(uri)) {    
        case Constant.ITEM:    
            return Constant.CONTENT_TYPE;    
        case Constant.ITEM_ID:    
            return Constant.CONTENT_ITEM_TYPE;    
        default:    
            throw new IllegalArgumentException("Unknown URI"+uri);    
        }    
    }    
    
    @Override    
    public Uri insert(Uri uri, ContentValues values) {    
        // TODO Auto-generated method stub    
        long rowId;    
        if(mMatcher.match(uri)!=Constant.ITEM){    
            throw new IllegalArgumentException("Unknown URI"+uri);    
        }    
        rowId = db.insert(Constant.TABLE_NAME,null,values);    
        if(rowId>0){    
            Uri noteUri=ContentUris.withAppendedId(Constant.CONTENT_URI, rowId);    
            getContext().getContentResolver().notifyChange(noteUri, null);    
            return noteUri;    
        }    
    
        throw new SQLException("Failed to insert row into " + uri);    
    }    
    
    @Override    
    public boolean onCreate() {    
        // TODO Auto-generated method stub    
        mDbHelper = new DBHelper(getContext());    
        db = mDbHelper.getReadableDatabase();    
    
        return true;    
    }    
    
    @Override    
    public Cursor query(Uri uri, String[] projection, String selection,    
            String[] selectionArgs, String sortOrder) {    
        // TODO Auto-generated method stub    
        Cursor c = null;    
        switch (mMatcher.match(uri)) {    
        case Constant.ITEM:    
            c =  db.query(Constant.TABLE_NAME, projection, selection, selectionArgs, null, null, sortOrder);    
            break;    
        case Constant.ITEM_ID:    
            c = db.query(Constant.TABLE_NAME, projection,Constant.COLUMN_ID + "="+uri.getLastPathSegment(), selectionArgs, null, null, sortOrder);    
            break;    
        default:    
            throw new IllegalArgumentException("Unknown URI"+uri);    
        }    
    
        c.setNotificationUri(getContext().getContentResolver(), uri);    
        return c;    
    }    
    
    @Override    
    public int update(Uri uri, ContentValues values, String selection,    
            String[] selectionArgs) {    
        // TODO Auto-generated method stub    
        return 0;    
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // TODO Auto-generated method stub
        return 0;
    }    
    
}

MainActivity.java(ContentResolver操作)

public class MainActivity extends Activity {
    private ContentResolver mContentResolver = null; 
    private Cursor cursor = null;  
         @Override
        protected void onCreate(Bundle savedInstanceState) {
            // TODO Auto-generated method stub
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            
               TextView tv = (TextView) findViewById(R.id.tv);
                
                mContentResolver = getContentResolver();  
                tv.setText("添加初始數據 ");
                for (int i = 0; i < 10; i++) {  
                    ContentValues values = new ContentValues();  
                    values.put(Constant.COLUMN_NAME, "fanrunqi"+i);  
                    mContentResolver.insert(Constant.CONTENT_URI, values);  
                } 
                
                tv.setText("查詢數據 ");
                cursor = mContentResolver.query(Constant.CONTENT_URI, new String[]{Constant.COLUMN_ID,Constant.COLUMN_NAME}, null, null, null);  
                if (cursor.moveToFirst()) {
                    String s = cursor.getString(cursor.getColumnIndex(Constant.COLUMN_NAME));
                    tv.setText("第一個數據: "+s);
                }
        }
         
}

最後在manifest申明 :

<provider android:name="MyProvider" android:authorities="cn.scu.myprovider" />

七、總結

  • 如何通過 ContentProvider 查詢數據? 通過 ContentResolver 進行uri匹配
  • 如何實現自己的ContentProvider? 繼承 ContentProvider,實現對應的方法。在 manifest 中聲明

7.1、額外補充:隱式 Intent 中 <data> 標簽

該部分內容與ContentProvider 沒關系,隻是這裡講到瞭 URI,就順便此處在插入另外一個知識點:Intent 中 <data> 標簽。看不懂的可以直接略過,看下一步分的內容,此處內容與 activity 相關。

Data 的匹配規則:如果過濾規則 intent-filter 中定義瞭 data,那麼 Intent 中必須也要攜帶可匹配的 data

data 的語法如下所示:

<data android:scheme=“string”
      android:host=“string”
      android:port=“string”
      android:path=“string”
      android:pathPattern=“string”
      android:pathPrefix=“string”
      android:mimeType=“string”>

data 由兩部分組成:mimeType 和 URI。mimeType 可以為空,URI 一定不會為空,因為有默認值。mimeType 指媒體類型,比如 image/jpeg,video/* 等,可表示圖片,視頻等不同的媒體格式

示例1

data 的匹配:

<intent-filter>
     <action android:name="com.action.demo1"></action>
     <category android:name="android.intent.category.DEFAULT" />
     <data
         android:scheme="x7"
         android:host="www.360.com"
            />
 </intent-filter>

清單文件 intent-filter 定義的 data 中,隻有 URI, 沒有 mimeType 類型,匹配如下

intent.setData(Uri.parse("x7://www.360.com"))

示例2

<intent-filter>
       <action android:name="com.action.demo1"></action>
       <category android:name="android.intent.category.DEFAULT" />
       <data android:mimeType="image/*" />
 </intent-filter>

清單文件 intent-filter 定義的 data 中,沒有定義 URI,隻有 mimeType 類型,但是 URI 卻有默認值,URI 中的 scheme 默認為 content 或者 file,host 一定不能為空,隨便給個字符串abc 都可以,匹配如下

intent.setDataAndType(Uri.parse("content://abc"),"image/png");

註意:

content://abc 換成 file://abc 在 7.0 以上的版本(即把 targetSdkVersion 指定成 24 及之上並且在 API>=24 的設備上運行)會出現 FileUriExposedException 異常,google 提供瞭FileProvider 解決這個異常,使用它可以生成 content://Uri 來替代 file://Uri.

示例3

<intent-filter>
      <action android:name="com.action.demo1"></action>
      <category android:name="android.intent.category.DEFAULT" />
        <data
               android:mimeType="image/*"
               android:scheme="x7"
               android:host="www.360.com"
         />
        <data
             android:mimeType="video/*"
             android:scheme="x7"
             android:host="www.360.com"
         />
</intent-filter>

清單文件 intent-filter 定義的 data 中,URI 和 mimeType 都有, 匹配如下:

intent.setDataAndType(Uri.parse("x7://www.360.com"),"image/png");
// 或者
intent.setDataAndType(Uri.parse("x7://www.360.com"),"video/mpeg");

Inent 中攜帶的 data 標簽對應的數據,在某一組 intent-filter 中可以找到,即匹配成功。data 標簽數據在 intent-filter 中也可以有多組隱示啟動,防止匹配失敗的可以提前檢測。

判斷的方法如下:

PackageManager mPackageManager = getPackageManager();
//返回匹配成功中最佳匹配的一個act信息,intent 需要按照前面的把 action, data 等都設置好
ResolveInfo info = mPackageManager.resolveActivity(intent,PackageManager.MATCH_DEFAULT_ONLY);
//返回所有匹配成功的act信息,是一個集合
 List<ResolveInfo> infoList = mPackageManager.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);

隻要上述 2 個方法的返回值不為 null,那麼 startActivity 一定可以成功

以上就是詳解Android ContentProvider的基本原理和使用的詳細內容,更多關於Android ContentProvider的資料請關註WalkonNet其它相關文章!

推薦閱讀: