首页 > 代码库 > android学习十二(android的Content Provider(内容提供器)的使用)

android学习十二(android的Content Provider(内容提供器)的使用)

    文件存储和SharePreference存储以及数据存储一般为了安全,最好用于当前应用程序中访问和存储数据。内容提供器(Content Provider)主要用于在不同的应用程序之间实现数据共享的功能,它提供了一套完整的机制,允许一个程序访问另一个程序中的数据,同时还能保证被访问数据的安全性。目前使用内容提供器是android实现跨程序共享数据的标准方式。内容提供器可以选择只对一部分数据进行共享,从而保证我们的程序中的隐私数据不会有泄漏的风险。

    内容提供器的用法一般有两种,一种是使用现有的内容提供器来读取和操作相应程序中的数据,另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口。


访问其他程序中的数据

     当一个应用程序通过内容提供器对其数据了外部访问接口,任何其他的应用程序就都可以对这部分数据进行访问了。android系统中自带的电话薄,短信,媒体等程序都提供了类似的访问接口,这就使得第三方应用程序可以充分地利用这部分数据来实现更好的功能。

ContentResolver的基本用法

    对于一个应用程序来说,如果想要访问内容提供器中共享的数据,就一定要借助ContentResolver类,可以通过Context中的getContentResolver()方法获取到该类的实例。ContentResolver中提供了一系列的方法用于对数据进行CRUD操作,其中insert()方法用于添加数据,update()方法用于更新数据,delete()方法用于删除数据,query()方法用于查询数据。

    不同于SQLiteDatabase,ContentResolver中的增删改查方法都是不接收表名参数的,而是使用一个Uri参数替代,这个参数被称为内容URI。内容URI给内容提供器中的数据建立了唯一标识符,它主要由2部分组成,权限(authority)和路径(path)。权限是用于对不同的应用程序做区分的,一般为了避免冲突,都会采用程序包名的方式来进行命名。比如某个程序的包名是com.example.app,那么该程序对应的权限就可以命名为com.example.app.provider.路径则是用于对同一应用程序中不同的表做区分的,通常都会添加到权限的后面。比如某个程序的数据库里存在两张表,table1和table2,这时就可以将路径分别命名为/table1和table2,然后把权限和路径进行组合,内容URI就变成了com.example.app.provider/table1和com.example.app.provider/table2.不过目前还很难辨认出这两个字符串是两个内容URI,我们还需要在字符串的头部加上协议声明,因此,内容提供器最标准的格式写法如下:

content://com.example.app.provider/table1

content://com.example.app.provider/table2


这时候URI就可以非常清楚地表达我们想要访问哪个程序中哪张表里的数据。

在得到了内容URI字符串之后,我们还需要将他解析成Uri对象才可以作为参数传入。解析的方法也相当简单,代码如下:

Uri uri=Uri.parse("content://com.example.app.provider/table1");

只需要调用Uri.parse()方法,就可以将内容URI字符串解析成Uri对象了。

现在就可以使用这个Uri对象来查询table1表中的数据了,代码如下所示:

Cursor cursor=getContentResolver().query(

uri,

projection,

selection,

selectionArgs,

sortOrder

);


参数的详细解释见下面的内容:

query()对应SQL部分
描述
uri
from table_name指定查询某个应用程序下的某一张表
projection
selection column1,column2指定查询的列名
selection
where column=value指定where的约束条件
selectionArgs
         -为where中的占位符提供具体的值
sortOrder
order by column1,column2指定查询结果的排序方式

查询完成后返回的仍然是一个Cursor对象,这时我们就可以将数据从Cursor对象中逐个读取出来了。读取的思路仍然是通过移动游标的位置来遍历Cursor的所有行,然后再取出每一行中相应列的数据,代码如下所示:

if(cursor!=null){

   while(cursor.moveToNext()){

          String column1=cursor.getString(cursor.getColumnIndex("column1"));

          String column2=cursor.getString(cursor.getColumnIndex("column2"));

}

cursor.close();

}

掌握了查询操作,下面我们来看看如何向table1中添加一条数据,代码如下:

ContentValues values=new ContentValues();

values.put("column1"."text");

values.put("column2",1);

getContentResolver().insert(uri,values);

可以看到仍然是将待添加的数据组装到ContentValues中,然后调用ContentResolver的insert()方法,将Uri和ContentValues作为参数传入即可。


如果我们想要更新这条新添加的数据,把column1的值清空,可以借助ContentResolver的update()方法实现,代码如下:

ContentValues values=new ContentValues();

values.put("column1"."");

getContentResolver().update(uri,values,"column1=? and column2=?",new String[]{"text","1"});

注意上述代码使用了selection和selectionArgs参数来对想要更新的数据进行约束,以防止所有行都会受影响。

最后,可以调用ContentResolver的delete()方法将这条数据删除掉,代码如下:

getContentResolver().delete(uri,values,"column2=?",new String[]{"1"});

基本的操作,已经做了一个小结了,下面进行实战。



读取系统联系人

    由于要读取系统的联系人信息,而模拟器中没有联系人信息的存在,所以先手动添加几个联系人信息。打开电话簿程序,界面如下所示:




目前电话簿里面没有任何联系人,现在点击create a new contact按钮来对联系人进行创建。这里先创建2个联系人,分别输入他们的姓名和手机号码,如下:



做好了准备工作了,现在新建一个ContactsTest项目。

修改activity_main.xml布局文件,使读取出来的联系人信息能够在ListView中显示,因此修改代码如下:

<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"
    >

    <ListView 
        android:id="@+id/contacts_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        >
    </ListView>

</LinearLayout>

接着修改MainActivity中的代码,如下:

<pre name="code" class="java">package com.jack.contactstest;

import java.util.ArrayList;
import java.util.List;

import android.os.Bundle;
import android.provider.ContactsContract;
import android.app.Activity;
import android.database.Cursor;
import android.view.Menu;
import android.widget.ArrayAdapter;
import android.widget.ListView;

public class MainActivity extends Activity {

	private ListView contactsView;
	private ArrayAdapter<String> adapter;
	private List<String> contactsList=new ArrayList<String>();
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		//获得ListView组件
		contactsView=(ListView) findViewById(R.id.contacts_view);
		adapter=new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1,
				contactsList);
		contactsView.setAdapter(adapter);//设置适配器
		readContacts();
		
		
		
	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.main, menu);
		return true;
	}

	private void readContacts(){
		Cursor cursor=null;//定义游标
		try{
			//查询联系人数据
			cursor=(Cursor) getContentResolver().query(
					ContactsContract.CommonDataKinds.Phone.CONTENT_URI, 
					null, null, null, null);
			
			/*
			 * 上面可以看到query()方法中没有使用Uri.parse()方法去解析一个内容URI字符串,这是因为
			 * ContactsContract.CommonDataKinds.Phone类已经帮我们做好了封装,提供了一个CONTENT_URI常量
			 * ,而这个常量就是使用Uri.parse()方法解析出来的结果,接着对Cursor对象进行遍历,将联系人姓名和手机号码这些数据
			 * 逐个取出来,联系人姓名对应的常量是ContactsContract.CommonDataKinds.Photo.DISPLAY_NAME,
			 * 联系人手机号码这一列对应的常量是ContactsContract.CommonDataKinds.Phone.NUMBER。这两个数据取出来后
			 * 放ListView中。最后记得关闭Cursor对象。
			 * */
			//遍历cursor取出数据
			while(cursor.moveToNext()){
				//获取联系人姓名
				String name=cursor.getString(cursor.getColumnIndex(
						ContactsContract.CommonDataKinds.Photo.DISPLAY_NAME));
				//获取联系人手机号码
				String number=cursor.getString(cursor.getColumnIndex(
						ContactsContract.CommonDataKinds.Phone.NUMBER));
				//把数据添加到contactsList中
				contactsList.add(name+"\n"+number);
				
			}
			
		}catch(Exception e){
			e.printStackTrace();
		}finally{
			if(cursor!=null){
				cursor.close();//关闭游标
			}
		}
		
	}
	
	
}


读取联系人信息需要权限,因此要修改AndroidManifest.xml中的代码,如下:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.jack.contactstest"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="13"
        android:targetSdkVersion="17" />
    <!--增加权限  -->
   <uses-permission android:name="android.permission.READ_CONTACTS"/>
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.jack.contactstest.MainActivity"
            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>

</manifest>

运行程序,效果如下:



刚刚在模拟器中添加的2个联系人数据都已经成功读取出来了。跨程序访问的功能的确实现了。


创建自己的内容提供器

     如果想实现跨程序共享数据的功能,官方推荐的方式就是使用内容提供器,可以通过新建一个类去继承ContentProvider的方式来创建一个自己的内容提供器。ContentProvider类中有6个抽象方法,我们在使用子类继承它时候,需要将这六个方法全部重写。

新建一个MyProvider继承自ContentProvider,代码如下所示:

package com.jack.contactstest;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;

public class MyProvider extends ContentProvider {

	
	
	/*
	 * delete()方法从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据,selection和
	 * selectionArgs参数用于约束删除哪些行,被删除的行将作为返回值返回。
	 * */
	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		// TODO Auto-generated method stub
		return 0;
	}

	
	/*
	 * getType()根据传入的内容URI来返回相应的MIME类型。
	 * */
	@Override
	public String getType(Uri uri) {
		// TODO Auto-generated method stub
		return null;
	}
    
	
	/*
	 * insert()方法向内容提供器中添加一条数据。使用uri参数来确定添加到的表,待添加的数据保存在values参数中。
	 * 添加完成后,返回一个用于表示这条新记录的URI
	 * */
	@Override
	public Uri insert(Uri uri, ContentValues values) {
		// TODO Auto-generated method stub
		return null;
	}

	
	/*
	 * onCreate()方法初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作,返回
	 * true表示内容提供器初始化成功,返回false则表示失败。注意只有当存在ContentResolver尝试访问
	 * 我们程序中的数据时,内容提供器才会被初始化。
	 * */
	@Override
	public boolean onCreate() {
		// TODO Auto-generated method stub
		return false;
	}

	
	
	/*
	 * query()方法从内容提供器中查询数据。使用uri参数来确定查询哪张表,projection参数用于确定查询
	 * 哪些列,selection和selectionArgs参数用于约束查询哪些行,sortOrder参数用于对结果进行排序,
	 * 查询的结果存放在Cursor对象中返回。
	 * */
	@Override
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {
		// TODO Auto-generated method stub
		return null;
	}

	
	/*
	 * update()更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据,更新数据保存
	 * 在values中,selection和selectionArgs参数用于约束更新哪些行,受影响的行将作为返回值返回。
	 * */
	@Override
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {
		// TODO Auto-generated method stub
		return 0;
	}

}


可以看到很多的方法都需要Uri这个参数,这个参数正是调用ContentResolver的增删改查方法时传递过来的。而现在,我们需要对传入的Uri参数进行解析,从中分析出调用方期望访问的表和数据。

一个标准的URI写法如下:

content://com.example.app.provider/table1

这就表示调用方期望访问的是com.example.app这个应用的table1表中的数据。除此之外,我们还可以在这个内容URI的后面添加一个id,如下所示:

content://com.example.app.provider/table1/1

这就表示调用方期望访问的是com.example.app这个应用的table1表中id为1的数据。

内容URI的格式主要就只有以上2种,以路径结尾就表示期望访问该表中所有的数据,以id结尾就表示期望访问该表中拥有相应id的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容URI,规则如下:

1.      *:表示匹配任意长度的任意字符

2.      # :表示匹配任意长度的数字

所以一个能够匹配任意表的内容URI格式就可以写出:

content://com.example.app.provider/*

而一个能够匹配table1表中任意一行数据的内容URI格式就可以写成:

content://com.example.app.provider/table1/#

      接着我们再借助UriMatcher这个类就可以轻松的实现匹配内容URI的功能。UriMatcher中提供了一个addURI()方法,这个方法接收三个参数,可以分别把权限,路径和自定义代码传进去。这样,当调用UriMatcher的match()方法时就可以将一个Uri对象传入,返回值是某个能够匹配这个Uri对象所对应的自定义代码,利用这个代码,我们就可以判断出调用方期望访问的是哪一张表中的数据了。修改MyProvider中的代码,如下所示:

package com.jack.contactstest;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.net.Uri;

public class MyProvider extends ContentProvider {

	/*
	 * MyProvider中新增四个整形常量,其中TABLE1_DIR表示访问table1表中的所有数据,
	 * TABLE1_ITEM表示访问的table1表中的单条数据,TABLE2_DIR表示访问table2表中的所有数据,
	 * TABLE2_ITEM表示访问的table2表中的单条数据。
	 * */
	public static final int TABLE1_DIR=0;
	public static final int TABLE1_ITEM=1;
	public static final int TABLE2_DIR=2;
	public static final int TABLE2_ITEM=3;
	private static UriMatcher uriMatcher;
	
	
	/*
	 * 上面定义常量以后,接着在静态代码块里,创建UriMatcher的实例,并调用addURI()方法,将期望匹配的内容
	 * URI格式传递进去,注意这里传入的路径参数是可以使用通配符的。然后当query()方法被调用的时候,就会通过UriMatcher
	 * 的match()方法对传入的Uri对象进行匹配,如果发现UriMatcher中某个内容URI格式成功匹配了该Uri对象,则
	 * 返回相应的自定义代码,然后就可以判断期望访问的到底是什么数据了。这里只使用query()方法做了一个示范,其实
	 * insert(),update(),delete()这几个方法的实现也是差不多的,它们都会携带Uri这个参数,然后同样利用
	 * UriMatcher的match()方法判断出调用期望访问的是哪一张表,在对该表中的数据进行相应的操作就可以了。
	 * */
	static{
		uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);
		uriMatcher.addURI("com.jack.contactstest.provider", "table1", TABLE1_DIR);
		uriMatcher.addURI("com.jack.contactstest.provider", "table1/#", TABLE1_ITEM);
		uriMatcher.addURI("com.jack.contactstest.provider", "table2", TABLE2_DIR);
		uriMatcher.addURI("com.jack.contactstest.provider", "table2/#", TABLE2_ITEM);
	}
	
	
	
	/*
	 * delete()方法从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据,selection和
	 * selectionArgs参数用于约束删除哪些行,被删除的行将作为返回值返回。
	 * */
	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		// TODO Auto-generated method stub
		return 0;
	}

	
	/*
	 * getType()根据传入的内容URI来返回相应的MIME类型。
	 * */
	@Override
	public String getType(Uri uri) {
		// TODO Auto-generated method stub
		return null;
	}
    
	
	/*
	 * insert()方法向内容提供器中添加一条数据。使用uri参数来确定添加到的表,待添加的数据保存在values参数中。
	 * 添加完成后,返回一个用于表示这条新记录的URI
	 * */
	@Override
	public Uri insert(Uri uri, ContentValues values) {
		// TODO Auto-generated method stub
		return null;
	}

	
	/*
	 * onCreate()方法初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作,返回
	 * true表示内容提供器初始化成功,返回false则表示失败。注意只有当存在ContentResolver尝试访问
	 * 我们程序中的数据时,内容提供器才会被初始化。
	 * */
	@Override
	public boolean onCreate() {
		// TODO Auto-generated method stub
		return false;
	}

	
	
	/*
	 * query()方法从内容提供器中查询数据。使用uri参数来确定查询哪张表,projection参数用于确定查询
	 * 哪些列,selection和selectionArgs参数用于约束查询哪些行,sortOrder参数用于对结果进行排序,
	 * 查询的结果存放在Cursor对象中返回。
	 * */
	@Override
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {
		// TODO Auto-generated method stub
		switch(uriMatcher.match(uri)){
		case TABLE1_DIR:
			//查询table1表中的所有数据
			break;
		case TABLE1_ITEM:
			//查询table1表中的单条数据
			break;
		case TABLE2_DIR:
			//查询table2表中的所有数据
			break;
		case TABLE2_ITEM:
			//查询table2表中的单条数据
			break;
		}
		return null;
	}

	
	/*
	 * update()更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据,更新数据保存
	 * 在values中,selection和selectionArgs参数用于约束更新哪些行,受影响的行将作为返回值返回。
	 * */
	@Override
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {
		// TODO Auto-generated method stub
		return 0;
	}

}

注要的说明,都在注释里面解释了,就不多说了。

     现在可能就对getType()方法比较陌生了。getType()方法是所有内容提供器都必须提供的一个方法,用于获取Uri对象所对应的MIME类型。一个内容URI所对应的MIME字符串主要由三部分组成,android对这三个部分做了如下格式的规定:

1.必须以vnd开头。

2.如果内容URI以路径结尾,则后接android.cursor.dir/,如果内容URI以id结尾,则后接android.cursor.item/。

3.最后接上vnd.<authority>.<path>。

所以,对于content://com.example.app.provider/table1这个内容URI,它所对应的MIME类型就可以写成:

vnd.android.cursor.dir/vnd.com.example.app.provider/table1

对于content://com.example.app.provider/table1/1这个内容URI,它所对应的MIME类型就可以写成:

vnd.android.cursor.item/vnd.com.example.app.provider/table1


现在我们继续完善MyProvider中的内容,这次来实现getType()方法中的逻辑,代码如下所示:

package com.jack.contactstest;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.net.Uri;

public class MyProvider extends ContentProvider {

	/*
	 * MyProvider中新增四个整形常量,其中TABLE1_DIR表示访问table1表中的所有数据,
	 * TABLE1_ITEM表示访问的table1表中的单条数据,TABLE2_DIR表示访问table2表中的所有数据,
	 * TABLE2_ITEM表示访问的table2表中的单条数据。
	 * */
	public static final int TABLE1_DIR=0;
	public static final int TABLE1_ITEM=1;
	public static final int TABLE2_DIR=2;
	public static final int TABLE2_ITEM=3;
	private static UriMatcher uriMatcher;
	
	
	/*
	 * 上面定义常量以后,接着在静态代码块里,创建UriMatcher的实例,并调用addURI()方法,将期望匹配的内容
	 * URI格式传递进去,注意这里传入的路径参数是可以使用通配符的。然后当query()方法被调用的时候,就会通过UriMatcher
	 * 的match()方法对传入的Uri对象进行匹配,如果发现UriMatcher中某个内容URI格式成功匹配了该Uri对象,则
	 * 返回相应的自定义代码,然后就可以判断期望访问的到底是什么数据了。这里只使用query()方法做了一个示范,其实
	 * insert(),update(),delete()这几个方法的实现也是差不多的,它们都会携带Uri这个参数,然后同样利用
	 * UriMatcher的match()方法判断出调用期望访问的是哪一张表,在对该表中的数据进行相应的操作就可以了。
	 * */
	static{
		uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);
		uriMatcher.addURI("com.jack.contactstest.provider", "table1", TABLE1_DIR);
		uriMatcher.addURI("com.jack.contactstest.provider", "table1/#", TABLE1_ITEM);
		uriMatcher.addURI("com.jack.contactstest.provider", "table2", TABLE2_DIR);
		uriMatcher.addURI("com.jack.contactstest.provider", "table2/#", TABLE2_ITEM);
	}
	
	
	
	/*
	 * delete()方法从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据,selection和
	 * selectionArgs参数用于约束删除哪些行,被删除的行将作为返回值返回。
	 * */
	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		// TODO Auto-generated method stub
		return 0;
	}

	
	/*
	 * getType()根据传入的内容URI来返回相应的MIME类型。
	 * */
	@Override
	public String getType(Uri uri) {
		// TODO Auto-generated method stub
		switch(uriMatcher.match(uri)){
		case TABLE1_DIR:
			//查询table1表中的所有数据
			return "vnd.android.cursor.dir/vnd.com.jack.contactstest.table1";
			
		case TABLE1_ITEM:
			//查询table1表中的单条数据
			return "vnd.android.cursor.item/vnd.com.jack.contactstest.table1";
			
		case TABLE2_DIR:
			//查询table2表中的所有数据
			return "vnd.android.cursor.dir/vnd.com.jack.contactstest.table2";
			
		case TABLE2_ITEM:
			//查询table2表中的单条数据
			return "vnd.android.cursor.item/vnd.com.jack.contactstest.table2";
		
		default:break;
		}
		return null;
	}
    
	
	/*
	 * insert()方法向内容提供器中添加一条数据。使用uri参数来确定添加到的表,待添加的数据保存在values参数中。
	 * 添加完成后,返回一个用于表示这条新记录的URI
	 * */
	@Override
	public Uri insert(Uri uri, ContentValues values) {
		// TODO Auto-generated method stub
		return null;
	}

	
	/*
	 * onCreate()方法初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作,返回
	 * true表示内容提供器初始化成功,返回false则表示失败。注意只有当存在ContentResolver尝试访问
	 * 我们程序中的数据时,内容提供器才会被初始化。
	 * */
	@Override
	public boolean onCreate() {
		// TODO Auto-generated method stub
		return false;
	}

	
	
	/*
	 * query()方法从内容提供器中查询数据。使用uri参数来确定查询哪张表,projection参数用于确定查询
	 * 哪些列,selection和selectionArgs参数用于约束查询哪些行,sortOrder参数用于对结果进行排序,
	 * 查询的结果存放在Cursor对象中返回。
	 * */
	@Override
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {
		// TODO Auto-generated method stub
		switch(uriMatcher.match(uri)){
		case TABLE1_DIR:
			//查询table1表中的所有数据
			break;
		case TABLE1_ITEM:
			//查询table1表中的单条数据
			break;
		case TABLE2_DIR:
			//查询table2表中的所有数据
			break;
		case TABLE2_ITEM:
			//查询table2表中的单条数据
			break;
		}
		return null;
	}

	
	/*
	 * update()更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据,更新数据保存
	 * 在values中,selection和selectionArgs参数用于约束更新哪些行,受影响的行将作为返回值返回。
	 * */
	@Override
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {
		// TODO Auto-generated method stub
		return 0;
	}

}


到这里,一个完整的内容提供器就创建完成了,现在任何一个应用程序都可以使用ContentResolver来访问我们程序中的数据。那么如何才能保证隐私数据不会泄漏出去呢?其实多亏了内容提供器的良好机制,这个问题已经已经在不知不觉中被解决了。因为所有的CRUD操作都一定要匹配到相应的内容URI格式才能进行,而我们当然不可能向UriMatcher中添加隐私数据的URI,所以这部分数据根本无法被外部程序访问到,安全问题也就不存在了。下面进行实战,体验一下跨程序共享的功能。




实现跨程序数据共享

简单起见,我们使用上一篇博客的DatabaseTest的项目,在该项目的基础上进行修改继续开发,通过内容提供器给它加入外部访问接口。打开DatabaseTest项目,首先将MyDatabaseHelper中使用Toast弹出创建数据成功的提示去掉,因为跨程序访问时我们不能直接使用Toast。然后添加一个DatabaseProvider类,代码如下所示:

package com.jack.databasetest;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.net.Uri;

public class DatabaseProvider extends ContentProvider {

	//自定义代码
	public static final int BOOK_DIR=0;
	public static final int BOOK_ITEM=1;
	public static final int CATEGORY_DIR=2;
	public static final int CATEGORY_ITEM=3;
	//权限
	public static final String AUTHORITY="com.jack.databasetest.provider";
	private static UriMatcher uriMatcher;
	private MyDatabaseHelper dbHelper;
	//静态代码块进行初始话
	static {
		uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);
		uriMatcher.addURI(AUTHORITY, "book", BOOK_DIR);
		uriMatcher.addURI(AUTHORITY, "book/#", BOOK_ITEM);
		uriMatcher.addURI(AUTHORITY, "category", CATEGORY_DIR);
		uriMatcher.addURI(AUTHORITY, "category/#", CATEGORY_ITEM);
	}
	
	
	
	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		// TODO Auto-generated method stub
		//删除数据
		SQLiteDatabase db=dbHelper.getWritableDatabase();
		int deleteRows=0;
		switch(uriMatcher.match(uri)){
		case BOOK_DIR:
			deleteRows=db.delete("book", selection, selectionArgs);
			break;
		case BOOK_ITEM:
			String bookId=uri.getPathSegments().get(1);
			deleteRows=db.delete("book", "id=?", new String[]{bookId});
			break;
		case CATEGORY_DIR:
			deleteRows=db.delete("category", selection, selectionArgs);
			break;
		case CATEGORY_ITEM:
			String categoryId=uri.getPathSegments().get(1);
			deleteRows=db.delete("category", "id=?",new String[]{categoryId});
			break;	
		default:
			break;
		}
		return deleteRows;//被删除的行数作为返回值返回
	}

	@Override
	public String getType(Uri uri) {
		// TODO Auto-generated method stub
		switch(uriMatcher.match(uri)){
		case BOOK_DIR:
			return "vnd.android.cursor.dir/vnd.com.jack.databasetest.provider.book";
		case BOOK_ITEM:
			return "vnd.android.cursor.item/vnd.com.jack.databasetest.provider.book";
		case CATEGORY_DIR:
			return "vnd.android.cursor.dir/vnd.com.jack.databasetest.provider.category";
		case CATEGORY_ITEM:
			return "vnd.android.cursor.item/vnd.com.jack.databasetest.provider.category";	
		}
		return null;
	}

	@Override
	public Uri insert(Uri uri, ContentValues values) {
		// TODO Auto-generated method stub
		//添加数据
		SQLiteDatabase db=dbHelper.getWritableDatabase();
		Uri uriReturn=null;
		switch(uriMatcher.match(uri)){
		case BOOK_DIR:
		case BOOK_ITEM:
			long newBookId=db.insert("book", null, values);
			uriReturn=Uri.parse("content://"+AUTHORITY+"/book/"+newBookId);
			break;
		case CATEGORY_DIR:
		case CATEGORY_ITEM:
			long newCategoryId=db.insert("category", null, values);
			uriReturn=Uri.parse("content://"+AUTHORITY+"/book/"+newCategoryId);
			break;	
		default:
			break;
		}
		/*
		 * insert()方法要求返回一个能够表示这条新增数据的URI,所以需要调用Uri.parse()方法来将一个内容
		 * URI解析成Uri对象,当然这个内容是以新增数据的id结尾的。
		 * */
		return uriReturn;
	}

	@Override
	public boolean onCreate() {
		// TODO Auto-generated method stub
		dbHelper=new MyDatabaseHelper(getContext(), "BookStore.db", null, 2);
		return true;//返回true表示内容提供器初始化成功,这时数据库就已经完成了创建或升级操作
	}

	@Override
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {
		// TODO Auto-generated method stub
		//查询数据
		SQLiteDatabase db=dbHelper.getReadableDatabase();//获得SQLiteDatabase对象
		Cursor cursor=null;
		switch(uriMatcher.match(uri)){
		case BOOK_DIR:
			//进行查询
			cursor=db.query("book", projection, selection, selectionArgs,
					null, null, sortOrder);
			break;
		case BOOK_ITEM:
			//进行查询
			/*Uri对象的getPathSegments()方法会将内容URI权限之后的部分以“、”符号进行分割,并把分割后的结果
			 * 放入到一个字符串列表中,那这个列表的第0个位置存放的就是路径,第1个位置存放的就是id,得到id后,在通过
			 * selection和selectionArgs参数就实现了查询单条数据的功能。
			 * */
			String bookId=uri.getPathSegments().get(1);
			cursor=db.query("book", projection, "id=?", new String[]{bookId}, 
					null, null, sortOrder);
			break;
		case CATEGORY_DIR:
			//进行查询
			cursor=db.query("category", projection, selection, selectionArgs,
					null, null, sortOrder);
			break;
		case CATEGORY_ITEM:
			//进行查询
			String categoryId=uri.getPathSegments().get(1);
			cursor=db.query("book", projection, "id=?", new String[]{categoryId}, 
					null, null, sortOrder);
			break;	
		default:
			break;
		}
		return cursor;
	}

	@Override
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {
		// TODO Auto-generated method stub
		SQLiteDatabase db=dbHelper.getWritableDatabase();
		int updatedRows=0;
		//更新数据
		switch(uriMatcher.match(uri)){
		case BOOK_DIR:
			updatedRows=db.update("book", values, selection,selectionArgs);
			break;
		case BOOK_ITEM:
			String bookId=uri.getPathSegments().get(1);
			updatedRows=db.update("book", values, "id=?", new String[]{bookId});
			break;
		case CATEGORY_DIR:
			updatedRows=db.update("category", values, selection,selectionArgs);
			break;
		case CATEGORY_ITEM:
			String categoryId=uri.getPathSegments().get(1);
			updatedRows=db.update("book", values, "id=?", new String[]{categoryId});
			break;	
		default:
			break;
		}
		return updatedRows;//受影响的行数作为返回值
	}

}


上面的功能,在注释已经说名了,就不多说了,经过上面的步骤,内容提供器的代码全部编写完了,不过离跨实现程序数据共享的功能还差了一小步,因为还需要将内容提供器在AndroidManifest.xml文件中注册才可以,如下所示:

<pre name="code" class="html"><?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.jack.databasetest"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="13"
        android:targetSdkVersion="17" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.jack.databasetest.MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        
        
        <provider 
            android:name="com.jack.databasetest.DatabaseProvider"
            android:authorities="com.jack.databasetest.provider"
            android:exported="true"
            ></provider>
        
    </application>

</manifest>


android:exported="true"上面三个属性需要添加的,不然,就不能实现跨程序访问了。我刚开始没加
android:exported="true"这个属性,值加了上面的android:name="com.jack.databasetest.DatabaseProvider"
            android:authorities="com.jack.databasetest.provider"属性,程序访问出现安全问题了,百度后,说是需要android:exported="true"这个属性,才能跨程序被其他的程序访问。我试试了下,当中需要这个属性,不然后面进行跨程序访问的时候会出现错误。


现在DatabaseTest这个项目就已经拥有了跨程序共享数据的功能了,现在我们来试试。首先需要将DatabaseTest程序从模拟器中删除掉,以防止以前的遗留数据对我们产生影响。然后运行下项目,将DatabaseTest程序重写安装在模拟器上。接着关闭这个项目,并创建一个新项目ProviderTest,我们就通过这个程序去访问DatabaseTest中的数据。

先修改下ProviderTest的布局文件activity_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"
    >

    <Button 
        android:id="@+id/add_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="add data to book"
        />
    
    <Button 
        android:id="@+id/query_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="query from book"
        />

    <Button 
        android:id="@+id/update_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="update book"
        />
    
    <Button 
        android:id="@+id/delete_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="delete data from book"
        />
    
    
</LinearLayout>


放置了四个按钮,分别用来添加数据,查询,修改和删除数据。然后在修改MainActivity中的代码,如下所示:

package com.jack.providertest;

import android.net.Uri;
import android.os.Bundle;
import android.app.Activity;
import android.content.ContentValues;
import android.database.Cursor;
import android.util.Log;
import android.view.Menu;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class MainActivity extends Activity {

	private String  newId;
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		
		Button addData=http://www.mamicode.com/(Button) findViewById(R.id.add_data);>
现在运行下ProviderTest项目,显示如下:



点击add data to book,此时数据应该已经添加到DatabaseTest程序的数据库中了 ,我们通过点击query  form book按钮来检查下,打印日志如下:





然后点击下update book按钮来更新数据,在点击下query from book按钮进行检查,结果如下:





最后再点击delete data frombook按删除数据,此时再点击query from book按钮就查询不到数据了。

通过上面的测试,我们的跨程序共享数据功能已经成功实现了!!不仅是ProviderTest程序,任何一个程序都可以轻松访问DatabaseTest中的数据,而且我们还丝毫不用担心隐私数据泄漏的问题。



转载请注明来自:http://blog.csdn.net/j903829182/article/details/41150089


android学习十二(android的Content Provider(内容提供器)的使用)