Android ContentProvider(二)

96
作者 飞奔
2016.08.20 18:58* 字数 883

上一篇文章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权限适配,比你想的还要简单(实践篇)

如果文章对你有所帮助,那么请您点一下❤
由于本人水平有限,如有错误,欢迎大家指正。如果你在操作过程中发现一些没有讲到的错误或者问题,欢迎在评论留言,一起探讨,共同学习进步!

Android基础