【摘】ContentProvider总结

　　ContentProvider一般译作内容提供者，官方文档中的解释：它用来管理结构化数据的访问。通过它我们可以共享自己应用中的数据，或者访问别的应用提供的数据，比如‘联系人’应用就实现了ContentProvider，通过它提供的ContentProvider我们可以查询、删除、更新联系人数据。

ContentProvider简介

 ContentProvider是不同应用程序之间进行数据交换的标准API，ContentProvider以URI的形式对外提供数据，允许其他应用访问或修改数据；其他应用程序使用ContentResolver根据URI去访问\操作指定的数据。ContentProvider可以看作是一个网站，用来提供各种数据；ContentResolver则可当成浏览器。我们访问某个网站其实就是想获取那个网站上的数据。而且我们是通过浏览器与网站交互的。

开发步骤

1.从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”。

2.在AndroidManifest.xml中注册之，和其它组件的注册过程类似。

<!-- 注册一个ContentProvider -->
        <provider android:name=".ExampleProvider" 
            android:authorities="com.example.provider"/>

 其中authorities属性就相当于网站的url。

使用ContentResolver操作ContentProvider中的数据

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

URI介绍：

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

 

 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文件中person节点下的name节点，可以构建这样的路径：/person/name

如果要把一个字符串转换成Uri，可以使用Uri类中的parse()方法，如下：

Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person")

UriMatcher类使用介绍

因为Uri代表了要操作的数据，所以我们很经常需要解析Uri，并从Uri中获取数据。Android系统提供了两个用于操作Uri的工具类，分别为UriMatcher 和ContentUris 。掌握它们的使用，会便于我们的开发工作。 UriMatcher类用于匹配Uri，它的用法如下：

首先第一步把你需要匹配Uri路径全部给注册上，如下：

/常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码
UriMatcher  sMatcher = new UriMatcher(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"))) { 
   case 1
    break;
   case 2
    break;
   default://不匹配
    break;
}

注册完需要匹配的Uri后，就可以使用sMatcher.match(uri)方法对输入的Uri进行匹配，如果匹配就返回匹配码，匹配码是调用addURI()方法传入的第三个参数，假设匹配content://cn.itcast.provider.personprovider/person路径，返回的匹配码为1

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

 

 示例：

package org.crazyit.content;

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.RawContacts;
import android.provider.ContactsContract.RawContacts.Data;
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 ContactProviderTest extends Activity {
    Button search;
    Button add;

    @Override
    public 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() {
            @Override
            public 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()) {
                    // 获取联系人ID
                    String 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
                                    + " = ?", new String[] { contactId }, 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的ExpandableListView
                ExpandableListView list = (ExpandableListView) resultDialog
                        .findViewById(R.id.list);
                // 创建一个ExpandableListAdapter对象
                ExpandableListAdapter adapter = new BaseExpandableListAdapter() {
                    // 获取指定组位置、指定子列表项处的子列表项数据
                    @Override
                    public Object getChild(int groupPosition, int childPosition) {
                        return details.get(groupPosition).get(childPosition);
                    }

                    @Override
                    public long getChildId(int groupPosition, int childPosition) {
                        return childPosition;
                    }

                    @Override
                    public 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(
                                ContactProviderTest.this);
                        textView.setLayoutParams(lp);
                        textView.setGravity(Gravity.CENTER_VERTICAL
                                | Gravity.LEFT);
                        textView.setPadding(36, 0, 0, 0);
                        textView.setTextSize(20);
                        return textView;
                    }

                    // 该方法决定每个子选项的外观
                    @Override
                    public View getChildView(int groupPosition,
                            int childPosition, boolean isLastChild,
                            View convertView, ViewGroup parent) {
                        TextView textView = getTextView();
                        textView.setText(getChild(groupPosition, childPosition)
                                .toString());
                        return textView;
                    }

                    // 获取指定组位置处的组数据
                    @Override
                    public Object getGroup(int groupPosition) {
                        return names.get(groupPosition);
                    }

                    @Override
                    public int getGroupCount() {
                        return names.size();
                    }

                    @Override
                    public long getGroupId(int groupPosition) {
                        return groupPosition;
                    }

                    // 该方法决定每个组选项的外观
                    @Override
                    public View getGroupView(int groupPosition,
                            boolean isExpanded, View convertView,
                            ViewGroup parent) {
                        TextView textView = getTextView();
                        textView.setText(getGroup(groupPosition).toString());
                        return textView;
                    }

                    @Override
                    public boolean isChildSelectable(int groupPosition,
                            int childPosition) {
                        return true;
                    }

                    @Override
                    public boolean hasStableIds() {
                        return true;
                    }
                };
                // 为ExpandableListView设置Adapter对象
                list.setAdapter(adapter);
                // 使用对话框来显示查询结果。
                new AlertDialog.Builder(ContactProviderTest.this)
                        .setView(resultDialog).setPositiveButton("确定", null)
                        .show();
            }
        });
        // 为add按钮的单击事件绑定监听器
        add.setOnClickListener(new OnClickListener() {
            @Override
            public 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();
                // 创建一个空的ContentValues
                ContentValues 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(ContactProviderTest.this, "联系人数据添加成功", 8000)
                        .show();
            }
        });
    }
}

 

PS:最近几天，基本上把官方文档中关于ContentProvider的部分看完了。可懒得自己写总结了，以上内容基本上全部来自黎活明的android培训课件。