ContentProvider初探

2023-03-31 13:45 更新

本節(jié)引言:

本節(jié)給大家?guī)淼氖茿ndroid四大組件中的最后一個——ContentProvider(內(nèi)容提供者),可能部分讀者 有疑問了,"Android不是有五大組件的嗎?還有個Intent呢?"對的,Intent也是很重要的,但是他 只是維系這幾個組件間的紐帶!Intent我們下一章會講解!說會這個ContentProvider,我們什么時候 會用到他呢?有下面這兩種:

  • 1.我們想在自己的應(yīng)用中訪問別的應(yīng)用,或者說一些ContentProvider暴露給我們的一些數(shù)據(jù), 比如手機聯(lián)系人,短信等!我們想對這些數(shù)據(jù)進行讀取或者修改,這就需要用到ContentProvider了!
  • 2.我們自己的應(yīng)用,想把自己的一些數(shù)據(jù)暴露出來,給其他的應(yīng)用進行讀取或操作,我們也可以用 到ContentProvider,另外我們可以選擇要暴露的數(shù)據(jù),就避免了我們隱私數(shù)據(jù)的的泄露!

好像好流弊的樣子,其實用起來也很簡單,下面我們來對ContentProvider進行學(xué)習(xí)~ 官方文檔ContentProvider 本節(jié)我們來講解下ContentProvder的概念,給大家寫幾個常用的使用系統(tǒng)ContentProvider的示例, 以及自定義ContentProvider!


1.ContentProvider概念講解:


2.使用系統(tǒng)提供的ContentProvider

其實很多時候我們用到ContentProvider并不是自己暴露自己的數(shù)據(jù),更多的時候通過 ContentResolver來讀取其他應(yīng)用的信息,最常用的莫過于讀取系統(tǒng)APP,信息,聯(lián)系人, 多媒體信息等!如果你想來調(diào)用這些ContentProvider就需要自行查閱相關(guān)的API資料了! 另外,不同的版本,可能對應(yīng)著不同的URL!這里給出如何獲取URL與對應(yīng)的數(shù)據(jù)庫表的字段, 這里以最常用的聯(lián)系人為例,其他自行g(shù)oogle~
①來到系統(tǒng)源碼文件下:all-src.rar -> TeleponeProvider -> AndroidManifest.xml查找對應(yīng)API
②打開模擬器的file exploer/data/data/com.android.providers.contacts/databases/contact2.db 導(dǎo)出后使用SQLite圖形工具查看,三個核心的表:raw_contact表data表,mimetypes表!
下面演示一些基本的操作示例:


1)簡單的讀取收件箱信息:

核心代碼:

private void getMsgs(){
    Uri uri = Uri.parse("content://sms/");
    ContentResolver resolver = getContentResolver();
    //獲取的是哪些列的信息
    Cursor cursor = resolver.query(uri, new String[]{"address","date","type","body"}, null, null, null);
    while(cursor.moveToNext())
    {
        String address = cursor.getString(0);
        String date = cursor.getString(1);
        String type = cursor.getString(2);
        String body = cursor.getString(3);
        System.out.println("地址:" + address);
        System.out.println("時間:" + date);
        System.out.println("類型:" + type);
        System.out.println("內(nèi)容:" + body);
        System.out.println("======================");
    }
    cursor.close();
}

別忘了,往AndroidManifest.xml加入讀取收件箱的權(quán)限:

<uses-permission android:name="android.permission.READ_SMS"/>

運行結(jié)果:

部分運行結(jié)果如下:


2)簡單的往收件箱里插入一條信息

核心代碼:

private void insertMsg() {
    ContentResolver resolver = getContentResolver();
    Uri uri = Uri.parse("content://sms/");
    ContentValues conValues = new ContentValues();
    conValues.put("address", "123456789");
    conValues.put("type", 1);
    conValues.put("date", System.currentTimeMillis());
    conValues.put("body", "no zuo no die why you try!");
    resolver.insert(uri, conValues);
    Log.e("HeHe", "短信插入完畢~");
}

運行結(jié)果:

注意事項:

上述代碼在4.4以下都可以實現(xiàn)寫入短信的功能,而5.0上就無法寫入,原因是: 從5.0開始,默認短信應(yīng)用外的軟件不能以寫入短信數(shù)據(jù)庫的形式發(fā)短信!


3)簡單的讀取手機聯(lián)系人

核心代碼:

private void getContacts(){
    //①查詢raw_contacts表獲得聯(lián)系人的id
    ContentResolver resolver = getContentResolver();
    Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
    //查詢聯(lián)系人數(shù)據(jù)
    cursor = resolver.query(uri, null, null, null, null);
    while(cursor.moveToNext())
    {
        //獲取聯(lián)系人姓名,手機號碼
        String cName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
        String cNum = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
        System.out.println("姓名:" + cName);
        System.out.println("號碼:" + cNum);
        System.out.println("======================");
    }
    cursor.close();
}

別忘了加讀聯(lián)系人的權(quán)限:

<uses-permission android:name="android.permission.READ_CONTACTS"/>

運行結(jié)果:

部分運行結(jié)果如下:


4)查詢指定電話的聯(lián)系人信息

核心代碼:

private void queryContact(String number){
        Uri uri = Uri.parse("content://com.android.contacts/data/phones/filter/" + number);
        ContentResolver resolver = getContentResolver();
        Cursor cursor = resolver.query(uri, new String[]{"display_name"}, null, null, null);
        if (cursor.moveToFirst()) {
            String name = cursor.getString(0);
            System.out.println(number + "對應(yīng)的聯(lián)系人名稱:" + name);
        }
    cursor.close();
}

運行結(jié)果:


5)添加一個新的聯(lián)系人

核心代碼:

private void AddContact() throws RemoteException, OperationApplicationException {
    //使用事務(wù)添加聯(lián)系人
    Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
    Uri dataUri =  Uri.parse("content://com.android.contacts/data");

    ContentResolver resolver = getContentResolver();
    ArrayList<ContentProviderOperation> operations = new ArrayList<ContentProviderOperation>();
    ContentProviderOperation op1 = ContentProviderOperation.newInsert(uri)
            .withValue("account_name", null)
            .build();
    operations.add(op1);

    //依次是姓名,號碼,郵編
    ContentProviderOperation op2 = ContentProviderOperation.newInsert(dataUri)
            .withValueBackReference("raw_contact_id", 0)
            .withValue("mimetype", "vnd.android.cursor.item/name")
            .withValue("data2", "Coder-pig")
            .build();
    operations.add(op2);

    ContentProviderOperation op3 = ContentProviderOperation.newInsert(dataUri)
            .withValueBackReference("raw_contact_id", 0)
            .withValue("mimetype", "vnd.android.cursor.item/phone_v2")
            .withValue("data1", "13798988888")
            .withValue("data2", "2")
            .build();
    operations.add(op3);

    ContentProviderOperation op4 = ContentProviderOperation.newInsert(dataUri)
            .withValueBackReference("raw_contact_id", 0)
            .withValue("mimetype", "vnd.android.cursor.item/email_v2")
            .withValue("data1", "779878443@qq.com")
            .withValue("data2", "2")
            .build();
    operations.add(op4);
    //將上述內(nèi)容添加到手機聯(lián)系人中~
    resolver.applyBatch("com.android.contacts", operations);
    Toast.makeText(getApplicationContext(), "添加成功", Toast.LENGTH_SHORT).show();
}

運行結(jié)果:

別忘了權(quán)限:

<uses-permission android:name="android.permission.WRITE_CONTACTS"/>
<uses-permission android:name="android.permission.WRITE_PROFILE"/>

3.自定義ContentProvider

我們很少會自己來定義ContentProvider,因為我們很多時候都不希望自己應(yīng)用的數(shù)據(jù)暴露給 其他應(yīng)用,雖然這樣,學(xué)習(xí)如何ContentProvider還是有必要的,多一種數(shù)據(jù)傳輸?shù)姆绞剑前蓗
這是之前畫的一個流程圖:

接下來我們就來一步步實現(xiàn):

在開始之前我們先要創(chuàng)建一個數(shù)據(jù)庫創(chuàng)建類(數(shù)據(jù)庫內(nèi)容后面會講~):

DBOpenHelper.java

public class DBOpenHelper extends SQLiteOpenHelper {

    final String CREATE_SQL = "CREATE TABLE test(_id INTEGER PRIMARY KEY AUTOINCREMENT,name)";

    public DBOpenHelper(Context context, String name, CursorFactory factory,
            int version) {
        super(context, name, null, 1);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_SQL);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // TODO Auto-generated method stub

    }

}

Step 1:自定義ContentProvider類,實現(xiàn)onCreate(),getType(),根據(jù)需求重寫對應(yīng)的增刪改查方法:

NameContentProvider.java

public class NameContentProvider extends ContentProvider {

    //初始化一些常量
     private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);        
     private DBOpenHelper dbOpenHelper;

    //為了方便直接使用UriMatcher,這里addURI,下面再調(diào)用Matcher進行匹配

     static{  
         matcher.addURI("com.jay.example.providers.myprovider", "test", 1);
     }  

    @Override
    public boolean onCreate() {
        dbOpenHelper = new DBOpenHelper(this.getContext(), "test.db", null, 1);
        return true;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
            String[] selectionArgs, String sortOrder) {
        return null;
    }

    @Override
    public String getType(Uri uri) {
        return null;
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {

        switch(matcher.match(uri))
        {
        //把數(shù)據(jù)庫打開放到里面是想證明uri匹配完成
        case 1:
            SQLiteDatabase db = dbOpenHelper.getReadableDatabase();
            long rowId = db.insert("test", null, values);
            if(rowId > 0)
            {
                //在前面已有的Uri后面追加ID
                Uri nameUri = ContentUris.withAppendedId(uri, rowId);
                //通知數(shù)據(jù)已經(jīng)發(fā)生改變
                getContext().getContentResolver().notifyChange(nameUri, null);
                return nameUri;
            }
        }
        return null;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        return 0;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,
            String[] selectionArgs) {
        return 0;
    }

}

Step 2:AndroidManifest.xml中為ContentProvider進行注冊:

<!--屬性依次為:全限定類名,用于匹配的URI,是否共享數(shù)據(jù) -->
<provider android:name="com.jay.example.bean.NameContentProvider"
            android:authorities="com.jay.example.providers.myprovider"
            android:exported="true" />

好的,作為ContentProvider的部分就完成了!


接下來,創(chuàng)建一個新的項目,我們來實現(xiàn)ContentResolver的部分,我們直接通過按鈕點擊插入一條數(shù)據(jù):

MainActivity.java

public class MainActivity extends Activity {

    private Button btninsert;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        btninsert = (Button) findViewById(R.id.btninsert);

        //讀取contentprovider 數(shù)據(jù)  
        final ContentResolver resolver = this.getContentResolver();

        btninsert.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                 ContentValues values = new ContentValues();
                 values.put("name", "測試");
                 Uri uri = Uri.parse("content://com.jay.example.providers.myprovider/test");
                resolver.insert(uri, values);
                Toast.makeText(getApplicationContext(), "數(shù)據(jù)插入成功", Toast.LENGTH_SHORT).show();

            }
        });

    }
}

如何使用? 好吧,代碼還是蠻簡單的,先運行作為ContentProvider的項目,接著再運行ContentResolver的項目, 點擊按鈕插入一條數(shù)據(jù),然后打開file exploer將ContentProvider的db數(shù)據(jù)庫取出,用圖形查看工具 查看即可發(fā)現(xiàn)插入數(shù)據(jù),時間關(guān)系,就不演示結(jié)果了~


4.通過ContentObserver監(jiān)聽ContentProvider的數(shù)據(jù)變化

使用指南

運行程序后,晾一邊,收到短信后,可以在logcat上看到該條信息的內(nèi)容,可以根據(jù)自己的需求 將Activtiy改做Service,而在后臺做這種事情~


本節(jié)小結(jié):

好的,關(guān)于ContentProvider的初探就到這里,本節(jié)我們學(xué)習(xí)了: ContentProvider的概念以及流程,使用系統(tǒng)提供的一些ContentProvider,以及定制自己的ContentProvider, 最后還講解了通過ContentObserver監(jiān)聽ContentProvider的數(shù)據(jù)變化,ContentProvider的內(nèi)容就掌握得差不多 了,下一節(jié)我們來走走文檔看下有什么不知道的~謝謝s

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號