to top
Android APIs
public static final class

ContactsContract.RawContactsEntity

extends Object
implements BaseColumns ContactsContract.DataColumns ContactsContract.RawContactsColumns
java.lang.Object
   ↳ android.provider.ContactsContract.RawContactsEntity

Class Overview

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 _ID read-only Raw contact row ID. See ContactsContract.RawContacts.
long CONTACT_ID read-only See ContactsContract.RawContacts.
int AGGREGATION_MODE read-only See ContactsContract.RawContacts.
int DELETED read-only See ContactsContract.RawContacts.
Data
long DATA_ID read-only Data row ID. It will be null if the raw contact has no data rows.
String MIMETYPE read-only See ContactsContract.Data.
int IS_PRIMARY read-only See ContactsContract.Data.
int IS_SUPER_PRIMARY read-only See ContactsContract.Data.
int DATA_VERSION read-only See ContactsContract.Data.
Any type DATA1
DATA2
DATA3
DATA4
DATA5
DATA6
DATA7
DATA8
DATA9
DATA10
DATA11
DATA12
DATA13
DATA14
DATA15
read-only See ContactsContract.Data.
Any type SYNC1
SYNC2
SYNC3
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.
[Expand]
Inherited Constants
From interface android.provider.BaseColumns
From interface android.provider.ContactsContract.DataColumns
From interface android.provider.ContactsContract.RawContactsColumns
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.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String CONTENT_TYPE

Added in API level 5

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

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

public static final String DATA_ID

Added in API level 5

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

public static final Uri CONTENT_URI

Added in API level 5

The content:// style URI for this table

public static final Uri PROFILE_CONTENT_URI

Added in API level 14

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

No examples for this method.
Frequently called with: [Clear]
Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.