Android学习笔记（6）：Hello Content Provider

前言

Content Provider——Android四大组件之一。

本文要点

1.Content Provider简介

2.URI简介

3.如何访问Content Provider中数据

一、Content Provider简介

Content Provider，Android四大组件之一。它是Android系统提供的在多个应用之间共享数据的一种机制。一个Content Provider类实现了一组标准的方法接口，从而能够让其他的应用保存或读取此Content Provider的各种数据类型。有几点说明：

（1）每个ContentProvider都会对外提供一个公共的URI（包装成Uri对象），如果应用程序有数据需要共享，就需要使用ContentProvider为这些数据定义一个URI，然后其他应用程序就可以通过ContentProvider传入这个URI来对数据进行操作。

（2）我们的APP可以通过实现一个Content Provider的抽象接口将自己的数据暴露出去，也可以通过ContentResolver接口访问Content Provider提供的数据；

（3）ContentResolver支持CRUD(create, retrieve, update, and delete)操作；

（4）Android系统提供了诸如：音频、视频、图片、通讯录等主要数据类型的Content Provider。我们也可以创建自己的Content Provider。

二、URI简介

URI唯一标识了Provider中的数据，当应用程序访问Content Provider中的数据时，URI将会是其中一个重要参数。URI包含了两部分内容：（1）要操作的Content Provider对象（2）要操作的Content Provider中数据的类型。

URI由以下几个部分组成：

（1）Scheme：在Android中URI的Scheme是不变的，即：Content://

（2）Authority：用于标识ContentProvider（API原文：A string that identifies the entire content provider.）；

（3）Path：用来标识我们要操作的数据。零个或多个段，用正斜杠（/）分割;

（4）ID：指定ID后，将操作指定ID的数据（ID也可以看成是path的一部分），ID在URI中是可选的（API原文：A unique numeric identifier for a single row in the subset of data identified by the preceding path part.）。

URI示例：

（1）content://media/internal/images   返回设备上存储的所有图片;

（2）content://media/internal/images /10 返回设备上存储的ID为10的图片 

操作URI经常会使用到UriMatcher和ContentUris两个类。

UriMatcher：用于匹配Uri；

ContentUris：用于操作Uri路径后面的ID部分，如提供了方法withAppendedId（）向URI中追加ID。

三、访问Content Provider中数据

应用程序访问Content Provider的内容需要用到ContentResolver对象，这里以操作Android通讯录提供的Content Provider为例来说明如何访问Content Provider中的数据。

1.创建一个project：HelloContentProvider，MainActivity的Layout文件命名为main.xml；

2.在文件：AndroidManifest.xml中添加Contact的读写权限；

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

3.在main.xml中添加几个button:Insert,Query,Update,Delete,并绑定onClick事件：

//main.xml代码

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="fill_parent" 
              android:layout_height="fill_parent" 
              android:orientation="vertical" >
    <TextView android:id="@+id/text"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:text="Hello Content Provider" />
    <Button android:id="@+id/btnInsert"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:width="100dp"
            android:text="Insert" 
            android:onClick="insertContact"/>
    <Button android:id="@+id/btnQuery"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:width="100dp"
            android:text="Query" 
            android:onClick="queryContacts"/>

    <Button android:id="@+id/btnUpdate"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:width="100dp"
            android:text="Update" 
            android:onClick="updateContact"/>
       <Button android:id="@+id/btnDelete"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:width="100dp"
            android:text="Delete" 
            android:onClick="deleteContact"/>
</LinearLayout>

4.在MainActivity.java中实现对通讯录联系人的增。删。改。查操作；

//Insert,这里将要创建的联系人(wZhang,15899998888)直接写在代码里了（偷点懒☺）

    
    //Insert Contact
    public void insertContact(View view){
        //获取ContentResolver
        ContentResolver resolver = this.getContentResolver();
        //创建ContentValues的实例
        ContentValues values = new ContentValues();    
        
        //将联系人姓名Insert到ContentResolver中
        values.put(Contacts.People.NAME,"wZhang");
        Uri newPersonUri = getContentResolver().insert(People.CONTENT_URI, values);
        
        //Insert联系人电话
        Uri uri = null;
        ContentValues numValues = new ContentValues();
        String tel = "15899998888";
        if (tel!="") {
            numValues.clear();            
            uri = Uri.withAppendedPath(newPersonUri, Contacts.People.Phones.CONTENT_DIRECTORY);
            numValues.put(Contacts.Phones.TYPE, Contacts.Phones.TYPE_MOBILE);
            numValues.put(Contacts.Phones.NUMBER, tel);
            getContentResolver().insert(uri, numValues);
            }  

        Toast.makeText(MainActivity.this, "Intert Contact:联系人wZhang,电话"+tel,Toast.LENGTH_LONG).show();
    }    

//Query

    
    //Query Contacts
    public void queryContacts(View view){
        ContentResolver resolver = this.getContentResolver();
        //查询所有的联系人
        Cursor cursor = resolver.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
        if (cursor.moveToFirst()) {
            int idColumn = cursor.getColumnIndex(ContactsContract.Contacts._ID);
            int displayNameColumn = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME);
            do {
                //获取联系人ID
                String contactId = cursor.getString(idColumn); 
                //获取联系人姓名
                String disPlayName = cursor.getString(displayNameColumn);
                Toast.makeText(MainActivity.this, "联系人姓名："+disPlayName,Toast.LENGTH_LONG).show();
                int phoneCount = cursor.getInt(cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER));
                 if (phoneCount > 0) {
                     Cursor phonesCursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,
                             ContactsContract.CommonDataKinds.Phone.CONTACT_ID+ " = " + contactId, null, null);
                     if (phonesCursor.moveToFirst()) {
                         do {
                             String phoneNumber = phonesCursor.getString(phonesCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
                             Toast.makeText(MainActivity.this, "联系人电话："+phoneNumber,Toast.LENGTH_LONG).show();                                 
                         }
                         while (phonesCursor.moveToNext());
                     }
                 }
            }
            while (cursor.moveToNext());
        }
    }

//Update，更新联系人这里没有实现

//Delete

    //Delete
    public void deleteContact(View view){
        ContentResolver resolver = this.getContentResolver();
        Cursor cursor = resolver.query(Data.CONTENT_URI,new String[] { Data.RAW_CONTACT_ID },
                ContactsContract.Contacts.DISPLAY_NAME + "=?",new String[] { "wZhang" }, null);
        ArrayList<ContentProviderOperation> ops = new ArrayList<ContentProviderOperation>();
        if (cursor.moveToFirst()) {
            do {
                long Id = cursor.getLong(cursor.getColumnIndex(Data.RAW_CONTACT_ID));
                ops.add(ContentProviderOperation.newDelete(ContentUris.withAppendedId(RawContacts.CONTENT_URI,Id)).build());
                try {
                    getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);
                    }
                catch (Exception e){}
                }
            while (cursor.moveToNext());
            cursor.close();
        Toast.makeText(MainActivity.this, "删除联系人wZhang成功",Toast.LENGTH_LONG).show();                                 
        }
    }

5.启动虚拟机（启动前,在Contact中手动添加一个联系人TEST），界面如下：

 

（1）点击Insert将预先定义的wZhang，15899998888信息插入到Contact中：

  

（2）点击Query查询，或者打开Contact查看刚刚添加的联系人（如下图）；

（3）点击Delete，然后再查看结果 (如下图)，可见确实删除成功了。

从上面的实例我们可以得到以下几点：

（1）访问Content Provider需要一定的操作权限；

（2）访问Content Prvider需要使用到ContentResolver对象；

（3）ContentResolver支持query，insert，delete，update操作；

（4）由URI确定Content Provider中要操作的具体数据；

（5）insert时，要添加的数据可以使用ContentValues封装。

本文简单的通过一个实例介绍了Content Provider。在Andriod中我们也可以创建自己的Content Provider，有时间把这部分内容补上。

源码下载：HelloContentProvider.rar