内容提供器
内容提供器(Content Provider)主要用于在不同程序之间实现数据共享的功能,它提供一套完整的机制,允许一个程序访问另一个程序中的数据,并保证被访问数据的安全性。内容提供器可以选择对哪一部分数据进行共享,从而保证程序中的隐私不会泄露。
内容提供器的增删查改操作(CRUD)
ContentResolver的增删查改方法都是不接收表名参数的,而是使用一个Uri参数代替,这个参数被称为内容URI。内容URI给内容提供器中的数据建立了唯一标识符,由authority与path组成,authority是用于对不同的应用程序做区分的,一般采用程序包名的方式来命名,比如某个程序的包名为com.example.app,那么该程序对应的authority就是com.example.app.provider,path是用于对同一应用程序中不同表做区分,通常会添加到authority后面,加入某个程序中存有两张表table1,table2,则该程序path为/table1,/table2,内容URI加上协议声明之后的标准格式如下:
content://com.example.app.provider/table1;
content://com.example.app.provider/table2;
内容URI字符串需要解析为Uri对象才能作为参数传入
Uri uri = Uri.parse("content://com.example.app.provider/table1");
- 查询语句
//uri:指定查询某个应用程序下的某一张表
//projection:指定查询的列名
//selection:指定where的约束条件
//selectionArgs:为where中的占位符提供具体的值
//sortOrder: 指定查询结果的排序方式
Cursor cursor = getContentResolver().query(uri,projection,selection,selecetionArgs,sortOrder)
查询语句返回Cursor对象,取值操作与SQLite中相同
if(cursor!=null){
while(cursor.moveToNext){
String xxx = cursor.getString(cursor.getColumnIndex("XXX"));
int xxx = cursor.getInt(cursor.getColumnIndex("XXX"));
}
cursor.close();
}
- 插入语句
ContentValues values = new ContentValues();
values.put("column1","text");
values.put("column2","1");
getContentResolver().insert(uri,values);
- 删除语句
getContentResolver().delete(uri,selection,selectionArgs);
例:getContentResolver().delete(uri,"column1 = ?","new String[]{ "1" }");
- 更新语句
getContentResolver().update(uri,values,selection,selectionArgs);
例:
ContentValues values = new ContentValues();
values.put("column1","");
getContentResolver().update(uri,values,"where column1 = ? and column2 = ?",new String[]{"text","1"});
访问其他程序中的数据
访问系统联系人
- 在AVD中创建联系人
- 使用ListView来展示联系人信息
- 活动中判断是否获取访问系统联系人的权限
- 若已获取,则访问联系人
- 否则,动态申请权限,处理结果
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); contact_list = findViewById(R.id.contact_list); adapter = new ArrayAdapter<String >(this,android.R.layout.simple_list_item_1,contactList); contact_list.setAdapter(adapter); //是否已获取访问系统联系人的权限 if(ContextCompat.checkSelfPermission(MainActivity.this,Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED){ ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.READ_CONTACTS},1); }else{ //若已获取权限,访问联系人 readContacts(); } }
<uses-permission android:name="android.permission.READ_CONTACTS"/>
访问系统联系人封装为方法@Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); switch(requestCode){ case 1: if(grantResults.length>0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){ readContacts(); }else{ Toast.makeText(this,"you denied the permission",Toast.LENGTH_SHORT).show(); } break; default: } }
private void readContacts(){ Cursor cursor = null; try{ cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,null,null,null); if(cursor!=null){ while(cursor.moveToNext()){ String displayName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME)); String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER)); contactList.add(displayName + "\n" + number); } //调用此方法来刷新ListView列表 adapter.notifyDataSetChanged(); } }catch(Exception e){ e.printStackTrace(); }finally { if(cursor!=null){ cursor.close(); } } }
上述查询方法中第一个参数的由来:ContactsContract.CommonDataKinds.Phone类帮我们做好封装,提供一个CONTENT_URI常量,实际为通过Uri.parse()方法解析出来的
ContactsContract.CommonDataKinds.Phone.CONTENT_URI
系统联系人姓名常量
ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME
系统联系人电话常量
ContactsContract.CommonDataKinds.Phone.NUMBER
创建自己的内容提供器
- 创建一个类去继承ContentProvider类
- 实现六个抽象方法
@override
public boolean onCreate(){
return false;
}
@override
public Cursor query(Uri uri,String []projection,String selection,String []selectionArgs,String sortOrder){
return null;
}
@override
public Uri insert(Uri uri,ContentValues values){
return null;
}
@override
public int update(Uri uri,ContentValues values,String selection,String[] selectionArgs){
return 0;
}
@override
public int delete(Uri uri,String selection,String[] selectionArgs){
return 0;
}
@override
public String getTyoe(Uri uri){
return null;
}
- onCreate():初始化的时候调用,通常在这里完成对数据库的创建和升级
- query():查询内容提供器中已有的数据,返回Cursor对象
- update():更新内容提供器中已有的数据,受影响的行数作为返回值
- delete():从内容提供器中删除数据,被删除的行数作为返回值
- getType():根据传入的URI来返回相应的MIME类型
内容URI的MIME类型- 必须以vnd开头
- 如果内容URI以路径结尾,则后接android.cursor.dir/,如果以id结尾,则后接上android.cursor.item/
- 最后接上vnd.< authority > . < path >
例如:conten://com.example.app.provider/table1的MIME类型为:
content://com.example.app.provider/table1/1的MIME类型为:vnd.android.cursor.dir/vnd.com.example.app.provider.table1
vnd.android.cursor.item/vnd.com.example.app.provider.table1
分析Uri参数指向的表和数据
几乎每一个方法都带有Uri这个参数,现在我们对Uri参数进行解析,分析出调用方期望访问的表和数据。
标准Uri参数的写法是:
content://com.example.app.priovider/table1
这里表示调用方期望访问的是com.example.app这个应用的table1表中的数据。我们还可以在这个内容Uri后加上一个id,如:
content://com.example.app/table1/1
这里表示调用方期望访问的是com.example.app这个应用的table1表中id为1的数据。
内容Uri格式有以上两种,以路径结尾表示期望访问该表中所有的数据,以id结尾表示期望访问该表中相应id的数据。因此我们可以使用通配符的方式来分别匹配这两种格式的内容URI。
*:表示匹配任意长度的字符串
#:表示匹配任意长度的数据
一个能够匹配任意表的内容URI格式:
content://com.example.app/*
一个能偶匹配任意一行数据的内容URI格式:
content://com.example.app/table1/#
我们再借助UriMatcher这个类就可以轻松实现匹配内容URI的功能,addURI():添加内容Ur和自定义代码i;match():匹配内容URI并返回自定义代码
UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
matcher.addURI(authority,path,自定义代码);
matcher.match(uri);//uri匹配成功后会返回addURI()中的自定义代码
自定义内容提供器:MyProvider
public class MyProvider extends ContentProvider {
public static final int BOOK_DIR = 0;
public static final int BOOK_ITEM = 1;
public static final int CATEGORY_DIR = 2;
public static final int CATEGORY_ITEM = 3;
public static final String authority = "com.example.app.provider";
private static UriMatcher uriMatcher;
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI(authority, "/Book", BOOK_DIR);
uriMatcher.addURI(authority, "/Book/#", BOOK_ITEM);
}
@Override
public boolean onCreate() {
// TODO: Implement this to initialize your content provider on startup.
return true;
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
int deleteRows = 0;
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
//返回被删除的行数
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
break;
}
return deleteRows;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
// TODO: Implement this to handle requests to insert a new row.
Uri uriReturn = null;
switch (uriMatcher.match(uri)){
case BOOK_DIR:
case BOOK_ITEM:
//返回新插入行id,或者-1
break;
}
return uriReturn;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
// TODO: Implement this to handle query requests from clients.
Cursor cursor = null;
switch (uriMatcher.match(uri)){
case BOOK_DIR:
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
break;
}
return cursor;
}
@Override
public int update(Uri uri, ContentValues values, String selection,
String[] selectionArgs) {
// TODO: Implement this to handle requests to update one or more rows.
int updateRows = 0;
switch (uriMatcher.match(uri)){
case BOOK_DIR:
//返回受影响的行数
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
break;
}
return updateRows;
}
@Override
public String getType(Uri uri) {
// TODO: Implement this to handle requests for the MIME type of the data
// at the given URI.
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
return "vnd.android.cursor.dir/vnd.com.example.sqlitetest.provider.book";
case BOOK_ITEM:
return "vnd.android.cursor.item/vnd.com.example.sqlitetest.provider.book";
}
return null;
}
}