/*

* Copyright (C) 2006 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 android.provider;

import com.android.internal.R;

import android.content.ContentResolver;

import android.content.ContentUris;

import android.content.ContentValues;

import android.content.Context;

import android.database.Cursor;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.net.Uri;

import android.text.TextUtils;

import android.util.Log;

import android.widget.ImageView;

import java.io.ByteArrayInputStream;

import java.io.InputStream;

/**

* The Contacts provider stores all information about contacts.

*

* @deprecated The APIs have been superseded by {@link ContactsContract}. The newer APIs allow

* access multiple accounts and support aggregation of similar contacts. These APIs continue to

* work but will only return data for the first Google account created, which matches the original

* behavior.

*/

@Deprecated

public class Contacts {

private static final String TAG = "Contacts";

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String AUTHORITY = "contacts";

/**

* The content:// style URL for this provider

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY);

/**

* Signifies an email address row that is stored in the ContactMethods table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int KIND_EMAIL = 1;

/**

* Signifies a postal address row that is stored in the ContactMethods table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int KIND_POSTAL = 2;

/**

* Signifies an IM address row that is stored in the ContactMethods table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int KIND_IM = 3;

/**

* Signifies an Organization row that is stored in the Organizations table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int KIND_ORGANIZATION = 4;

/**

* Signifies a Phone row that is stored in the Phones table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int KIND_PHONE = 5;

/**

* no public constructor since this is a utility class

*/

private Contacts() {}

/**

* Columns from the Settings table that other columns join into themselves.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public interface SettingsColumns {

/**

* The _SYNC_ACCOUNT to which this setting corresponds. This may be null.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String _SYNC_ACCOUNT = "_sync_account";

/**

* The _SYNC_ACCOUNT_TYPE to which this setting corresponds. This may be null.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String _SYNC_ACCOUNT_TYPE = "_sync_account_type";

/**

* The key of this setting.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String KEY = "key";

/**

* The value of this setting.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String VALUE = "value";

}

/**

* The settings over all of the people

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final class Settings implements BaseColumns, SettingsColumns {

/**

* no public constructor since this is a utility class

*/

private Settings() {}

/**

* The content:// style URL for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri CONTENT_URI =

Uri.parse("content://contacts/settings");

/**

* The directory twig for this sub-table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_DIRECTORY = "settings";

/**

* The default sort order for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DEFAULT_SORT_ORDER = "key ASC";

/**

* A setting that is used to indicate if we should sync down all groups for the

* specified account. For this setting the _SYNC_ACCOUNT column must be set.

* If this isn't set then we will only sync the groups whose SHOULD_SYNC column

* is set to true.

* <p>

* This is a boolean setting. It is true if it is set and it is anything other than the

* emptry string or "0".

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String SYNC_EVERYTHING = "syncEverything";

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static String getSetting(ContentResolver cr, String account, String key) {

// For now we only support a single account and the UI doesn't know what

// the account name is, so we're using a global setting for SYNC_EVERYTHING.

// Some day when we add multiple accounts to the UI this should honor the account

// that was asked for.

String selectString;

String[] selectArgs;

if (false) {

selectString = (account == null)

? "_sync_account is null AND key=?"

: "_sync_account=? AND key=?";

// : "_sync_account=? AND _sync_account_type=? AND key=?";

selectArgs = (account == null)

? new String[]{key}

: new String[]{account, key};

} else {

selectString = "key=?";

selectArgs = new String[] {key};

}

Cursor cursor = cr.query(Settings.CONTENT_URI, new String[]{VALUE},

selectString, selectArgs, null);

try {

if (!cursor.moveToNext()) return null;

return cursor.getString(0);

} finally {

cursor.close();

}

}

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static void setSetting(ContentResolver cr, String account, String key,

String value) {

ContentValues values = new ContentValues();

// For now we only support a single account and the UI doesn't know what

// the account name is, so we're using a global setting for SYNC_EVERYTHING.

// Some day when we add multiple accounts to the UI this should honor the account

// that was asked for.

//values.put(_SYNC_ACCOUNT, account.mName);

//values.put(_SYNC_ACCOUNT_TYPE, account.mType);

values.put(KEY, key);

values.put(VALUE, value);

cr.update(Settings.CONTENT_URI, values, null, null);

}

}

/**

* Columns from the People table that other tables join into themselves.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public interface PeopleColumns {

/**

* The person's name.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String NAME = "name";

/**

* Phonetic equivalent of the person's name, in a locale-dependent

* character set (e.g. hiragana for Japanese).

* Used for pronunciation and/or collation in some languages.

* <p>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String PHONETIC_NAME = "phonetic_name";

/**

* The display name. If name is not null name, else if number is not null number,

* else if email is not null email.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DISPLAY_NAME = "display_name";

/**

* The field for sorting list phonetically. The content of this field

* may not be human readable but phonetically sortable.

* <P>Type: TEXT</p>

* @hide Used only in Contacts application for now.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String SORT_STRING = "sort_string";

/**

* Notes about the person.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String NOTES = "notes";

/**

* The number of times a person has been contacted

* <P>Type: INTEGER</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String TIMES_CONTACTED = "times_contacted";

/**

* The last time a person was contacted.

* <P>Type: INTEGER</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String LAST_TIME_CONTACTED = "last_time_contacted";

/**

* A custom ringtone associated with a person. Not always present.

* <P>Type: TEXT (URI to the ringtone)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CUSTOM_RINGTONE = "custom_ringtone";

/**

* Whether the person should always be sent to voicemail. Not always

* present.

* <P>Type: INTEGER (0 for false, 1 for true)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String SEND_TO_VOICEMAIL = "send_to_voicemail";

/**

* Is the contact starred?

* <P>Type: INTEGER (boolean)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String STARRED = "starred";

/**

* The server version of the photo

* <P>Type: TEXT (the version number portion of the photo URI)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String PHOTO_VERSION = "photo_version";

}

/**

* This table contains people.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final class People implements BaseColumns, PeopleColumns,

PhonesColumns, PresenceColumns {

/**

* no public constructor since this is a utility class

* @deprecated see {@link android.provider.ContactsContract}

*/

private People() {}

/**

* The content:// style URL for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri CONTENT_URI =

Uri.parse("content://contacts/people");

/**

* The content:// style URL for filtering people by name. The filter

* argument should be passed as an additional path segment after this URI.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri CONTENT_FILTER_URI =

Uri.parse("content://contacts/people/filter");

/**

* The content:// style URL for the table that holds the deleted

* contacts.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri DELETED_CONTENT_URI =

Uri.parse("content://contacts/deleted_people");

/**

* The content:// style URL for filtering people that have a specific

* E-mail or IM address. The filter argument should be passed as an

* additional path segment after this URI. This matches any people with

* at least one E-mail or IM {@link ContactMethods} that match the

* filter.

*

* Not exposed because we expect significant changes in the contacts

* schema and do not want to have to support this.

* @hide

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri WITH_EMAIL_OR_IM_FILTER_URI =

Uri.parse("content://contacts/people/with_email_or_im_filter");

/**

* The MIME type of {@link #CONTENT_URI} providing a directory of

* people.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_TYPE = "vnd.android.cursor.dir/person";

/**

* The MIME type of a {@link #CONTENT_URI} subdirectory of a single

* person.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/person";

/**

* The default sort order for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DEFAULT_SORT_ORDER = People.NAME + " ASC";

/**

* The ID of the persons preferred phone number.

* <P>Type: INTEGER (foreign key to phones table on the _ID field)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String PRIMARY_PHONE_ID = "primary_phone";

/**

* The ID of the persons preferred email.

* <P>Type: INTEGER (foreign key to contact_methods table on the

* _ID field)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String PRIMARY_EMAIL_ID = "primary_email";

/**

* The ID of the persons preferred organization.

* <P>Type: INTEGER (foreign key to organizations table on the

* _ID field)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String PRIMARY_ORGANIZATION_ID = "primary_organization";

/**

* Mark a person as having been contacted.

*

* @param resolver the ContentResolver to use

* @param personId the person who was contacted

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static void markAsContacted(ContentResolver resolver, long personId) {

Uri uri = ContentUris.withAppendedId(CONTENT_URI, personId);

uri = Uri.withAppendedPath(uri, "update_contact_time");

ContentValues values = new ContentValues();

// There is a trigger in place that will update TIMES_CONTACTED when

// LAST_TIME_CONTACTED is modified.

values.put(LAST_TIME_CONTACTED, System.currentTimeMillis());

resolver.update(uri, values, null, null);

}

/**

* @hide Used in vCard parser code.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static long tryGetMyContactsGroupId(ContentResolver resolver) {

Cursor groupsCursor = resolver.query(Groups.CONTENT_URI, GROUPS_PROJECTION,

Groups.SYSTEM_ID + "='" + Groups.GROUP_MY_CONTACTS + "'", null, null);

if (groupsCursor != null) {

try {

if (groupsCursor.moveToFirst()) {

return groupsCursor.getLong(0);

}

} finally {

groupsCursor.close();

}

}

return 0;

}

/**

* Adds a person to the My Contacts group.

*

* @param resolver the resolver to use

* @param personId the person to add to the group

* @return the URI of the group membership row

* @throws IllegalStateException if the My Contacts group can't be found

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static Uri addToMyContactsGroup(ContentResolver resolver, long personId) {

long groupId = tryGetMyContactsGroupId(resolver);

if (groupId == 0) {

throw new IllegalStateException("Failed to find the My Contacts group");

}

return addToGroup(resolver, personId, groupId);

}

/**

* Adds a person to a group referred to by name.

*

* @param resolver the resolver to use

* @param personId the person to add to the group

* @param groupName the name of the group to add the contact to

* @return the URI of the group membership row

* @throws IllegalStateException if the group can't be found

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static Uri addToGroup(ContentResolver resolver, long personId, String groupName) {

long groupId = 0;

Cursor groupsCursor = resolver.query(Groups.CONTENT_URI, GROUPS_PROJECTION,

Groups.NAME + "=?", new String[] { groupName }, null);

if (groupsCursor != null) {

try {

if (groupsCursor.moveToFirst()) {

groupId = groupsCursor.getLong(0);

}

} finally {

groupsCursor.close();

}

}

if (groupId == 0) {

throw new IllegalStateException("Failed to find the My Contacts group");

}

return addToGroup(resolver, personId, groupId);

}

/**

* Adds a person to a group.

*

* @param resolver the resolver to use

* @param personId the person to add to the group

* @param groupId the group to add the person to

* @return the URI of the group membership row

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static Uri addToGroup(ContentResolver resolver, long personId, long groupId) {

ContentValues values = new ContentValues();

values.put(GroupMembership.PERSON_ID, personId);

values.put(GroupMembership.GROUP_ID, groupId);

return resolver.insert(GroupMembership.CONTENT_URI, values);

}

private static final String[] GROUPS_PROJECTION = new String[] {

Groups._ID,

};

/**

* Creates a new contacts and adds it to the "My Contacts" group.

*

* @param resolver the ContentResolver to use

* @param values the values to use when creating the contact

* @return the URI of the contact, or null if the operation fails

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static Uri createPersonInMyContactsGroup(ContentResolver resolver,

ContentValues values) {

Uri contactUri = resolver.insert(People.CONTENT_URI, values);

if (contactUri == null) {

Log.e(TAG, "Failed to create the contact");

return null;

}

if (addToMyContactsGroup(resolver, ContentUris.parseId(contactUri)) == null) {

resolver.delete(contactUri, null, null);

return null;

}

return contactUri;

}

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static Cursor queryGroups(ContentResolver resolver, long person) {

return resolver.query(GroupMembership.CONTENT_URI, null, "person=?",

new String[]{String.valueOf(person)}, Groups.DEFAULT_SORT_ORDER);

}

/**

* Set the photo for this person. data may be null

* @param cr the ContentResolver to use

* @param person the Uri of the person whose photo is to be updated

* @param data the byte[] that represents the photo

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static void setPhotoData(ContentResolver cr, Uri person, byte[] data) {

Uri photoUri = Uri.withAppendedPath(person, Contacts.Photos.CONTENT_DIRECTORY);

ContentValues values = new ContentValues();

values.put(Photos.DATA, data);

cr.update(photoUri, values, null, null);

}

/**

* Opens an InputStream for the person's photo and returns the photo as a Bitmap.

* If the person's photo isn't present returns the placeholderImageResource instead.

* @param person the person whose photo should be used

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static InputStream openContactPhotoInputStream(ContentResolver cr, Uri person) {

Uri photoUri = Uri.withAppendedPath(person, Contacts.Photos.CONTENT_DIRECTORY);

Cursor cursor = cr.query(photoUri, new String[]{Photos.DATA}, null, null, null);

try {

if (cursor == null || !cursor.moveToNext()) {

return null;

}

byte[] data = cursor.getBlob(0);

if (data == null) {

return null;

}

return new ByteArrayInputStream(data);

} finally {

if (cursor != null) cursor.close();

}

}

/**

* Opens an InputStream for the person's photo and returns the photo as a Bitmap.

* If the person's photo isn't present returns the placeholderImageResource instead.

* @param context the Context

* @param person the person whose photo should be used

* @param placeholderImageResource the image resource to use if the person doesn't

* have a photo

* @param options the decoding options, can be set to null

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static Bitmap loadContactPhoto(Context context, Uri person,

int placeholderImageResource, BitmapFactory.Options options) {

if (person == null) {

return loadPlaceholderPhoto(placeholderImageResource, context, options);

}

InputStream stream = openContactPhotoInputStream(context.getContentResolver(), person);

Bitmap bm = stream != null ? BitmapFactory.decodeStream(stream, null, options) : null;

if (bm == null) {

bm = loadPlaceholderPhoto(placeholderImageResource, context, options);

}

return bm;

}

private static Bitmap loadPlaceholderPhoto(int placeholderImageResource, Context context,

BitmapFactory.Options options) {

if (placeholderImageResource == 0) {

return null;

}

return BitmapFactory.decodeResource(context.getResources(),

placeholderImageResource, options);

}

/**

* A sub directory of a single person that contains all of their Phones.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final class Phones implements BaseColumns, PhonesColumns,

PeopleColumns {

/**

* no public constructor since this is a utility class

*/

private Phones() {}

/**

* The directory twig for this sub-table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_DIRECTORY = "phones";

/**

* The default sort order for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DEFAULT_SORT_ORDER = "number ASC";

}

/**

* A subdirectory of a single person that contains all of their

* ContactMethods.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final class ContactMethods

implements BaseColumns, ContactMethodsColumns, PeopleColumns {

/**

* no public constructor since this is a utility class

*/

private ContactMethods() {}

/**

* The directory twig for this sub-table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_DIRECTORY = "contact_methods";

/**

* The default sort order for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DEFAULT_SORT_ORDER = "data ASC";

}

/**

* The extensions for a person

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static class Extensions implements BaseColumns, ExtensionsColumns {

/**

* no public constructor since this is a utility class

* @deprecated see {@link android.provider.ContactsContract}

*/

private Extensions() {}

/**

* The directory twig for this sub-table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_DIRECTORY = "extensions";

/**

* The default sort order for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DEFAULT_SORT_ORDER = "name ASC";

/**

* The ID of the person this phone number is assigned to.

* <P>Type: INTEGER (long)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String PERSON_ID = "person";

}

}

/**

* Columns from the groups table.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public interface GroupsColumns {

/**

* The group name.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String NAME = "name";

/**

* Notes about the group.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String NOTES = "notes";

/**

* Whether this group should be synced if the SYNC_EVERYTHING settings is false

* for this group's account.

* <P>Type: INTEGER (boolean)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String SHOULD_SYNC = "should_sync";

/**

* The ID of this group if it is a System Group, null otherwise.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String SYSTEM_ID = "system_id";

}

/**

* This table contains the groups for an account.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final class Groups

implements BaseColumns, GroupsColumns {

/**

* no public constructor since this is a utility class

*/

private Groups() {}

/**

* The content:// style URL for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri CONTENT_URI =

Uri.parse("content://contacts/groups");

/**

* The content:// style URL for the table that holds the deleted

* groups.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri DELETED_CONTENT_URI =

Uri.parse("content://contacts/deleted_groups");

/**

* The MIME type of {@link #CONTENT_URI} providing a directory of

* groups.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_TYPE = "vnd.android.cursor.dir/contactsgroup";

/**

* The MIME type of a {@link #CONTENT_URI} subdirectory of a single

* group.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/contactsgroup";

/**

* The default sort order for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String DEFAULT_SORT_ORDER = NAME + " ASC";

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String GROUP_ANDROID_STARRED = "Starred in Android";

/**

* The "My Contacts" system group.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String GROUP_MY_CONTACTS = "Contacts";

}

/**

* Columns from the Phones table that other columns join into themselves.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public interface PhonesColumns {

/**

* The type of the the phone number.

* <P>Type: INTEGER (one of the constants below)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String TYPE = "type";

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_CUSTOM = 0;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_HOME = 1;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_MOBILE = 2;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_WORK = 3;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_FAX_WORK = 4;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_FAX_HOME = 5;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_PAGER = 6;

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final int TYPE_OTHER = 7;

/**

* The user provided label for the phone number, only used if TYPE is TYPE_CUSTOM.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String LABEL = "label";

/**

* The phone number as the user entered it.

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String NUMBER = "number";

/**

* The normalized phone number

* <P>Type: TEXT</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String NUMBER_KEY = "number_key";

/**

* Whether this is the primary phone number

* <P>Type: INTEGER (if set, non-0 means true)</P>

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final String ISPRIMARY = "isprimary";

}

/**

* This table stores phone numbers and a reference to the person that the

* contact method belongs to. Phone numbers are stored separately from

* other contact methods to make caller ID lookup more efficient.

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final class Phones

implements BaseColumns, PhonesColumns, PeopleColumns {

/**

* no public constructor since this is a utility class

*/

private Phones() {}

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final CharSequence getDisplayLabel(Context context, int type,

CharSequence label, CharSequence[] labelArray) {

CharSequence display = "";

if (type != People.Phones.TYPE_CUSTOM) {

CharSequence[] labels = labelArray != null? labelArray

: context.getResources().getTextArray(

com.android.internal.R.array.phoneTypes);

try {

display = labels[type - 1];

} catch (ArrayIndexOutOfBoundsException e) {

display = labels[People.Phones.TYPE_HOME - 1];

}

} else {

if (!TextUtils.isEmpty(label)) {

display = label;

}

}

return display;

}

/**

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final CharSequence getDisplayLabel(Context context, int type,

CharSequence label) {

return getDisplayLabel(context, type, label, null);

}

/**

* The content:// style URL for this table

* @deprecated see {@link android.provider.ContactsContract}

*/

@Deprecated

public static final Uri CONTENT_URI =

Uri.parse("content://contacts/phones");

/**

* The content:// style URL for filtering phone numbers

* @deprecated see {@link android.provider.ContactsContract}

*/