android数据存储之ContentProvider

android数据存储之ContentProvider

在android中应用的数据一般都是私有的，如果两个应用之间要共享数据，可以通过Content provider来实现。即是，如果一个应用实现了ContentProvider接口，就可以将自己的数据暴露出去，其他应用就可以通过ContentResolver来获取ContentProvider提供的接口服务，只是这种数据访问是通过RUI来表示的，这样就实现应用之间的数据共享。
在android中提供两类数据共享，一类是系统应用的数据共享，即系统应用已经实现了ContentProvider接口，只需要在其他应用中调用ContentResolver就可以访问。另一类是自定义数据共享，需要自己去实现ContentProvider接口。
（1）ContentProvider(android.content.ContentProvider)，实现这个接口可以将应用的数据服务分布出去供其他应用访问。ContentProvider为存储和获取数据提供统一的接口。实现这个接口需要实现下面几个方法。

public Uri insert(Uri uri, ContentValues values);//插入数据
	
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder);//查去数据
	
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs); //更新数据
	
	public int delete(Uri uri, String selection, String[] selectionArgs) ; //删除数据

	public String getType(Uri uri); //获取数据的mime类型 

	public boolean onCreate(); //创建ContentProvider时回调该方法

ContentProvider中对数据操作的方法都有一个android.net.Uri类型的参数，该参数代表操作数据的唯一标识。
content://com.example.MyDatabase/users/#
URI由三部分组成格式为：scheme+authority+path，scheme是content://表示移动的协议标识。authority用于唯一标识这个ContentProvider，一般以类的全名命名。path是/user/#可以用来表示我们要操作的数据。
Android提供了两个工具类来对Uri进行操作：UriMatcher的Uri进行注册和匹配，ContentUris对Uri进行组装。
基于前面sqlite的列子我们可以通过实现下面的列子来叙述android中ContentProvider的创建和使用。
设计如下：
MyDatabase：数据库结构类，是一个常量类存储数据库结构信息。
MysqliteDatabase：sqlite数据库操作类，通过该类构建获取SQLiteDatabase对象操作数据库。
MyContentProvider：继承ContentProvider类，实现ContentProvider类的方法。
Activity4：Activity类。

MyDatabase实现如下：

package com.contentProvider;

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

/**
 * 常量类表示数据库表结构
 * @author xmong
 */
public class MyDatabase {
	
	//数据库名
	public final static String DB_NAME = "db_test";
	//数据库版本
	public final static int DB_VERSION = 1;
	//
	public final static String AUTHORITY = "com.contentProvider.MyDatabase";
	
	/**
	 * User表结构,
	 * 实现BaseColumns常量接口，包含两个默认属性_ID和_COUNT
	 */
	public static class User implements BaseColumns{
		public final static String TAB_NAME = "user"; //表名
		public final static String COL_NAME = "name"; //用户名
		//访问该ContentProvider的URI
		public static final Uri CONTENT_URI = Uri.parse("content://"+AUTHORITY+"/users");
		//该ContentProvider所返回的数据类型
		public static final String CONTENT_TYPE_DIR = "vnd.android.cursor.dir/vnd.mydatabase.user";
		public static final String CONTENT_TYPE_ITEM = "vnd.android.cursor.item/vnd.mydatabase.user";
		//该ContentProvider的RUI匹配类型
		public static final int URI_TYPE_DIR = 1;
		public static final int URI_TYPE_ITEM = 2;
	}

MySqliteDatabase实现如下：

package com.contentProvider;


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

/**
 * @author xmong
 */
public class MySqliteDatabase{
	
	//sqlite数据库对象
	private SQLiteDatabase sqliteDatabase = null; 

	/**
	 * 数据库帮助类，继承SQLiteOpenHelper
	 */
	static class DatabaseHelper extends SQLiteOpenHelper{
		
		/**
		 * 构造数据库对象
		 * @param context context对象
		 * @param name 数据库名
		 * @param factory 可选游标工厂，通常可是null
		 * @param version 当前数据库版本
		 */
		public DatabaseHelper(Context context, String name,
				CursorFactory factory, int version) {
			super(context, name, factory, version);
		}

		//根据context构建数据库帮助对象
		public DatabaseHelper(Context context) {
			//调用自身构造方法
			this(context, MyDatabase.DB_NAME, null,  MyDatabase.DB_VERSION);
		}

		/**
		 * 该函数是在第一次创建数据库的时候执行，即第一次调用SQLiteOpenHelper对象的
		 * getWritableDatabase()或getReadableDatabase()方法时才执行该方法
		 * 可用于执行数据库初始化工作
		 */
		@Override
		public void onCreate(SQLiteDatabase db) {
			
			System.out.println("create table:"+ MyDatabase.User.TAB_NAME);
			//创建表sql语句
			String sql = "create table "+MyDatabase.User.TAB_NAME
					+" ("+MyDatabase.User._ID+" integer primary key autoincrement,"
					+MyDatabase.User.COL_NAME+" varchar(20))";
			//执行sql语句
			db.execSQL(sql);
		}

		/**
		 * 第一个参数是SQLiteDatabase对象，第二个参数是旧的数据库版本，第三个参数是新的数据库版本号，
		 * 可用于执行数据库的升级，将一个数据库从旧版本转变到新版本执行相应的操作
		 */
		@Override
		public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
			//可执行一些升级或修改数据库操作
			System.out.println("update database");
		}
		
	}
	
	/**
	 * 根据context构建sqlite数据库对象
	 * @param context
	 */
	public MySqliteDatabase(Context context) {
		/**
		 * 通过调用数据库帮助对象SQLiteOpenHelper的getWritableDatabase()方法
		 * 获取一个可读写的数据库对象sqliteDatabase
		 */
		sqliteDatabase = (new DatabaseHelper(context)).getWritableDatabase();
	}
	
	
	/**
	 * 关闭数据库，数据库操作完后需要释放资源
	 */
	public void close() {
		sqliteDatabase.close();
	}
	
	/**
	 * 获取sqliteDatabase对象
	 * @return
	 */
	public SQLiteDatabase getSqliteDatabase(){
		return sqliteDatabase;
	}
}

}

MyContentProvider实现如下：

package com.contentProvider;

import java.util.HashMap;
import java.util.Map;

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.database.sqlite.SQLiteQueryBuilder;
import android.net.Uri;
import android.text.TextUtils;

public class MyContentProvider extends ContentProvider{

	private SQLiteDatabase sqLiteDatabase; //sqlite数据库对象
	private static UriMatcher uriMatcher;
	private static Map<String, String> userProjectionMap;
	static {
		//注册需要匹配的uri，将uri与匹配码相匹配
		uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
		//注册调用match()方法时，匹配content://com.contentProvider.MyDatabase/user路径，则返回匹配码1
		uriMatcher.addURI(MyDatabase.AUTHORITY, "users", MyDatabase.User.URI_TYPE_DIR);
		uriMatcher.addURI(MyDatabase.AUTHORITY, "users/#", MyDatabase.User.URI_TYPE_ITEM);
		
		userProjectionMap = new HashMap<String, String>();
		userProjectionMap.put(MyDatabase.User._ID, MyDatabase.User._ID);
		userProjectionMap.put(MyDatabase.User.COL_NAME, MyDatabase.User.COL_NAME);
	}
	
	//根据传入的URI，返回该URI所表示的数据MIME类型
	@Override
	public String getType(Uri uri) {
		System.out.println("contentProvider getType");
		switch(uriMatcher.match(uri)){
		case MyDatabase.User.URI_TYPE_DIR:
			return MyDatabase.User.CONTENT_TYPE_DIR;
		case MyDatabase.User.URI_TYPE_ITEM:
			return MyDatabase.User.CONTENT_TYPE_ITEM; 
		default:
			throw new IllegalArgumentException("Unknown URI:" + uri);
		}
	}

	//插入数据
	@Override
	public Uri insert(Uri uri, ContentValues values) {
		System.out.println("contentProvider intert");
		Uri insertUri = null;
		long id = sqLiteDatabase.insert(MyDatabase.User.TAB_NAME, null, values);
		if(id>0){
			//生成uri：content://com.contentProvider.MyDatabase/user/id
			insertUri = ContentUris.withAppendedId(MyDatabase.User.CONTENT_URI, id);
			//通知监听器，数据已经改变
			getContext().getContentResolver().notifyChange(insertUri, null);
			return insertUri;
		}
		return insertUri;
	}

	//查去数据
	@Override
	public Cursor query(Uri uri, String[] projection, String selection,
			String[] selectionArgs, String sortOrder) {
		System.out.println("contentProvider query");
		SQLiteQueryBuilder qb = new SQLiteQueryBuilder();
		/**
		 * 调用UriMatcher匹配uri类型，返回匹配码
		 * 根据不同的uri类型构建不同的sqlQuery
		 */
		switch (uriMatcher.match(uri)) {
		case MyDatabase.User.URI_TYPE_DIR:
			qb.setTables(MyDatabase.User.TAB_NAME);
			qb.setProjectionMap(userProjectionMap);
			break;
		case MyDatabase.User.URI_TYPE_ITEM:
			qb.setTables(MyDatabase.User.TAB_NAME);
			qb.setProjectionMap(userProjectionMap);
			qb.appendWhere(MyDatabase.User._ID+"="+uri.getPathSegments().get(1));
			break;
		default:
			throw new IllegalArgumentException("Unknown URI:" + uri);
		}
		//设置order by参数
		Cursor cursor = qb.query(sqLiteDatabase, projection, selection, 
				selectionArgs, null, null, null);
		return cursor;
	}
	
	//修改数据
	@Override
	public int update(Uri uri, ContentValues values, String selection,
			String[] selectionArgs) {
		System.out.println("contentProvider update");
		switch (uriMatcher.match(uri)) {
		case MyDatabase.User.URI_TYPE_DIR:
			return sqLiteDatabase.update(MyDatabase.User.TAB_NAME, values, selection, selectionArgs);
		case MyDatabase.User.URI_TYPE_ITEM:
			String uid = uri.getPathSegments().get(1);
			return sqLiteDatabase.update(MyDatabase.User.TAB_NAME, values,
					MyDatabase.User._ID+"="+uid
					+(!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""), selectionArgs);
		default:
			throw new IllegalArgumentException("Unknown URI:" + uri);
		}
	}
	
	//删除数据
	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		System.out.println("contentProvider delete");
		switch (uriMatcher.match(uri)) {
		case MyDatabase.User.URI_TYPE_DIR:
			return sqLiteDatabase.delete(MyDatabase.User.TAB_NAME, selection, selectionArgs);
		case MyDatabase.User.URI_TYPE_ITEM:
			String uid = uri.getPathSegments().get(1);
			return sqLiteDatabase.delete(MyDatabase.User.TAB_NAME,
					MyDatabase.User._ID+"="+uid
					+(!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""), selectionArgs);
		default:
			throw new IllegalArgumentException("Unknown URI:" + uri);
		}
	}

	//该方法在ContentProvider创建时被执行
	@Override
	public boolean onCreate() {
		System.out.println("contentProvider create");
		//获取sqLiteDatabase对象
		sqLiteDatabase = (new MySqliteDatabase(getContext())).getSqliteDatabase();
		return false;
	}
	
	
	
}

Activity4实现如下：

package com.contentProvider;

import com.example.R;

import android.net.Uri;
import android.os.Bundle;
import android.text.TextUtils;
import android.view.KeyEvent;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.app.Activity;
import android.content.ContentValues;
import android.database.Cursor;

public class Activity4 extends Activity {

	private EditText editText; //输入框
	private Button insertBtn; //插入按钮
	private Button queryBtn; //查询按钮
	private Button updateBtn; //更新按钮
	private Button deleteBtn; //删除按钮
	
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity3);
		//从视图中获取控件对象
		editText = (EditText)findViewById(R.id.text);
		insertBtn = (Button)findViewById(R.id.insert);
		queryBtn = (Button)findViewById(R.id.query);
		updateBtn = (Button)findViewById(R.id.update);
		deleteBtn = (Button)findViewById(R.id.delete);
		//为按钮对象设置点击事件
		insertBtn.setOnClickListener(insertBtnClick);
		queryBtn.setOnClickListener(queryBtnClick);
		updateBtn.setOnClickListener(updateBtnClick);
		deleteBtn.setOnClickListener(deleteBtnClick);
		
	}
	
	//插入按钮点击事件监听器
	OnClickListener insertBtnClick = new OnClickListener() {
			
		@Override
		public void onClick(View v) {
			String text = editText.getText().toString().trim();
			ContentValues cv = new ContentValues();
			cv.put(MyDatabase.User.COL_NAME, text);
			Uri uri = getContentResolver().insert(MyDatabase.User.CONTENT_URI, cv);
			System.out.println(uri.toString());
		}
	};
	
	//查取按钮点击事件监听器
	OnClickListener queryBtnClick = new OnClickListener() {
		
		@Override
		public void onClick(View v) {
			//根据输入框中是否输入id号来构建content的uri
			String text = editText.getText().toString().trim();
			String uidUri = TextUtils.isEmpty(text)? "":"/"+text;
			Uri uri = Uri.parse(MyDatabase.User.CONTENT_URI+uidUri);
			Cursor cursor = getContentResolver().query(uri, 
					new String[]{MyDatabase.User._ID, MyDatabase.User.COL_NAME}, null, null, null);
			//遍历游标输出查取的数据
			for(cursor.moveToFirst();!cursor.isAfterLast();cursor.moveToNext()){
				String str = MyDatabase.User._ID+":"+cursor.getInt(cursor.getColumnIndex(MyDatabase.User._ID))
						+","+MyDatabase.User.COL_NAME+":"+cursor.getString(cursor.getColumnIndex(MyDatabase.User.COL_NAME));
				System.out.println(str);
			}
		}
	};
	
	//修改按钮点击事件监听器
	OnClickListener updateBtnClick = new OnClickListener() {
		
		@Override
		public void onClick(View v) {
			String text = editText.getText().toString().trim();
			String[] arr = text.split(",");
			ContentValues cv = new ContentValues();
			cv.put(MyDatabase.User.COL_NAME, arr[1]);
			String uidUri = TextUtils.isEmpty(arr[0])? "":"/"+arr[0];
			Uri uri = Uri.parse(MyDatabase.User.CONTENT_URI+uidUri);
			getContentResolver().update(uri, cv, null, null);
		}
	};
	
	//删除按钮点击事件监听器
	OnClickListener deleteBtnClick = new OnClickListener() {
		
		@Override
		public void onClick(View v) {
			String text = editText.getText().toString().trim();
			String uidUri = TextUtils.isEmpty(text)? "":"/"+text;
			Uri uri = Uri.parse(MyDatabase.User.CONTENT_URI+uidUri);
			getContentResolver().delete(uri, null, null);
		}
	};
	
	//按键事件
	public boolean onKeyUp(int keyCode, KeyEvent event) {
		//当按键为回退键是结束这个activity
		if (keyCode == KeyEvent.KEYCODE_BACK) {
			Activity4.this.finish();
		}
		return true;
	};
}

修改AndroidManifest.xml文件，分布ContentProvider服务。

<provider  android:name="com.contentProvider.MyContentProvider"
            android:authorities="com.contentProvider.MyDatabase"></provider>

上面的配置是name属性是指向自定义ContentProvider类，authorities属性是配置该ContentProvider uri的authority。

运行程序：
后台输出：
contentProvider create
在输入框中输入“xmong”，点击insert按钮，后台输出：
contentProvider insert
content://com.contentProvider.MyDatabase/users/1
清空输入框，点击query按钮，后台输出：
contentProvider query
_id:1,name:xmong
……
从操作结果我们可以知道ContentProvider的分布成功，调用也成功。

源代码下载: http://xmong.iteye.com/blog/1852204

android数据存储之ContentProvider

猜你喜欢