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.