ContactsContract.RawContactsEntity


public static final class ContactsContract.RawContactsEntity
extends Object implements BaseColumns, ContactsContract.DataColumns, ContactsContract.RawContactsColumns

java.lang.Object
   ↳ android.provider.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. It is a strictly read-only table.

If a raw contact has data rows, the RawContactsEntity cursor will contain a one row for each data row. If the raw contact has no data rows, the cursor will still contain one row with the raw contact-level information and nulls for data columns.

 Uri entityUri = ContentUris.withAppendedId(RawContactsEntity.CONTENT_URI, rawContactId);
 Cursor c = getContentResolver().query(entityUri,
          new String[]{
              RawContactsEntity.SOURCE_ID,
              RawContactsEntity.DATA_ID,
              RawContactsEntity.MIMETYPE,
              RawContactsEntity.DATA1
          }, null, null, null);
 try {
     while (c.moveToNext()) {
         String sourceId = c.getString(0);
         if (!c.isNull(1)) {
             String mimeType = c.getString(2);
             String data = c.getString(3);
             ...
         }
     }
 } finally {
     c.close();
 }
 

Columns

RawContactsEntity has a combination of RawContact and Data columns.

Summary

Constants

String CONTENT_TYPE

The MIME type of CONTENT_URI providing a directory of raw contact entities.

String DATA_ID

The ID of the data column.

Inherited constants

String _COUNT

The count of rows in a directory.

String _ID

The unique ID for a row.

String CARRIER_PRESENCE

This constant was deprecated in API level 31. The contacts database will only show presence information on devices where CarrierConfigManager.KEY_USE_RCS_PRESENCE_BOOL is true, otherwise use RcsUceAdapter.

int CARRIER_PRESENCE_VT_CAPABLE

This constant was deprecated in API level 31. Same as DataColumns.CARRIER_PRESENCE.

String DATA1

Generic data column, the meaning is MIMETYPE specific

String DATA10

Generic data column, the meaning is MIMETYPE specific

String DATA11

Generic data column, the meaning is MIMETYPE specific

String DATA12

Generic data column, the meaning is MIMETYPE specific

String DATA13

Generic data column, the meaning is MIMETYPE specific

String DATA14

Generic data column, the meaning is MIMETYPE specific

String DATA15

Generic data column, the meaning is MIMETYPE specific.

String DATA2

Generic data column, the meaning is MIMETYPE specific

String DATA3

Generic data column, the meaning is MIMETYPE specific

String DATA4

Generic data column, the meaning is MIMETYPE specific

String DATA5

Generic data column, the meaning is MIMETYPE specific

String DATA6

Generic data column, the meaning is MIMETYPE specific

String DATA7

Generic data column, the meaning is MIMETYPE specific

String DATA8

Generic data column, the meaning is MIMETYPE specific

String DATA9

Generic data column, the meaning is MIMETYPE specific

String DATA_VERSION

The version of this data record.

String IS_PRIMARY

Whether this is the primary entry of its kind for the raw contact it belongs to.

String IS_READ_ONLY

The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter.

String IS_SUPER_PRIMARY

Whether this is the primary entry of its kind for the aggregate contact it belongs to.

String MIMETYPE

The MIME type of the item represented by this row.

String PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

The flattened ComponentName of a PhoneAccountHandle that is the preferred PhoneAccountHandle to call the contact with.

String PREFERRED_PHONE_ACCOUNT_ID

The ID of a PhoneAccountHandle that is the preferred PhoneAccountHandle to call the contact with.

String RAW_CONTACT_ID

A reference to the RawContacts._ID that this data belongs to.

String RES_PACKAGE

The package name to use when creating Resources objects for this data row.

String SYNC1

Generic column for use by sync adapters.

String SYNC2

Generic column for use by sync adapters.

String SYNC3

Generic column for use by sync adapters.

String SYNC4

Generic column for use by sync adapters.

String ACCOUNT_TYPE_AND_DATA_SET

A concatenation of the account type and data set (delimited by a forward slash) - if the data set is empty, this will be the same as the account type.

String AGGREGATION_MODE

The aggregation mode for this contact.

String BACKUP_ID

Persistent unique id for each raw_contact within its account.

String CONTACT_ID

A reference to the ContactsContract.Contacts._ID that this data belongs to.

String DATA_SET

The data set within the account that this row belongs to.

String DELETED

The "deleted" flag: "0" by default, "1" if the row has been marked for deletion.

String METADATA_DIRTY

This constant was deprecated in API level 30. This column never actually worked since added. It will not supported as of Android version Build.VERSION_CODES.R.

String RAW_CONTACT_IS_READ_ONLY

The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter.

String RAW_CONTACT_IS_USER_PROFILE

Flag that reflects whether this raw contact belongs to the user's personal profile entry.

Fields

public static final Uri CONTENT_URI

The content:// style URI for this table

public static final Uri PROFILE_CONTENT_URI

The content:// style URI for this table, specific to the user's profile.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

CONTENT_TYPE

Added in API level 5
public static final String CONTENT_TYPE

The MIME type of CONTENT_URI providing a directory of raw contact entities.

Constant Value: "vnd.android.cursor.dir/raw_contact_entity"

DATA_ID

Added in API level 5
public static final String DATA_ID

The ID of the data column. The value will be null if this raw contact has no data rows.

Type: INTEGER

Constant Value: "data_id"

Fields

CONTENT_URI

Added in API level 5
public static final Uri CONTENT_URI

The content:// style URI for this table

PROFILE_CONTENT_URI

Added in API level 14
public static final Uri PROFILE_CONTENT_URI

The content:// style URI for this table, specific to the user's profile.