内容提供器一般有两种,一种是使用现有的内容提供器来读取和操作响应程序中的数据,另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口
ContentResolver的基本用法
对于每一个程序来说,如果想要访问内容提供器中共享的数据,就一定要借助ComtentResolver类,可以通过Context中的getContentResolver()
方法获取到该类的实例,这个类还提供了一系列的方法用于对数据的CRUD操作,insert()用于添加数据,update()方法用于更新数据,delete()方法用于删除数据,query()方法用于查询数据,和SQLite中方法差不多,但是在参数上是有差距的
- ContentResolver中的增删改查方法中不接受表名参数而要接收一个Uri参数,这个参数被称作内容URI,内容URI给内容提供器中的数据建立了唯一标识符,主要有两部分组成,authority和path,
authority是用于对不同的应用程序做区分的,一般都会采用程序的包名来命名,path是对于同一应用程序中不同的表做区分
,我们还需要在字符串的头部加上协议声明,因此内容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.parse()方法就可以将内容URI字符串解析成Uri对象了
- 现在就可以使用这个Uri对象来查询table1表中的数据了,代码如下
Cursor cursor = getContentResolver().query(
uri,
projection,
selection,
selectionArgs,
sortOrder
);
查询完成后返回的仍然是一个Cursor对象,这个时候我们就可以将数据从Cursor对象中逐个读取出来了,还是通过移动的游标的位置来遍历Cursor的所有行,然后再读取出来每一行中对应的列的数据,代码如下
if(cursor != null){
while(cursor.moveToNext()){
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
String column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
- 向table表中添加数据
ContentValues values = new ContentValues();
values.put("column1","text");
values.put("column2",1);
getContentResolver().insert(uri,values);
- 这里调用的是getContentResolver().insert()方法,第一个参数是Uri,第二个参数是values
- 更新一条数据
ContentValues values = new ContentValues();
values.put("column1","");
getContentResolver().update(uri,values,"column1 = ? and column2 = ?",new String[]{"text","1"});
- 删除一条数据
getContentResolver().delete(uri,"column2 = ?",new String[]{"1"});
方法的使用和SQLiteDatabases差不多,但是要注意的就是uri这个参数
读取系统联系人(READ_CONTACTS)
首先创建两个联系人
- 修改activity_main.xml中的代码
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent"
>
<ListView
android:id="@+id/contacts_view"
android:layout_width="match_parent"
android:layout_height="match_parent">
</ListView>
</LinearLayout>
- 这里使用ListView
- 在MainActivity中的代码
public class MainActivity extends AppCompatActivity {
ArrayAdapter<String> adapter;
List<String> contactsList = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取到个ListView实例
ListView contactsView = (ListView)findViewById(R.id.contacts_view);
// 适配器
adapter = new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,contactsList);
contactsView.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();
}
}
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 name = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
String phone = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
contactsList.add(name+"\n"+phone);
}
adapter.notifyDataSetChanged();
}
}catch (Exception e){
e.printStackTrace();
}finally {
if (cursor != null){
cursor.close();
}
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] 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:
}
}
}
- 在onCreate()方法中,首先获取到了ListView控件实例,并设置好适配器,然后调用运行时权限的处理逻辑,
因为READ_CONTACTS权限是属于危险的权限
,关于运行时权限在上一节中已经写过了,在授权之后调用 readContacts()方法读取联系人信息 - 在 readContacts方法中,使用了getContentResolver().query()方法来查询系统联系人,这个时候为啥不调用Uri.parse()方法呢,因为ContactsContract.CommonDataKinds.Phone类已经给我们封装好了,直接使用就可以了,把联系人和电话逐个遍历出来,联系人是
ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME
,名字是ContactsContract.CommonDataKinds.Phone.NUMBER
,出来后在中间加上换行符,然后添加到ListView中,并通知刷新一下ListView,最后关闭Cursor对象
- 这样就结束了吗? 不不不, 读取系统联系人的权限还的声明一下里,修改AndroidMainfest.xml中的代码
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.md.contacts">
<uses-permission android:name="android.permission.READ_CONTACTS"/>
...
</manifest>
-
运行程序,首先弹出申请访问联系人的对话框,点击同意