ContentProvider和ContentResolver

ContentProvider:一个程序可以通过实现一个ContentProvider的抽象接口将自己的数据完全暴露出去,而且ContentProviders是以类似数据库中表的方式将数据暴露,也就是说ContentProvider就像一个“数据库”。那么外界获取其提供的数据,也就应该与从数据库中获取数据的操作基本一样,只不过是采用URI来表示外界需要访问的“数据库”。ContentProvider向外界提供数据操作的接口:

query(Uri, String[], String, String[], String)
insert(Uri, ContentValues)
update(Uri, ContentValues, String, String[])
delete(Uri, String, String[])

1.ContentProvider应该是Android在系统启动时就创建了,否则就谈不上数据共享了。这就要求在AndroidManifest.XML中使用<provider>元素明确定义。
2. 可能会有多个程序同时通过ContentResolver访问一个ContentProvider,会不会导致像数据库那样的“脏数据”?这个问题一方面需要数据库访问的同步,尤其是数据写入的同步,在AndroidManifest.XML中定义ContentProvider的时候,需要考虑是<provider>元素multiprocess属性的值;另外一方面Android在ContentResolver中提供了 notifyChange()接口,在数据改变时会通知其他ContentObserver,这个地方应该使用了观察者模式,在 ContentResolver中应该有一些类似register,unregister的接口。

一、什么是URI?

在学习如何获取ContentResolver前,有个名词是必须了解的:URI。URI是网络资源的定义,在Android中赋予其更广阔的含义,先看个例子,如下:
URI

将其分为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

二、UriMatcher:用于匹配Uri,它的用法如下: 

1.首先把你需要匹配Uri路径全部给注册上,如下:

UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);//常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码(-1)。

//如果match()方法匹配content://com.changcheng.sqlite.provider.contactprovider/contact路径,返回匹配码为1

uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact”, 1);//添加需要匹配uri,如果匹配就会返回匹配码

//如果match()方法匹配 content://com.changcheng.sqlite.provider.contactprovider/contact/230路径,返回匹配码为2

uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact/#”, 2);//#号为通配符

2.注册完需要匹配的Uri后,就可以使用uriMatcher.match(uri)方法对输入的Uri进行匹配,如果匹配就返回匹配码,匹配码是调用 addURI()方法传入的第三个参数,假设匹配 content://com.changcheng.sqlite.provider.contactprovider/contact路径,返回的匹配码为1。

 

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.

 

 创建一个ContentProvider

public class AlarmProvider extends ContentProvider {
private SQLiteOpenHelper mOpenHelper;

private static final int ALARMS = 1;
private static final int ALARMS_ID = 2;
private static final UriMatcher sURLMatcher = new UriMatcher(
UriMatcher.NO_MATCH);

static {
sURLMatcher.addURI("com.android.deskclock", "alarm", ALARMS);
sURLMatcher.addURI("com.android.deskclock", "alarm/#", ALARMS_ID);
}

private static class DatabaseHelper extends SQLiteOpenHelper {
private static final String DATABASE_NAME = "alarms.db";
private static final int DATABASE_VERSION = 5;

public DatabaseHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}

@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL("CREATE TABLE alarms (" +
"_id INTEGER PRIMARY KEY," +
"hour INTEGER, " +
"minutes INTEGER, " +
"daysofweek INTEGER, " +
"alarmtime INTEGER, " +
"enabled INTEGER, " +
"vibrate INTEGER, " +
"message TEXT, " +
"alert TEXT);");

// insert default alarms
String insertMe = "INSERT INTO alarms " +
"(hour, minutes, daysofweek, alarmtime, enabled, vibrate, message, alert) " +
"VALUES ";
db.execSQL(insertMe + "(8, 30, 31, 0, 0, 1, '', '');");
db.execSQL(insertMe + "(9, 00, 96, 0, 0, 1, '', '');");
}

@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int currentVersion) {
if (Log.LOGV) Log.v(
"Upgrading alarms database from version " +
oldVersion + " to " + currentVersion +
", which will destroy all old data");
db.execSQL("DROP TABLE IF EXISTS alarms");
onCreate(db);
}
}

public AlarmProvider() {
}

@Override
public boolean onCreate() {
mOpenHelper = new DatabaseHelper(getContext());
return true;
}

@Override
public Cursor query(Uri url, String[] projectionIn, String selection,
String[] selectionArgs, String sort) {
SQLiteQueryBuilder qb = new SQLiteQueryBuilder();

// Generate the body of the query
int match = sURLMatcher.match(url);
switch (match) {
case ALARMS:
qb.setTables("alarms");
break;
case ALARMS_ID:
qb.setTables("alarms");
qb.appendWhere("_id=");
qb.appendWhere(url.getPathSegments().get(1));
break;
default:
throw new IllegalArgumentException("Unknown URL " + url);
}

SQLiteDatabase db = mOpenHelper.getReadableDatabase();
Cursor ret = qb.query(db, projectionIn, selection, selectionArgs,
null, null, sort);

if (ret == null) {
if (Log.LOGV) Log.v("Alarms.query: failed");
} else {
ret.setNotificationUri(getContext().getContentResolver(), url);
}

return ret;
}

@Override
public String getType(Uri url) {
int match = sURLMatcher.match(url);
switch (match) {
case ALARMS:
return "vnd.android.cursor.dir/alarms";
case ALARMS_ID:
return "vnd.android.cursor.item/alarms";
default:
throw new IllegalArgumentException("Unknown URL");
}
}

@Override
public int update(Uri url, ContentValues values, String where, String[] whereArgs) {
int count;
long rowId = 0;
int match = sURLMatcher.match(url);
SQLiteDatabase db = mOpenHelper.getWritableDatabase();
switch (match) {
case ALARMS_ID: {
String segment = url.getPathSegments().get(1);
rowId = Long.parseLong(segment);
count = db.update("alarms", values, "_id=" + rowId, null);
break;
}
default: {
throw new UnsupportedOperationException(
"Cannot update URL: " + url);
}
}
if (Log.LOGV) Log.v("*** notifyChange() rowId: " + rowId + " url " + url);
getContext().getContentResolver().notifyChange(url, null);
return count;
}

@Override
public Uri insert(Uri url, ContentValues initialValues) {
if (sURLMatcher.match(url) != ALARMS) {
throw new IllegalArgumentException("Cannot insert into URL: " + url);
}

ContentValues values = new ContentValues(initialValues);

SQLiteDatabase db = mOpenHelper.getWritableDatabase();
long rowId = db.insert("alarms", Alarm.Columns.MESSAGE, values);
if (rowId < 0) {
throw new SQLException("Failed to insert row into " + url);
}
if (Log.LOGV) Log.v("Added alarm rowId = " + rowId);

Uri newUrl = ContentUris.withAppendedId(Alarm.Columns.CONTENT_URI, rowId);
getContext().getContentResolver().notifyChange(newUrl, null);
return newUrl;
}

public int delete(Uri url, String where, String[] whereArgs) {
SQLiteDatabase db = mOpenHelper.getWritableDatabase();
int count;
long rowId = 0;
switch (sURLMatcher.match(url)) {
case ALARMS:
count = db.delete("alarms", where, whereArgs);
break;
case ALARMS_ID:
String segment = url.getPathSegments().get(1);
rowId = Long.parseLong(segment);
if (TextUtils.isEmpty(where)) {
where = "_id=" + segment;
} else {
where = "_id=" + segment + " AND (" + where + ")";
}
count = db.delete("alarms", where, whereArgs);
break;
default:
throw new IllegalArgumentException("Cannot delete from URL: " + url);
}

getContext().getContentResolver().notifyChange(url, null);
return count;
}
}

 

posted @ 2012-07-25 17:27  罗小姿  阅读(517)  评论(0编辑  收藏  举报