Android应用程序可以使用文件或SqlLite数据库来存储数据。Content Provider提供了一种在多个应用程序之间数据共享的方式(跨进程共享数据)。
虽然Content Provider也可以在同一个应用程序中被访问,但这么做并没有什么意义。Content Provider存在的目的向其他应用程序共享数据和允许其他应用程序对数据进行增、删、改、查操作。
Android系统本身提供了很多Content Provider,例如,音频、视频、联系人信息等等。我们可以通过这些Content Provider获得相关信息的列表。这些列表数据将以Cursor对象返回。因此,从Content Provider返回的数据是二维表的形式。
对于访问Content Provider的程序,需要使用ContentResolver对象。
ContentResolver cr = getContentResolver();
与Activity一样,Content Provider也需要与一个URI对应。每一个Content Provider可以控制多个数据集,在这种情况下,每一个数据集会对应一个单独的URI。所有的URI必须以“content://”开头。 为了程序更容易维护,也为了简化程序代码,一般将URI定义成一个常量。例如,下面的常量表示系统的联系人电话号码。
android.provider.Contacts.Phones.CONTENT_URI
下面来看一下Content Provider的具体步骤:
- 编写一个继承于android.content.ContentProvider的子类。该类是ContentProvider的核心类,在该类中会实现 query、insert、update及delete方法。
- 在AndroidManifest.xml文件中配置ContentProvider。要想唯一确定一个ContentProvider,需要指定这个 ContentProvider的URI,除此之外,还需要指定URI所对应的ContentProvider类。 先看一下如图5所示的URI。
下面对图5所示的URI的4个部分做一下解释。
A:Content Provider URI的固定前缀,也就是说,所有的URI必须以content://开头。
B:URI中最重要的部分。该部分是Content Provider的唯一标识。对于第三方应用程序来说,该部分最后使用完整的类名(包名+类名),以确保URI的唯一性。该部分需要在 AndroidManifest.xml文件中<provider>标签中定义,代码如下:
<provider name=".TransportationProvider" authorities="com.example.transportationprovider"
. . . >
C:这部分是URI的路径(path)。表示URI中各种被请求的数据。这部分是可选的, 如果Content Provider仅仅提供一种请求的数据,那么这部分可以省略。如果Content Provider要提供多种请求数据。就需要添加多个路径,甚至是子路径。例如,“land/bus”、“land/train”、“sea/ship” 就指定了3种可能提供的数据。
D:这部分也是可选的。如果要传递一个值给Content Provider,可以通过这部分传递。当然,如果不需要传值,这部分也可以省略,省略后的URI如下所示:
content://com.example.transportationprovider/trains
本例利用了《基于 android SDK1.5的英文电子词典的实现》一文中实现的电子词典程序。通过ContentProvider,将电子词典的查词功能共享成Cursor对象。这样 其他的应用程序就可以通过ContentProvider来查词英文单词了。
... ...
public class DictionaryContentProvider extends ContentProvider
{
private static UriMatcher uriMatcher;
private static final String AUTHORITY = "net.blogjava.mobile.dictionarycontentprovider";
private static final int SINGLE_WORD = 1;
private static final int PREFIX_WORDS = 2;
public static final String DATABASE_PATH = android.os.Environment
.getExternalStorageDirectory().getAbsolutePath()
+ "/dictionary";
public static final String DATABASE_FILENAME = "dictionary.db";
private SQLiteDatabase database;
static
{
// 添加访问ContentProvider的Uri
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI(AUTHORITY, "single", SINGLE_WORD);
uriMatcher.addURI(AUTHORITY, "prefix/*", PREFIX_WORDS);
}
// 该方法在Activity的onCreate方法之前调用
@Override
public boolean onCreate()
{
database = openDatabase();
return true;
}
// 在本例中只实现了query方法,其他的方法(insert、update和delete)与query方法的实现
// 类似
@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder)
{
Cursor cursor = null;
switch (uriMatcher.match(uri))
{
case SINGLE_WORD:
// 查找指定的单词
cursor = database.query("t_words", projection, selection,
selectionArgs, null, null, sortOrder);
break;
case PREFIX_WORDS:
String word = uri.getPathSegments().get(1);
// 查找以指定字符串开头的单词集合
cursor = database
.rawQuery(
"select english as _id, chinese from t_words where english like ?",
new String[]
{ word + "%" });
break;
default:
throw new IllegalArgumentException("<" + uri + ">格式不正确.");
}
return cursor;
}
... ...
}
关于DictionaryContentProvider类的代码需要做如下的解释。
- 在DictionaryContentProvider类的开头定义的AUTHORITY是访问ContentProvider的URI的前半部分。
- 访问ContentProvider的URI的后半部分由uriMatcher.addURI(...)方法指定。该方法的第1个参数就是 AUTHORITY(Uri的前半部分),第2个参数是Uri的后半部分,第3个参数是与第2个参数值对应的代码。当其他的应用程序通过Uri访问 ContentProvider时。系统解析Uri后,将addURI方法的第2个参数值转换成与之对应的代码(第3个参数值)。
- addURI的第2个参数值可以使用通配符。例如,prefix/中的表示所有字符。prefix/abc、prefix/xxx都会匹配成功。
- 访问ContentProvider的URI是addURI的第1个和第2个参数值的组件,例如,按着DictionaryContentProvider中设置的两个URI,可以分别匹配下面的两个URI
content://net.blogjava.mobile.dictionarycontentprovider/single
content://net.blogjava.mobile.dictionarycontentprovider/prefix/wo
要注意的是,访问ContentProvider的URI必须以“content://”开头。
下面在AndroidManifest.xml文件中配置DictionaryContentProvider类。
<provider android:name="DictionaryContentProvider"
android:authorities="net.blogjava.mobile.dictionarycontentprovider" />
现在来看看应用程序如何调用ContentProvider。
调用ContentProvider的关键是使用 getContentResolver方法来获得一个ContentResolver对象,并通过ContentResolver对象的query方法来 访问ContentProvider。
首先来定义两个访问ContentProvider的常量。
public final String DICTIONARY_SINGLE_WORD_URI = "content://net.blogjava.mobile.dictionarycontentprovider/single";
public final String DICTIONARY_PREFIX_WORD_URI = "content://net.blogjava.mobile.dictionarycontentprovider/prefix";
然后在查询按钮的单击事件中编写如下的代码来查询单词。
public void onClick(View view)
{
Uri uri = Uri.parse(DICTIONARY_SINGLE_WORD_URI);
// 通过ContentProvider查询单词,并返回Cursor对象,然后的操作就和直接从数据中获得
// Cursor对象后的操作是一样的了
Cursor cursor = getContentResolver().query(uri, null, "english=?",
new String[]{ actvWord.getText().toString() }, null);
String result = "未找到该单词.";
if (cursor.getCount() > 0)
{
cursor.moveToFirst();
result = cursor.getString(cursor.getColumnIndex("chinese"));
}
new AlertDialog.Builder(this).setTitle("查询结果").setMessage(result)
.setPositiveButton("关闭", null).show();
}
下面是显示单词列表的代码。
public void afterTextChanged(Editable s)
{
if ("".equals(s.toString()))
return;
Uri uri = Uri.parse(DICTIONARY_PREFIX_WORD_URI + "/" + s.toString());
// 从ContentProvider中获得以某个字符串开头的所有单词的Cursor对象
Cursor cursor = getContentResolver().query(uri, null, null, null, null);
DictionaryAdapter dictionaryAdapter = new DictionaryAdapter(this,
cursor, true);
actvWord.setAdapter(dictionaryAdapter);
}