FileDocCategorySizeDatePackage
VoiceContact.javaAPI DocAndroid 1.5 API11316Wed May 06 22:42:48 BST 2009com.android.voicedialer

VoiceContact

public class VoiceContact extends Object
This class represents a person who may be called via the VoiceDialer app. The person has a name and a list of phones (home, mobile, work, other).

Fields Summary
private static final String
TAG
public static final long
ID_UNDEFINED
Corresponding row doesn't exist.
public final String
mName
public final long
mPersonId
public final long
mPrimaryId
public final long
mHomeId
public final long
mMobileId
public final long
mWorkId
public final long
mOtherId
Constructors Summary
private VoiceContact(String name, long personId, long primaryId, long homeId, long mobileId, long workId, long otherId)
Constructor.

param
name person's name.
param
personId ID in person table.
param
primaryId primary ID in phone table.
param
homeId home ID in phone table.
param
mobileId mobile ID in phone table.
param
workId work ID in phone table.
param
otherId other ID in phone table.


                                                        
          
                   
        mName = name;
        mPersonId = personId;
        mPrimaryId = primaryId;
        mHomeId = homeId;
        mMobileId = mobileId;
        mWorkId = workId;
        mOtherId = otherId;
Methods Summary
public static java.util.ListgetVoiceContacts(android.app.Activity activity)

param
activity The VoiceDialerActivity instance.
return
List of {@link VoiceContact} from the contact list content provider.

        if (Config.LOGD) Log.d(TAG, "VoiceContact.getVoiceContacts");
        
        List<VoiceContact> contacts = new ArrayList<VoiceContact>();

        String[] phonesProjection = new String[] {
            Contacts.Phones._ID,
            Contacts.Phones.TYPE,
            Contacts.Phones.ISPRIMARY,
            // TODO: handle type != 0,1,2, and use LABEL
            Contacts.Phones.LABEL,
            Contacts.Phones.NAME,
            //Contacts.Phones.NUMBER,
            Contacts.Phones.PERSON_ID,
        };
        
        // table is sorted by name
        Cursor cursor = activity.getContentResolver().query(
                Contacts.Phones.CONTENT_URI, phonesProjection,
                "", null, Contacts.Phones.DEFAULT_SORT_ORDER);

        final int phoneIdColumn = cursor.getColumnIndexOrThrow(Contacts.Phones._ID);
        final int typeColumn = cursor.getColumnIndexOrThrow(Contacts.Phones.TYPE);
        final int isPrimaryColumn = cursor.getColumnIndexOrThrow(Contacts.Phones.ISPRIMARY);
        int labelColumn = cursor.getColumnIndexOrThrow(Contacts.Phones.LABEL);
        final int nameColumn = cursor.getColumnIndexOrThrow(Contacts.Phones.NAME);
        //final int numberColumn = cursor.getColumnIndexOrThrow(Contacts.Phones.NUMBER);
        final int personIdColumn = cursor.getColumnIndexOrThrow(Contacts.Phones.PERSON_ID);
        
        // pieces of next VoiceContact
        String name = null;
        long personId = ID_UNDEFINED;
        long primaryId = ID_UNDEFINED;
        long homeId = ID_UNDEFINED;
        long mobileId = ID_UNDEFINED;
        long workId = ID_UNDEFINED;
        long otherId = ID_UNDEFINED;

        // loop over phone table
        cursor.moveToFirst();
        while (cursor.moveToNext()) {
            long phoneIdAtCursor = cursor.getLong(phoneIdColumn);
            int typeAtCursor = cursor.getInt(typeColumn);
            long isPrimaryAtCursor = cursor.getLong(isPrimaryColumn);
            String labelAtCursor = cursor.getString(labelColumn);
            String nameAtCursor = cursor.getString(nameColumn);
            //String numberAtCursor = cursor.getString(numberColumn);
            long personIdAtCursor = cursor.getLong(personIdColumn);

            /*
            if (Config.LOGD) {
                Log.d(TAG, "phoneId=" + phoneIdAtCursor
                        + " type=" + typeAtCursor
                        + " isPrimary=" + isPrimaryAtCursor
                        + " label=" + labelAtCursor
                        + " name=" + nameAtCursor
                        //+ " number=" + numberAtCursor
                        + " personId=" + personIdAtCursor
                        );
            }
            */
            
            // encountered a new name, so generate current VoiceContact
            if (name != null && !name.equals(nameAtCursor)) {
                contacts.add(new VoiceContact(name, personId, primaryId,
                        homeId, mobileId, workId, otherId));
                name = null;
            }
            
            // start accumulating pieces for a new VoiceContact
            if (name == null) {
                name = nameAtCursor;
                personId = personIdAtCursor;
                primaryId = ID_UNDEFINED;
                homeId = ID_UNDEFINED;
                mobileId = ID_UNDEFINED;
                workId = ID_UNDEFINED;
                otherId = ID_UNDEFINED;
            }
            
            // if labeled, then patch to HOME/MOBILE/WORK/OTHER
            if (typeAtCursor == Contacts.Phones.TYPE_CUSTOM &&
                    labelAtCursor != null) {
                String label = labelAtCursor.toLowerCase();
                if (label.contains("home") || label.contains("house")) {
                    typeAtCursor = Contacts.Phones.TYPE_HOME;
                }
                else if (label.contains("mobile") || label.contains("cell")) {
                    typeAtCursor = Contacts.Phones.TYPE_MOBILE;
                }
                else if (label.contains("work") || label.contains("office")) {
                    typeAtCursor = Contacts.Phones.TYPE_WORK;
                }
                else if (label.contains("other")) {
                    typeAtCursor = Contacts.Phones.TYPE_OTHER;
                }
            }
            
            // save the home, mobile, or work phone id
            switch (typeAtCursor) {
                case Contacts.Phones.TYPE_HOME:
                    homeId = phoneIdAtCursor;
                    if (isPrimaryAtCursor != 0) {
                        primaryId = phoneIdAtCursor;
                    }
                    break;
                case Contacts.Phones.TYPE_MOBILE:
                    mobileId = phoneIdAtCursor;
                    if (isPrimaryAtCursor != 0) {
                        primaryId = phoneIdAtCursor;
                    }
                    break;
                case Contacts.Phones.TYPE_WORK:
                    workId = phoneIdAtCursor;
                    if (isPrimaryAtCursor != 0) {
                        primaryId = phoneIdAtCursor;
                    }
                    break;
                case Contacts.Phones.TYPE_OTHER:
                    otherId = phoneIdAtCursor;
                    if (isPrimaryAtCursor != 0) {
                        primaryId = phoneIdAtCursor;
                    }
                    break;
            }
        }
        
        // generate the last VoiceContact
        if (name != null) {
            contacts.add(new VoiceContact(name, personId, primaryId,
                            homeId, mobileId, workId, otherId));
        }
        
        // clean up cursor
        cursor.close();

        if (Config.LOGD) Log.d(TAG, "VoiceContact.getVoiceContacts " + contacts.size());
        
        return contacts;
public static java.util.ListgetVoiceContactsFromFile(java.io.File contactsFile)

param
contactsFile File containing a list of names, one per line.
return
a List of {@link VoiceContact} in a File.

        if (Config.LOGD) Log.d(TAG, "getVoiceContactsFromFile " + contactsFile);

        List<VoiceContact> contacts = new ArrayList<VoiceContact>();

        // read from a file
        BufferedReader br = null;
        try {
            br = new BufferedReader(new FileReader(contactsFile), 8192);
            String name;
            for (int id = 1; (name = br.readLine()) != null; id++) {
                contacts.add(new VoiceContact(name, id, ID_UNDEFINED,
                        ID_UNDEFINED, ID_UNDEFINED, ID_UNDEFINED, ID_UNDEFINED));
            }
        }
        catch (IOException e) {
            if (Config.LOGD) Log.d(TAG, "getVoiceContactsFromFile failed " + e);
        }
        finally {
            try {
                br.close();
            } catch (IOException e) {
                if (Config.LOGD) Log.d(TAG, "getVoiceContactsFromFile failed during close " + e);
            }
        }

        if (Config.LOGD) Log.d(TAG, "getVoiceContactsFromFile " + contacts.size());

        return contacts;
public inthashCode()

        final int LARGE_PRIME = 1610612741;
        int hash = 0;
        hash = LARGE_PRIME * (hash + (int)mPersonId);
        hash = LARGE_PRIME * (hash + (int)mPrimaryId);
        hash = LARGE_PRIME * (hash + (int)mHomeId);
        hash = LARGE_PRIME * (hash + (int)mMobileId);
        hash = LARGE_PRIME * (hash + (int)mWorkId);
        hash = LARGE_PRIME * (hash + (int)mOtherId);
        return mName.hashCode() + hash;
public static java.lang.StringredialNumber(android.app.Activity activity)

param
activity The VoiceDialerActivity instance.
return
String of last number dialed.

        Cursor cursor = activity.getContentResolver().query(
                CallLog.Calls.CONTENT_URI,
                new String[] { CallLog.Calls.NUMBER },
                CallLog.Calls.TYPE + "=" + CallLog.Calls.OUTGOING_TYPE,
                null,
                CallLog.Calls.DEFAULT_SORT_ORDER + " LIMIT 1");
        String number = null;
        if (cursor.getCount() >= 1) {
            cursor.moveToNext();
            int column = cursor.getColumnIndexOrThrow(CallLog.Calls.NUMBER);
            number = cursor.getString(column);
        }
        cursor.close();
        
        if (Config.LOGD) Log.d(TAG, "redialNumber " + number);
        
        return number;
public java.lang.StringtoString()

        return "mName=" + mName
                + " mPersonId=" + mPersonId
                + " mPrimaryId=" + mPrimaryId
                + " mHomeId=" + mHomeId
                + " mMobileId=" + mMobileId
                + " mWorkId=" + mWorkId
                + " mOtherId=" + mOtherId;