test_common/src/com/android/providers/contacts/testutil/RawContactUtil.java

/*
 * Copyright (C) 2013 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License
 */

package com.android.providers.contacts.testutil;

import android.accounts.Account;
import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.provider.ContactsContract;

import java.util.List;

/**
 * Convenience methods for operating on the RawContacts table.
 */
public class RawContactUtil {

    private static final Uri URI = ContactsContract.RawContacts.CONTENT_URI;

    public static void update(ContentResolver resolver, long rawContactId,
            ContentValues values) {
        Uri uri = ContentUris.withAppendedId(URI, rawContactId);
        resolver.update(uri, values, null, null);
    }

    public static String[] queryByRawContactId(ContentResolver resolver,
            long rawContactId, String[] projection) {
        Uri uri = ContentUris.withAppendedId(ContactsContract.RawContacts.CONTENT_URI,
                rawContactId);
        Cursor cursor = resolver.query(uri, projection, null, null, null);
        return CommonDatabaseUtils.singleRecordToArray(cursor);
    }

    public static void delete(ContentResolver resolver, long rawContactId,
            boolean isSyncAdapter) {
        Uri uri = ContentUris.withAppendedId(ContactsContract.RawContacts.CONTENT_URI, rawContactId)
                .buildUpon()
                .appendQueryParameter(ContactsContract.CALLER_IS_SYNCADAPTER, isSyncAdapter + "")
                .build();
        resolver.delete(uri, null, null);
    }

    public static long queryContactIdByRawContactId(ContentResolver resolver, long rawContactid) {
        String[] projection = new String[]{
                ContactsContract.RawContacts.CONTACT_ID
        };
        String[] result = RawContactUtil.queryByRawContactId(resolver, rawContactid,
                projection);
        if (result == null) {
            return CommonDatabaseUtils.NOT_FOUND;
        }
        return Long.parseLong(result[0]);
    }

    public static boolean rawContactExistsById(ContentResolver resolver, long rawContactid) {
        long contactId = queryContactIdByRawContactId(resolver, rawContactid);
        return contactId != CommonDatabaseUtils.NOT_FOUND;
    }

    public static long createRawContact(ContentResolver resolver, Account account,
            String... extras) {
        ContentValues values = new ContentValues();
        CommonDatabaseUtils.extrasVarArgsToValues(values, extras);
        final Uri uri = TestUtil.maybeAddAccountQueryParameters(
                ContactsContract.RawContacts.CONTENT_URI, account);
        Uri contactUri = resolver.insert(uri, values);
        return ContentUris.parseId(contactUri);
    }

    public static long createRawContactWithAccountDataSet(ContentResolver resolver,
            String accountName, String accountType, String dataSet, String... extras) {
        ContentValues values = new ContentValues();
        CommonDatabaseUtils.extrasVarArgsToValues(values, extras);
        final Uri uri = TestUtil.maybeAddAccountWithDataSetQueryParameters(
                ContactsContract.RawContacts.CONTENT_URI, accountName, accountType, dataSet);
        Uri contactUri = resolver.insert(uri, values);
        return ContentUris.parseId(contactUri);
    }

    public static long createRawContactWithName(ContentResolver resolver) {
        return createRawContactWithName(resolver, null);
    }

    public static long createRawContactWithName(ContentResolver resolver, Account account) {
        return createRawContactWithName(resolver, "John", "Doe", account);
    }

    public static long createRawContactWithName(ContentResolver resolver, String firstName,
            String lastName) {
        return createRawContactWithName(resolver, firstName, lastName, null);
    }

    public static long createRawContactWithName(ContentResolver resolver, String firstName,
            String lastName, Account account) {
        long rawContactId = createRawContact(resolver, account);
        DataUtil.insertStructuredName(resolver, rawContactId, firstName, lastName);
        return rawContactId;
    }

    public static long createRawContact(ContentResolver resolver) {
        return createRawContact(resolver, null);
    }

    public static long createRawContactWithBackupId(ContentResolver resolver, String backupId,
            Account account) {
        ContentValues values = new ContentValues();
        values.put(ContactsContract.RawContacts.BACKUP_ID, backupId);
        final Uri uri = ContactsContract.RawContacts.CONTENT_URI
                .buildUpon()
                .appendQueryParameter(ContactsContract.RawContacts.ACCOUNT_NAME,
                        account.name)
                .appendQueryParameter(ContactsContract.RawContacts.ACCOUNT_TYPE,
                        account.type)
                .build();
        Uri contactUri = resolver.insert(uri, values);
        return ContentUris.parseId(contactUri);
    }
}