Android ContentProvider(二)
上一篇文章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 6.0也可以运行了，并且可以从图中看出同意与不同意授权的区别。
这篇文章就到这里，关于Android M的权限问题也可以看一下微信公众号的这篇文章Android 6.0权限适配，比你想的还要简单（实践篇）
如果文章对你有所帮助，那么请您点一下❤
由于本人水平有限，如有错误，欢迎大家指正。如果你在操作过程中发现一些没有讲到的错误或者问题，欢迎在评论留言，一起探讨，共同学习进步！
