The Android Developer Challenge is back! Submit your idea before December 2.

연락처 세부정보 검색

이 과정에서는 연락처와 관련된 세부적인 데이터(예: 이메일 주소, 전화번호 등)를 검색하는 방법에 관해 설명합니다. 이는 사용자가 연락처를 검색할 때 찾는 세부정보입니다. 사용자에게 연락처의 모든 세부정보를 제공하거나 이메일 주소와 같은 특정 유형의 세부정보만 표시할 수 있습니다.

이 과정의 단계는 사용자가 선택한 연락처와 관련된 ContactsContract.Contacts 행을 이미 갖고 있다고 가정합니다. 연락처 목록을 검색하는 방법은 연락처 이름 검색 과정에서 설명합니다.

연락처 관련 모든 세부정보 검색

연락처의 모든 세부정보를 검색하려면 ContactsContract.Data 표를 연락처의 LOOKUP_KEY를 포함하고 있는 행 어디서나 검색하세요. 이 열은 ContactsContract.Data 표에서 사용할 수 있는데 이는 연락처 제공자가 ContactsContract.Contacts 표와 ContactsContract.Data 표를 무조건 연결하기 때문입니다. LOOKUP_KEY 열에 관해서는 연락처 이름 검색 과정에서 더 자세히 설명합니다.

참고: 연락처의 모든 세부정보를 검색할 경우 ContactsContract.Data 표의 모든 열을 검색해야 하므로 기기 성능을 떨어뜨립니다. 이 기술을 사용하기 전에 성능에 미칠 영향을 고려하세요.

권한 요청

연락처 제공자에서 읽기 작업을 하려면 앱에 READ_CONTACTS 권한이 있어야 합니다. 이 권한을 요청하려면 manifest 파일에 <manifest>의 다음 하위 요소를 추가하세요.

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

프로젝션 설정

행에 포함된 데이터 유형에 따라 몇 개의 열만 사용하거나 많은 열을 사용할 수 있습니다. 또한 데이터 유형에 따라 데이터가 다른 열에 포함됩니다. 가능한 모든 데이터 유형과 관련해 가능한 모든 열을 가져오려면 프로젝션에 열 이름을 모두 추가해야 합니다. 항상 Data._ID를 검색하세요(결과 CursorListView에 바인딩하는 경우). 그러지 않으면 바인딩할 수 없습니다. 또한 Data.MIMETYPE을 검색하여 검색하는 각 행의 데이터 유형을 파악할 수 있도록 하세요. 예를 들면 다음과 같습니다.

Kotlin

    private val PROJECTION: Array<out String> = arrayOf(
            ContactsContract.Data._ID,
            ContactsContract.Data.MIMETYPE,
            ContactsContract.Data.DATA1,
            ContactsContract.Data.DATA2,
            ContactsContract.Data.DATA3,
            ContactsContract.Data.DATA4,
            ContactsContract.Data.DATA5,
            ContactsContract.Data.DATA6,
            ContactsContract.Data.DATA7,
            ContactsContract.Data.DATA8,
            ContactsContract.Data.DATA9,
            ContactsContract.Data.DATA10,
            ContactsContract.Data.DATA11,
            ContactsContract.Data.DATA12,
            ContactsContract.Data.DATA13,
            ContactsContract.Data.DATA14,
            ContactsContract.Data.DATA15
    )
    

자바

        private static final String[] PROJECTION =
                {
                    ContactsContract.Data._ID,
                    ContactsContract.Data.MIMETYPE,
                    ContactsContract.Data.DATA1,
                    ContactsContract.Data.DATA2,
                    ContactsContract.Data.DATA3,
                    ContactsContract.Data.DATA4,
                    ContactsContract.Data.DATA5,
                    ContactsContract.Data.DATA6,
                    ContactsContract.Data.DATA7,
                    ContactsContract.Data.DATA8,
                    ContactsContract.Data.DATA9,
                    ContactsContract.Data.DATA10,
                    ContactsContract.Data.DATA11,
                    ContactsContract.Data.DATA12,
                    ContactsContract.Data.DATA13,
                    ContactsContract.Data.DATA14,
                    ContactsContract.Data.DATA15
                };
    

이 프로젝션은 ContactsContract.Data 표에 있는 행의 모든 열을 검색하며 ContactsContract.Data 클래스에서 정의된 열 이름을 사용합니다.

선택적으로 ContactsContract.Data 클래스에서 정의되거나 상속된 다른 열 상수를 사용할 수도 있습니다. 하지만 SYNC1에서 SYNC4 열은 동기화 어댑터에서 사용되기 때문에 데이터가 유용하지 않습니다.

선정 기준 정의

선택 절의 상수, 선정 인수 보유 배열, 선정 값 보유 변수를 정의하세요. Contacts.LOOKUP_KEY 열을 사용하여 연락처를 찾습니다. 예를 들면 다음과 같습니다.

Kotlin

    // Defines the selection clause
    private const val SELECTION: String = "${ContactsContract.Data.LOOKUP_KEY} = ?"
    ...
    // Defines the array to hold the search criteria
    private val selectionArgs: Array<String> = arrayOf("")
    /*
     * Defines a variable to contain the selection value. Once you
     * have the Cursor from the Contacts table, and you've selected
     * the desired row, move the row's LOOKUP_KEY value into this
     * variable.
     */
    private var lookupKey: String? = null
    

자바

        // Defines the selection clause
        private static final String SELECTION = Data.LOOKUP_KEY + " = ?";
        // Defines the array to hold the search criteria
        private String[] selectionArgs = { "" };
        /*
         * Defines a variable to contain the selection value. Once you
         * have the Cursor from the Contacts table, and you've selected
         * the desired row, move the row's LOOKUP_KEY value into this
         * variable.
         */
        private lateinit var lookupKey: String
    

선택 텍스트 표현식에서 '?'를 자리표시자로 사용하면 SQL 컴파일 대신 바인딩을 통해 검색이 생성됩니다. 이렇게 하면 악의적인 SQL 삽입 가능성을 없애줍니다.

정렬 순서 정의

결과 Cursor에 원하는 정렬 순서를 정의합니다. 특정 데이터 유형의 모든 행을 함께 유지하려면 Data.MIMETYPE으로 정렬하세요. 이 쿼리 인수는 모든 이메일 행, 모든 전화 행 등을 그룹화합니다. 예를 들면 다음과 같습니다.

Kotlin

    /*
     * Defines a string that specifies a sort order of MIME type
     */
    private const val SORT_ORDER = ContactsContract.Data.MIMETYPE
    

자바

        /*
         * Defines a string that specifies a sort order of MIME type
         */
        private static final String SORT_ORDER = ContactsContract.Data.MIMETYPE;
    

참고: 일부 데이터 유형은 하위유형을 사용하지 않으므로 하위유형별로 정렬할 수 없습니다. 대신 반환된 Cursor를 반복해야 하며 현재 행의 데이터 유형을 결정하고 하위유형을 사용하는 행의 데이터를 저장해야 합니다. 커서 읽기 작업을 마치고 나면 하위유형별로 각 데이터 유형을 정렬하고 결과를 표시할 수 있습니다.

로더 초기화

항상 백그라운드 스레드의 연락처 제공자(및 기타 모든 콘텐츠 제공자)에서 검색합니다. 백그라운드 검색을 하려면 LoaderManager 클래스 및 LoaderManager.LoaderCallbacks 인터페이스에서 정의된 로더 프레임워크를 사용하세요.

행을 검색할 준비가 되면 initLoader()를 호출하여 로더 프레임워크를 초기화합니다. 정수 식별자를 메서드에 전달하면 이 식별자가 LoaderManager.LoaderCallbacks 메서드로 전달됩니다. 식별자는 로더 간에 구별할 수 있도록 해줌으로써 앱에서 여러 가지 로더를 사용하도록 돕습니다.

다음 스니펫은 로더 프레임워크를 초기화하는 방법을 보여줍니다.

Kotlin

    // Defines a constant that identifies the loader
    private const val DETAILS_QUERY_ID: Int = 0

    class DetailsFragment : Fragment(), LoaderManager.LoaderCallbacks<Cursor> {
        ...
        override fun onActivityCreated(savedInstanceState: Bundle?) {
            ...
            // Initializes the loader framework
            loaderManager.initLoader(DETAILS_QUERY_ID, null, this)
    

자바

    public class DetailsFragment extends Fragment implements
            LoaderManager.LoaderCallbacks<Cursor> {
        ...
        // Defines a constant that identifies the loader
        static int DETAILS_QUERY_ID = 0;
        ...
        /*
         * Invoked when the parent Activity is instantiated
         * and the Fragment's UI is ready. Put final initialization
         * steps here.
         */
        @Override
        onActivityCreated(Bundle savedInstanceState) {
            ...
            // Initializes the loader framework
            getLoaderManager().initLoader(DETAILS_QUERY_ID, null, this);
    

onCreateLoader() 구현

initLoader()를 호출한 후 즉시 로더 프레임워크에 의해 호출되는 onCreateLoader() 메서드를 구현합니다. 이 메서드에서 CursorLoader를 반환합니다. ContactsContract.Data 표를 검색 중이므로 상수 Data.CONTENT_URI를 콘텐츠 URI로 사용합니다. 예를 들면 다음과 같습니다.

Kotlin

    override fun onCreateLoader(loaderId: Int, args: Bundle?): Loader<Cursor> {
        // Choose the proper action
        mLoader = when(loaderId) {
            DETAILS_QUERY_ID -> {
                // Assigns the selection parameter
                selectionArgs[0] = lookupKey
                // Starts the query
                activity?.let {
                    CursorLoader(
                            it,
                            ContactsContract.Data.CONTENT_URI,
                            PROJECTION,
                            SELECTION,
                            selectionArgs,
                            SORT_ORDER
                    )
                }
            }
            ...
        }
        return mLoader
    }
    

자바

    @Override
        public Loader<Cursor> onCreateLoader(int loaderId, Bundle args) {
            // Choose the proper action
            switch (loaderId) {
                case DETAILS_QUERY_ID:
                // Assigns the selection parameter
                selectionArgs[0] = lookupKey;
                // Starts the query
                CursorLoader mLoader =
                        new CursorLoader(
                                getActivity(),
                                ContactsContract.Data.CONTENT_URI,
                                PROJECTION,
                                SELECTION,
                                selectionArgs,
                                SORT_ORDER
                        );
        }
    

onLoadFinished() 및 onLoaderReset() 구현

onLoadFinished() 메서드를 구현합니다. 연락처 제공자가 쿼리 결과를 반환하면 로더 프레임워크가 onLoadFinished()를 호출합니다. 예를 들면 다음과 같습니다.

Kotlin

        override fun onLoadFinished(loader: Loader<Cursor>, data: Cursor) {
            when(loader.id) {
                DETAILS_QUERY_ID -> {
                    /*
                     * Process the resulting Cursor here.
                     */
                }
                ...
            }
        }
    

자바

        @Override
        public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) {
            switch (loader.getId()) {
                case DETAILS_QUERY_ID:
                        /*
                         * Process the resulting Cursor here.
                         */
                    }
                    break;
                ...
            }
        }
    

로더 프레임워크가 결과 Cursor를 지원하는 데이터가 변경되었다고 감지하면 onLoaderReset() 메서드가 호출됩니다. 이때 Cursor를 참조하는 모든 기존 항목을 null로 설정하여 삭제합니다. 삭제하지 않으면 로더 프레임워크가 이전 Cursor를 제거하지 않으며 메모리 누수가 발생합니다. 예를 들면 다음과 같습니다.

Kotlin

        override fun onLoaderReset(loader: Loader<Cursor>) {
            when (loader.id) {
                DETAILS_QUERY_ID -> {
                    /*
                     * If you have current references to the Cursor,
                     * remove them here.
                     */
                }
                ...
            }
        }
    

자바

        @Override
        public void onLoaderReset(Loader<Cursor> loader) {
            switch (loader.getId()) {
                case DETAILS_QUERY_ID:
                    /*
                     * If you have current references to the Cursor,
                     * remove them here.
                     */
                    }
                    break;
        }
    

연락처 관련 특정 세부정보 검색

모든 이메일과 같이 연락처의 특정 데이터 유형을 검색할 때 모든 세부정보를 검색할 때와 동일한 패턴을 따릅니다. 연락처 관련 모든 세부정보 검색에 표시된 코드에서 다음 사항만 변경하면 됩니다.

프로젝션
프로젝션을 수정하여 데이터 유형과 관련된 열을 검색합니다. 또한 프로젝션을 수정하여 데이터 유형에 해당하는 ContactsContract.CommonDataKinds 서브클래스에서 정의된 열 이름 상수를 사용하세요.
선택
선택 텍스트를 수정하여 데이터 유형에 해당하는 MIMETYPE 값을 검색합니다.
정렬 순서
한 가지 세부정보 유형만 선택하므로 반환된 CursorData.MIMETYPE별로 그룹화하지 마세요.

이러한 수정 사항은 다음 섹션에 설명되어 있습니다.

프로젝션 정의

데이터 유형의 ContactsContract.CommonDataKinds 서브클래스에 있는 열 이름 상수를 사용하여 검색하려는 열을 정의합니다. CursorListView에 바인딩하려는 경우 _ID 열을 검색해야 합니다. 예를 들어 이메일 데이터를 검색하려면 다음 프로젝션을 정의하세요.

Kotlin

    private val PROJECTION: Array<String> = arrayOf(
            ContactsContract.CommonDataKinds.Email._ID,
            ContactsContract.CommonDataKinds.Email.ADDRESS,
            ContactsContract.CommonDataKinds.Email.TYPE,
            ContactsContract.CommonDataKinds.Email.LABEL
    )
    

자바

        private static final String[] PROJECTION =
                {
                    ContactsContract.CommonDataKinds.Email._ID,
                    ContactsContract.CommonDataKinds.Email.ADDRESS,
                    ContactsContract.CommonDataKinds.Email.TYPE,
                    ContactsContract.CommonDataKinds.Email.LABEL
                };
    

이 프로젝션에서는 ContactsContract.CommonDataKinds.Email 클래스에서 정의된 열 이름을 사용하며 ContactsContract.Data 클래스에서 정의된 이름을 사용하지 않습니다. 이메일 관련 열 이름을 사용하면 코드를 더 쉽게 읽을 수 있습니다.

프로젝션에서 ContactsContract.CommonDataKinds 서브클래스에서 정의된 다른 열을 사용할 수도 있습니다.

선택 기준 정의

특정 연락처의 LOOKUP_KEY 및 원하는 세부정보의 Data.MIMETYPE 관련 열을 검색하는 검색 텍스트 표현식을 정의합니다. 상수 시작 및 끝부분에 '''(작은따옴표) 문자를 연결하여 MIMETYPE 값을 작은따옴표로 묶습니다. 그러지 않으면 제공자가 상수를 문자열 값이 아닌 변수 이름으로 해석합니다. 사용자가 제공한 값 대신 상수를 사용하므로 이 값에 자리표시자를 사용하지 않아도 됩니다. 예를 들면 다음과 같습니다.

Kotlin

    /*
     * Defines the selection clause. Search for a lookup key
     * and the Email MIME type
     */
    private const val SELECTION =
            "${ContactsContract.Data.LOOKUP_KEY} = ? AND " +
            "${ContactsContract.Data.MIMETYPE} = '${Email.CONTENT_ITEM_TYPE}'"
    ...
    // Defines the array to hold the search criteria
    private val selectionArgs: Array<String> = arrayOf("")
    

자바

        /*
         * Defines the selection clause. Search for a lookup key
         * and the Email MIME type
         */
        private static final String SELECTION =
                Data.LOOKUP_KEY + " = ?" +
                " AND " +
                Data.MIMETYPE + " = " +
                "'" + Email.CONTENT_ITEM_TYPE + "'";
        // Defines the array to hold the search criteria
        private String[] selectionArgs = { "" };
    

정렬 순서 정의

반환된 Cursor의 정렬 순서를 정의합니다. 특정 데이터 유형을 검색 중이므로 MIMETYPE의 정렬은 생략하세요. 대신 검색 중인 세부 데이터 유형에 하위유형이 포함되어 있는 경우 정렬하시기 바랍니다. 예를 들어 이메일 데이터는 Email.TYPE으로 정렬할 수 있습니다.

Kotlin

    private const val SORT_ORDER: String = "${Email.TYPE} ASC"
    

자바

        private static final String SORT_ORDER = Email.TYPE + " ASC ";