diff --git a/core/api/current.txt b/core/api/current.txt index b944ac98bb79e..5a2b8bdd3c0a1 100644 --- a/core/api/current.txt +++ b/core/api/current.txt @@ -33998,8 +33998,8 @@ package android.provider { public static final class SimPhonebookContract.SimRecords { method @NonNull public static android.net.Uri getContentUri(int, int); - method @WorkerThread public static int getEncodedNameLength(@NonNull android.content.ContentResolver, @NonNull String); - method @NonNull public static android.net.Uri getItemUri(int, int, int); + method @IntRange(from=0) @WorkerThread public static int getEncodedNameLength(@NonNull android.content.ContentResolver, @NonNull String); + method @NonNull public static android.net.Uri getItemUri(int, int, @IntRange(from=1) int); field public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/sim-contact_v2"; field public static final String CONTENT_TYPE = "vnd.android.cursor.dir/sim-contact_v2"; field public static final String ELEMENTARY_FILE_TYPE = "elementary_file_type"; diff --git a/core/java/android/provider/SimPhonebookContract.java b/core/java/android/provider/SimPhonebookContract.java index 030b86339822c..fb89eb0385582 100644 --- a/core/java/android/provider/SimPhonebookContract.java +++ b/core/java/android/provider/SimPhonebookContract.java @@ -17,13 +17,14 @@ package android.provider; import static android.provider.SimPhonebookContract.ElementaryFiles.EF_ADN; -import static android.provider.SimPhonebookContract.ElementaryFiles.EF_ADN_PATH_SEGMENT; import static android.provider.SimPhonebookContract.ElementaryFiles.EF_FDN; -import static android.provider.SimPhonebookContract.ElementaryFiles.EF_FDN_PATH_SEGMENT; import static android.provider.SimPhonebookContract.ElementaryFiles.EF_SDN; -import static android.provider.SimPhonebookContract.ElementaryFiles.EF_SDN_PATH_SEGMENT; +import static android.provider.SimPhonebookContract.ElementaryFiles.PATH_SEGMENT_EF_ADN; +import static android.provider.SimPhonebookContract.ElementaryFiles.PATH_SEGMENT_EF_FDN; +import static android.provider.SimPhonebookContract.ElementaryFiles.PATH_SEGMENT_EF_SDN; import android.annotation.IntDef; +import android.annotation.IntRange; import android.annotation.NonNull; import android.annotation.SystemApi; import android.annotation.WorkerThread; @@ -78,11 +79,11 @@ public final class SimPhonebookContract { public static String getEfUriPath(@ElementaryFiles.EfType int efType) { switch (efType) { case EF_ADN: - return EF_ADN_PATH_SEGMENT; + return PATH_SEGMENT_EF_ADN; case EF_FDN: - return EF_FDN_PATH_SEGMENT; + return PATH_SEGMENT_EF_FDN; case EF_SDN: - return EF_SDN_PATH_SEGMENT; + return PATH_SEGMENT_EF_SDN; default: throw new IllegalArgumentException("Unsupported EfType " + efType); } @@ -109,9 +110,9 @@ public final class SimPhonebookContract { * the phone number can contain at most {@link ElementaryFiles#PHONE_NUMBER_MAX_LENGTH} * characters. The {@link SimRecords#NAME} column can contain at most * {@link ElementaryFiles#NAME_MAX_LENGTH} bytes when it is encoded for storage on the SIM. - * Encoding is done internally and so the name should be provided unencoded but the number of - * bytes required to encode it will vary depending on the characters it contains. This length - * can be determined by calling + * Encoding is done internally and so the name should be provided to these provider APIs as a + * Java String but the number of bytes required to encode it for storage will vary depending on + * the characters it contains. This length can be determined by calling * {@link SimRecords#getEncodedNameLength(ContentResolver, String)}. *
*