Android ContentProvider(二)

作者: 前端develop | 来源:发表于2016-08-20 18:58 被阅读451次

    上一篇文章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 ContentProvider(二)

        本文链接:https://www.haomeiwen.com/subject/ncabsttx.html