Added in API level 5

Summary: Constants | Inherited Constants | Fields | Inherited Methods

ContactsContract.RawContactsEntity

---

Kotlin |Java

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.

RawContacts
long	BaseColumns._ID	read-only	Raw contact row ID. See RawContacts.
long	ContactsContract.RawContactsColumns.CONTACT_ID	read-only	See RawContacts.
int	ContactsContract.RawContactsColumns.AGGREGATION_MODE	read-only	See RawContacts.
int	ContactsContract.RawContactsColumns.DELETED	read-only	See RawContacts.

Data
long	DATA_ID	read-only	Data row ID. It will be null if the raw contact has no data rows.
String	ContactsContract.DataColumns.MIMETYPE	read-only	See ContactsContract.Data.
int	ContactsContract.DataColumns.IS_PRIMARY	read-only	See ContactsContract.Data.
int	ContactsContract.DataColumns.IS_SUPER_PRIMARY	read-only	See ContactsContract.Data.
int	ContactsContract.DataColumns.DATA_VERSION	read-only	See ContactsContract.Data.
Any type	ContactsContract.DataColumns.DATA1 ContactsContract.DataColumns.DATA2 ContactsContract.DataColumns.DATA3 ContactsContract.DataColumns.DATA4 ContactsContract.DataColumns.DATA5 ContactsContract.DataColumns.DATA6 ContactsContract.DataColumns.DATA7 ContactsContract.DataColumns.DATA8 ContactsContract.DataColumns.DATA9 ContactsContract.DataColumns.DATA10 ContactsContract.DataColumns.DATA11 ContactsContract.DataColumns.DATA12 ContactsContract.DataColumns.DATA13 ContactsContract.DataColumns.DATA14 ContactsContract.DataColumns.DATA15	read-only	See ContactsContract.Data.
Any type	ContactsContract.DataColumns.SYNC1 ContactsContract.DataColumns.SYNC2 ContactsContract.DataColumns.SYNC3 ContactsContract.DataColumns.SYNC4	read-only	See ContactsContract.Data.

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
From interface android.provider.BaseColumns String _COUNT The count of rows in a directory. String _ID The unique ID for a row.
From interface android.provider.ContactsContract.DataColumns 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.
From interface android.provider.ContactsContract.RawContactsColumns 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

From class java.lang.Object 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.