十.Android ContentProvider 实例——获取联系人

1.ContentProvider简述

• ContenttProvider(以下简称CP)是为了获取不同应用之间的数据而诞生的组件，并且官方为常见的一些数据提供了默认的CP。例如，联系人、短信等。
• CP的几点关键：
  
  1. Uri：是CP的标志符，是识别CP的唯一方式。
  2. ContentResolver：对CP进行操作的类。
  3. 权限：有时候操作一些地方需要一些权限。

2.获取联系人实现思路

3.具体实现

3.1 申请权限

android6.0不仅要在AndroidManifest.xml中静态申请，还需要在代码中进行动态申请。

• 静态申请
  在AndroidManifest.xml中进行申请。

<manifest ...> <uses-permission android:name="android.permission.READ_CONTACTS" /></manifest>

• 动态申请
  动态申请的流程为：发起申请和申请结果。

• 发起申请：
  主要使用requestPermissions(permission名字的数组,整型的自定义reques code)方法
  注：

  1. 什么时候进行动态申请呢？版本大于等于6.0且当前页面没有这个权限。
  2. request code 为自定义数值，例子中我定义了一个常量int–PERMISSIONS_REQUEST_READ_CONTACTS，这个是为了在查看申请结果时判定用的。
     

     private void showContacts() {    //检验是否版本大于6.0，当前页面是否有这个权限    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M &&checkSelfPermission(Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) {        //发起申请        requestPermissions(new String[]{Manifest.permission.READ_CONTACTS}, PERMISSIONS_REQUEST_READ_CONTACTS);    } else {        //低版本直接运行，跳过动态申请。        readContacts();    }}

• 申请结果
  重写onRequsetPermissionResult(int requestCode,String[] permissions,int[] grantResults)方法。
  注：

  1. 在此返回的requestCode是发送申请中自定义的requestCode，permissions String数组也是发送申请中的，grantResults返回的有两种PackageManager.PERMISSION_**GRANTED**和PackageManager.PERMISSIO
     N_**DENIED**
     

     @Overridepublic void onRequestPermissionsResult(int requestCode, String[] permissions,                                       int[] grantResults) {    if (requestCode == PERMISSIONS_REQUEST_READ_CONTACTS) {        if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {            // 申请权限通过            showContacts();        } else {            Toast.makeText(this, "只有通过了权限申请才能查看", Toast.LENGTH_SHORT).show();        }    }}

3.2 获取联系人

• 主要使用ContentResolver进行操作
  使用游标来对ContentResolver获取的数据进行操作。

private void readContacts(){        Cursor cursor=null;        try{            cursor=getContentResolver().query(                    ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,null,null,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);            }        }catch (Exception e){            e.printStackTrace();        }finally {            if(cursor!=null){                cursor.close();            }        }    }

3.3 页面显示

• List->adapter->ListView

ListView contactsView;ArrayAdapter<String> adapter;List<String> contactsList =new ArrayList<>();...adapter=new ArrayAdapter<>(this,android.R.layout.simple_list_item_1,contactsList);contactsView.setAdapter(adapter);

4.结果

5.日常福利

• Github源码