共享数据功能使用-ContentProvider

package it.date;

import it.service.MangerDatabase;
import android.content.ContentProvider;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.net.Uri;
import android.text.TextUtils;

public class PersonContentProvider extends ContentProvider {
	private MangerDatabase manger;
	private static final int code1=1;
	private static final int code2=2;
	//常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码 还回码为-1
	//UriMatcher为解析Url的类
	private static final UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH);
	static {
		//参数 域名  路径  匹配码
		sMatcher.addURI("cn.itcast.provider.personprovider", "person", code1);
		sMatcher.addURI("cn.itcast.provider.personprovider", "person/#", code2);
	}
    /**
     * 进行数据初始化工作
     */
	@Override
	public boolean onCreate() {
		// TODO Auto-generated method stub
		manger=new MangerDatabase(this.getContext());
		return true;
	}

	@Override
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {
		SQLiteDatabase db=manger.getReadableDatabase();
		switch (sMatcher.match(uri)) {
		case code1:
			  //select * from person
			  return db.query("person", projection, selection, selectionArgs, null, null, sortOrder);
		case code2:
			   //获取id 
			  long personid=ContentUris.parseId(uri);
			  String where=TextUtils.isEmpty(selection)?"personid=?":selection+"personid=?";
			  String[] param=new String[]{String.valueOf(personid)};
			  if(!TextUtils.isEmpty(selection)&&selectionArgs!=null)
			  {
				  param=new String[selectionArgs.length+1];
				  for(int i=0;i<selectionArgs.length;i++)
				  {
					  param[i]=selectionArgs[i];
				  }
				  param[selectionArgs.length+1]=String.valueOf(personid);
			  }
			  //参数 表名 返回的字段 指定的条件  条件对应的参数 是否分组 分组条件 排序类型
			  return db.query("person", projection, where, param, null, null, sortOrder);	  
		default:
			 throw new IllegalArgumentException("Unknow Uri:"+uri);
		}
	
	}
    /**
     *  执行还回操作的内容 字符串
     */
	@Override
	public String getType(Uri uri) {
		//sMatcher.match(uri) 该方法通过获取的路径 得到返回的匹配吗值
	    switch (sMatcher.match(uri)) {
		case code1:  //表示操作的是多条记录
		    return "vnd.android.cursor.dir/personprovider.persons";		
        case code2:  //表示操作的是单条记录
			return "vnd.android.cursor.item/personprovider.persons";
		default:
			throw new IllegalArgumentException("Unknow Uri:"+uri);
		}
		
	}

	@Override
	public Uri insert(Uri uri, ContentValues values) {
		SQLiteDatabase db=manger.getWritableDatabase();
		/**
		 * 参数 表名 列名 传入的值 
		 * 列明 当传入的值为空时，android的api会自动创建一条sql语句 ，为了保证语句的正确创建就必须指定一列名
		 */
		long id=0; //记录行号 如果主键为int类型  那么行号就是主键值
		//判断Uri的路径样式
		//如果match()方法匹配content://cn.itcast.provider.personprovider/person路径，返回匹配码为1
		//如果match()方法匹配content://cn.itcast.provider.personprovider/person/230路径，返回匹配码为2
       switch (sMatcher.match(uri)) {
	   case code1:  //content://cn.itcast.provider.personprovider/perso
		  id=db.insert("person", "name", values);//行号
		  /**
		   * ContentUris类用于获取Uri路径后面的ID部分，它有两个比较实用的方法：
		   * withAppendedId(uri, id)用于为路径加上ID部分
		   * parseId(uri)方法用于从路径中获取ID部分
		   */
		
		   return ContentUris.withAppendedId(uri, id);
		   
	   case code2://content://cn.itcast.provider.personprovider/person/230
		   id = db.insert("person", "name", values);
		   String path=uri.toString();
		  return Uri.parse(path.substring(0, path.lastIndexOf("/"))+id);
	   default:
		  throw new IllegalArgumentException("Unknow Uri:"+uri);
	  }
	
	}

	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
	
		SQLiteDatabase db=manger.getWritableDatabase();
		int count = 0;
		switch (sMatcher.match(uri)) {
		case code1: // content://cn.itcast.provider.personprovider/person
			count = db.delete("person", selection, selectionArgs);
			break; 
		case code2:// content://cn.itcast.provider.personprovider/person/100
			long personid = ContentUris.parseId(uri);
			String where = TextUtils.isEmpty(selection)? "personid=?" : selection +" and personid=?";
			String[] params = new String[]{String.valueOf(personid)};
			if(!TextUtils.isEmpty(selection) && selectionArgs!=null){
				params = new String[selectionArgs.length + 1];
				for(int i=0 ; i < selectionArgs.length ; i++){
					params[i] = selectionArgs[i];
				}
				params[selectionArgs.length + 1] = String.valueOf(personid);
			}
			count = db.delete("person", where, params);
			break; 
		default:
			throw new IllegalArgumentException("Unknow Uri:"+ uri);
		}
		return count;
	}
    /**
     *  url 
     *  values 字段值 
     *  selection 指定的条件
     *  selectionArgs 条件映射的固定值
     */
	@Override
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {
		SQLiteDatabase db=manger.getWritableDatabase();
		/**
		 * 参数 表名 列名 传入的值 
		 * 列明 当传入的值为空时，android的api会自动创建一条sql语句 ，为了保证语句的正确创建就必须指定一列名
		 */
		int count=0; //影响的记录数
		//判断Uri的路径样式
		//如果match()方法匹配content://cn.itcast.provider.personprovider/person路径，返回匹配码为1
		//如果match()方法匹配content://cn.itcast.provider.personprovider/person/230路径，返回匹配码为2
       switch (sMatcher.match(uri)) {
	   case code1:  //content://cn.itcast.provider.personprovider/perso
		 
		   /**
		    * 表名 列值 选择的条件 选择的条件映射值
		    */
		   count=db.update("person", values, selection, selectionArgs);
		  break;
	   case code2://content://cn.itcast.provider.personprovider/person/230 表示为id为230的修改
		     //获取id 
		    long id=ContentUris.parseId(uri);
	       //android中判断edittext输入框是否为空的工具类  TextUtils
		    String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";
		    //获取映射的参数值
		    String[] params = new String[]{String.valueOf(id)};
			if(!TextUtils.isEmpty(selection) && selectionArgs!=null){
				params = new String[selectionArgs.length + 1];
				for(int i=0 ; i < selectionArgs.length ; i++){
					params[i] = selectionArgs[i];
				}
				params[selectionArgs.length + 1] = String.valueOf(id);
			}
		    count=db.update("person", values, where, params);
		    break;
	   default:
		  throw new IllegalArgumentException("Unknow Uri:"+uri);
	  }
	
		return count;
	}

}

 

 

资源配置文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="it.date"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
      <!-- 域名提供者 命名  公司.提供者.哪类提供者 provider表示内容提供者配置 -->
        <provider android:name=".PersonContentProvider" android:authorities="cn.itcast.provider.personprovider"/>
        <!-- 单元测试 -->
        <uses-library android:name="android.test.runner" />
        <activity android:name=".DataActivity"
                  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="7" />
    <!-- 单元测试 -->
    <instrumentation android:name="android.test.InstrumentationTestRunner"
     android:targetPackage="it.date" android:label="Tests for My App" />
</manifest> 

 

 新建一个工程

package it.cast;

import android.app.Activity;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.util.Log;

public class ContentActivity extends Activity {
    private static final String tag="ContentActivity";
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        //获取内容提供者对象
        ContentResolver context=this.getContentResolver();
        /**
        //设置内容提供者具体Uri
        Uri uri=Uri.parse("content://cn.itcast.provider.personprovider/person");
        //设置操作的值
        ContentValues values=new ContentValues();
        values.put("name", "zhanghong");
        values.put("age", (short)33);
        //通过外部应用执行杀入数据
     //  context.insert(uri, values);
       //执行删除的Uri
    // uri=Uri.parse("content://cn.itcast.provider.personprovider/person/6");
       //context.delete(uri, null, null);  
        //执行更新操作
        //context.update(uri, values, null, null);
     /**
	   * 参数 表名 返回的字段 指定的条件  条件对应的参数 是否分组 分组条件 排序类型
	   */
        /**
     Cursor  cusor=context.query(uri, new String[]{"personid","name","age"}, null, null, "personid desc");
      
      while(cusor.moveToNext()){
    	  Log.i(tag, "personid="+cusor.getInt(0)+",name="+cusor.getString(1)+",age="+cusor.getShort(2));
      }
      //执行游标关闭 防止在下次执行交互数据库德应用出现内存异常错误
      cusor.close();
      */
      
        
        //获取联系人信息
        // ContactsContract.Contacts.CONTENT_URI  这个是获取资源文件的URI
        //
        Cursor cursor = context.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
        while(cursor.moveToNext()){
        	int contactId = cursor.getInt(cursor.getColumnIndex(ContactsContract.Contacts._ID)); //联系人的id 
        	String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));  //联系人的name
        	Log.i(tag, "contactid="+ contactId + ",name="+ name);
        	//查询电话表 条件是指定的联系人的id  ContactsContract.CommonDataKinds.Phone.CONTACT_ID +" = "+ contactId
        	Cursor phones = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,  
        		        null,  
        		        ContactsContract.CommonDataKinds.Phone.CONTACT_ID +" = "+ contactId,  
        		        null, null);
        	 StringBuilder sb = new StringBuilder();
        	 while(phones.moveToNext()){
        		 String phoneNumber = phones.getString(phones.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));  
        		 sb.append(phoneNumber).append(",");
        	 }
        	 Log.i(tag, sb.toString());
        }
        cursor.close();
    }
}

 

新工程的资源配置文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="it.cast"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".ContentActivity"
                  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="7" />
    <!-- 获取联系人的权限配置 -->
   <uses-permission android:name="android.permission.READ_CONTACTS"/>
</manifest> 

 

 

总结：

当应用继承ContentProvider类，并重写该类用于提供数据和存储数据的方法，就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据，但数据访问方式会因数据存储的方式而不同，如：采用文件方式对外共享数据，需要进行文件操作读写数据；采用sharedpreferences共享数据，需要使用sharedpreferences API读写数据。而使用ContentProvider共享数据的好处是统一了数据访问方式。
当应用需要通过ContentProvider对外共享数据时，第一步需要继承ContentProvider并重写下面方法：
public class PersonContentProvider extends ContentProvider{
   public boolean onCreate()
   public Uri insert(Uri uri, ContentValues values)
   public int delete(Uri uri, String selection, String[] selectionArgs)
   public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
   public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
   public String getType(Uri uri)}
第二步需要在AndroidManifest.xml使用<provider>对该ContentProvider进行配置，为了能让其他应用找到该ContentProvider ， ContentProvider 采用了authorities（主机名/域名）对它进行唯一标识，你可以把 ContentProvider看作是一个网站（想想，网站也是提供数据者），authorities 就是他的域名：
<manifest .... >
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <provider android:name=".PersonContentProvider" android:authorities="cn.itcast.provider.personprovider"/>
    </application>
</manifest>
注意：一旦应用继承了ContentProvider类，后面我们就会把这个应用称为ContentProvider（内容提供者）。

 

 

 

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

 

因为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类用于获取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

 

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

 

当外部应用需要对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的记录。