k-9/src/com/fsck/k9/helper/ContactsSdk3_4.java

package com.fsck.k9.helper;

import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.util.Log;
import android.provider.Contacts;
import android.provider.Contacts.ContactMethods;
import com.fsck.k9.mail.Address;
import com.fsck.k9.K9;


/**
 * Access the contacts on the device using the old API (introduced in SDK 1).
 *
 * @see android.provider.Contacts
 */
@SuppressWarnings("deprecation")
public class ContactsSdk3_4 extends com.fsck.k9.helper.Contacts {
    /**
     * The order in which the search results are returned by
     * {@link #searchContacts(CharSequence)}.
     */
    private static final String SORT_ORDER =
        Contacts.ContactMethods.TIMES_CONTACTED + " DESC, " +
        Contacts.ContactMethods.DISPLAY_NAME + ", " +
        Contacts.ContactMethods._ID;

    /**
     * Array of columns to load from the database.
     *
     * Important: The _ID field is needed by
     * {@link com.fsck.k9.EmailAddressAdapter} or more specificly by
     * {@link android.widget.ResourceCursorAdapter}.
     */
    private static final String PROJECTION[] = {
        Contacts.ContactMethods._ID,
        Contacts.ContactMethods.DISPLAY_NAME,
        Contacts.ContactMethods.DATA,
        Contacts.ContactMethods.PERSON_ID
    };

    /**
     * Index of the name field in the projection. This must match the order in
     * {@link #PROJECTION}.
     */
    private static final int NAME_INDEX = 1;

    /**
     * Index of the email address field in the projection. This must match the
     * order in {@link #PROJECTION}.
     */
    private static final int EMAIL_INDEX = 2;

    /**
     * Index of the contact id field in the projection. This must match the order in
     * {@link #PROJECTION}.
     */
    private static final int CONTACT_ID_INDEX = 3;


    public ContactsSdk3_4(final Context context) {
        super(context);
    }

    @Override
    public void createContact(final Address email) {
        final Uri contactUri = Uri.fromParts("mailto", email.getAddress(), null);

        final Intent contactIntent = new Intent(Contacts.Intents.SHOW_OR_CREATE_CONTACT);
        contactIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        contactIntent.setData(contactUri);

        // Pass along full E-mail string for possible create dialog
        contactIntent.putExtra(Contacts.Intents.EXTRA_CREATE_DESCRIPTION,
                               email.toString());

        // Only provide personal name hint if we have one
        final String senderPersonal = email.getPersonal();
        if (senderPersonal != null) {
            contactIntent.putExtra(Contacts.Intents.Insert.NAME, senderPersonal);
        }

        mContext.startActivity(contactIntent);
    }

    @Override
    public String getOwnerName() {
        String name = null;
        final Cursor c = mContentResolver.query(
                             Uri.withAppendedPath(Contacts.People.CONTENT_URI, "owner"),
                             new String[] {Contacts.ContactMethods.DISPLAY_NAME},
                             null,
                             null,
                             null);

        if (c != null) {
            if (c.getCount() > 0) {
                c.moveToFirst();
                name = c.getString(0);  // owner's display name
            }
            c.close();
        }

        return name;
    }

    @Override
    public boolean isInContacts(final String emailAddress) {
        boolean result = false;

        final Cursor c = getContactByAddress(emailAddress);

        if (c != null) {
            if (c.getCount() > 0) {
                result = true;
            }
            c.close();
        }

        return result;
    }

    @Override
    public Cursor searchContacts(final CharSequence constraint) {
        final String where;
        final String[] args;
        if (constraint == null) {
            where = Contacts.ContactMethods.KIND + " = " + Contacts.KIND_EMAIL;
            args = null;
        } else {
            where = Contacts.ContactMethods.KIND + " = " + Contacts.KIND_EMAIL +
                    " AND " +
                    "(" +
                    // Match if name starts with "constraint"
                    Contacts.People.NAME + " LIKE ?" +
                    " OR " +
                    // Match if name contains a word that starts with "constraint"
                    Contacts.People.NAME + " LIKE ?" +
                    " OR " +
                    // Match if phonetic name starts with "constraint"
                    Contacts.People.PHONETIC_NAME + " LIKE ?" +
                    " OR " +
                    // Match if phonetic name contains a word that starts with "constraint"
                    Contacts.People.PHONETIC_NAME + " LIKE ?" +
                    " OR " +
                    // Match if email address starts with "constraint"
                    Contacts.ContactMethods.DATA + " LIKE ?" +
                    ")";
            final String filter = constraint.toString() + "%";
            final String filter2 = "% " + filter;
            args = new String[] {filter, filter2, filter, filter2, filter};
        }

        final Cursor c = mContentResolver.query(
                             Contacts.ContactMethods.CONTENT_URI,
                             PROJECTION,
                             where,
                             args,
                             SORT_ORDER);

        if (c != null) {
            /*
             * To prevent expensive execution in the UI thread:
             * Cursors get lazily executed, so if you don't call anything on
             * the cursor before returning it from the background thread you'll
             * have a complied program for the cursor, but it won't have been
             * executed to generate the data yet. Often the execution is more
             * expensive than the compilation...
             */
            c.getCount();
        }

        return c;
    }

    @Override
    public String getNameForAddress(String address) {
        if (address == null) {
            return null;
        }

        final Cursor c = getContactByAddress(address);

        String name = null;
        if (c != null) {
            if (c.getCount() > 0) {
                c.moveToFirst();
                name = getName(c);
            }
            c.close();
        }

        return name;
    }

    @Override
    public String getName(Cursor c) {
        return c.getString(NAME_INDEX);
    }

    @Override
    public String getEmail(Cursor c) {
        return c.getString(EMAIL_INDEX);
    }

    @Override
    public void markAsContacted(final Address[] addresses) {
        //TODO: Optimize! Potentially a lot of database queries
        for (final Address address : addresses) {
            final Cursor c = getContactByAddress(address.getAddress());

            if (c != null) {
                if (c.getCount() > 0) {
                    c.moveToFirst();
                    final long personId = c.getLong(CONTACT_ID_INDEX);
                    Contacts.People.markAsContacted(mContentResolver, personId);
                }
                c.close();
            }
        }
    }

    @Override
    public Intent contactPickerIntent() {
        return new Intent(Intent.ACTION_PICK, Contacts.People.CONTENT_URI);
    }

    @Override
    public String getEmailFromContactPicker(final Intent data) {
        Cursor cursor = null;
        Cursor cursor2 = null;
        String email = "";

        try {
            Uri result = data.getData();
            cursor = mContentResolver.query(result, null, null, null, null);
            if (cursor.moveToFirst()) {
                String emailId = cursor.getString(cursor.getColumnIndex(Contacts.People.PRIMARY_EMAIL_ID));
                cursor2 = mContext.getContentResolver().query(
                        ContactMethods.CONTENT_EMAIL_URI,
                        new String[] { ContactMethods.DATA },
                        "contact_methods._id=?",
                        new String[] { emailId },
                        null);

                if (cursor2.moveToFirst()) {
                    email = cursor2.getString(0);
                }
            }
        } catch (Exception e) {
            Log.e(K9.LOG_TAG, "Failed to get email data", e);
        } finally {
            if (cursor != null) {
                cursor.close();
            }
            if (cursor2 != null) {
                cursor2.close();
            }
        }

        return email;
    }

    /**
     * Return a {@link Cursor} instance that can be used to fetch information
     * about the contact with the given email address.
     *
     * @param address The email address to search for.
     * @return A {@link Cursor} instance that can be used to fetch information
     *         about the contact with the given email address
     */
    private Cursor getContactByAddress(String address) {
        final String where = Contacts.ContactMethods.KIND + " = " + Contacts.KIND_EMAIL +
                             " AND " +
                             Contacts.ContactMethods.DATA + " = ?";
        final String[] args = new String[] {address};

        final Cursor c = mContentResolver.query(
                             Contacts.ContactMethods.CONTENT_URI,
                             PROJECTION,
                             where,
                             args,
                             SORT_ORDER);
        return c;
    }
}