ContactsContract

extends Object

java.lang.Object
↳	android.provider.ContactsContract

Class Overview

The contract between the contacts provider and applications. Contains definitions for the supported URIs and columns. These APIs supersede ContactsContract.Contacts.

Overview

ContactsContract defines an extensible database of contact-related information. Contact information is stored in a three-tier data model:

A row in the ContactsContract.Data table can store any kind of personal data, such as a phone number or email addresses. The set of data kinds that can be stored in this table is open-ended. There is a predefined set of common kinds, but any application can add its own data kinds.
A row in the ContactsContract.RawContacts table represents a set of data describing a person and associated with a single account (for example, one of the user's Gmail accounts).
A row in the ContactsContract.Contacts table represents an aggregate of one or more RawContacts presumably describing the same person. When data in or associated with the RawContacts table is changed, the affected aggregate contacts are updated as necessary.

Other tables include:

ContactsContract.Groups, which contains information about raw contact groups such as Gmail contact groups. The current API does not support the notion of groups spanning multiple accounts.
ContactsContract.StatusUpdates, which contains social status updates including IM availability.
ContactsContract.AggregationExceptions, which is used for manual aggregation and disaggregation of raw contacts
ContactsContract.Settings, which contains visibility and sync settings for accounts and groups.
ContactsContract.SyncState, which contains free-form data maintained on behalf of sync adapters
ContactsContract.PhoneLookup, which is used for quick caller-ID lookup

Summary

Nested Classes
class	ContactsContract.AggregationExceptions	Constants for the contact aggregation exceptions table, which contains aggregation rules overriding those used by automatic aggregation.
interface	ContactsContract.BaseSyncColumns	Generic columns for use by sync adapters.
class	ContactsContract.CommonDataKinds	Container for definitions of common data types stored in the `ContactsContract.Data` table.
interface	ContactsContract.ContactOptionsColumns	Columns of `ContactsContract.Contacts` that track the user's preferences for, or interactions with, the contact.
interface	ContactsContract.ContactStatusColumns
class	ContactsContract.Contacts	Constants for the contacts table, which contains a record per aggregate of raw contacts representing the same person.
interface	ContactsContract.ContactsColumns	Columns of `ContactsContract.Contacts` that refer to intrinsic properties of the contact, as opposed to the user-specified options found in `ContactsContract.ContactOptionsColumns`.
class	ContactsContract.Data	Constants for the data table, which contains data points tied to a raw contact.
interface	ContactsContract.DataColumns	Columns in the Data table.
interface	ContactsContract.DataColumnsWithJoins	Combines all columns returned by `ContactsContract.Data` table queries.
class	ContactsContract.Groups	Constants for the groups table.
interface	ContactsContract.GroupsColumns
class	ContactsContract.Intents	Contains helper classes used to create or manage `Intents` that involve contacts.
class	ContactsContract.PhoneLookup	A table that represents the result of looking up a phone number, for example for caller ID.
interface	ContactsContract.PhoneLookupColumns
class	ContactsContract.Presence	This class is deprecated. This old name was never meant to be made public. Do not use.
interface	ContactsContract.PresenceColumns	Additional data mixed in with `ContactsContract.ContactStatusColumns` to link back to specific `_ID` entries.
class	ContactsContract.QuickContact	Helper methods to display QuickContact dialogs that allow users to pivot on a specific `Contacts` entry.
class	ContactsContract.RawContacts	Constants for the raw contacts table, which contains one row of contact information for each person in each synced account.
interface	ContactsContract.RawContactsColumns
class	ContactsContract.RawContactsEntity	Constants for the raw contacts entities table, which can be thought of as an outer join of the raw_contacts table with the data table.
class	ContactsContract.Settings	Contacts-specific settings for various `Account`'s.
interface	ContactsContract.SettingsColumns
interface	ContactsContract.StatusColumns	Social status update columns.
class	ContactsContract.StatusUpdates	A status update is linked to a `ContactsContract.Data` row and captures the user's latest status update via the corresponding source, e.g.
interface	ContactsContract.SyncColumns	Columns that appear when each row of a table belongs to a specific account, including sync information that an account may need.
class	ContactsContract.SyncState	A table provided for sync adapters to use for storing private sync state data.

Constants
String	AUTHORITY	The authority for the contacts provider
Uri	AUTHORITY_URI	A content:// style uri to the authority for the contacts provider
String	CALLER_IS_SYNCADAPTER	An optional URI parameter for insert, update, or delete queries that allows the caller to specify that it is a sync adapter.

Public Constructors
	ContactsContract()

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Called before the object's memory is reclaimed by the VM.
final Class<? extends Object>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Constants

public static final String AUTHORITY

Since: API Level 5

The authority for the contacts provider

Constant Value: "com.android.contacts"

public static final Uri AUTHORITY_URI

Since: API Level 5

A content:// style uri to the authority for the contacts provider

public static final String CALLER_IS_SYNCADAPTER

Since: API Level 5

An optional URI parameter for insert, update, or delete queries that allows the caller to specify that it is a sync adapter. The default value is false. If true DIRTY is not automatically set and the "syncToNetwork" parameter is set to false when calling notifyChange(android.net.Uri, android.database.ContentObserver, boolean). This prevents an unnecessary extra synchronization, see the discussion of the delete operation in ContactsContract.RawContacts.

Constant Value: "caller_is_syncadapter"

Public Constructors

public ContactsContract ()

Since: API Level 5

Interfaces

Classes

Exceptions

ContactsContract

Class Overview

Overview

Summary

Constants

public static final String AUTHORITY

public static final Uri AUTHORITY_URI

public static final String CALLER_IS_SYNCADAPTER

Public Constructors

public ContactsContract ()