本节书摘来自异步社区《Android开发进阶:从小工到专家》一书中的第1章,第1.4节ContentProvider(外共享数据),作者 何红辉,更多章节内容可以访问云栖社区“异步社区”公众号查看
1.4 ContentProvider(外共享数据)
ContentProvider在android中的作用是对外共享数据,也就是说可以通过ContentProvider把应用中的数据共享给其他应用访问,其他应用可以通过ContentProvider对应用中的数据进行添、删、改、查。使用ContentProvider对外共享数据的好处是,统一了数据的访问方式,它实际上是对SQliteOpenHelper的进一步封装,通过Uri映射来判断选择需要操作数据库中的哪个表,并且进行增、删、改、查处理。
首先我们先来学习Uri,Uri代表了要操作的数据表的绝对路径,Uri主要包含了两部分信息,一是需要操作的ContentProvider,二是对ContentProvider中的哪个表进行操作。对于ContentProvider来说,一个Uri由以下几部分组成,如图1-18所示。
ContentProvider的scheme已经由Android固定设置为content://,Authority用于唯一标识这个ContentProvider,外部调用者可以根据这个标识来找到它。这里的path就是要操作的数据库表,最后的id关键字是可选字段,例如,我们要操作特定的数据项时就会指定一个查询条件,如所有联系人的Uri:content://contacts/people,某个联系人的Uri: content://contacts/people/5,这个5就是联系人的id,也就对应了这里的查询关键字。
如果要把一个字符串转换成Uri,可以使用Uri类中的parse()函数,如下:
Uri uri = Uri.parse("content://contacts /people");
Android系统根据Uri来定位注册到系统的ContentProvider中,找到ContentProvider之后会通过ContentResolver来操作对应的数据库。实现ContentProvider的第一步就是需要覆写ContentProvider的insert、query、upate、delete、getType函数。下面我们要创建一个ContentProvider,该ContentProvider存储了一些服务行业人员的电话信息,如一些系统中就存储了快递人员、肯德基订餐电话等信息。我们要做的就是实现类似的功能,首先定义一个ContentProvider,代码如下:
public class UserInfoProvider extends ContentProvider {
private static final String CONTENT = "content://";
public static final String AUTHORIY = "com.book.jtm.info";
/**
* 该ContentProvider所返回的数据类型定义、数据集合
*/
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd." + AUTHORIY;
/**
* 单项数据
*/
public static final String CONTENT_TYPE_ITEM = "vnd.android.cursor.item/vnd." + AUTHORIY;
/**
* 数据集合操作时的Uri
*/
public static final Uri POSTCODE_URI = Uri.parse(CONTENT + AUTHORIY + "/" +
UserInfoDbHelper.TABLE_USER_INFO);
/**
* 数据集合操作时的Uri
*/
public static final Uri COMPANY_URI = Uri.parse(CONTENT + AUTHORIY + "/" +
UserInfoDbHelper.TABLE_COMPANY);
private SQLiteDatabase mDatabase;
static final int USER_INFOS = 1;
static final int USER_INFO_ITEM = 2;
static final int COMPANY = 3;
static final int COMPANY_ITEM = 4;
static UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
static {
uriMatcher.addURI(AUTHORIY, "userinfo", USER_INFOS);
uriMatcher.addURI(AUTHORIY, "userinfo/*", USER_INFO_ITEM);
uriMatcher.addURI(AUTHORIY, "company", COMPANY);
uriMatcher.addURI(AUTHORIY, "company/#",COMPANY_ITEM);
}
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case USER_INFOS:
case COMPANY:
return CONTENT_TYPE;
case USER_INFO_ITEM:
case COMPANY_ITEM:
return CONTENT_TYPE_ITEM;
default:
throw new RuntimeException("错误的Uri");
}
}
// 删除、更新的代码省略
}
我们需要在ContentProvider中根据Uri建立关系映射,通过UriMatcher管理不同Uri对应的Type类型,这个类型会在getType中被返回。当在ContentProvider中进行增、删、改、查操作时,就会根据这个类型选择对应的数据表。在这个例子中,我们通过UriMatcher映射了4种Uri类型, Uri 的格式主要有两种,以表名结尾就表示期望访问该表中所有的数据,以id结尾就表示期望访问该表中拥有相应 id 的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容Uri,“*”表示匹配任意长度的任意字符,“#”表示匹配任意长度的数字。因此,content://com.book.jtm.info /userinfo表示要查询userinfo表中的所有数据,而content://com.book.jtm.info /userinfo/#表示要根据一个数字id查询一个用户。
下面我们就完成数据库操作的相关代码:
@Override
public boolean onCreate() {
mDatabase = new UserInfoDbHelper(getContext()).getWritableDatabase();
return true;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
long newId = 0 ;
Uri newUri = null;
switch (uriMatcher.match(uri)) {
case USER_INFOS:
newId = mDatabase.insert(UserInfoDbHelper.TABLE_USER_INFO, null, values);
newUri = Uri.parse(CONTENT + AUTHORIY + "/"
+ UserInfoDbHelper.TABLE_USER_INFO + "/" + newId);
break;
case COMPANY:
newId = mDatabase.insert(UserInfoDbHelper.TABLE_COMPANY, null, values);
newUri = Uri.parse(CONTENT + AUTHORIY + "/"
+ UserInfoDbHelper.TABLE_COMPANY + "/" + newId);
break;
}
if (newId > 0) {
return newUri;
}
throw new IllegalArgumentException("Failed to insert row into" + uri);
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[]
selectionArgs, String sortOrder) {
Cursor cursor = null;
switch (uriMatcher.match(uri)) {
case USER_INFOS:
cursor = mDatabase.query(UserInfoDbHelper.TABLE_USER_INFO, projection,
selection, selectionArgs, null, null, sortOrder);
break;
case USER_INFO_ITEM:
String tel = uri.getPathSegments().get(1);
cursor = mDatabase.query(UserInfoDbHelper.TABLE_USER_INFO, projection,
"tel_num = ?", new String[]{tel}, null, null, sortOrder);
break;
case COMPANY:
cursor = mDatabase.query(UserInfoDbHelper.TABLE_COMPANY, projection,
selection, selectionArgs, null, null, sortOrder);
break;
case COMPANY_ITEM:
String cid = uri.getPathSegments().get(1);
cursor = mDatabase.query(UserInfoDbHelper.TABLE_COMPANY, projection,
"id = ?", new String[]{cid}, null, null, sortOrder);
break;
}
return cursor;
}
// 删除、更新的代码省略
上述代码中,我们把传递进来的Uri通过UriMatcher进行解析,得到type之后,再根据type来判断要操作哪个表,根据它的数据类型是所有数据还是单个数据,然后执行对应的数据库操作。对数据库的操作通过UserInfoDbHelper类实现。代码如下:
public class UserInfoDbHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "userinfo.db";
private static final int DB_VERSION = 1;
public static final String TABLE_USER_INFO = "userinfo";
public static final String TABLE_COMPANY = "company";
public static final String TEL_COLUMN = "tel_num";
public static final String DESC_COLUMN = "desc";
public static final String COMP_ID_COLUMN = "comp_id";
public static final String ID_COLUMN = "id";
public static final String BUSINESS_COLUMN = "business";
public static final String ADDR_COLUMN = "addr";
private static final String POSTCODE_TABLE_SQL = "CREATE TABLE " + TABLE_USER_INFO + " ("
+ TEL_COLUMN + " TEXT ,"
+ COMP_ID_COLUMN + " TEXT , "
+ DESC_COLUMN + " TEXT "
+ ")";
private static final String COMPANY_TABLE_SQL = "CREATE TABLE " + TABLE_COMPANY + " ("
+ ID_COLUMN + " TEXT PRIMARY KEY , "
+ BUSINESS_COLUMN + " TEXT , "
+ ADDR_COLUMN + " TEXT"
+ ")";
public UserInfoDbHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
}
@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL(POSTCODE_TABLE_SQL);
db.execSQL(COMPANY_TABLE_SQL);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
}
在UserInfoDbHelper中我们建立了两个表,分别为userinfo和company,表结构表1-2和表1-3所示。
完成ContentProvider代码之后,第二步需要在AndroidManifest.xml中使用对该ContentProvider进行配置,为了能让其他应用找到该ContentProvider ,ContentProvider采用了authorities对它进行唯一标识,示例如下:
<providerandroid:name=".provider.UserInfoProvider"
android:authorities="com.book.jtm.info" />
此时,我们就可以使用该ContentProvider了。
我们新建一个ProviderActivity,在该Activity中存储、查询用户信息,代码如下所示:
public class ProviderActivity extends Activity {
EditText mUserDescEdittext; // 用户描述信息
EditText mUserTelEdittext; // 电话号码
EditText mUserCompIdEdittext ; // 用户所属的公司id
Button mSubmitBtn; // 提交按钮
EditText mCompIdEdittext; // 公司id
EditText mCompBusinessEdittext; // 公司业务
EditText mCompAddrEdittext; // 公司地址
Button mCompSubmitBtn; // 提交按钮
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_provider);
initWidgets();
}
private void initWidgets() {
// 用户信息相关的View
mUserDescEdittext = (EditText) findViewById(R.id.desc_edit);
mUserTelEdittext = (EditText) findViewById(R.id.tel_edit);
mUserCompIdEdittext = (EditText) findViewById(R.id.comp_edit);
mSubmitBtn = (Button) findViewById(R.id.submit_btn);
mSubmitBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
saveUserInfoRecord();
mSubmitBtn.postDelayed(new Runnable() {
@Override
public void run() {
queryPostCode();
}
}, 1000) ;
}
});
// 公司信息相关的View
mCompAddrEdittext = (EditText) findViewById(R.id.comp_addr_edit);
mCompIdEdittext = (EditText) findViewById(R.id.comp_id_edit);
mCompBusinessEdittext = (EditText) findViewById(R.id.comp_business_edit);
mCompSubmitBtn = (Button) findViewById(R.id.submit_comp_btn);
mCompSubmitBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
saveCompanyRecord();
}
});
}
/**
* 存储用户信息到ContentProvider
*/
private void saveUserInfoRecord() {
ContentValues newRecord = new ContentValues();
newRecord.put(UserInfoDbHelper.DESC_COLUMN,
mUserDescEdittext.getText().toString());
newRecord.put(UserInfoDbHelper.TEL_COLUMN,
mUserTelEdittext.getText().toString());
newRecord.put(UserInfoDbHelper.COMP_ID_COLUMN,
mCompIdEdittext.getText().toString());
getContentResolver().insert(UserInfoProvider.USERINFO_URI, newRecord);
}
/**
* 存储公司信息到ContentProvider中
*/
private void saveCompanyRecord() {
ContentValues newRecord = new ContentValues();
newRecord.put(UserInfoDbHelper.ADDR_COLUMN,
mCompAddrEdittext.getText().toString());
newRecord.put(UserInfoDbHelper.BUSINESS_COLUMN,
mCompBusinessEdittext.getText().toString());
newRecord.put(UserInfoDbHelper.ID_COLUMN, mCompIdEdittext.getText().toString());
getContentResolver().insert(UserInfoProvider.COMPANY_URI, newRecord);
}
/**
* 通过电话号码查询相关信息
*/
private void queryPostCode() {
Uri queryUri = Uri.parse("content://com.book.jtm.info/userinfo/123456");
Cursor cursor = getContentResolver().query(queryUri, null, null, null, null);
if (cursor.moveToFirst()) {
Toast.makeText(this, "电话来自 : "
+ cursor.getString(2), Toast.LENGTH_SHORT).show();
}
}
}
上述Activity中我们可以将用户信息和公司信息根据不同的Uri插入到同一个ContentProvider中,UserInfoProvider会根据Uri选择对应的表进行插入,查询也是同样的道理。首先我们插入一条用户数据,该用户的电话为123456,描述为顺风快递员吴老二,公司id为11,插入之后我们可通过电话号码123456到ContentProvider中查询该用户的信息,此时就会得到该用户的描述信息,如图1-19所示。
然后我们再插入该公司的信息,此时该ConentProvider的数据库中就有了数据,我们将数据库导出到PC中,结果如图1-20和图1-21所示。
正如本章前文所说,ContentProvider不过是对SQLiteOpenHelper的二次封装,通过UriMatcher将数据库中的表与Uri建立关联,当用户通过Uri操作ContentProvider时,ContentProvider会根据Uri选择对应的数据库表进行增、删、改、查操作。通过ContentProvider机制,使得数据可以在各应用之间共享,并且为用户提供了统一的API接口,降低了用户的使用成本。