Android学习笔记（十）-数据共享标准：ContentProvider

　　当在系统中部署了一个又一个Android应用之后，系统里将会包含多个Android应用，有时候就需要在不同的应用之间共享数据，对于这种需要在不同应用之间共享数据的需求，当然可以让一个应用程序直接去操作另一个应用程序所记录的数据，比如操作它记录的SharedPreferences、文件或数据库等，这种方式显得太杂乱了，不同的应用程序记录数据的方式差别很大，这种方式不利于应用程序之间进行数据交换。为了在应用程序之间交换数据，Android提供了ContentProvider，ContentProvider是不同应用程序之间进行数据交换的标准API，ContentProvider以某种Uri的形式对外提供数据，允许其他应用访问或修改数据；其他应用程序通过ContentResolver根据Uri去访问操作指定数据。

　　可以把ContentProvider当成Android系统内部的“网站”，这个网站以固定的Uri对外提供服务；而ContentResolver则可以当成Android系统内部的HttpClient，它可以指定Uri发送“请求”（实际是调用ContentResolver的方法），这种请求最后委托给ContentProvider处理，从而实现对“网站”（即ContentProvider）内部数据的操作。

Uri介绍：

Uri代表了要操作的数据，Uri主要包含了两部分信息：1》需要操作的ContentProvider ，2》对ContentProvider中的什么数据进行操作，一个Uri由以下几部分组成：

content://com.geniusxiaoyu.provider.personprovider/person/10

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或网络等其他存储方式，如下:
要操作xml文件中person节点下的name节点，可以构建这样的路径：/person/name
如果要把一个字符串转换成Uri，可以使用Uri类中的parse()方法，如下：
Uri uri = Uri.parse("content://com.geniusxiaoyu.provider.personprovider/person")

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”。

ContentResolver介绍：

当外部应用需要对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.providers.personprovider/person/10”)，那么将会对主机名为cn.itcast.providers.personprovider的ContentProvider进行操作，操作的数据为person表中id为10的记录。

下面介绍一个使用ContentProvider来操纵通讯录的简单例子：

ContentProviderActivity.java

package com.geniusxiaoyu.contentprovider;import java.util.ArrayList;import android.app.Activity;import android.app.AlertDialog;import android.content.ContentUris;import android.content.ContentValues;import android.database.Cursor;import android.net.Uri;import android.os.Bundle;import android.provider.ContactsContract;import android.provider.ContactsContract.CommonDataKinds.Email;import android.provider.ContactsContract.CommonDataKinds.Phone;import android.provider.ContactsContract.CommonDataKinds.StructuredName;import android.provider.ContactsContract.Contacts.Data;import android.provider.ContactsContract.RawContacts;import android.view.Gravity;import android.view.View;import android.view.View.OnClickListener;import android.view.ViewGroup;import android.widget.AbsListView;import android.widget.BaseExpandableListAdapter;import android.widget.Button;import android.widget.EditText;import android.widget.ExpandableListAdapter;import android.widget.ExpandableListView;import android.widget.TextView;import android.widget.Toast;public class ContentProviderActivity extends Activity {Button search;Button add;@Overridepublic void onCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);// 获取系统界面中查找、添加两个按钮search = (Button) findViewById(R.id.search);add = (Button) findViewById(R.id.add);search.setOnClickListener(new OnClickListener(){@Overridepublic void onClick(View source){// 定义两个List来封装系统的联系人信息、指定联系人的电话号码、Email等详情final ArrayList<String> names = new ArrayList<String>();final ArrayList<ArrayList<String>> details= new ArrayList<ArrayList<String>>();// 使用ContentResolver查找联系人数据Cursor cursor = getContentResolver().query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);// 遍历查询结果，获取系统中所有联系人while (cursor.moveToNext()){// 获取联系人IDString contactId = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));// 获取联系人的名字String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));names.add(name);// 使用ContentResolver查找联系人的电话号码Cursor phones = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = " + contactId, null, null);ArrayList<String> detail = new ArrayList<String>();// 遍历查询结果，获取该联系人的多个电话号码while (phones.moveToNext()){// 获取查询结果中电话号码列中数据。String phoneNumber = phones.getString(phones.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));detail.add("电话号码：" + phoneNumber); }phones.close();// 使用ContentResolver查找联系人的Email地址Cursor emails = getContentResolver().query(ContactsContract.CommonDataKinds.Email.CONTENT_URI,null,ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = " + contactId, null, null);// 遍历查询结果，获取该联系人的多个Email地址while (emails.moveToNext()){// 获取查询结果中Email地址列中数据。String emailAddress = emails.getString(emails.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA));detail.add("邮件地址：" + emailAddress); }emails.close();details.add(detail);}cursor.close();//加载result.xml界面布局代表的视图View resultDialog = getLayoutInflater().inflate(R.layout.result, null);// 获取resultDialog中ID为list的ExpandableListViewExpandableListView list = (ExpandableListView)resultDialog.findViewById(R.id.list);//创建一个ExpandableListAdapter对象ExpandableListAdapter adapter = new BaseExpandableListAdapter(){//获取指定组位置、指定子列表项处的子列表项数据@Overridepublic Object getChild(int groupPosition, int childPosition){return details.get(groupPosition).get(childPosition);}@Overridepublic long getChildId(int groupPosition, int childPosition){return childPosition;}@Overridepublic int getChildrenCount(int groupPosition){return details.get(groupPosition).size();}private TextView getTextView(){AbsListView.LayoutParams lp = new AbsListView.LayoutParams(ViewGroup.LayoutParams.FILL_PARENT, 64);TextView textView = new TextView(ContentProviderActivity.this);textView.setLayoutParams(lp);textView.setGravity(Gravity.CENTER_VERTICAL | Gravity.LEFT);textView.setPadding(36, 0, 0, 0);textView.setTextSize(20);return textView;}// 该方法决定每个子选项的外观@Overridepublic View getChildView(int groupPosition, int childPosition,boolean isLastChild, View convertView, ViewGroup parent){TextView textView = getTextView();textView.setText(getChild(groupPosition, childPosition).toString());return textView;}//获取指定组位置处的组数据@Overridepublic Object getGroup(int groupPosition){return names.get(groupPosition);}@Overridepublic int getGroupCount(){return names.size();}@Overridepublic long getGroupId(int groupPosition){return groupPosition;}//该方法决定每个组选项的外观@Overridepublic View getGroupView(int groupPosition, boolean isExpanded,View convertView, ViewGroup parent){TextView textView = getTextView();textView.setText(getGroup(groupPosition).toString());return textView;}@Overridepublic boolean isChildSelectable(int groupPosition, int childPosition){return true;}@Overridepublic boolean hasStableIds(){return true;}};// 为ExpandableListView设置Adapter对象list.setAdapter(adapter);// 使用对话框来显示查询结果。new AlertDialog.Builder(ContentProviderActivity.this).setView(resultDialog).setPositiveButton("确定" , null).show();}});// 为add按钮的单击事件绑定监听器add.setOnClickListener(new OnClickListener(){@Overridepublic void onClick(View v){// 获取程序界面中的3个文本框String name = ((EditText)findViewById(R.id.name)).getText().toString();String phone = ((EditText)findViewById(R.id.phone)).getText().toString();String email = ((EditText)findViewById(R.id.email)).getText().toString();// 创建一个空的ContentValuesContentValues values = new ContentValues();// 向RawContacts.CONTENT_URI执行一个空值插入，// 目的是获取系统返回的rawContactId Uri rawContactUri = getContentResolver().insert(RawContacts.CONTENT_URI, values);long rawContactId = ContentUris.parseId(rawContactUri);values.clear();values.put(Data.RAW_CONTACT_ID, rawContactId); // 设置内容类型values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);// 设置联系人名字values.put(StructuredName.GIVEN_NAME, name);// 向联系人URI添加联系人名字getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);values.clear();values.put(Data.RAW_CONTACT_ID, rawContactId);values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);// 设置联系人的电话号码values.put(Phone.NUMBER, phone);// 设置电话类型values.put(Phone.TYPE, Phone.TYPE_MOBILE);// 向联系人电话号码URI添加电话号码getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);values.clear();values.put(Data.RAW_CONTACT_ID, rawContactId);values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);// 设置联系人的Email地址values.put(Email.DATA, email);// 设置该电子邮件的类型values.put(Email.TYPE, Email.TYPE_WORK);// 向联系人Email URI添加Email数据getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);Toast.makeText(ContentProviderActivity.this, "联系人数据添加成功" , 8000).show();}});}}

layout/main.xml

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"android:orientation="vertical"android:layout_width="fill_parent"android:layout_height="fill_parent"><LinearLayout android:orientation="horizontal"android:layout_width="fill_parent"android:layout_height="wrap_content"android:gravity="center_horizontal"><Button android:id="@+id/search"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@string/search"/><Button android:id="@+id/add"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@string/add"/></LinearLayout><TextView  android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/name"/><EditTextandroid:id="@+id/name"android:layout_width="fill_parent" android:layout_height="wrap_content" /><TextView  android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/phone"/><EditTextandroid:id="@+id/phone"android:layout_width="fill_parent" android:layout_height="wrap_content" android:phoneNumber="true"/><TextView  android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/email"/><EditTextandroid:id="@+id/email"android:layout_width="fill_parent" android:layout_height="wrap_content"/></LinearLayout>

layout/result.xml

<?xml version="1.0" encoding="UTF-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"android:orientation="vertical"android:layout_width="fill_parent"android:layout_height="fill_parent"><ExpandableListViewandroid:id="@+id/list"android:layout_width="fill_parent" android:layout_height="wrap_content" android:childIndicator="@drawable/icon"/></LinearLayout>

values/strings.xml

<?xml version="1.0" encoding="utf-8"?><resources><string name="hello">Hello World, ContactProviderTest!</string><string name="app_name">操作系统联系人</string><string name="search">查询</string><string name="add">添加</string><string name="name">联系人姓名</string><string name="phone">电话</string><string name="email">Email</string></resources>

最后还需要在AndroidManifest.xml中添加读写联系人的权限

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"      package="com.geniusxiaoyu.contentprovider"      android:versionCode="1"      android:versionName="1.0">    <application android:icon="@drawable/icon" android:label="@string/app_name">        <activity android:name=".ContentProviderActivity"                  android:label="@string/app_name">            <intent-filter>                <action android:name="android.intent.action.MAIN" />                <category android:name="android.intent.category.LAUNCHER" />            </intent-filter>        </activity>    </application>    <uses-sdk android:minSdkVersion="8" />    <!-- 授予读联系人ContentProvider的权限 --><uses-permission android:name="android.permission.READ_CONTACTS"/><!-- 授予写联系人ContentProvider的权限 --><uses-permission android:name="android.permission.WRITE_CONTACTS"/></manifest>