简单实现读取系统联系人信息

首先，我先创建一个项目名为ContactsTest。

1.布局文件activity_main.xml

由于只是简单的实现读取联系人信息并展示出来，所以我的界面也十分简洁，只使用了一个ListView进行显示，代码如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@+id/contacts_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

2.主活动MainActivity.java

package com.example.contactstest;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import android.Manifest;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;
import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    ArrayAdapter<String> adapter;
    List<String> contactsList=new ArrayList<>();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ListView contactsView=(ListView) findViewById(R.id.contacts_view);
        adapter=new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,contactsList);
        contactsView.setAdapter(adapter);
        if(ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS)!= PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(this,new String[]{Manifest.permission.READ_CONTACTS},1);
        }else {
            readContacts();
        }
    }

    private void readContacts(){
        Cursor cursor=null;
        try{//查询联系人数据
            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);
                }
                adapter.notifyDataSetChanged();
            }
        }catch (Exception e){
            e.printStackTrace();
        }finally {
            if(cursor!=null){
                cursor.close();
            }
        }
    }

    @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:
        }
    }
}

在onCreate( )方法中，我首先获取了ListView的实例，然后用ArrayAdapter作为适配器，并将其泛型指定为String，并在其构造函数中依次传入上下文、ListView子项布局id和要适配的数据。然后调用setAdapter( )方法将构造好的适配器对象传递进去。接着就判断用户是否给过我们权限，因为查看联系人信息是一个危险的操作，需要用户给相应的权限才行。这里用ContextCompat.checkSelfPermission( )方法对其进行判断，checkSelfPermission( )方法接收两个参数：第一个参数是Content，第二个参数就是具体权限名（Manifest.permission.READ_CONTACTS）。这里用返回值与PackageManager.PERMISSION_GRANTED作比较，如果相等就说明用户已经授权过，不相等就表示用户没有授权。

如果没有授权的话，就用ActivityCompat.requestPermissions( )方法来申请获取权限，这里传入了三个参数：第一个是活动实例，第二个是具体权限名（放在String数组中），第三个是请求码，只要是唯一值就行。如果已经授权过的话，就直接调用readContacts( )方法查询联系人信息。

readContacts( )方法这里使用ContentResolver的query( )方法来查询联系人信息。并将数据存放在cursor中。然后就对cursor进行判断，当不为空时就对cursor进行遍历，将联系人姓名和联系方式逐个取出，其中ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME和ContactsContract.CommonDataKinds.Phone.NUMBER这两个常量分别对应联系人姓名和手机号。最后将两个数据进行拼接，并在中间加上换行符将数据添加到ListView的数据源里，通知刷新一下ListView,将Cursor对象关闭。

最后重写onRequestPermissionsResult( )方法，因为调用requestPermissions( )方法后，系统会弹出一个申请权限的对话框，用户可选择同意和拒绝这两种结果，但不论哪种结果最后都会回调到onRequestPermissionsResult( )方法中，而授权的结果则会封装到grantResults参数中。这里我们只需要对最后的授权结果进行判断，如果同意就调用readContacts( )方法读取联系人信息，不同意就弹出一条失败提示。

最后的最后，一定要记得在AndroidManifest.xml中声明读取联系人的权限。

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

效果展示：