首页 > 技术文章 > android学习笔记54——ContentProvider

YYkun 2016-10-20 16:28 原文

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();
	}
}

 实例二、添加联系人

 

推荐阅读