我们通过一个Content Provider小例子进行详细说明。数据源是一个SQLite数据库,名字为books.db,该数据库只含有一个表格,名字为books。表格中含有name,isbn,author,created_date和modified_date几列。我们通过一个名为BookProvider的内容提供者将数据源运行封装,并对外提供增删改查的接口。
首先:定义Content Provider的结构
创建一个Provider,我们首先需要定义好这个provider的结构。通过constant的定义,阐明接口的含义。本例在BookProviderMetaData类中定义,包括数据库,URI,列名等等,具体如下:
/* 定义一个类专门给出provider结构,以常量方式给出,根据具体的数据源结构,数据库对应一个authority,而不同的表格为不同的page segment,本例只有一个表格。本例为二层结构。Content://authority/table_name/book_item */ public class BookProviderMetaData { /* 步骤1:定义content://authority以及对应数据源(db)的相关属性 */ /* 步骤1.1 定义provider的内容:以constant的方式定义authority*/ public static final String AUTHORITY = "cn.flowingflying.provider.BookProvider"; /* 步骤1.2 定义数据源的相关信息,本例对相关的SQLite数据库进行定义 */ public static final String DATABASE_NAME = "books.db"; public static final int DATABASE_VERSION = 1; public static final String BOOKS_TABLE_NAME = "books"; /* 步骤1.3 定义私有的构造函数,目的是本类只进行结构描述,只用于定义引用,不能对本类创建对象 */ private BookProviderMetaData(){}; /* 步骤2:采用内部类定义content://authority/page_segment、具体的item和对应数据源(table),本例只有一个表格,其uri的引用方式为BookProviderMetaData.BookTableMetaData.CONTENT_URI。SQLite的表格实现BaseColumns接口,其中_id是该接口自带的,常量为_ID,每行由系统自动生成唯一的_id */ public static final class BookTableMetaData implements BaseColumns{ /* 步骤2.3 定义私有构造类,表明本类制作定义引用,不生成对象 */ private BookTableMetaData(){}; //不应该进行该对象的创建。只用于描述 /* 步骤2.1 定义provider的结构,本层结构已经映射到具体的item,定义相关的uri和MIME*/ public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/books"); public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.cn.flowingflying.book"; public static final String CONTENT_ITEM_TYPE="vnd.android.cursor.item/vnd.cn.flowingflying.book"; /* 步骤2.2 定义数据源的相关的结构,即表格的相关信息*/ public static final String TABLE_NAME = "books"; public static final String BOOK_NAME = "name"; public static final String BOOK_ISDN = "isbn"; public static final String BOOK_AUTHOR = "author"; public static final String CREATED_DATE = "created"; public static final String MODIFIED_DATE = "modified"; public static final String DEFAULE_SORT_ORDER = "modified DESC"; } } |
其次:继承ContentProvider抽象类,实现我们自己的Provider
BookProvider是android.content.ContentProvider的extend,需要对创建onCreate()、获取类型getType(),以及数据的增删改查 query(),add(),delete(),update进行重写。
/* 创建我们的BookProvider,先对数据源进行处理,为下一步对provider提供的增删改查等接口进行准备,即先处理数据源,然后对数据源的I/O接口(provider)进行处理。 */ /* 步骤1.3:@Override onUpgrade,当发现数据库的版本低于当前版本时,对数据库进行升级,本例将删除原来的 全部数据,重新建立新的表格*/ private DatabaseBookHelper mDataSource = null; //步骤2:设置并获取数据源对象 @Override @Override /* 步骤2:关联数据源,本例创建数据库的对象 */ @Override @Override |
第三:实现BookProvider的询问MIME,以及数据的增删改查
(1)获取数据类型,重写getType()
/* 通过getType(),Provider对外提供uri获取的数据类型(MIME Type),分为collection和item两种情况。*/ public String getType(Uri uri) { switch(sUriMatch.match(uri)){ case BOOK_COLLECTION_URI_INDICATOR: return BookTableMetaData.CONTENT_TYPE; case BOOK_ITEM_URI_INDICATION: return BookTableMetaData.CONTENT_ITEM_TYPE; default: //无效uri throw new IllegalArgumentException("Unknown Uri " + uri); } } |
(2)数据查询,重写query(),返回游标
public Cursor query(Uri uri, String[] protection, String selection, String[] selectionArgs, String order) { //1、通过SQLiteQueryBuilder,设置数据库查询的信息。Uri有两种情况,一种是collect,一种已经指定某个item, 两者需要区别对待,item将获取_ID,并在where中增加一个匹配条件。 SQLiteQueryBuilder dbQuery = new SQLiteQueryBuilder(); switch(sUriMatch.match(uri)){ case BOOK_COLLECTION_URI_INDICATOR: dbQuery.setTables(BookTableMetaData.TABLE_NAME); dbQuery.setProjectionMap(sBooksProjectionMap); //设定与project的映射关系 break; case BOOK_ITEM_URI_INDICATION: dbQuery.setTables(BookTableMetaData.TABLE_NAME); dbQuery.setProjectionMap(sBooksProjectionMap); //设定与project的映射关系 // 通过getPathSegments( )获取具体的ID,path segment从0还是计算,本例中0为books,1为# dbQuery.appendWhere(BookTableMetaData._ID + "=" + uri.getPathSegments().get(1)); break; default: throw new IllegalArgumentException("Unknown Uri " + uri); } //2、对缺省进行设置,如排序 String orderBy; if(TextUtils.isEmpty(order)){ orderBy = BookTableMetaData.DEFAULE_SORT_ORDER; }else{ orderBy = order; } //3、查询数据库 SQLiteDatabase db = mDataSource.getReadableDatabase(); Cursor c = dbQuery.query(db, protection, selection, selectionArgs, null, null, orderBy); //4、向系统注册通知:观察所要查询的数据,即Uri对应的数据,是否发生变化。开发者通过provider接口获取数据, 可通过通知获知数据已经发生变更。 c.setNotificationUri(getContext().getContentResolver(), uri); return c; } |
(3)数据增加,重写insert(),返回新增数据的uri
public Uri insert(Uri uri, ContentValues initalValue) { //1、检查uri是否合法,由于新增item,故uri只能是collection方式 if(sUriMatch.match(uri) != BOOK_COLLECTION_URI_INDICATOR){ throw new IllegalArgumentException("Unknown Uri " + uri); } //2、从ContentValues中获取数据,检查数据是否有效和完备 //3、在数据库表格中增加row |
(4)数据删除,重写delete(),返回成功删除的item数目
public int delete(Uri uri, String where, String[] whereArgs) { int count = 0; //记录删除item数目 SQLiteDatabase db = mDataSource.getWritableDatabase(); //删除:根据uri分为collection和item两种情况 switch(sUriMatch.match(uri)){ case BOOK_COLLECTION_URI_INDICATOR: count = db.delete(BookTableMetaData.TABLE_NAME, where, whereArgs); break; case BOOK_ITEM_URI_INDICATION: String id = uri.getPathSegments().get(1); //从0开始计算,本例中0为content://xxxx/books/2中的books count = db.delete(BookTableMetaData.TABLE_NAME, BookTableMetaData._ID + "=" + id +(TextUtils.isEmpty(where) ? "" : " AND (" + where + ")"), whereArgs); break; default: throw new IllegalArgumentException("Unknown Uri " + uri); } getContext().getContentResolver().notifyChange(uri, null); //通知该uri的数据发生变化 return count; } |
(5)数据更改,重写update(),返回成功修改的item数目
public int update(Uri uri, ContentValues values, String whereClause, String[] whereArgs) { int count = 0; //记录更新item数目 SQLiteDatabase db = mDataSource.getWritableDatabase(); //更新:根据uri分为collection和item两种情况 switch(sUriMatch.match(uri)){ case BOOK_COLLECTION_URI_INDICATOR: count = db.update(BookTableMetaData.TABLE_NAME, values, whereClause, whereArgs); break; case BOOK_ITEM_URI_INDICATION: count = db.update(BookTableMetaData.TABLE_NAME, values, BookTableMetaData._ID + "=" + uri.getPathSegments().get(1) + (!TextUtils.isEmpty(whereClause)? " AND (" + whereClause + ")" : ""), whereArgs); break; default: throw new IllegalArgumentException("Unknown Uri " + uri); } getContext().getContentResolver().notifyChange(uri,null); //通知该uri的数据发生变化 return count; } |
最后:在Manifest上注册BookProvider
<provider android:name=".BookProvider" android:authorities="cn.flowingflying.provider.BookProvider" /> |
相关链接: 我的Android开发相关文章
转自http://blog.csdn.net/flowingflying/article/details/9242995