Android 之 自定义ContentProvider的使用

ContentProvider的简介：
* Android系统中存在大量的应用，当不同的应用程序直接需要共享数据时，可以使用ContentProvider来实现。
* ContentProvider是Android应用的四大组件之一，与Activity和Serivce相同，使用前需要注册。
* 当一个程序需要把自己的数据暴露给其他程序使用时，该程序就可以通过提供ContentProvider来实现，
     其他应用程序就可以通过ContenResolver来操作Content Provider暴露的数据。
* 应用程序通过ContentProvider开放了自己的数据，该应用程序不需要启动，其他应用程序都可以操作开放的数据，包括增删改查操作。


自定义ContentProvider(内容提供者):
1、让自己的数据和其他的应用程序共享的两种方式：
* 创建自己的ContentProvider(继承ContentProvider的子类)
* 将自己的数据添加到已有的ContentProvider中去；(这种方式需要对应的权限)；

2、创建一个ContentProvider ， 主要有以下步骤：
(1) 建立数据存储系统；(可以通过Android的文件存储系统 或 SQLite数据库建立)；
(2) 扩展ContentProvider 类；作用：主要工作是将要共享的数据包装并以ContentResolver 和Cursor对象能够访问
到的形式对外展示；(继承ContentProvider需要实现多个方法，这些方法在ContentResolver对象中调用)；
(3) 在应用程序的AndroidMainfest.xml文件中声明ContentProvider 组件；



小贴士：
* URI 类型常量的定义：必须为该常量对象定义一个唯一的一个URI字符串，一般取类名的全称；
* SQLite数据库中 ， 不管数据表中有没有其他唯一标识一个记录的字段，都应该定义一个_id字段来唯一标识一个记录；
  (_id integer primary key autoincrement)；
* 注册ContentProvider: <provider android:name=".类名" android:authorities="uri的唯一ID指示名称"/>
* 当修饰为static时：类.内部类.字段；



案例实现：开发一个应用，该应用对外暴露数据库，实现其它应用共用数据库的效果；

ContentProvider的子类：

package com.example.user_defined_contentprovider;


import android.content.ContentProvider;
import android.content.ContentUris;
import android.content.ContentValues;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteQueryBuilder;
import android.net.Uri;
import android.widget.Toast;

/* 自定义ContentProvider 将数据库和其它的应用进行分享 */
public class User_defined_ContentProvider extends ContentProvider {

	private MySQLite helper;
	private final static int DB_VERSION = 2;
	private final static String DB_NAME = "mydb.db";
	
	
	/* 当ContentProvider 启动时被调用 *//* 动作：创建数据库 */
	public boolean onCreate() {
		helper = new MySQLite(this.getContext(),DB_NAME , null, DB_VERSION);
		return (helper==null) ? false:true;
	}

	/* 向  ContentProvider  中插入新的数据 */
	public Uri insert(Uri uri, ContentValues values) {
		/* 获取数据库的连接 */
		SQLiteDatabase db = helper.getWritableDatabase();
		
		/* 操作SQLite数据库，插入数据 */
		long raw_ID = db.insert(MyUser.TABLE_NAME, null, values);
				
		if(raw_ID>=0){
			/* 获取新的URI地址，将获得到的ID追加到原来的URI上面 */
			Uri newUri = ContentUris.withAppendedId(uri, raw_ID);
			return newUri;
		}
		return null;
	}

	/* 从  ContentProvider  中删除数据 */
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		return 0;
	}

	/* 返回Content Provider 中的数据(MIME) 类型 */
	public String getType(Uri uri) {
		return null;
	}

	/* 将查询的数据以 Cursor 对象的形式返回 */
	public Cursor query(Uri uri, String[] projection, String selection,	String[] selectionArgs, String 

sortOrder) {
		
		SQLiteDatabase db = helper.getWritableDatabase();
		SQLiteQueryBuilder sqb = new SQLiteQueryBuilder();
		sqb.setTables(MyUser.TABLE_NAME);
		Cursor cursor = sqb.query(db, projection, selection, selectionArgs, null, null, sortOrder);

		return cursor;
	}

	/* 更新  ContentProvider  中已经存在的数据 */
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {

		return 0;
	}

}

常量类：
package com.example.user_defined_contentprovider;

import android.net.Uri;
import android.provider.BaseColumns;

/* 常量类 */

public class MyUser {
	
	/* ContentProvider 的Uri */
	public static final String AUTHORITY = "com.example.user_defined_contentProvider.User_defined_ContentProvider";
	public static final String TABLE_NAME ="t_user";
	public MyUser(){}	
	
	/* 内部类：实现BaseColumns 这个接口：_id 和 _count */
	public static final class User implements BaseColumns{
		
		/* 定义Uri对象 */
		public static final Uri CONTENT_URI = Uri.parse("content://"+AUTHORITY+"/"+MyUser.TABLE_NAME);
		
		/* 定义基本字段 */
		public static final String NAME = "name";
		public static final String AGE= "age";
		
	}
}

数据库访问类：

package com.example.user_defined_contentprovider;


import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteDatabase.CursorFactory;
import android.database.sqlite.SQLiteOpenHelper;

//SQLite数据库 ， 用于创建数据库
public class MySQLite extends SQLiteOpenHelper {

	public MySQLite(Context context, String name, CursorFactory factory,int version) {
		super(context, name, factory, version);
	}

	/* 数据库第一次创建的时候调用，创建一张表 */
	public void onCreate(SQLiteDatabase db) {
		/* 初始化的时候创建表 */
		String sql = "create table "+MyUser.TABLE_NAME+"(_id integer primary key autoincrement,"+MyUser.User.NAME+" text , "+MyUser.User.AGE+" integer )";
		db.execSQL(sql);
	}

	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
		// TODO 删除表 ，删除后重新创建
		db.execSQL("drop table if exists "+MyUser.TABLE_NAME+"");
		onCreate(db);
	}

}

程序测试：

package com.example.user_defined_contentprovider;

import android.app.Activity;
import android.content.ContentValues;
import android.database.Cursor;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;


public class MainActivity extends Activity {   
	private Button selectionData,insertData;

	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		selectionData = (Button) findViewById(R.id.selectionData);
		insertData = (Button) findViewById(R.id.insertData);
		

		/***************************按钮事件**********************************************/
		/* 测试 ：插入数据 */
		insertData.setOnClickListener(new OnClickListener() {
			public void onClick(View v) {
				// TODO Auto-generated method stub
				insertData();
			}
		});

		
		/* 测试查询数据  */        
		selectionData.setOnClickListener(new OnClickListener() {
			public void onClick(View v) {
				selectionData();
			}
		});
		/************************************************************************************/
	}

	/* 插 入数据  */
	public void insertData(){
		ContentValues values = new ContentValues();
		values.put(MyUser.User.NAME, "tony");
		values.put(MyUser.User.AGE, 20);
		this.getContentResolver().insert(MyUser.User.CONTENT_URI, values);
		values.clear();
	}

	/* 查询数据 */
	public void selectionData(){
		/* 查询：返回一个Cursor对象 *//* 调用这个方法则间接的调用了ContentProvider子类中的query()方法，实现对数据库的操作 */
		Cursor cursor = this.getContentResolver().query(MyUser.User.CONTENT_URI, null, null, null, null);

		/* 读取Curosor对象中的数据 */
		while(cursor.moveToNext()){
			String name = cursor.getString(cursor.getColumnIndex("name"));
			String age = cursor.getString(cursor.getColumnIndex(MyUser.User.AGE));
			Toast.makeText(MainActivity.this, name+" "+age, 1000).show();
		}
	}
}

AndroidManifest.xml中的配置：

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

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

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.example.user_defined_contentprovider.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>
        
        <!-- ContentProvider为四大组件之一， 因此进行注册 -->
        <provider 
            android:name=".User_defined_ContentProvider" 
            android:authorities="com.example.user_defined_contentProvider.User_defined_ContentProvider" 
            android:readPermission="true"/>
    </application>

</manifest>