读取手机联系人

前言

读取手机联系人是Android应用中很常见的操作，也是很多应用的功能基础，本文就简单讲解一下如何使用ContentResolver对手机联系人进行读取。

主要代码

逻辑部分

public class MainActivity extends AppCompatActivity {
    private ListView contactsListView;//联系人列表
    private ArrayAdapter contactsAdapter;//列表适配器
    private ArrayList contactsList;//列表数据源

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        contactsListView= (ListView) findViewById(R.id.list_contacts);
        contactsList=new ArrayList();
        contactsAdapter=new ArrayAdapter(this,android.R.layout.
                simple_list_item_1,contactsList);
        contactsListView.setAdapter(contactsAdapter);//设置适配器

        findViewById(R.id.read_contacts).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                //检查是否具备读取联系人的权限
                if(ContextCompat.checkSelfPermission(MainActivity.this,Manifest.permission.
                        READ_CONTACTS)!= PackageManager.PERMISSION_GRANTED){
                    //没有权限则申请权限
                    ActivityCompat.requestPermissions(MainActivity.this,
                            new String[]{Manifest.permission.READ_CONTACTS},1);
                }else{
                    readContacts();//有权限则直接读取联系人
                }
            }
        });
    }

    //读取联系人
    private void readContacts(){
        contactsList.clear();//清空数据
        Cursor cursor=null;//用于读取数据的游标
        try {
            //使用Android预定义的Uri对象查询数据
            cursor=getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                    null,null,null,null);
            if(cursor.moveToFirst()){
                do{
                    String name=cursor.getString(cursor.getColumnIndex(
                            ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));//姓名
                    String phoneNumber=cursor.getString(cursor.getColumnIndex(
                            ContactsContract.CommonDataKinds.Phone.NUMBER));//电话号码
                    contactsList.add(name+" "+phoneNumber);
                }while(cursor.moveToNext());
            }
        } catch (SecurityException e) {
            e.printStackTrace();
        } finally {
            if(cursor!=null){//关闭资源
                cursor.close();
            }
        }
        contactsAdapter.notifyDataSetChanged();//刷新列表数据
    }

    @Override
    public void onRequestPermissionsResult(int requestCode,@NonNull String[] permissions,@NonNull int[] grantResults) {
        switch(requestCode){
            case 1:
                if(grantResults.length>0&&grantResults[0]==PackageManager.PERMISSION_GRANTED){
                    readContacts();//获得权限后读取联系人
                }else{
                    Toast.makeText(this,"您拒绝授予权限，读取联系人失败",Toast.LENGTH_SHORT).show();
                }
                break;
            default:
                break;
        }
    }
}

界面布局

权限

    
    

    
        ......
    

需要注意的是，在上述代码中用到了运行时权限相关的知识，这是Android6.0之后新增的机制，具体细节可以参考这篇博客：

详解Android权限机制

效果预览

将读取到的联系人信息加载到ListView中：

demo下载地址

Android读取手机联系人