惭愧,现在才接触到ContentResolver的用法
这个类主要是Android用来实现应用程序之间数据共享的
一个应用程序可以将自己的数据完全暴露出去,外界更本看不到,也不用看到这个应用程序暴露的数据是如何存储的,或者是使用数据库还是使用文件,还是通过网上获得,这些一切都不重要,重要的是外界可以通过这一套标准及统一的接口和这个程序里的数据打交道,例如:添加(insert)、删除(delete)、查询(query)、修改(update),当然需要一定的权限才可以。
一个程序可以通过实现一个Content provider的抽象接口将自己的数据完全暴露出去,而且Content providers是以类似数据库中表的方式将数据暴露。Content providers存储和检索数据,通过它可以让所有的应用程序访问到,这也是应用程序之间唯一共享数据的方法。
要想使应用程序的数据公开化,可通过2种 方法:
1)创建一个属于你自己的Content provider
2)将你的数据添加到一个已经存在的Content provider中,前提是有相同数据类型并且有写入Content provider的权限
什么是URI?
在学习如何获取ContentResolver前,有个名词是必须了解的:URI。URI是网络资源的定义,在Android中赋予其更广阔的含义,先看个例子,如下:
将其分为A,B,C,D 4个部分:
A:标准前缀,用来说明一个Content Provider控制这些数据,无法改变的;
B:URI的标识,它定义了是哪个Content Provider提供这些数据。对于第三方应用程序,为了保证URI标识的唯一性,它必须是一个完整的、小写的 类名。这个标识在<provider> 元素的 authorities属性中说明:
<provider name=”.TransportationProvider” authorities=”com.example.transportationprovider” . . . >
C:路径,Content Provider使用这些路径来确定当前需要生什么类型的数据,URI中可能不包括路径,也可能包括多个;
D:如果URI中包含,表示需要获取的记录的ID;如果没有ID,就表示返回全部;
由于URI通常比较长,而且有时候容易出错,切难以理解。所以,在Android当中定义了一些辅助类,并且定义了一些常量来代替这些长字符串,例如:People.CONTENT_URI
ContentResolver 介绍说明
看完这些介绍,大家一定就明白了,ContentResolver是通过URI来查询ContentProvider中提供的数据。除了URI以 外,还必须知道需要获取的数据段的名称,以及此数据段的数据类型。如果你需要获取一个特定的记录,你就必须知道当前记录的ID,也就是URI中D部分。
前面也提到了Content providers是以类似数据库中表的方式将数据暴露出去,那么ContentResolver也将采用类似数据库的操作来从Content providers中获取数据。现在简要介绍ContentResolver的主要接口,如下:
返回值 | 函数声明 |
final Uri | insert (Uri url, ContentValues values)Inserts a row into a table at the given URL. |
final int | delete (Uri url, String where, String[] selectionArgs)Deletes row(s) specified by a content URI. |
final Cursor | query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)Query the given URI, returning a Cursor over the result set. |
final int | update (Uri uri, ContentValues values, String where, String[] selectionArgs)Update row(s) in a content URI. |
可能还有2个问题,是需要关注的。
1. ContentProvider是什么时候创建的,是谁创建的?访问某个应用程序共享的数据,是否需要启动这个应用程序?这个问题在 Android SDK中没有明确说明,但是从数据共享的角度出发,ContentProvider应该是Android在系统启动时就创建了,否则就谈不上数据共享了。 这就要求在AndroidManifest.XML中使用<provider>元素明确定义。
2. 可能会有多个程序同时通过ContentResolver访问一个ContentProvider,会不会导致像数据库那样的“脏数据”?这个问题一方面需要数据库访问的同步 , 尤其是数据写入的同步,在AndroidManifest.XML中定义ContentProvider的时候,需要考虑 是<provider>元素multiprocess属性的值;另外一方面Android在ContentResolver中提供了 notifyChange()接口,在数据改变时会通知其他ContentObserver,这个地方应该使用了观察者模式,在 ContentResolver中应该有一些类似register,unregister的接口。
接触Android有一段时间了,每一个知识点都有涉及,现在觉得重新把知识点理一遍很重要,那么就凭感觉、凭喜好无知识点先后顺序来理清一遍。这篇文章主要叙述了如何来自定义自己的ContentProvider组件,其中涉及到的一些比较重要的知识点也顺带详细分解一下,那么现在就开始吧。
一、SQLiteOpenHelper简介:
SQLiteOpenHelper是Android给我们提供的一个工具,用来和数据库交互的。我们通常使用的方法是自定义一个类来继承于SQLiteOpenHelper,通过它可以得到一个SQLiteDatabase的实例,通过使用此对象的一些方法来与数据库交互。
例如:
execSQL(Stringsql).传入一个字符串形式的sql语句来执行等。
insert(String table, String nullColumnHack, ContentValues values)。插入操作,table是表名,values是ContentValues类型用来携带数据的,第二个参数是为了防止values为空时后台创建SQL语句出错。具体的其他方法参考API文档,此处就不做解释。
二、ContentProvider简介:
假如你的应用程序想把一些数据提供给其他的应用程序来使用,那么此时就会用到ContentProvider,有了它你的应用程序就可以在进程间共享数据。使用的时候需要创建一个类来继承ContentProvider,实现里面的方法,这就相当于此应用给其他应用程序提供访问数据的接口。说直观点,Contentprovider就相当于一个中介人,它介于第一个应用程序的数据层和另一应用程序之间。使用了Contentprovider最重要的作用是统一了共享数据时访问数据的方式。
三、ContentResolver简介:
当外部应用程序想对ContentProvider中数据进行操作时可以使用ContentResolver来完成,要获取它的对象可以使用Activity中的getContentResolver方法来完成。
四、Uri简介:
介绍之前默认为大家都了解URL,那么URL就相当于Uri的一个子集。Uri由三部分组成:scheme、authority、path。下面举一个例子来具体介绍。
Uri: content://com.jm.provider.myprovider/peoples
1 scheme部分:以content://开头,是Android系统定义的,不可更改。
2 authority部分:推荐以域名+provider+类名组成,也可自己定义。
3 path部分:用来表示我们要操作的数据。具体说明如下:
要操作peoples中所有数据可以构建 /peoples
要操作peoples中_id为1的数据可以构建/peoples/1
Uri有两个比较常用方法
1 parse(String uriString)它的作用是将字符型数据转换成Uri类型数据。
2 withAppendedPath(Uri baseUri,String pathSegment)它的作用是将baseUri后面加上pathSegment组成新的Uri。
五、UriMatcher简介:
作用是在ContentProvider中把需要匹配的Uri全部注册上。
UriMatcher.NO_MATCHER表示不匹配任何路径,返回码为-1.
UriMatcher有两个常用方法。
1 match(Uri uri)获取路径的返回码。
2 addURI(String authority, Stringpath, int code)是用来注册需要匹配的路径。具体实例参看下文。
API中推荐把它放在静态块中完成,例如:
- private static final UriMatcher mather = new UriMatcher(UriMatcher.NO_MATCH);
- static {
- mather.addURI(CONTENT_URI.getAuthority(), "peoples", PEOPLE);
- mather.addURI(CONTENT_URI.getAuthority(), "peoples/#", PEOPLE_ID);
- }
其中要解释的一点是#代表通配符,表示所有数字(will match any number)。*代表所有字符(will match any text)。
六、ContentUris简介:
ContentUris是用来获取uri后面id部分,它有两个比较实用的方法:
1 parseId(Uri contentUri)用来获得contentUri中id部分
2 withAppendedId(Uri contentUri,long id)用来给contentUri添加id组成新的Uri,功能和Uri的withAppendedPath(Uri baseUri,String pathSegment)方法类似。
七、ContentProvider中getType方法中MIME类型讲解:
vnd.android.cursor.dir代表值的集合
vnd.android.cursor.item代表一项值
最好不要默认返回null
结构分析,例如:"vnd.android.cursor.dir/peoplelist" 斜杠前部分可把它比作变量的类型是不能随便定义的,后部分相当于变量名,可自己定义。
当调用增删改查方法时系统会通过getType()进行验证,如果有值并且是系统可识别的类型,那么处理起来比较快。
八、代码示例:
1、继承SQLiteOpenHelper
- package com.jm.my.provider;
- import android.content.ContentValues;
- import android.content.Context;
- import android.database.sqlite.SQLiteDatabase;
- import android.database.sqlite.SQLiteOpenHelper;
- /**
- * 继承于SQLiteOpenHelper,用于和数据库交互
- * @author jinmeng
- * @date 2012-7-25
- * @version 1.0
- */
- public class MyHelper extends SQLiteOpenHelper {
- //数据库名字,可在文件目录下找到
- private static final String DATABASE_NAME = "mydb";
- //数据库版本号
- private static final int MYDATABASE_VERSION = 1;
- //数据库表名
- public static final String TABLE_NAME = "peoples";
- //数据库的一些基本字段
- public static final String COL_NAME = "name";
- public static final String COL_AGE = "age";
- public static final String COL_BIRTHDAY = "birthday";
- //创建数据库时的SQL语句
- public static final String CREATEDATABASE = "CREATE TABLE " + TABLE_NAME
- + " (_id INTEGER PRIMARY KEYAUTOINCREMENT, " + COL_NAME
- + " TEXT, " + COL_AGE + " INTEGER, " + COL_BIRTHDAY + " DATE);";
- public MyHelper(Context context) {
- super(context, DATABASE_NAME, null, MYDATABASE_VERSION);
- }
- /**
- * 当数据库被创建的时候执行SQL语句
- */
- @Override
- public void onCreate(SQLiteDatabase db) {
- db.execSQL(CREATEDATABASE);
- ContentValues cv = new ContentValues();
- cv.put(COL_NAME, "jinmeng");
- cv.put(COL_AGE, 22);
- String str = new String("1990-03-09");
- cv.put(COL_BIRTHDAY, str);
- db.insert(TABLE_NAME, null, cv);
- }
- /**
- * 当数据库版本号更新的时候回调此方法。
- */
- @Override
- public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
- db.execSQL("DROP TABLE IF EXIST" + TABLE_NAME);
- onCreate(db);
- }
- }
2、为示例添加ContentProvider类:
- package com.jm.my.provider;
- 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;
- /**
- * 继承于ContentProvider,提供外接访问接口
- *
- * @author jinmeng
- * @date 2012-7-25
- * @version 1.0
- */
- public class MyProvider extends ContentProvider {
- // 和Authority相关
- public static final Uri CONTENT_URI = Uri
- .parse("content://com.jm.provider.myprovider/peoples");
- // 数据库表名
- private static final String TABLE_NAME = "peoples";
- // 注册和解析路径时的返回码
- private static final int PEOPLE = 1;
- private static final int PEOPLE_ID = 2;
- // 注册需要的路径
- private static final UriMatcher mather = new UriMatcher(UriMatcher.NO_MATCH);
- static {
- mather.addURI(CONTENT_URI.getAuthority(), "peoples", PEOPLE);
- mather.addURI(CONTENT_URI.getAuthority(), "peoples/#", PEOPLE_ID);
- }
- private MyHelper helper;
- /**
- * 基本表结构
- *
- * @author jinmeng
- *
- */
- public static final class Mydata {
- public static final String COL_ID = "_id";
- public static final String COL_NAME = "name";
- public static final String COL_AGE = "age";
- public static final String COL_BIRTHDAY = "birthday";
- }
- @Override
- public boolean onCreate() {
- this.helper = new MyHelper(this.getContext());
- if (helper != null) {
- return true;
- } else {
- return false;
- }
- }
- /**
- * 启动时涉及到的MIME类型值: vnd.android.cursor.dir代表值的集合 vnd.android.cursor.item代表一项值
- * 最好不要默认返回空
- */
- @Override
- public String getType(Uri uri) {
- switch (mather.match(uri)) {
- case PEOPLE:
- return "vnd.android.cursor.dir/peoplelist";
- case PEOPLE_ID:
- return "vnd.android.cursor.item/peopleitem";
- default:
- throw new IllegalArgumentException("uri Illegal" + uri);
- }
- }
- /**
- * 具体的查询方法
- */
- @Override
- public Cursor query(Uri uri, String[] projection, String selection,
- String[] selectionArgs, String sortOrder) {
- SQLiteDatabase db = helper.getWritableDatabase();
- switch (mather.match(uri)) {
- case PEOPLE:
- return db.query(TABLE_NAME, projection, selection, selectionArgs,
- null, null, sortOrder);
- case PEOPLE_ID:
- long id = ContentUris.parseId(uri);
- String where = "_id=" + id;
- if ((selection != null) && (!"".equals(selection))) {
- where = where + " and " + selection;
- }
- return db.query(TABLE_NAME, projection, where, selectionArgs, null,
- null, sortOrder);
- default:
- throw new IllegalArgumentException("uri Illegal" + uri);
- }
- }
- /**
- * 具体的插入方法
- */
- @Override
- public Uri insert(Uri uri, ContentValues values) {
- SQLiteDatabase db = helper.getWritableDatabase();
- long id;
- switch (mather.match(uri)) {
- case PEOPLE:
- id = db.insert(TABLE_NAME, "_id", values);
- return ContentUris.withAppendedId(uri, id);
- case PEOPLE_ID:
- id = db.insert(TABLE_NAME, "_id", values);
- String uriPath = uri.toString();
- String path = uriPath.substring(0, uriPath.lastIndexOf("/")) + id;
- return Uri.parse(path);
- default:
- throw new IllegalArgumentException("uri Illegal" + uri);
- }
- }
- /**
- * 具体的删除方法
- */
- @Override
- public int delete(Uri uri, String selection, String[] selectionArgs) {
- SQLiteDatabase db = helper.getWritableDatabase();
- switch (mather.match(uri)) {
- case PEOPLE:
- return db.delete(TABLE_NAME, selection, selectionArgs);
- case PEOPLE_ID:
- long id = ContentUris.parseId(uri);
- String where = "_id=" + id;
- if ((selection != null) && (!"".equals(selection))) {
- where = where + " and " + selection;
- }
- return db.delete(TABLE_NAME, where, selectionArgs);
- default:
- throw new IllegalArgumentException("uri Illegal" + uri);
- }
- }
- /**
- * 具体的更新方法
- */
- @Override
- public int update(Uri uri, ContentValues values, String selection,
- String[] selectionArgs) {
- SQLiteDatabase db = helper.getWritableDatabase();
- switch (mather.match(uri)) {
- case PEOPLE:
- return db.update(TABLE_NAME, values, selection, selectionArgs);
- case PEOPLE_ID:
- long id = ContentUris.parseId(uri);
- String where = "_id=" + id;
- if ((selection != null) && (!"".equals(selection))) {
- where = where + " and " + selection;
- }
- return db.update(TABLE_NAME, values, where, selectionArgs);
- default:
- throw new IllegalArgumentException("uri Illegal" + uri);
- }
- }
- }
3、添加contentProvider配置:
此处定义的
- android:authorities
和代码中CONTENT_URI保持一致
- <providerandroid:name=".MyProvider"
- android:authorities="com.jm.provider.myprovider"/>
4、测试ContentProvider的示例程序:
ContentProvider是给其他应用程序提供数据的接口,那么测试工程新建,以下只给出insert的测试。
- package com.jm.test;
- import android.app.Activity;
- import android.content.ContentResolver;
- import android.database.Cursor;
- import android.net.Uri;
- import android.os.Bundle;
- import android.util.Log;
- /**
- * 用来测试ContentProvider
- * @author jinmeng
- * @date 2012-7-25
- * @version 1.0
- */
- public class MainActivity extends Activity {
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- //获取ContentResolver实例
- ContentResolver contentResolver = MainActivity.this
- .getContentResolver();
- //访问数据的Uri地址
- Uri uri = Uri.parse("content://com.jm.provider.myprovider/peoples");
- //通过ContentResolver来获取Cursor
- Cursor cursor = contentResolver.query(uri, new String[] { "_id",
- "name", "age" }, null, null, "_id desc");
- //遍例输出结果
- while (cursor.moveToNext()) {
- Log.i("jm",
- "_id=" + cursor.getInt(0) + ",name=" + cursor.getString(1)
- + ",age=" + cursor.getString(2));
- }
- }
- }