วิธีอ่านรายชื่อติดต่อทั้งหมดใน Android

ภาพรวม

ตัวอย่างนี้แสดงวิธีอ่านรายชื่อผู้ติดต่อทั้งหมดจาก Contacts Provider พร้อมจัดการ Runtime Permission สำหรับ READ_CONTACTS

ขั้นตอนการสร้าง

ขั้นตอนที่ 1: สร้างโปรเจกต์ใหม่

เปิด Android Studio ไปที่ File → New Project และกรอกข้อมูลที่จำเป็น

ขั้นตอนที่ 2: ออกแบบ Layout (res/layout/activity_main.xml)

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:gravity="center"
    android:layout_height="match_parent">
    <ListView
        android:id="@+id/list"
        android:layout_width="wrap_content"
        android:textSize="30sp"
        android:layout_height="wrap_content"
        android:text="Click"/>
</LinearLayout>

ขั้นตอนที่ 3: เขียนโค้ดหลัก (src/MainActivity.java)

package com.example.myapplication;

import android.Manifest;
import android.annotation.TargetApi;
import android.content.ContentResolver;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.os.Build;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {
    public static final int REQUEST_READ_CONTACTS = 79;
    ListView list;
    ArrayList<String> mobileArray;

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) 
                == PackageManager.PERMISSION_GRANTED) {
            mobileArray = getAllContacts();
            setupListView();
        } else {
            requestPermission();
        }
    }

    private void setupListView() {
        list = findViewById(R.id.list);
        ArrayAdapter<String> adapter = new ArrayAdapter<>(this,
                android.R.layout.simple_list_item_1, android.R.id.text1, mobileArray);
        list.setAdapter(adapter);
    }

    private void requestPermission() {
        if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.READ_CONTACTS)) {
            // แสดงเหตุผลก่อนขอสิทธิ์
        } else {
            ActivityCompat.requestPermissions(this, 
                    new String[]{Manifest.permission.READ_CONTACTS}, REQUEST_READ_CONTACTS);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        if (requestCode == REQUEST_READ_CONTACTS) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                mobileArray = getAllContacts();
                setupListView();
            } else {
                // Permission denied
            }
        }
    }

    private ArrayList<String> getAllContacts() {
        ArrayList<String> nameList = new ArrayList<>();
        ContentResolver cr = getContentResolver();
        Cursor cur = cr.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
        
        if (cur != null && cur.getCount() > 0) {
            while (cur.moveToNext()) {
                String name = cur.getString(cur.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
                nameList.add(name);
            }
        }
        
        if (cur != null) {
            cur.close();
        }
        return nameList;
    }
}

ขั้นตอนที่ 4: กำหนดสิทธิ์ใน AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.myapplication">
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <application ...>
        <activity android:name=".MainActivity" ...>
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

คำอธิบายสำคัญ

• ContactsContract.Contacts.CONTENT_URI - URI สำหรับเข้าถึงตารางผู้ติดต่อ
• DISPLAY_NAME - ชื่อผู้ติดต่อ
• HAS_PHONE_NUMBER - ตรวจสอบว่ามีเบอร์โทรหรือไม่
• Runtime Permission - ต้องขอสิทธิ์ READ_CONTACTS ตอนรัน (API 23+)

การขยาย: ดึงหมายเลขโทรศัพท์พร้อมกัน

private ArrayList<ContactInfo> getAllContactsWithPhones() {
    ArrayList<ContactInfo> contacts = new ArrayList<>();
    ContentResolver cr = getContentResolver();
    Cursor cur = cr.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
    
    if (cur != null) {
        while (cur.moveToNext()) {
            String id = cur.getString(cur.getColumnIndex(ContactsContract.Contacts._ID));
            String name = cur.getString(cur.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
            
            if (cur.getInt(cur.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER)) > 0) {
                Cursor pCur = cr.query(
                    ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                    null,
                    ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = ?",
                    new String[]{id}, null);
                
                ArrayList<String> phones = new ArrayList<>();
                while (pCur.moveToNext()) {
                    String phone = pCur.getString(pCur.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
                    phones.add(phone);
                }
                pCur.close();
                contacts.add(new ContactInfo(name, phones));
            }
        }
        cur.close();
    }
    return contacts;
}

class ContactInfo {
    String name;
    ArrayList<String> phones;
    ContactInfo(String name, ArrayList<String> phones) {
        this.name = name;
        this.phones = phones;
    }
}

แนวทางปฏิบัติที่ดี

• ใช้ CursorLoader + LoaderManager (Legacy) หรือ ContentResolver + Coroutines/Flow (Modern)
• ปิด Cursor ทุกครั้งหลังใช้งาน
• จัดการ Permission อย่างเหมาะสม
• ใช้ RecyclerView แทน ListView สำหรับ Performance ดีกว่า