android学习笔记54——ContentProvider

ContentProvider

ContentProvider用于实现数据共享.

ContentProvider是不同应用程序之间进行数据交换的标准API,其以某种Uri的形式对外提供数据，允许其他应用程序访问或修改数据；

其他应用程序使用ContentResolver根据Uri去访问操作指定数据。

注意：ContentProvider为android四大组件之一，需要在AndroidMainfest.xml中做配置处理。

如果把ContentProvider当做一个网站，那么完成的开发一个ContentProvider的操作步骤如下：

1.定义自己的ContentProvider类，该类需要继承android提供的ContentProvider基类；

2.向android系统注册这个“网站”，也就是在AndroidMainfest.xml文件中注册这个ContentProvider——就像注册Activity一样。注册ContentProvider需要为其绑定一个URL.

注意：

向android系统中注册ContentProvider只要在<application.../>元素中添加子元素即可，如下所示：

当我们向android系统注册了ContentProvider之后，其他应用程序就可通过Uri来访问DictProvider所暴露的数据了。

那么DictPovider到底如何暴露其提供的数据？

==》

由于应用程序对数据的操作无非就是CRUD,因此DictProvider除了需要继承ContentProvider之外，还需要提供如下几个方法：

public boolean onCreate()	该方法在ContentProvider创建后被调用，当其他应用程序第一次访问ContentProvider时，该ContentProvider会被创建出来， 并立即回调该onCreate()
public Uri insert(Uri uri,ContentValues values)	根据Uri插入values对应的数据
public int delete(Uri uri,String selection,String[] selecttionArgs)	根据Uri删除select条件所匹配的所有记录
publc int update(Uri uri,ContentValues values,String selection,Sting[] selecttionArgs)	根据Uri修改select条件所匹配的所有记录
public Cursor query(Uri uri,Sting[] projection,String selection,Sting[] selectionArgs,String sortOrder)	根据Uri查询select条件所匹配的所有记录，其中projection就是一个列名列表，表明只选择出指定的列的数据列
public String getType(Uri uri)	该方法用于返回当前Uri所代表的数据的MIME类型。如果该Uri对应数据可能包括多条记录，那么MIME类型字符串应该以vnd.android.cursor.dir/开头；如果该Uri对应的数据只包含一条记录，那么返回MIME类型字符串应该以vnd.android.cursor.item/开头

Uri简介

网页URL，如：https://www.baidu.com/s?tn=baidutop...

1.http://——URL协议部分，只要通过HTTP协议来访问网站，该部分为固定信息；

2.www.baidu.com——网站域名部分，只要通过http协议来访问网站，该部分总是固定信息；

3.s?tn=baidutop...——网站资源部分， 当访问者需要访问不同资源时，这个部分是动态改变的。

Android Uri因此类似，如下：

content://org.crazyit.providers.dictprovider/words

其也可分为三个部分：

1.content://，这个不是android规定的，是固定的；

2.org.crazyit.providers.dictprovider，这个部分就是ContentProvider的authority.系统就是由这个部分来找到操作那个ContentProvider.只要访问指定的ContentProvider,这个部分就是固定的；

3.words，资源部分或者说是数据部分，当访问者需要访问不同资源时，这个部分是动态改变的。

注意：

需要指出的是，Android的Uri所能表达的功能更丰富，还可以支持如下Uri:

content://org.crazyit.providers.dictprovider/words/2——此时需要访问的资源为words/2,其意味着访问words数据中ID为2的记录的word字段。

content://org.crazyit.providers.dictprovider/words——访问全部数据；

大部分使用ContentProvider所操作的数据都来自于数据库，但有时候这些数据也可以来自于文件、XML或网络等其他存储方式，此时支持的Uri也可改为如下形式：

content://org.crazyit.providers.dictprovider/word/detail/——代表操作word节点下的detail节点；

为了将一个字符串转换成Uri,Android提供的Uri工具类提供了parse()静态方法，转换方式如下：

Uri uri = Uri.parse("content://org.crazyit.providers.dictprovider/words/2");

使用ContentResolver操作数据

ContentProvider相当于一个“网站”，它的作用是暴露可供操作的数据；

其他程序则通过ContentResolver来操作ContentProvider所暴露的数据；ContentResolver相当于HttpClient.

Content提供了如下方法来获取ContentResolver对象：getContentResolver().

获取ContentResolver对象成功后，可通过如下方法操作数据：

insert(Uri uri,ContentValues values)	向Uri对应的ContentProvider中插入values对应的数据
delete(Uri uri,String where,Sting[] selectionArgs)	删除uri对应的ContentProvider中where提交匹配的数据
update(Uri uri,ContentValues values,String where,String[] selectionArgs)	更新uri对应的ContentProvider中where提交匹配的数据
query(Uri uri,Sting[] projection,String selection,String[] selectionArgs,String sortOrder)	查询Uri对应的ContentProvider中where提交匹配的数据

注意：一般来说，ContentProvider是单实例模式的，当多个应用程序通过ContentResolver来操作ContentProvider提供的数据时，ContentResolver

调用的数据操作将会委托给同一个ContentProvider处理。

操作系统的ContentProvider

使用ContentProvider操作数据的操作步骤：

1.调用Activity的ContentResolver()获取ContentResolver对象

2.根据需要调用ContentResolver的insert()、delete()、update()、query方法操作数据即可

注意：操作系统提供的ContentResolver，需要了解其对应的ContentProvider对应的Uri.

使用ContentProvider管理联系人

Android系统提供了Contacts应用程序来管理联系人，而且Android系统还为联系人管理提供了ContentProvider,这就运行其他应用程序以ContentResolver来管理联系人数据。

Android系统对联系人管理ContentProvider的几个Uri如下：

ContactsContact.Contacts.CONTENT_URI	管理联系人的Uri
ContactsContact.CommonDataKinds.Phone.CONTENT_URI	管理联系人的电话的Uri
ContactsContact.CommonDataKinds.Email.CONTENT_URI	管理联系人的邮箱的Uri

实例如下：

布局文件main.xml==>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity" >

    <Button
        android:id="@+id/btnQuery"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="查询" />

</LinearLayout>

result.xml==>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

    <ExpandableListView
        android:id="@+id/list"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:background="#ffffff"
        android:cacheColorHint="#00000000"
        android:listSelector="#00000000" >
    </ExpandableListView>

</LinearLayout>

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

代码实现==》
package com.example.myprovidercontent1;

import java.util.ArrayList;

import android.os.Bundle;
import android.provider.ContactsContract;
import android.app.Activity;
import android.app.AlertDialog;
import android.database.Cursor;
import android.database.DataSetObserver;
import android.util.Log;
import android.view.Gravity;
import android.view.Menu;
import android.view.View;
import android.view.ViewGroup;
import android.view.View.OnClickListener;
import android.widget.AbsListView;
import android.widget.AbsListView.LayoutParams;
import android.widget.Button;
import android.widget.ExpandableListAdapter;
import android.widget.ExpandableListView;
import android.widget.TextView;

public class MainActivity extends Activity
{
	@Override
	protected void onCreate(Bundle savedInstanceState)
	{
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		Button btnQuery = (Button) this.findViewById(R.id.btnQuery);
		btnQuery.setOnClickListener(new OnClickListener()
		{
			@Override
			public void onClick(View v)
			{
				query(v);
			}
		});
	}

	private void query(View v)
	{
		// 定义两个List封装系统联系人信息、指定联系人的电话号码、Email等...
		final ArrayList<String> names = new ArrayList<String>();
		final ArrayList<ArrayList<String>> details = new ArrayList<ArrayList<String>>();
		// 使用ContentResolver查找联系人数据
		Cursor cursor = this.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);
			Log.i("swg", "name：" + name);
			// 联系人电话号码
			Cursor phones = this.getContentResolver()
					.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null,
							ContactsContract.CommonDataKinds.Phone.CONTACT_ID + "=" + contactId,
							null, null);
			final ArrayList<String> detail = new ArrayList<String>();
			// 遍历查询结果，获取该联系人的多个 电话号码
			while (phones.moveToNext())
			{
				String phoneNum = phones.getString(phones
						.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
				Log.i("swg", "电话号码：" + phoneNum);
				detail.add("电话号码：" + phoneNum);
			}
			phones.close();

			// 使用ContentResolver查询联系人Email
			Cursor emails = this.getContentResolver()
					.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI, null,
							ContactsContract.CommonDataKinds.Email.CONTACT_ID + "=" + contactId,
							null, null);
			// 遍历查询结果，获取该联系人的多个Email地址
			while (emails.moveToNext())
			{
				String emailAdd = emails.getString(emails
						.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA));

				Log.i("swg", "邮件地址：" + emailAdd);
				detail.add("邮件地址：" + emailAdd);
			}
			emails.close();

			details.add(detail);
		}
		cursor.close();

		// 加载result.xml界面布局文件
		View resultDialog = this.getLayoutInflater().inflate(R.layout.result, null);
		ExpandableListView list = (ExpandableListView) resultDialog.findViewById(R.id.list);
		// 创建一个ExpandableListAdapter对象
		ExpandableListAdapter adapter = new ExpandableListAdapter()
		{
			@Override
			public void unregisterDataSetObserver(DataSetObserver observer)
			{
			}

			@Override
			public void registerDataSetObserver(DataSetObserver observer)
			{
			}

			@Override
			public void onGroupExpanded(int groupPosition)
			{
			}

			@Override
			public void onGroupCollapsed(int groupPosition)
			{
			}

			@Override
			public boolean isEmpty()
			{
				return false;
			}

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

			@Override
			public boolean hasStableIds()
			{
				return true;
			}

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

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

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

			@Override
			public Object getGroup(int groupPosition)
			{
				// details
				return names.get(groupPosition);
			}

			@Override
			public long getCombinedGroupId(long groupId)
			{
				return 0;
			}

			@Override
			public long getCombinedChildId(long groupId, long childId)
			{
				return 0;
			}

			@Override
			public int getChildrenCount(int groupPosition)
			{
				return details.get(groupPosition).size();
			}

			private TextView getTextView()
			{
				AbsListView.LayoutParams lp = new LayoutParams(ViewGroup.LayoutParams.FILL_PARENT,
						64);
				TextView tv = new TextView(MainActivity.this);
				tv.setLayoutParams(lp);
				tv.setGravity(Gravity.CENTER_HORIZONTAL | Gravity.LEFT);
				tv.setPadding(36, 0, 0, 0);
				tv.setTextSize(20);
				return tv;
			}

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

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

			@Override
			public Object getChild(int groupPosition, int childPosition)
			{
				return details.get(groupPosition).get(childPosition);
			}

			@Override
			public boolean areAllItemsEnabled()
			{
				return false;
			}
		};
		// 为ExpandableListView设置Adapter
		list.setAdapter(adapter);
		// 使用对话框来显示查询结果
		new AlertDialog.Builder(MainActivity.this).setView(resultDialog)
				.setPositiveButton("确定", null).show();
	}
}

实例二、添加联系人