上一篇文章Android ContentProvider(一)初步介绍了ContentProvider的用法,这篇就通过获取系统联系人来了解ContentProvider的具体使用方法。
创建ContactsTest项目
因为模拟器中并没有联系人,所以需要给模拟器添加几个联系人数据,然后开始创建ContactsTest项目。项目已上传Github
项目布局只有一个ListView,代码就不用贴出来了。主要还是看MainActivity的代码。
public class MainActivity extends AppCompatActivity {
ListView contactsView;
ArrayAdapter<String> adapter;
List<String> contactsList = new ArrayList<String>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
contactsView = (ListView) findViewById(R.id.contacts_view);
getContacts();
adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, contactsList);
contactsView.setAdapter(adapter);
}
private void getContacts() {
Cursor cursor = null;
//查询联系人数据
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));
contactsList.add(displayName + "\n" + number);
}
cursor.close();
}
}
}
onCreate()方法中,首先获取了ListView控件,然后调用getContacts()方法获取联系人数据,然后再给ListView设置Adapter。主要看一下getContacts()方法,可以看到,这里使用了ContentResolver的query()方法来查询系统的联系人数据。不过传入的Uri并没有调用Uri.parse()方法去解析一个内容URI字符串,这是因为ContactsContract.CommonDataKinds.Phone类已经帮我们做好了封装,提供了一个CONTENT_URI常量,而这个常量就是使用Uri.parse()方法解析出来的结果。接着对Cursor对象进行遍历,将联系人姓名和手机号这些数据逐个取出,联系人姓名这一列对应的常量是ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME
,联系人手机号这一列对应的常量是ContactsContract.CommonDataKinds.Phone.NUMBER
。两个数据都取出之后,将它们进行拼接,并且中间加上换行符,然后将拼接后的数据添加到ListView里。然后不要忘记将Cursor对象关闭掉。
最后不要忘了在AndroidManifest.xml添加权限
<uses-permission android:name="android.permission.READ_CONTACTS"/>
运行ContactsTest
运行在Android 5.0的效果如下,与预期的效果一样。
Android 5.0
运行在Android 6.0之后的版本就会报错
部分log后来通过查询了解到Android M开始就增加了运行时权限Runtime Permission,不清楚的话可以到Android官方培训课程(需要文明上网) 学习。了解到问题所在之后就要开始解决问题。
解决问题
- 修改代码
public class MainActivity extends AppCompatActivity {
private static final int PERMISSIONS_REQUEST_READ_CONTACTS = 100;
……
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
contactsView = (ListView) findViewById(R.id.contacts_view);
showContacts();
}
private void showContacts() {
// 检查SDK版本并判断权限是否授权
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M
&& checkSelfPermission(Manifest.permission.READ_CONTACTS) !=
PackageManager.PERMISSION_GRANTED) {
//请求权限,之后会回调onRequestPermissionsResult()
requestPermissions(new String[]{Manifest.permission.READ_CONTACTS}, PERMISSIONS_REQUEST_READ_CONTACTS);
} else {
//Android版本小于6.0或者已经授权
getContacts();
adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, contactsList);
contactsView.setAdapter(adapter);
}
}
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
if(requestCode == PERMISSIONS_REQUEST_READ_CONTACTS){
if (grantResults[0] == PackageManager.PERMISSION_GRANTED){
//权限同意授权,然后重新调用showContacts()
showContacts();
}else{
//不同意授权,用Toast提示用户
Toast.makeText(this,"Until you grant the permission, we canot display the contacts", Toast.LENGTH_SHORT).show();
}
}
}
private void getContacts() {
……
}
}
代码相同的部分用……表示,这里主要看一下showContacts()方法,首先判断Android版本与权限是否授权,如果是Android M之后的版本并且还没有授权相应的权限就会调用requestPermissions()请求权限授权,然后回调onRequestPermissionsResult()通过requestCode监听相应权限的授权状态,再作相应的处理。
- 重新运行程序
修改代码之后Android 6.0也可以运行了,并且可以从图中看出同意与不同意授权的区别。
这篇文章就到这里,关于Android M的权限问题也可以看一下微信公众号的这篇文章Android 6.0权限适配,比你想的还要简单(实践篇)
如果文章对你有所帮助,那么请您点一下❤
由于本人水平有限,如有错误,欢迎大家指正。如果你在操作过程中发现一些没有讲到的错误或者问题,欢迎在评论留言,一起探讨,共同学习进步!
网友评论