Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 94c8761d authored by Yorke Lee's avatar Yorke Lee
Browse files

ContactsContract API changes 

* Make ContactCounts an interface
* Improve clarity of ContactCounts documentation
* Add PinnedPositions.undemote method, and hide the method name
constant that is only used for the internal implementation

Bug: 16403306

Change-Id: If8b5cad779293cb9a3b90e698b13481f79b2351f
parent 48b3fe6f

api/current.txt

+58 −8
Original line number Diff line number Diff line
@@ -24344,8 +24344,11 @@ package android.provider { 














  public static final class ContactsContract.CommonDataKinds.Callable implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    ctor public ContactsContract.CommonDataKinds.Callable();













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final android.net.Uri CONTENT_FILTER_URI;















    field public static final android.net.Uri CONTENT_URI;













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















  }





























  protected static abstract interface ContactsContract.CommonDataKinds.CommonColumns implements android.provider.ContactsContract.CommonDataKinds.BaseTypes {









@@ -24356,8 +24359,11 @@ package android.provider {



























  public static final class ContactsContract.CommonDataKinds.Contactables implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    ctor public ContactsContract.CommonDataKinds.Contactables();













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final android.net.Uri CONTENT_FILTER_URI;















    field public static final android.net.Uri CONTENT_URI;













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String VISIBLE_CONTACTS_ONLY = "visible_contacts_only";















  }























@@ -24365,12 +24371,15 @@ package android.provider {













    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);















    field public static final java.lang.String ADDRESS = "data1";













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final android.net.Uri CONTENT_FILTER_URI;















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/email_v2";















    field public static final android.net.Uri CONTENT_LOOKUP_URI;















    field public static final java.lang.String CONTENT_TYPE = "vnd.android.cursor.dir/email_v2";















    field public static final android.net.Uri CONTENT_URI;















    field public static final java.lang.String DISPLAY_NAME = "data4";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final int TYPE_HOME = 1; // 0x1















    field public static final int TYPE_MOBILE = 4; // 0x4















    field public static final int TYPE_OTHER = 3; // 0x3









@@ -24380,7 +24389,10 @@ package android.provider {













  public static final class ContactsContract.CommonDataKinds.Event implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static int getTypeResource(java.lang.Integer);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/contact_event";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String START_DATE = "data1";















    field public static final int TYPE_ANNIVERSARY = 1; // 0x1















    field public static final int TYPE_BIRTHDAY = 3; // 0x3









@@ -24388,13 +24400,19 @@ package android.provider {













  }





























  public static final class ContactsContract.CommonDataKinds.GroupMembership implements android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/group_membership";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String GROUP_ROW_ID = "data1";















    field public static final java.lang.String GROUP_SOURCE_ID = "group_sourceid";















  }





























  public static final class ContactsContract.CommonDataKinds.Identity implements android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/identity";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String IDENTITY = "data1";















    field public static final java.lang.String NAMESPACE = "data2";















  }









@@ -24404,8 +24422,11 @@ package android.provider {













    method public static final int getProtocolLabelResource(int);















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/im";















    field public static final java.lang.String CUSTOM_PROTOCOL = "data6";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String PROTOCOL = "data5";















    field public static final int PROTOCOL_AIM = 0; // 0x0















    field public static final int PROTOCOL_CUSTOM = -1; // 0xffffffff









@@ -24423,7 +24444,10 @@ package android.provider {













  }





























  public static final class ContactsContract.CommonDataKinds.Nickname implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/nickname";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String NAME = "data1";















    field public static final int TYPE_DEFAULT = 1; // 0x1















    field public static final int TYPE_INITIALS = 5; // 0x5









@@ -24434,16 +24458,22 @@ package android.provider {













  }





























  public static final class ContactsContract.CommonDataKinds.Note implements android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/note";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String NOTE = "data1";















  }





























  public static final class ContactsContract.CommonDataKinds.Organization implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String COMPANY = "data1";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/organization";















    field public static final java.lang.String DEPARTMENT = "data5";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String JOB_DESCRIPTION = "data6";















    field public static final java.lang.String OFFICE_LOCATION = "data9";















    field public static final java.lang.String PHONETIC_NAME = "data8";









@@ -24456,10 +24486,13 @@ package android.provider {













  public static final class ContactsContract.CommonDataKinds.Phone implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final android.net.Uri CONTENT_FILTER_URI;















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/phone_v2";















    field public static final java.lang.String CONTENT_TYPE = "vnd.android.cursor.dir/phone_v2";















    field public static final android.net.Uri CONTENT_URI;













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String NORMALIZED_NUMBER = "data4";















    field public static final java.lang.String NUMBER = "data1";















    field public static final java.lang.String SEARCH_DISPLAY_NAME_KEY = "search_display_name";










@@ -24487,7 +24520,10 @@ package android.provider {













  }





























  public static final class ContactsContract.CommonDataKinds.Photo implements android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/photo";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String PHOTO = "data15";















    field public static final java.lang.String PHOTO_FILE_ID = "data14";















  }









@@ -24495,7 +24531,10 @@ package android.provider {













  public static final class ContactsContract.CommonDataKinds.Relation implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/relation";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String NAME = "data1";















    field public static final int TYPE_ASSISTANT = 1; // 0x1















    field public static final int TYPE_BROTHER = 2; // 0x2









@@ -24516,7 +24555,10 @@ package android.provider {













  public static final class ContactsContract.CommonDataKinds.SipAddress implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/sip_address";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String SIP_ADDRESS = "data1";















    field public static final int TYPE_HOME = 1; // 0x1















    field public static final int TYPE_OTHER = 3; // 0x3









@@ -24524,8 +24566,11 @@ package android.provider {













  }





























  public static final class ContactsContract.CommonDataKinds.StructuredName implements android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/name";















    field public static final java.lang.String DISPLAY_NAME = "data1";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String FAMILY_NAME = "data3";















    field public static final java.lang.String FULL_NAME_STYLE = "data10";















    field public static final java.lang.String GIVEN_NAME = "data2";









@@ -24540,11 +24585,14 @@ package android.provider {













  public static final class ContactsContract.CommonDataKinds.StructuredPostal implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {















    method public static final java.lang.CharSequence getTypeLabel(android.content.res.Resources, int, java.lang.CharSequence);















    method public static final int getTypeLabelResource(int);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CITY = "data7";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/postal-address_v2";















    field public static final java.lang.String CONTENT_TYPE = "vnd.android.cursor.dir/postal-address_v2";















    field public static final android.net.Uri CONTENT_URI;















    field public static final java.lang.String COUNTRY = "data10";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String FORMATTED_ADDRESS = "data1";















    field public static final java.lang.String NEIGHBORHOOD = "data6";















    field public static final java.lang.String POBOX = "data5";









@@ -24557,7 +24605,10 @@ package android.provider {













  }





























  public static final class ContactsContract.CommonDataKinds.Website implements android.provider.ContactsContract.CommonDataKinds.CommonColumns android.provider.ContactsContract.DataColumnsWithJoins {













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/website";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final int TYPE_BLOG = 2; // 0x2















    field public static final int TYPE_FTP = 6; // 0x6















    field public static final int TYPE_HOME = 4; // 0x4









@@ -24568,13 +24619,6 @@ package android.provider {













    field public static final java.lang.String URL = "data1";















  }



























  public static final class ContactsContract.ContactCounts {













    ctor public ContactsContract.ContactCounts();













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";













  }



























  protected static abstract interface ContactsContract.ContactNameColumns {















    field public static final java.lang.String DISPLAY_NAME_ALTERNATIVE = "display_name_alt";















    field public static final java.lang.String DISPLAY_NAME_PRIMARY = "display_name";










@@ -24612,6 +24656,7 @@ package android.provider {













    method public static deprecated void markAsContacted(android.content.ContentResolver, long);















    method public static java.io.InputStream openContactPhotoInputStream(android.content.ContentResolver, android.net.Uri, boolean);















    method public static java.io.InputStream openContactPhotoInputStream(android.content.ContentResolver, android.net.Uri);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final android.net.Uri CONTENT_FILTER_URI;















    field public static final android.net.Uri CONTENT_FREQUENT_URI;















    field public static final android.net.Uri CONTENT_GROUP_URI;









@@ -24624,6 +24669,8 @@ package android.provider {













    field public static final android.net.Uri CONTENT_URI;















    field public static final java.lang.String CONTENT_VCARD_TYPE = "text/x-vcard";















    field public static final android.net.Uri CONTENT_VCARD_URI;













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















  }





























  public static final class ContactsContract.Contacts.AggregationSuggestions implements android.provider.BaseColumns android.provider.ContactsContract.ContactOptionsColumns android.provider.ContactsContract.ContactStatusColumns android.provider.ContactsContract.ContactsColumns {










@@ -24668,8 +24715,11 @@ package android.provider {



























  public static final class ContactsContract.Data implements android.provider.ContactsContract.DataColumnsWithJoins {















    method public static android.net.Uri getContactLookupUri(android.content.ContentResolver, android.net.Uri);













    field public static final java.lang.String ADDRESS_BOOK_INDEX_EXTRAS = "address_book_index_extras";















    field public static final java.lang.String CONTENT_TYPE = "vnd.android.cursor.dir/data";















    field public static final android.net.Uri CONTENT_URI;













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_COUNTS = "address_book_index_counts";













    field public static final java.lang.String EXTRA_ADDRESS_BOOK_INDEX_TITLES = "address_book_index_titles";















    field public static final java.lang.String VISIBLE_CONTACTS_ONLY = "visible_contacts_only";















  }
























@@ -24875,8 +24925,8 @@ package android.provider {



























  public static final class ContactsContract.PinnedPositions {















    ctor public ContactsContract.PinnedPositions();













    method public static void undemote(android.content.ContentResolver, long);















    field public static final int DEMOTED = -1; // 0xffffffff













    field public static final java.lang.String UNDEMOTE_METHOD = "undemote";















    field public static final int UNPINNED = 0; // 0x0















  }







































core/java/android/provider/ContactsContract.java



+56
−46


























File changed.
Preview size limit exceeded, changes collapsed.