《老罗Android》学习之Content Provider

 Android有4大主键： Activity, Service, Broadcast, ContentProvider.
1. 使用ContentProvider需要在AndroidManifest.xml中声明 
  <provider     android:name=".StudentProvider"
            android:authorities="com.example.android_contentprovider2.StudentProvider" >
2. ContentProvider介绍
 Content Provider 的作用是使得各个应用程序之间实现数据共享。而数据库是不能跨应用的，如果数据只要在本应用中调用 ，用SQLite就可以了。它的结构是这样的：
    
内容提供者继承ContentProvider 类，并运营一个数据库。  内容解析者通过生成一个ContentResolver对象，来完成对ContentProvider 的数据访问，即实现增、删、改、查。
1）什么情况下要用到内容提供者（ContentProvider）呢？
 1.你需要提供一个复杂的数据或文件给其它应用。
 2.你允许用户从你的应用中拷贝复杂的数据到其它应用。
 3.你想要在框架内提供自定义的查询功能。
 如果是在自己的应用当中想要获取数据，不需要用到ContentProvider，用SQLite就可以了。


3.示例：封装一个ContentProvider，给别的APP调用
1.  DbHelper.java ------->生成一个 SQLite数据库

public class DbHelper extends SQLiteOpenHelper {
	private static String name = "mydb.db"; 
	private static int version = 1;// 初始的版本号是一
	public DbHelper(Context context) {
	super(context, name, null, version);//传入数据库名，版本等信息
	}
	public void onCreate(SQLiteDatabase database) {
	String sql = "create table student (id integer primary key autoincrement ,name varchar(64) ,address varchar(64))";
	database.execSQL(sql);// 对数据库的表的创建
	}
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
}

2. StudentProvider.java --------- 实现一个ContentProvider类，对数据库进行访问操作
  部分摘自：基础总结篇之八：创建及调用自己的ContentProvider
    在Android中，每一个ContentProvider都会用类似于域名的字符串来注册自己，我们成为授权(authority)。这个唯一标识的字符串是此ContentProvider可提供的一组URI的基础，有了这个基础，才能够向外界提供信息的共享服务。我们先来了解以下两个知识点：
  1)  授权是在AndroidManifest.xml中完成的，每一个ContentProvider必须在此声明并授权，方式如下：

<provider   android:name=".StudentProvider"
            android:authorities="com.example.contentprovider.StudentProvider" ></provider><！--包名+类名 -->

上面的<provider>元素指明了ContentProvider的提供者是“StudentProvider”这个类，并为其授权，授权的基础URI为“com.example.contentprovider.StudentProvider ”。有了这个授权信息，系统可以准确的定位到具体的ContentProvider，从而使访问者能够获取到指定的信息。

 2) Android也遵循类似的约定来定义MIME类型。

对于单条记录，MIME类型类似于：

vnd.android.cursor.item/vnd.your-company.content-type

而对于记录集合，MIME类型类似于：

vnd.android.cursor.dir/vnd.your-company.comtent-type

其中的vnd表示这些类型和子类型具有非标准的、供应商特定的形式；content-type可以根据ContentProvider的功能来定，比如日记的ContentProvider可以为note，日程安排的ContentProvider可以为schedule，等等。

了解了以上两个知识点之后，我们就结合实例来演示一下具体的过程。

如我们创建一个记录person信息的ContentProvider，实现对person的CRUD操作，访问者可以通过下面路径操作我们的ContentProvider：

  
  访问者可以通过“[BASE_URI]/persons”来操作person集合，也可以通过“[BASE_URI]/persons/#”的形式操作单个person。

public class StudentProvider extends ContentProvider {
	private final String TAG = "StudentProvider";
	private DbHelper helper = null;
	private static final UriMatcher URI_MATCHER = new UriMatcher(UriMatcher.NO_MATCH);
	private static final int STUDENT = 1;// 操作单条记录
	private static final int STUDENTS = 2;// 操作多条记录
	static {//定义匹配规则，匹配外部的请求
	URI_MATCHER.addURI(//根据请求，判断是STUDENTS还是STUDENT标志。
	"com.example.android_contentprovider2.StudentProvider","student", STUDENTS);
	URI_MATCHER.addURI(
	"com.example.android_contentprovider2.StudentProvider","student/#", STUDENT);
	}
	public StudentProvider() {
	}
	public int delete(Uri uri, String selection, String[] selectionArgs) {//删除
		int count = -1;// 影响数据库的行数
	try {
		int flag = URI_MATCHER.match(uri);
		SQLiteDatabase database = helper.getWritableDatabase();
		switch (flag) {
		case STUDENT:
			// content://com.example.android_contentprovider2.StudentProvider/student/1
			// delete from student where id = ? //id 通过客户端传递过来的
			long id = ContentUris.parseId(uri);
			String where_value = " id = " + id;
			if (selection != null && !selection.equals("")) {
				where_value += " and " + selection;
			}
			count = database.delete("student", where_value, selectionArgs);
			break;
		case STUDENTS:
			count = database.delete("student", selection, selectionArgs);
			break;
			}
		} catch (Exception e) {
		}
		return count;
	}
	public String getType(Uri uri) {
		int flag = URI_MATCHER.match(uri);
		switch (flag) {
		case STUDENT:
			return "vnd.android.cursor.item/student"; //操作单条记录
		case STUDENTS:
			return "vnd.android.cursor.dir/students";//操作多条记录
		}
		return null;
	}
	public Uri insert(Uri uri, ContentValues values) {//增加
		// insert into student () (?,?);
		Uri resultUri = null;
		int flag = URI_MATCHER.match(uri);//匹配外部调用规则，若匹配则调用，不匹配不调用 
		switch (flag) {
		case STUDENTS:
			SQLiteDatabase database = helper.getWritableDatabase();
			long id = database.insert("student", null, values);// 返回插入当前行的行号
			resultUri = ContentUris.withAppendedId(uri, id);//插入完成后，生成一个新的URI供应用调用 
			break;
		}
		Log.i(TAG, "---->>" + resultUri.toString());
		return resultUri;
	}
	public boolean onCreate() {
		helper = new DbHelper(getContext());//在onCreate方法中要先生成DbHelper的对象，操作数据库都要用到这个对象
		return true;
	}
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {//查询
		Cursor cursor = null;
		try {
			SQLiteDatabase database = helper.getReadableDatabase();
			int flag = URI_MATCHER.match(uri);
			switch (flag) {
			case STUDENT:
				long id = ContentUris.parseId(uri);
				String where_value = " id = " + id;
				if (selection != null && !selection.equals("")) {
					where_value += " and " + selection;
				}
		cursor = database.query("student", null, where_value,selectionArgs, null, null, null, null);
				break;
			case STUDENTS:
		cursor = database.query("student", null, selection,selectionArgs, null, null, null);
				break;
			}
		} catch (Exception e) {
		}
		return cursor;
	}
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {//更改
		int count = -1;
		try {
			// update table set name = ? ,address = ? where id = ?
			SQLiteDatabase database = helper.getWritableDatabase();
			long id = ContentUris.parseId(uri);
			int flag = URI_MATCHER.match(uri);
			switch (flag) {
			case STUDENT:
				String where_value = " id = " + id;
				if (selection != null && !selection.equals("")) {
					where_value += " and " + selection;
				}
		count = database.update("student", values, where_value,	selectionArgs);
				break;
			}
		} catch (Exception e) {
		}
		return count;
	}
}

3.  MyTest.java  ----- 外部访问 ContentProvider，可以放在另一个APP中也可以访问。

public class MyTest extends AndroidTestCase {
	public MyTest() {
	}
	public void insert() {
		// 访问内容提供者的步骤：
		// 1、需要一个内容解析者
		ContentResolver contentResolver = getContext().getContentResolver();
		// 使用content://+授权路径----> 从清单文件中读取到  +单条/多条标志
		Uri url = Uri.parse("content://com.example.android_contentprovider2.StudentProvider/student");
		ContentValues values = new ContentValues();
		values.put("name", "张三疯");
		values.put("address", "北京");
		contentResolver.insert(url, values);
	}
	public void delete() {
		ContentResolver contentResolver = getContext().getContentResolver();
		// 删除单行记录,如果要删除多行记录：content://com.example.android_contentprovider2.StudentProvider/student
		Uri uri = Uri.parse("content://com.example.android_contentprovider2.StudentProvider/student/1");
		contentResolver.delete(uri, null, null);
	}
	public void update() {
		ContentResolver contentResolver = getContext().getContentResolver();
		Uri uri = Uri.parse("content://com.example.android_contentprovider2.StudentProvider/student/2");
		ContentValues values = new ContentValues();
		values.put("name", "李斯");
		values.put("address", "上海");
		contentResolver.update(uri, values, null, null);
	}	
	public void query(){
		ContentResolver contentResolver = getContext().getContentResolver();
		//查询单条记录：content://com.example.android_contentprovider2.StudentProvider/student/2
		//查询多条记录：content://com.example.android_contentprovider2.StudentProvider/student
		Uri uri = Uri.parse("content://com.example.android_contentprovider2.StudentProvider/student");
		//select *  from student where id = 2;
		Cursor cursor = contentResolver.query(uri, null, null, null, null);
		while(cursor.moveToNext()){
			System.out.println("---->>"+cursor.getString(cursor.getColumnIndex("name")));
		}
	}
}

如果是："content://com.example.android_contentprovider2.StudentProvider/student"，就会匹配到STUDENTS。
content://com.example.android_contentprovider2.StudentProvider/student/2，就会匹配到STUDENT。
4.这里用到了单元测试，所以要在AndroidManifest.xml中加入 instrumentation（测试设备）。
 
步骤：1）点击Instrumentation. 再点击Add添加一个Instrumentation.
2)点击Name---->Browse，只有一个选项，选择它。
3）点击Target package，选择你要为哪个包添加测试设备，选择你的ContentProvider工程包。
4）在Manifest代码中加入：<uses-library android:name="android.test.runner"/>   位于<application>中<activity>之上。
以上4步就完成了添加，按Ctrl+S保存即可
5. 运行，测试
1）先把Android工程运行起来，--->run as androidApplication.   
2）再在AndroidTestCase实现类中，要执行哪个方法，就在相应方法代码上单击右键---->run as Android Junit Test.
如果出现绿条，表示运行成功：
  
3）在DDMS中 /data/data相应工程 包下可找到生成的database
   
4)把这个mydb.db导出到电脑上，用SQLite管理工具 SQLite Expert Professional打开，就可看到里面数据的变化是否操作正确：
   

总结：

 ContentProvider首先肯定要实现一个 ContentProvider类，主要完成对数据的增、删、改、查；ContentProvider类中需要对SQLite数据库进行操作，所以要得到一个数据库；就要创建一个类来完成，这个类继承自SQLiteOpenHelper 一般被命名为DBHelper 。
 访问 ContentProvider的数据用ContentResolver，访问的时候遇到一个选择：访问单条记录还是多条记录。这通过访问时给定的uri来解析判断，所以要UriMatcher  Uri的匹配规则来匹配是单条还是多条记录。匹配出来后，根据不同情况做不同的处理。