diff options
Diffstat (limited to 'telephony/java/android/provider/Telephony.java')
| -rw-r--r-- | telephony/java/android/provider/Telephony.java | 3470 |
1 files changed, 3470 insertions, 0 deletions
diff --git a/telephony/java/android/provider/Telephony.java b/telephony/java/android/provider/Telephony.java new file mode 100644 index 000000000000..cb87d1fb1d56 --- /dev/null +++ b/telephony/java/android/provider/Telephony.java @@ -0,0 +1,3470 @@ +/* + * Copyright (C) 2006 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package android.provider; + +import android.annotation.SdkConstant; +import android.annotation.SdkConstant.SdkConstantType; +import android.annotation.TestApi; +import android.app.job.JobService; +import android.content.ComponentName; +import android.content.ContentResolver; +import android.content.ContentValues; +import android.content.Context; +import android.content.Intent; +import android.database.Cursor; +import android.database.ContentObserver; +import android.database.sqlite.SqliteWrapper; +import android.net.Uri; +import android.telephony.Rlog; +import android.telephony.ServiceState; +import android.telephony.SmsMessage; +import android.telephony.SubscriptionManager; +import android.telephony.TelephonyManager; +import android.text.TextUtils; +import android.util.Patterns; + +import com.android.internal.telephony.PhoneConstants; +import com.android.internal.telephony.SmsApplication; + + +import java.util.HashSet; +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +/** + * The Telephony provider contains data related to phone operation, specifically SMS and MMS + * messages, access to the APN list, including the MMSC to use, and the service state. + * + * <p class="note"><strong>Note:</strong> These APIs are not available on all Android-powered + * devices. If your app depends on telephony features such as for managing SMS messages, include + * a <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code <uses-feature>} + * </a> element in your manifest that declares the {@code "android.hardware.telephony"} hardware + * feature. Alternatively, you can check for telephony availability at runtime using either + * {@link android.content.pm.PackageManager#hasSystemFeature + * hasSystemFeature(PackageManager.FEATURE_TELEPHONY)} or {@link + * android.telephony.TelephonyManager#getPhoneType}.</p> + * + * <h3>Creating an SMS app</h3> + * + * <p>Only the default SMS app (selected by the user in system settings) is able to write to the + * SMS Provider (the tables defined within the {@code Telephony} class) and only the default SMS + * app receives the {@link android.provider.Telephony.Sms.Intents#SMS_DELIVER_ACTION} broadcast + * when the user receives an SMS or the {@link + * android.provider.Telephony.Sms.Intents#WAP_PUSH_DELIVER_ACTION} broadcast when the user + * receives an MMS.</p> + * + * <p>Any app that wants to behave as the user's default SMS app must handle the following intents: + * <ul> + * <li>In a broadcast receiver, include an intent filter for {@link Sms.Intents#SMS_DELIVER_ACTION} + * (<code>"android.provider.Telephony.SMS_DELIVER"</code>). The broadcast receiver must also + * require the {@link android.Manifest.permission#BROADCAST_SMS} permission. + * <p>This allows your app to directly receive incoming SMS messages.</p></li> + * <li>In a broadcast receiver, include an intent filter for {@link + * Sms.Intents#WAP_PUSH_DELIVER_ACTION}} ({@code "android.provider.Telephony.WAP_PUSH_DELIVER"}) + * with the MIME type <code>"application/vnd.wap.mms-message"</code>. + * The broadcast receiver must also require the {@link + * android.Manifest.permission#BROADCAST_WAP_PUSH} permission. + * <p>This allows your app to directly receive incoming MMS messages.</p></li> + * <li>In your activity that delivers new messages, include an intent filter for + * {@link android.content.Intent#ACTION_SENDTO} (<code>"android.intent.action.SENDTO" + * </code>) with schemas, <code>sms:</code>, <code>smsto:</code>, <code>mms:</code>, and + * <code>mmsto:</code>. + * <p>This allows your app to receive intents from other apps that want to deliver a + * message.</p></li> + * <li>In a service, include an intent filter for {@link + * android.telephony.TelephonyManager#ACTION_RESPOND_VIA_MESSAGE} + * (<code>"android.intent.action.RESPOND_VIA_MESSAGE"</code>) with schemas, + * <code>sms:</code>, <code>smsto:</code>, <code>mms:</code>, and <code>mmsto:</code>. + * This service must also require the {@link + * android.Manifest.permission#SEND_RESPOND_VIA_MESSAGE} permission. + * <p>This allows users to respond to incoming phone calls with an immediate text message + * using your app.</p></li> + * </ul> + * + * <p>Other apps that are not selected as the default SMS app can only <em>read</em> the SMS + * Provider, but may also be notified when a new SMS arrives by listening for the {@link + * Sms.Intents#SMS_RECEIVED_ACTION} + * broadcast, which is a non-abortable broadcast that may be delivered to multiple apps. This + * broadcast is intended for apps that—while not selected as the default SMS app—need to + * read special incoming messages such as to perform phone number verification.</p> + * + * <p>For more information about building SMS apps, read the blog post, <a + * href="http://android-developers.blogspot.com/2013/10/getting-your-sms-apps-ready-for-kitkat.html" + * >Getting Your SMS Apps Ready for KitKat</a>.</p> + * + */ +public final class Telephony { + private static final String TAG = "Telephony"; + + /** + * Not instantiable. + * @hide + */ + private Telephony() { + } + + /** + * Base columns for tables that contain text-based SMSs. + */ + public interface TextBasedSmsColumns { + + /** Message type: all messages. */ + public static final int MESSAGE_TYPE_ALL = 0; + + /** Message type: inbox. */ + public static final int MESSAGE_TYPE_INBOX = 1; + + /** Message type: sent messages. */ + public static final int MESSAGE_TYPE_SENT = 2; + + /** Message type: drafts. */ + public static final int MESSAGE_TYPE_DRAFT = 3; + + /** Message type: outbox. */ + public static final int MESSAGE_TYPE_OUTBOX = 4; + + /** Message type: failed outgoing message. */ + public static final int MESSAGE_TYPE_FAILED = 5; + + /** Message type: queued to send later. */ + public static final int MESSAGE_TYPE_QUEUED = 6; + + /** + * The type of message. + * <P>Type: INTEGER</P> + */ + public static final String TYPE = "type"; + + /** + * The thread ID of the message. + * <P>Type: INTEGER</P> + */ + public static final String THREAD_ID = "thread_id"; + + /** + * The address of the other party. + * <P>Type: TEXT</P> + */ + public static final String ADDRESS = "address"; + + /** + * The date the message was received. + * <P>Type: INTEGER (long)</P> + */ + public static final String DATE = "date"; + + /** + * The date the message was sent. + * <P>Type: INTEGER (long)</P> + */ + public static final String DATE_SENT = "date_sent"; + + /** + * Has the message been read? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String READ = "read"; + + /** + * Has the message been seen by the user? The "seen" flag determines + * whether we need to show a notification. + * <P>Type: INTEGER (boolean)</P> + */ + public static final String SEEN = "seen"; + + /** + * {@code TP-Status} value for the message, or -1 if no status has been received. + * <P>Type: INTEGER</P> + */ + public static final String STATUS = "status"; + + /** TP-Status: no status received. */ + public static final int STATUS_NONE = -1; + /** TP-Status: complete. */ + public static final int STATUS_COMPLETE = 0; + /** TP-Status: pending. */ + public static final int STATUS_PENDING = 32; + /** TP-Status: failed. */ + public static final int STATUS_FAILED = 64; + + /** + * The subject of the message, if present. + * <P>Type: TEXT</P> + */ + public static final String SUBJECT = "subject"; + + /** + * The body of the message. + * <P>Type: TEXT</P> + */ + public static final String BODY = "body"; + + /** + * The ID of the sender of the conversation, if present. + * <P>Type: INTEGER (reference to item in {@code content://contacts/people})</P> + */ + public static final String PERSON = "person"; + + /** + * The protocol identifier code. + * <P>Type: INTEGER</P> + */ + public static final String PROTOCOL = "protocol"; + + /** + * Is the {@code TP-Reply-Path} flag set? + * <P>Type: BOOLEAN</P> + */ + public static final String REPLY_PATH_PRESENT = "reply_path_present"; + + /** + * The service center (SC) through which to send the message, if present. + * <P>Type: TEXT</P> + */ + public static final String SERVICE_CENTER = "service_center"; + + /** + * Is the message locked? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String LOCKED = "locked"; + + /** + * The subscription to which the message belongs to. Its value will be + * < 0 if the sub id cannot be determined. + * <p>Type: INTEGER (long) </p> + */ + public static final String SUBSCRIPTION_ID = "sub_id"; + + /** + * The MTU size of the mobile interface to which the APN connected + * @hide + */ + public static final String MTU = "mtu"; + + /** + * Error code associated with sending or receiving this message + * <P>Type: INTEGER</P> + */ + public static final String ERROR_CODE = "error_code"; + + /** + * The identity of the sender of a sent message. It is + * usually the package name of the app which sends the message. + * <p class="note"><strong>Note:</strong> + * This column is read-only. It is set by the provider and can not be changed by apps. + * <p>Type: TEXT</p> + */ + public static final String CREATOR = "creator"; + } + + /** + * Contains all text-based SMS messages. + */ + public static final class Sms implements BaseColumns, TextBasedSmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Sms() { + } + + /** + * Used to determine the currently configured default SMS package. + * @param context context of the requesting application + * @return package name for the default SMS package or null + */ + public static String getDefaultSmsPackage(Context context) { + ComponentName component = SmsApplication.getDefaultSmsApplication(context, false); + if (component != null) { + return component.getPackageName(); + } + return null; + } + + /** + * Return cursor for table query. + * @hide + */ + public static Cursor query(ContentResolver cr, String[] projection) { + return cr.query(CONTENT_URI, projection, null, null, DEFAULT_SORT_ORDER); + } + + /** + * Return cursor for table query. + * @hide + */ + public static Cursor query(ContentResolver cr, String[] projection, + String where, String orderBy) { + return cr.query(CONTENT_URI, projection, where, + null, orderBy == null ? DEFAULT_SORT_ORDER : orderBy); + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://sms"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + + /** + * Add an SMS to the given URI. + * + * @param resolver the content resolver to use + * @param uri the URI to add the message to + * @param address the address of the sender + * @param body the body of the message + * @param subject the pseudo-subject of the message + * @param date the timestamp for the message + * @param read true if the message has been read, false if not + * @param deliveryReport true if a delivery report was requested, false if not + * @return the URI for the new message + * @hide + */ + public static Uri addMessageToUri(ContentResolver resolver, + Uri uri, String address, String body, String subject, + Long date, boolean read, boolean deliveryReport) { + return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), + resolver, uri, address, body, subject, date, read, deliveryReport, -1L); + } + + /** + * Add an SMS to the given URI. + * + * @param resolver the content resolver to use + * @param uri the URI to add the message to + * @param address the address of the sender + * @param body the body of the message + * @param subject the psuedo-subject of the message + * @param date the timestamp for the message + * @param read true if the message has been read, false if not + * @param deliveryReport true if a delivery report was requested, false if not + * @param subId the subscription which the message belongs to + * @return the URI for the new message + * @hide + */ + public static Uri addMessageToUri(int subId, ContentResolver resolver, + Uri uri, String address, String body, String subject, + Long date, boolean read, boolean deliveryReport) { + return addMessageToUri(subId, resolver, uri, address, body, subject, + date, read, deliveryReport, -1L); + } + + /** + * Add an SMS to the given URI with the specified thread ID. + * + * @param resolver the content resolver to use + * @param uri the URI to add the message to + * @param address the address of the sender + * @param body the body of the message + * @param subject the pseudo-subject of the message + * @param date the timestamp for the message + * @param read true if the message has been read, false if not + * @param deliveryReport true if a delivery report was requested, false if not + * @param threadId the thread_id of the message + * @return the URI for the new message + * @hide + */ + public static Uri addMessageToUri(ContentResolver resolver, + Uri uri, String address, String body, String subject, + Long date, boolean read, boolean deliveryReport, long threadId) { + return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), + resolver, uri, address, body, subject, + date, read, deliveryReport, threadId); + } + + /** + * Add an SMS to the given URI with thread_id specified. + * + * @param resolver the content resolver to use + * @param uri the URI to add the message to + * @param address the address of the sender + * @param body the body of the message + * @param subject the psuedo-subject of the message + * @param date the timestamp for the message + * @param read true if the message has been read, false if not + * @param deliveryReport true if a delivery report was requested, false if not + * @param threadId the thread_id of the message + * @param subId the subscription which the message belongs to + * @return the URI for the new message + * @hide + */ + public static Uri addMessageToUri(int subId, ContentResolver resolver, + Uri uri, String address, String body, String subject, + Long date, boolean read, boolean deliveryReport, long threadId) { + ContentValues values = new ContentValues(8); + Rlog.v(TAG,"Telephony addMessageToUri sub id: " + subId); + + values.put(SUBSCRIPTION_ID, subId); + values.put(ADDRESS, address); + if (date != null) { + values.put(DATE, date); + } + values.put(READ, read ? Integer.valueOf(1) : Integer.valueOf(0)); + values.put(SUBJECT, subject); + values.put(BODY, body); + if (deliveryReport) { + values.put(STATUS, STATUS_PENDING); + } + if (threadId != -1L) { + values.put(THREAD_ID, threadId); + } + return resolver.insert(uri, values); + } + + /** + * Move a message to the given folder. + * + * @param context the context to use + * @param uri the message to move + * @param folder the folder to move to + * @return true if the operation succeeded + * @hide + */ + public static boolean moveMessageToFolder(Context context, + Uri uri, int folder, int error) { + if (uri == null) { + return false; + } + + boolean markAsUnread = false; + boolean markAsRead = false; + switch(folder) { + case MESSAGE_TYPE_INBOX: + case MESSAGE_TYPE_DRAFT: + break; + case MESSAGE_TYPE_OUTBOX: + case MESSAGE_TYPE_SENT: + markAsRead = true; + break; + case MESSAGE_TYPE_FAILED: + case MESSAGE_TYPE_QUEUED: + markAsUnread = true; + break; + default: + return false; + } + + ContentValues values = new ContentValues(3); + + values.put(TYPE, folder); + if (markAsUnread) { + values.put(READ, 0); + } else if (markAsRead) { + values.put(READ, 1); + } + values.put(ERROR_CODE, error); + + return 1 == SqliteWrapper.update(context, context.getContentResolver(), + uri, values, null, null); + } + + /** + * Returns true iff the folder (message type) identifies an + * outgoing message. + * @hide + */ + public static boolean isOutgoingFolder(int messageType) { + return (messageType == MESSAGE_TYPE_FAILED) + || (messageType == MESSAGE_TYPE_OUTBOX) + || (messageType == MESSAGE_TYPE_SENT) + || (messageType == MESSAGE_TYPE_QUEUED); + } + + /** + * Contains all text-based SMS messages in the SMS app inbox. + */ + public static final class Inbox implements BaseColumns, TextBasedSmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Inbox() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://sms/inbox"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + + /** + * Add an SMS to the Draft box. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the pseudo-subject of the message + * @param date the timestamp for the message + * @param read true if the message has been read, false if not + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(ContentResolver resolver, + String address, String body, String subject, Long date, + boolean read) { + return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), + resolver, CONTENT_URI, address, body, subject, date, read, false); + } + + /** + * Add an SMS to the Draft box. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the psuedo-subject of the message + * @param date the timestamp for the message + * @param read true if the message has been read, false if not + * @param subId the subscription which the message belongs to + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(int subId, ContentResolver resolver, + String address, String body, String subject, Long date, boolean read) { + return addMessageToUri(subId, resolver, CONTENT_URI, address, body, + subject, date, read, false); + } + } + + /** + * Contains all sent text-based SMS messages in the SMS app. + */ + public static final class Sent implements BaseColumns, TextBasedSmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Sent() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://sms/sent"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + + /** + * Add an SMS to the Draft box. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the pseudo-subject of the message + * @param date the timestamp for the message + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(ContentResolver resolver, + String address, String body, String subject, Long date) { + return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), + resolver, CONTENT_URI, address, body, subject, date, true, false); + } + + /** + * Add an SMS to the Draft box. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the psuedo-subject of the message + * @param date the timestamp for the message + * @param subId the subscription which the message belongs to + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(int subId, ContentResolver resolver, + String address, String body, String subject, Long date) { + return addMessageToUri(subId, resolver, CONTENT_URI, address, body, + subject, date, true, false); + } + } + + /** + * Contains all sent text-based SMS messages in the SMS app. + */ + public static final class Draft implements BaseColumns, TextBasedSmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Draft() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://sms/draft"); + + /** + * @hide + */ + public static Uri addMessage(ContentResolver resolver, + String address, String body, String subject, Long date) { + return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), + resolver, CONTENT_URI, address, body, subject, date, true, false); + } + + /** + * Add an SMS to the Draft box. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the psuedo-subject of the message + * @param date the timestamp for the message + * @param subId the subscription which the message belongs to + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(int subId, ContentResolver resolver, + String address, String body, String subject, Long date) { + return addMessageToUri(subId, resolver, CONTENT_URI, address, body, + subject, date, true, false); + } + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + } + + /** + * Contains all pending outgoing text-based SMS messages. + */ + public static final class Outbox implements BaseColumns, TextBasedSmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Outbox() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://sms/outbox"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + + /** + * Add an SMS to the outbox. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the pseudo-subject of the message + * @param date the timestamp for the message + * @param deliveryReport whether a delivery report was requested for the message + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(ContentResolver resolver, + String address, String body, String subject, Long date, + boolean deliveryReport, long threadId) { + return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), + resolver, CONTENT_URI, address, body, subject, date, + true, deliveryReport, threadId); + } + + /** + * Add an SMS to the Out box. + * + * @param resolver the content resolver to use + * @param address the address of the sender + * @param body the body of the message + * @param subject the psuedo-subject of the message + * @param date the timestamp for the message + * @param deliveryReport whether a delivery report was requested for the message + * @param subId the subscription which the message belongs to + * @return the URI for the new message + * @hide + */ + public static Uri addMessage(int subId, ContentResolver resolver, + String address, String body, String subject, Long date, + boolean deliveryReport, long threadId) { + return addMessageToUri(subId, resolver, CONTENT_URI, address, body, + subject, date, true, deliveryReport, threadId); + } + } + + /** + * Contains all sent text-based SMS messages in the SMS app. + */ + public static final class Conversations + implements BaseColumns, TextBasedSmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Conversations() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://sms/conversations"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + + /** + * The first 45 characters of the body of the message. + * <P>Type: TEXT</P> + */ + public static final String SNIPPET = "snippet"; + + /** + * The number of messages in the conversation. + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_COUNT = "msg_count"; + } + + /** + * Contains constants for SMS related Intents that are broadcast. + */ + public static final class Intents { + + /** + * Not instantiable. + * @hide + */ + private Intents() { + } + + /** + * Set by BroadcastReceiver to indicate that the message was handled + * successfully. + */ + public static final int RESULT_SMS_HANDLED = 1; + + /** + * Set by BroadcastReceiver to indicate a generic error while + * processing the message. + */ + public static final int RESULT_SMS_GENERIC_ERROR = 2; + + /** + * Set by BroadcastReceiver to indicate insufficient memory to store + * the message. + */ + public static final int RESULT_SMS_OUT_OF_MEMORY = 3; + + /** + * Set by BroadcastReceiver to indicate that the message, while + * possibly valid, is of a format or encoding that is not + * supported. + */ + public static final int RESULT_SMS_UNSUPPORTED = 4; + + /** + * Set by BroadcastReceiver to indicate a duplicate incoming message. + */ + public static final int RESULT_SMS_DUPLICATED = 5; + + /** + * Activity action: Ask the user to change the default + * SMS application. This will show a dialog that asks the + * user whether they want to replace the current default + * SMS application with the one specified in + * {@link #EXTRA_PACKAGE_NAME}. + */ + @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) + public static final String ACTION_CHANGE_DEFAULT = + "android.provider.Telephony.ACTION_CHANGE_DEFAULT"; + + /** + * The PackageName string passed in as an + * extra for {@link #ACTION_CHANGE_DEFAULT} + * + * @see #ACTION_CHANGE_DEFAULT + */ + public static final String EXTRA_PACKAGE_NAME = "package"; + + /** + * Broadcast Action: A new text-based SMS message has been received + * by the device. This intent will only be delivered to the default + * sms app. That app is responsible for writing the message and notifying + * the user. The intent will have the following extra values:</p> + * + * <ul> + * <li><em>"pdus"</em> - An Object[] of byte[]s containing the PDUs + * that make up the message.</li> + * <li><em>"format"</em> - A String describing the format of the PDUs. It can + * be either "3gpp" or "3gpp2".</li> + * <li><em>"subscription"</em> - An optional long value of the subscription id which + * received the message.</li> + * <li><em>"slot"</em> - An optional int value of the SIM slot containing the + * subscription.</li> + * <li><em>"phone"</em> - An optional int value of the phone id associated with the + * subscription.</li> + * <li><em>"errorCode"</em> - An optional int error code associated with receiving + * the message.</li> + * </ul> + * + * <p>The extra values can be extracted using + * {@link #getMessagesFromIntent(Intent)}.</p> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p class="note"><strong>Note:</strong> + * The broadcast receiver that filters for this intent must declare + * {@link android.Manifest.permission#BROADCAST_SMS} as a required permission in + * the <a href="{@docRoot}guide/topics/manifest/receiver-element.html">{@code + * <receiver>}</a> tag. + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SMS_DELIVER_ACTION = + "android.provider.Telephony.SMS_DELIVER"; + + /** + * Broadcast Action: A new text-based SMS message has been received + * by the device. This intent will be delivered to all registered + * receivers as a notification. These apps are not expected to write the + * message or notify the user. The intent will have the following extra + * values:</p> + * + * <ul> + * <li><em>"pdus"</em> - An Object[] of byte[]s containing the PDUs + * that make up the message.</li> + * </ul> + * + * <p>The extra values can be extracted using + * {@link #getMessagesFromIntent(Intent)}.</p> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SMS_RECEIVED_ACTION = + "android.provider.Telephony.SMS_RECEIVED"; + + /** + * Broadcast Action: A new data based SMS message has been received + * by the device. This intent will be delivered to all registered + * receivers as a notification. The intent will have the following extra + * values:</p> + * + * <ul> + * <li><em>"pdus"</em> - An Object[] of byte[]s containing the PDUs + * that make up the message.</li> + * </ul> + * + * <p>The extra values can be extracted using + * {@link #getMessagesFromIntent(Intent)}.</p> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String DATA_SMS_RECEIVED_ACTION = + "android.intent.action.DATA_SMS_RECEIVED"; + + /** + * Broadcast Action: A new WAP PUSH message has been received by the + * device. This intent will only be delivered to the default + * sms app. That app is responsible for writing the message and notifying + * the user. The intent will have the following extra values:</p> + * + * <ul> + * <li><em>"transactionId"</em> - (Integer) The WAP transaction ID</li> + * <li><em>"pduType"</em> - (Integer) The WAP PDU type</li> + * <li><em>"header"</em> - (byte[]) The header of the message</li> + * <li><em>"data"</em> - (byte[]) The data payload of the message</li> + * <li><em>"contentTypeParameters" </em> + * -(HashMap<String,String>) Any parameters associated with the content type + * (decoded from the WSP Content-Type header)</li> + * <li><em>"subscription"</em> - An optional long value of the subscription id which + * received the message.</li> + * <li><em>"slot"</em> - An optional int value of the SIM slot containing the + * subscription.</li> + * <li><em>"phone"</em> - An optional int value of the phone id associated with the + * subscription.</li> + * </ul> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>The contentTypeParameters extra value is map of content parameters keyed by + * their names.</p> + * + * <p>If any unassigned well-known parameters are encountered, the key of the map will + * be 'unassigned/0x...', where '...' is the hex value of the unassigned parameter. If + * a parameter has No-Value the value in the map will be null.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_MMS} or + * {@link android.Manifest.permission#RECEIVE_WAP_PUSH} (depending on WAP PUSH type) to + * receive.</p> + * + * <p class="note"><strong>Note:</strong> + * The broadcast receiver that filters for this intent must declare + * {@link android.Manifest.permission#BROADCAST_WAP_PUSH} as a required permission in + * the <a href="{@docRoot}guide/topics/manifest/receiver-element.html">{@code + * <receiver>}</a> tag. + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String WAP_PUSH_DELIVER_ACTION = + "android.provider.Telephony.WAP_PUSH_DELIVER"; + + /** + * Broadcast Action: A new WAP PUSH message has been received by the + * device. This intent will be delivered to all registered + * receivers as a notification. These apps are not expected to write the + * message or notify the user. The intent will have the following extra + * values:</p> + * + * <ul> + * <li><em>"transactionId"</em> - (Integer) The WAP transaction ID</li> + * <li><em>"pduType"</em> - (Integer) The WAP PDU type</li> + * <li><em>"header"</em> - (byte[]) The header of the message</li> + * <li><em>"data"</em> - (byte[]) The data payload of the message</li> + * <li><em>"contentTypeParameters"</em> + * - (HashMap<String,String>) Any parameters associated with the content type + * (decoded from the WSP Content-Type header)</li> + * </ul> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>The contentTypeParameters extra value is map of content parameters keyed by + * their names.</p> + * + * <p>If any unassigned well-known parameters are encountered, the key of the map will + * be 'unassigned/0x...', where '...' is the hex value of the unassigned parameter. If + * a parameter has No-Value the value in the map will be null.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_MMS} or + * {@link android.Manifest.permission#RECEIVE_WAP_PUSH} (depending on WAP PUSH type) to + * receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String WAP_PUSH_RECEIVED_ACTION = + "android.provider.Telephony.WAP_PUSH_RECEIVED"; + + /** + * Broadcast Action: A new Cell Broadcast message has been received + * by the device. The intent will have the following extra + * values:</p> + * + * <ul> + * <li><em>"message"</em> - An SmsCbMessage object containing the broadcast message + * data. This is not an emergency alert, so ETWS and CMAS data will be null.</li> + * </ul> + * + * <p>The extra values can be extracted using + * {@link #getMessagesFromIntent(Intent)}.</p> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SMS_CB_RECEIVED_ACTION = + "android.provider.Telephony.SMS_CB_RECEIVED"; + + /** + * Action: A SMS based carrier provision intent. Used to identify default + * carrier provisioning app on the device. + * @hide + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + @TestApi + public static final String SMS_CARRIER_PROVISION_ACTION = + "android.provider.Telephony.SMS_CARRIER_PROVISION"; + + /** + * Broadcast Action: A new Emergency Broadcast message has been received + * by the device. The intent will have the following extra + * values:</p> + * + * <ul> + * <li><em>"message"</em> - An SmsCbMessage object containing the broadcast message + * data, including ETWS or CMAS warning notification info if present.</li> + * </ul> + * + * <p>The extra values can be extracted using + * {@link #getMessagesFromIntent(Intent)}.</p> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_EMERGENCY_BROADCAST} to + * receive.</p> + * @removed + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SMS_EMERGENCY_CB_RECEIVED_ACTION = + "android.provider.Telephony.SMS_EMERGENCY_CB_RECEIVED"; + + /** + * Broadcast Action: A new CDMA SMS has been received containing Service Category + * Program Data (updates the list of enabled broadcast channels). The intent will + * have the following extra values:</p> + * + * <ul> + * <li><em>"operations"</em> - An array of CdmaSmsCbProgramData objects containing + * the service category operations (add/delete/clear) to perform.</li> + * </ul> + * + * <p>The extra values can be extracted using + * {@link #getMessagesFromIntent(Intent)}.</p> + * + * <p>If a BroadcastReceiver encounters an error while processing + * this intent it should set the result code appropriately.</p> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SMS_SERVICE_CATEGORY_PROGRAM_DATA_RECEIVED_ACTION = + "android.provider.Telephony.SMS_SERVICE_CATEGORY_PROGRAM_DATA_RECEIVED"; + + /** + * Broadcast Action: The SIM storage for SMS messages is full. If + * space is not freed, messages targeted for the SIM (class 2) may + * not be saved. + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SIM_FULL_ACTION = + "android.provider.Telephony.SIM_FULL"; + + /** + * Broadcast Action: An incoming SMS has been rejected by the + * telephony framework. This intent is sent in lieu of any + * of the RECEIVED_ACTION intents. The intent will have the + * following extra value:</p> + * + * <ul> + * <li><em>"result"</em> - An int result code, e.g. {@link #RESULT_SMS_OUT_OF_MEMORY} + * indicating the error returned to the network.</li> + * </ul> + * + * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SMS_REJECTED_ACTION = + "android.provider.Telephony.SMS_REJECTED"; + + /** + * Broadcast Action: An incoming MMS has been downloaded. The intent is sent to all + * users, except for secondary users where SMS has been disabled and to managed + * profiles. + * @hide + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String MMS_DOWNLOADED_ACTION = + "android.provider.Telephony.MMS_DOWNLOADED"; + + /** + * Broadcast Action: A debug code has been entered in the dialer. This intent is + * broadcast by the system and OEM telephony apps may need to receive these broadcasts. + * These "secret codes" are used to activate developer menus by dialing certain codes. + * And they are of the form {@code *#*#<code>#*#*}. The intent will have the data + * URI: {@code android_secret_code://<code>}. It is possible that a manifest + * receiver would be woken up even if it is not currently running. + * + * <p>Requires {@code android.Manifest.permission#CONTROL_INCALL_EXPERIENCE} to + * send and receive.</p> + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String SECRET_CODE_ACTION = + "android.provider.Telephony.SECRET_CODE"; + + /** + * Broadcast action: When the default SMS package changes, + * the previous default SMS package and the new default SMS + * package are sent this broadcast to notify them of the change. + * A boolean is specified in {@link #EXTRA_IS_DEFAULT_SMS_APP} to + * indicate whether the package is the new default SMS package. + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String ACTION_DEFAULT_SMS_PACKAGE_CHANGED = + "android.provider.action.DEFAULT_SMS_PACKAGE_CHANGED"; + + /** + * The IsDefaultSmsApp boolean passed as an + * extra for {@link #ACTION_DEFAULT_SMS_PACKAGE_CHANGED} to indicate whether the + * SMS app is becoming the default SMS app or is no longer the default. + * + * @see #ACTION_DEFAULT_SMS_PACKAGE_CHANGED + */ + public static final String EXTRA_IS_DEFAULT_SMS_APP = + "android.provider.extra.IS_DEFAULT_SMS_APP"; + + /** + * Broadcast action: When a change is made to the SmsProvider or + * MmsProvider by a process other than the default SMS application, + * this intent is broadcast to the default SMS application so it can + * re-sync or update the change. The uri that was used to call the provider + * can be retrieved from the intent with getData(). The actual affected uris + * (which would depend on the selection specified) are not included. + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String ACTION_EXTERNAL_PROVIDER_CHANGE = + "android.provider.action.EXTERNAL_PROVIDER_CHANGE"; + + /** + * Read the PDUs out of an {@link #SMS_RECEIVED_ACTION} or a + * {@link #DATA_SMS_RECEIVED_ACTION} intent. + * + * @param intent the intent to read from + * @return an array of SmsMessages for the PDUs + */ + public static SmsMessage[] getMessagesFromIntent(Intent intent) { + Object[] messages; + try { + messages = (Object[]) intent.getSerializableExtra("pdus"); + } + catch (ClassCastException e) { + Rlog.e(TAG, "getMessagesFromIntent: " + e); + return null; + } + + if (messages == null) { + Rlog.e(TAG, "pdus does not exist in the intent"); + return null; + } + + String format = intent.getStringExtra("format"); + int subId = intent.getIntExtra(PhoneConstants.SUBSCRIPTION_KEY, + SubscriptionManager.getDefaultSmsSubscriptionId()); + + Rlog.v(TAG, " getMessagesFromIntent sub_id : " + subId); + + int pduCount = messages.length; + SmsMessage[] msgs = new SmsMessage[pduCount]; + + for (int i = 0; i < pduCount; i++) { + byte[] pdu = (byte[]) messages[i]; + msgs[i] = SmsMessage.createFromPdu(pdu, format); + if (msgs[i] != null) msgs[i].setSubId(subId); + } + return msgs; + } + } + } + + /** + * Base column for the table that contain Carrier Public key. + * @hide + */ + public interface CarrierColumns extends BaseColumns { + + public static final String MCC = "mcc"; + public static final String MNC = "mnc"; + public static final String KEY_TYPE = "key_type"; + public static final String MVNO_TYPE = "mvno_type"; + public static final String MVNO_MATCH_DATA = "mvno_match_data"; + public static final String PUBLIC_KEY = "public_key"; + public static final String KEY_IDENTIFIER = "key_identifier"; + public static final String EXPIRATION_TIME = "expiration_time"; + public static final String LAST_MODIFIED = "last_modified"; + + /** + * The {@code content://} style URL for this table. + * @hide + */ + public static final Uri CONTENT_URI = Uri.parse("content://carrier_information/carrier"); + } + + /** + * Base columns for tables that contain MMSs. + */ + public interface BaseMmsColumns extends BaseColumns { + + /** Message box: all messages. */ + public static final int MESSAGE_BOX_ALL = 0; + /** Message box: inbox. */ + public static final int MESSAGE_BOX_INBOX = 1; + /** Message box: sent messages. */ + public static final int MESSAGE_BOX_SENT = 2; + /** Message box: drafts. */ + public static final int MESSAGE_BOX_DRAFTS = 3; + /** Message box: outbox. */ + public static final int MESSAGE_BOX_OUTBOX = 4; + /** Message box: failed. */ + public static final int MESSAGE_BOX_FAILED = 5; + + /** + * The thread ID of the message. + * <P>Type: INTEGER (long)</P> + */ + public static final String THREAD_ID = "thread_id"; + + /** + * The date the message was received. + * <P>Type: INTEGER (long)</P> + */ + public static final String DATE = "date"; + + /** + * The date the message was sent. + * <P>Type: INTEGER (long)</P> + */ + public static final String DATE_SENT = "date_sent"; + + /** + * The box which the message belongs to, e.g. {@link #MESSAGE_BOX_INBOX}. + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_BOX = "msg_box"; + + /** + * Has the message been read? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String READ = "read"; + + /** + * Has the message been seen by the user? The "seen" flag determines + * whether we need to show a new message notification. + * <P>Type: INTEGER (boolean)</P> + */ + public static final String SEEN = "seen"; + + /** + * Does the message have only a text part (can also have a subject) with + * no picture, slideshow, sound, etc. parts? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String TEXT_ONLY = "text_only"; + + /** + * The {@code Message-ID} of the message. + * <P>Type: TEXT</P> + */ + public static final String MESSAGE_ID = "m_id"; + + /** + * The subject of the message, if present. + * <P>Type: TEXT</P> + */ + public static final String SUBJECT = "sub"; + + /** + * The character set of the subject, if present. + * <P>Type: INTEGER</P> + */ + public static final String SUBJECT_CHARSET = "sub_cs"; + + /** + * The {@code Content-Type} of the message. + * <P>Type: TEXT</P> + */ + public static final String CONTENT_TYPE = "ct_t"; + + /** + * The {@code Content-Location} of the message. + * <P>Type: TEXT</P> + */ + public static final String CONTENT_LOCATION = "ct_l"; + + /** + * The expiry time of the message. + * <P>Type: INTEGER (long)</P> + */ + public static final String EXPIRY = "exp"; + + /** + * The class of the message. + * <P>Type: TEXT</P> + */ + public static final String MESSAGE_CLASS = "m_cls"; + + /** + * The type of the message defined by MMS spec. + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_TYPE = "m_type"; + + /** + * The version of the specification that this message conforms to. + * <P>Type: INTEGER</P> + */ + public static final String MMS_VERSION = "v"; + + /** + * The size of the message. + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_SIZE = "m_size"; + + /** + * The priority of the message. + * <P>Type: INTEGER</P> + */ + public static final String PRIORITY = "pri"; + + /** + * The {@code read-report} of the message. + * <P>Type: INTEGER (boolean)</P> + */ + public static final String READ_REPORT = "rr"; + + /** + * Is read report allowed? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String REPORT_ALLOWED = "rpt_a"; + + /** + * The {@code response-status} of the message. + * <P>Type: INTEGER</P> + */ + public static final String RESPONSE_STATUS = "resp_st"; + + /** + * The {@code status} of the message. + * <P>Type: INTEGER</P> + */ + public static final String STATUS = "st"; + + /** + * The {@code transaction-id} of the message. + * <P>Type: TEXT</P> + */ + public static final String TRANSACTION_ID = "tr_id"; + + /** + * The {@code retrieve-status} of the message. + * <P>Type: INTEGER</P> + */ + public static final String RETRIEVE_STATUS = "retr_st"; + + /** + * The {@code retrieve-text} of the message. + * <P>Type: TEXT</P> + */ + public static final String RETRIEVE_TEXT = "retr_txt"; + + /** + * The character set of the retrieve-text. + * <P>Type: INTEGER</P> + */ + public static final String RETRIEVE_TEXT_CHARSET = "retr_txt_cs"; + + /** + * The {@code read-status} of the message. + * <P>Type: INTEGER</P> + */ + public static final String READ_STATUS = "read_status"; + + /** + * The {@code content-class} of the message. + * <P>Type: INTEGER</P> + */ + public static final String CONTENT_CLASS = "ct_cls"; + + /** + * The {@code delivery-report} of the message. + * <P>Type: INTEGER</P> + */ + public static final String DELIVERY_REPORT = "d_rpt"; + + /** + * The {@code delivery-time-token} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String DELIVERY_TIME_TOKEN = "d_tm_tok"; + + /** + * The {@code delivery-time} of the message. + * <P>Type: INTEGER</P> + */ + public static final String DELIVERY_TIME = "d_tm"; + + /** + * The {@code response-text} of the message. + * <P>Type: TEXT</P> + */ + public static final String RESPONSE_TEXT = "resp_txt"; + + /** + * The {@code sender-visibility} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String SENDER_VISIBILITY = "s_vis"; + + /** + * The {@code reply-charging} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLY_CHARGING = "r_chg"; + + /** + * The {@code reply-charging-deadline-token} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLY_CHARGING_DEADLINE_TOKEN = "r_chg_dl_tok"; + + /** + * The {@code reply-charging-deadline} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLY_CHARGING_DEADLINE = "r_chg_dl"; + + /** + * The {@code reply-charging-id} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLY_CHARGING_ID = "r_chg_id"; + + /** + * The {@code reply-charging-size} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLY_CHARGING_SIZE = "r_chg_sz"; + + /** + * The {@code previously-sent-by} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String PREVIOUSLY_SENT_BY = "p_s_by"; + + /** + * The {@code previously-sent-date} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String PREVIOUSLY_SENT_DATE = "p_s_d"; + + /** + * The {@code store} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String STORE = "store"; + + /** + * The {@code mm-state} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MM_STATE = "mm_st"; + + /** + * The {@code mm-flags-token} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MM_FLAGS_TOKEN = "mm_flg_tok"; + + /** + * The {@code mm-flags} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MM_FLAGS = "mm_flg"; + + /** + * The {@code store-status} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String STORE_STATUS = "store_st"; + + /** + * The {@code store-status-text} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String STORE_STATUS_TEXT = "store_st_txt"; + + /** + * The {@code stored} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String STORED = "stored"; + + /** + * The {@code totals} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String TOTALS = "totals"; + + /** + * The {@code mbox-totals} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MBOX_TOTALS = "mb_t"; + + /** + * The {@code mbox-totals-token} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MBOX_TOTALS_TOKEN = "mb_t_tok"; + + /** + * The {@code quotas} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String QUOTAS = "qt"; + + /** + * The {@code mbox-quotas} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MBOX_QUOTAS = "mb_qt"; + + /** + * The {@code mbox-quotas-token} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MBOX_QUOTAS_TOKEN = "mb_qt_tok"; + + /** + * The {@code message-count} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String MESSAGE_COUNT = "m_cnt"; + + /** + * The {@code start} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String START = "start"; + + /** + * The {@code distribution-indicator} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String DISTRIBUTION_INDICATOR = "d_ind"; + + /** + * The {@code element-descriptor} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String ELEMENT_DESCRIPTOR = "e_des"; + + /** + * The {@code limit} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String LIMIT = "limit"; + + /** + * The {@code recommended-retrieval-mode} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String RECOMMENDED_RETRIEVAL_MODE = "r_r_mod"; + + /** + * The {@code recommended-retrieval-mode-text} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String RECOMMENDED_RETRIEVAL_MODE_TEXT = "r_r_mod_txt"; + + /** + * The {@code status-text} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String STATUS_TEXT = "st_txt"; + + /** + * The {@code applic-id} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String APPLIC_ID = "apl_id"; + + /** + * The {@code reply-applic-id} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLY_APPLIC_ID = "r_apl_id"; + + /** + * The {@code aux-applic-id} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String AUX_APPLIC_ID = "aux_apl_id"; + + /** + * The {@code drm-content} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String DRM_CONTENT = "drm_c"; + + /** + * The {@code adaptation-allowed} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String ADAPTATION_ALLOWED = "adp_a"; + + /** + * The {@code replace-id} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String REPLACE_ID = "repl_id"; + + /** + * The {@code cancel-id} of the message. + * <P>Type: TEXT</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String CANCEL_ID = "cl_id"; + + /** + * The {@code cancel-status} of the message. + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported. + * @hide + */ + @Deprecated + public static final String CANCEL_STATUS = "cl_st"; + + /** + * Is the message locked? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String LOCKED = "locked"; + + /** + * The subscription to which the message belongs to. Its value will be + * < 0 if the sub id cannot be determined. + * <p>Type: INTEGER (long)</p> + */ + public static final String SUBSCRIPTION_ID = "sub_id"; + + /** + * The identity of the sender of a sent message. It is + * usually the package name of the app which sends the message. + * <p class="note"><strong>Note:</strong> + * This column is read-only. It is set by the provider and can not be changed by apps. + * <p>Type: TEXT</p> + */ + public static final String CREATOR = "creator"; + } + + /** + * Columns for the "canonical_addresses" table used by MMS and SMS. + */ + public interface CanonicalAddressesColumns extends BaseColumns { + /** + * An address used in MMS or SMS. Email addresses are + * converted to lower case and are compared by string + * equality. Other addresses are compared using + * PHONE_NUMBERS_EQUAL. + * <P>Type: TEXT</P> + */ + public static final String ADDRESS = "address"; + } + + /** + * Columns for the "threads" table used by MMS and SMS. + */ + public interface ThreadsColumns extends BaseColumns { + + /** + * The date at which the thread was created. + * <P>Type: INTEGER (long)</P> + */ + public static final String DATE = "date"; + + /** + * A string encoding of the recipient IDs of the recipients of + * the message, in numerical order and separated by spaces. + * <P>Type: TEXT</P> + */ + public static final String RECIPIENT_IDS = "recipient_ids"; + + /** + * The message count of the thread. + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_COUNT = "message_count"; + + /** + * Indicates whether all messages of the thread have been read. + * <P>Type: INTEGER</P> + */ + public static final String READ = "read"; + + /** + * The snippet of the latest message in the thread. + * <P>Type: TEXT</P> + */ + public static final String SNIPPET = "snippet"; + + /** + * The charset of the snippet. + * <P>Type: INTEGER</P> + */ + public static final String SNIPPET_CHARSET = "snippet_cs"; + + /** + * Type of the thread, either {@link Threads#COMMON_THREAD} or + * {@link Threads#BROADCAST_THREAD}. + * <P>Type: INTEGER</P> + */ + public static final String TYPE = "type"; + + /** + * Indicates whether there is a transmission error in the thread. + * <P>Type: INTEGER</P> + */ + public static final String ERROR = "error"; + + /** + * Indicates whether this thread contains any attachments. + * <P>Type: INTEGER</P> + */ + public static final String HAS_ATTACHMENT = "has_attachment"; + + /** + * If the thread is archived + * <P>Type: INTEGER (boolean)</P> + */ + public static final String ARCHIVED = "archived"; + } + + /** + * Helper functions for the "threads" table used by MMS and SMS. + */ + public static final class Threads implements ThreadsColumns { + + private static final String[] ID_PROJECTION = { BaseColumns._ID }; + + /** + * Private {@code content://} style URL for this table. Used by + * {@link #getOrCreateThreadId(android.content.Context, java.util.Set)}. + */ + private static final Uri THREAD_ID_CONTENT_URI = Uri.parse( + "content://mms-sms/threadID"); + + /** + * The {@code content://} style URL for this table, by conversation. + */ + public static final Uri CONTENT_URI = Uri.withAppendedPath( + MmsSms.CONTENT_URI, "conversations"); + + /** + * The {@code content://} style URL for this table, for obsolete threads. + */ + public static final Uri OBSOLETE_THREADS_URI = Uri.withAppendedPath( + CONTENT_URI, "obsolete"); + + /** Thread type: common thread. */ + public static final int COMMON_THREAD = 0; + + /** Thread type: broadcast thread. */ + public static final int BROADCAST_THREAD = 1; + + /** + * Not instantiable. + * @hide + */ + private Threads() { + } + + /** + * This is a single-recipient version of {@code getOrCreateThreadId}. + * It's convenient for use with SMS messages. + * @param context the context object to use. + * @param recipient the recipient to send to. + */ + public static long getOrCreateThreadId(Context context, String recipient) { + Set<String> recipients = new HashSet<String>(); + + recipients.add(recipient); + return getOrCreateThreadId(context, recipients); + } + + /** + * Given the recipients list and subject of an unsaved message, + * return its thread ID. If the message starts a new thread, + * allocate a new thread ID. Otherwise, use the appropriate + * existing thread ID. + * + * <p>Find the thread ID of the same set of recipients (in any order, + * without any additions). If one is found, return it. Otherwise, + * return a unique thread ID.</p> + */ + public static long getOrCreateThreadId( + Context context, Set<String> recipients) { + Uri.Builder uriBuilder = THREAD_ID_CONTENT_URI.buildUpon(); + + for (String recipient : recipients) { + if (Mms.isEmailAddress(recipient)) { + recipient = Mms.extractAddrSpec(recipient); + } + + uriBuilder.appendQueryParameter("recipient", recipient); + } + + Uri uri = uriBuilder.build(); + //if (DEBUG) Rlog.v(TAG, "getOrCreateThreadId uri: " + uri); + + Cursor cursor = SqliteWrapper.query(context, context.getContentResolver(), + uri, ID_PROJECTION, null, null, null); + if (cursor != null) { + try { + if (cursor.moveToFirst()) { + return cursor.getLong(0); + } else { + Rlog.e(TAG, "getOrCreateThreadId returned no rows!"); + } + } finally { + cursor.close(); + } + } + + Rlog.e(TAG, "getOrCreateThreadId failed with " + recipients.size() + " recipients"); + throw new IllegalArgumentException("Unable to find or allocate a thread ID."); + } + } + + /** + * Contains all MMS messages. + */ + public static final class Mms implements BaseMmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Mms() { + } + + /** + * The {@code content://} URI for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://mms"); + + /** + * Content URI for getting MMS report requests. + */ + public static final Uri REPORT_REQUEST_URI = Uri.withAppendedPath( + CONTENT_URI, "report-request"); + + /** + * Content URI for getting MMS report status. + */ + public static final Uri REPORT_STATUS_URI = Uri.withAppendedPath( + CONTENT_URI, "report-status"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + + /** + * Regex pattern for names and email addresses. + * <ul> + * <li><em>mailbox</em> = {@code name-addr}</li> + * <li><em>name-addr</em> = {@code [display-name] angle-addr}</li> + * <li><em>angle-addr</em> = {@code [CFWS] "<" addr-spec ">" [CFWS]}</li> + * </ul> + * @hide + */ + public static final Pattern NAME_ADDR_EMAIL_PATTERN = + Pattern.compile("\\s*(\"[^\"]*\"|[^<>\"]+)\\s*<([^<>]+)>\\s*"); + + /** + * Helper method to query this table. + * @hide + */ + public static Cursor query( + ContentResolver cr, String[] projection) { + return cr.query(CONTENT_URI, projection, null, null, DEFAULT_SORT_ORDER); + } + + /** + * Helper method to query this table. + * @hide + */ + public static Cursor query( + ContentResolver cr, String[] projection, + String where, String orderBy) { + return cr.query(CONTENT_URI, projection, + where, null, orderBy == null ? DEFAULT_SORT_ORDER : orderBy); + } + + /** + * Helper method to extract email address from address string. + * @hide + */ + public static String extractAddrSpec(String address) { + Matcher match = NAME_ADDR_EMAIL_PATTERN.matcher(address); + + if (match.matches()) { + return match.group(2); + } + return address; + } + + /** + * Is the specified address an email address? + * + * @param address the input address to test + * @return true if address is an email address; false otherwise. + * @hide + */ + public static boolean isEmailAddress(String address) { + if (TextUtils.isEmpty(address)) { + return false; + } + + String s = extractAddrSpec(address); + Matcher match = Patterns.EMAIL_ADDRESS.matcher(s); + return match.matches(); + } + + /** + * Is the specified number a phone number? + * + * @param number the input number to test + * @return true if number is a phone number; false otherwise. + * @hide + */ + public static boolean isPhoneNumber(String number) { + if (TextUtils.isEmpty(number)) { + return false; + } + + Matcher match = Patterns.PHONE.matcher(number); + return match.matches(); + } + + /** + * Contains all MMS messages in the MMS app inbox. + */ + public static final class Inbox implements BaseMmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Inbox() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri + CONTENT_URI = Uri.parse("content://mms/inbox"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + } + + /** + * Contains all MMS messages in the MMS app sent folder. + */ + public static final class Sent implements BaseMmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Sent() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri + CONTENT_URI = Uri.parse("content://mms/sent"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + } + + /** + * Contains all MMS messages in the MMS app drafts folder. + */ + public static final class Draft implements BaseMmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Draft() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri + CONTENT_URI = Uri.parse("content://mms/drafts"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + } + + /** + * Contains all MMS messages in the MMS app outbox. + */ + public static final class Outbox implements BaseMmsColumns { + + /** + * Not instantiable. + * @hide + */ + private Outbox() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri + CONTENT_URI = Uri.parse("content://mms/outbox"); + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "date DESC"; + } + + /** + * Contains address information for an MMS message. + */ + public static final class Addr implements BaseColumns { + + /** + * Not instantiable. + * @hide + */ + private Addr() { + } + + /** + * The ID of MM which this address entry belongs to. + * <P>Type: INTEGER (long)</P> + */ + public static final String MSG_ID = "msg_id"; + + /** + * The ID of contact entry in Phone Book. + * <P>Type: INTEGER (long)</P> + */ + public static final String CONTACT_ID = "contact_id"; + + /** + * The address text. + * <P>Type: TEXT</P> + */ + public static final String ADDRESS = "address"; + + /** + * Type of address: must be one of {@code PduHeaders.BCC}, + * {@code PduHeaders.CC}, {@code PduHeaders.FROM}, {@code PduHeaders.TO}. + * <P>Type: INTEGER</P> + */ + public static final String TYPE = "type"; + + /** + * Character set of this entry (MMS charset value). + * <P>Type: INTEGER</P> + */ + public static final String CHARSET = "charset"; + } + + /** + * Contains message parts. + */ + public static final class Part implements BaseColumns { + + /** + * Not instantiable. + * @hide + */ + private Part() { + } + + /** + * The identifier of the message which this part belongs to. + * <P>Type: INTEGER</P> + */ + public static final String MSG_ID = "mid"; + + /** + * The order of the part. + * <P>Type: INTEGER</P> + */ + public static final String SEQ = "seq"; + + /** + * The content type of the part. + * <P>Type: TEXT</P> + */ + public static final String CONTENT_TYPE = "ct"; + + /** + * The name of the part. + * <P>Type: TEXT</P> + */ + public static final String NAME = "name"; + + /** + * The charset of the part. + * <P>Type: TEXT</P> + */ + public static final String CHARSET = "chset"; + + /** + * The file name of the part. + * <P>Type: TEXT</P> + */ + public static final String FILENAME = "fn"; + + /** + * The content disposition of the part. + * <P>Type: TEXT</P> + */ + public static final String CONTENT_DISPOSITION = "cd"; + + /** + * The content ID of the part. + * <P>Type: INTEGER</P> + */ + public static final String CONTENT_ID = "cid"; + + /** + * The content location of the part. + * <P>Type: INTEGER</P> + */ + public static final String CONTENT_LOCATION = "cl"; + + /** + * The start of content-type of the message. + * <P>Type: INTEGER</P> + */ + public static final String CT_START = "ctt_s"; + + /** + * The type of content-type of the message. + * <P>Type: TEXT</P> + */ + public static final String CT_TYPE = "ctt_t"; + + /** + * The location (on filesystem) of the binary data of the part. + * <P>Type: INTEGER</P> + */ + public static final String _DATA = "_data"; + + /** + * The message text. + * <P>Type: TEXT</P> + */ + public static final String TEXT = "text"; + } + + /** + * Message send rate table. + */ + public static final class Rate { + + /** + * Not instantiable. + * @hide + */ + private Rate() { + } + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.withAppendedPath( + Mms.CONTENT_URI, "rate"); + + /** + * When a message was successfully sent. + * <P>Type: INTEGER (long)</P> + */ + public static final String SENT_TIME = "sent_time"; + } + + /** + * Intents class. + */ + public static final class Intents { + + /** + * Not instantiable. + * @hide + */ + private Intents() { + } + + /** + * Indicates that the contents of specified URIs were changed. + * The application which is showing or caching these contents + * should be updated. + */ + @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + public static final String CONTENT_CHANGED_ACTION + = "android.intent.action.CONTENT_CHANGED"; + + /** + * An extra field which stores the URI of deleted contents. + */ + public static final String DELETED_CONTENTS = "deleted_contents"; + } + } + + /** + * Contains all MMS and SMS messages. + */ + public static final class MmsSms implements BaseColumns { + + /** + * Not instantiable. + * @hide + */ + private MmsSms() { + } + + /** + * The column to distinguish SMS and MMS messages in query results. + */ + public static final String TYPE_DISCRIMINATOR_COLUMN = + "transport_type"; + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://mms-sms/"); + + /** + * The {@code content://} style URL for this table, by conversation. + */ + public static final Uri CONTENT_CONVERSATIONS_URI = Uri.parse( + "content://mms-sms/conversations"); + + /** + * The {@code content://} style URL for this table, by phone number. + */ + public static final Uri CONTENT_FILTER_BYPHONE_URI = Uri.parse( + "content://mms-sms/messages/byphone"); + + /** + * The {@code content://} style URL for undelivered messages in this table. + */ + public static final Uri CONTENT_UNDELIVERED_URI = Uri.parse( + "content://mms-sms/undelivered"); + + /** + * The {@code content://} style URL for draft messages in this table. + */ + public static final Uri CONTENT_DRAFT_URI = Uri.parse( + "content://mms-sms/draft"); + + /** + * The {@code content://} style URL for locked messages in this table. + */ + public static final Uri CONTENT_LOCKED_URI = Uri.parse( + "content://mms-sms/locked"); + + /** + * Pass in a query parameter called "pattern" which is the text to search for. + * The sort order is fixed to be: {@code thread_id ASC, date DESC}. + */ + public static final Uri SEARCH_URI = Uri.parse( + "content://mms-sms/search"); + + // Constants for message protocol types. + + /** SMS protocol type. */ + public static final int SMS_PROTO = 0; + + /** MMS protocol type. */ + public static final int MMS_PROTO = 1; + + // Constants for error types of pending messages. + + /** Error type: no error. */ + public static final int NO_ERROR = 0; + + /** Error type: generic transient error. */ + public static final int ERR_TYPE_GENERIC = 1; + + /** Error type: SMS protocol transient error. */ + public static final int ERR_TYPE_SMS_PROTO_TRANSIENT = 2; + + /** Error type: MMS protocol transient error. */ + public static final int ERR_TYPE_MMS_PROTO_TRANSIENT = 3; + + /** Error type: transport failure. */ + public static final int ERR_TYPE_TRANSPORT_FAILURE = 4; + + /** Error type: permanent error (along with all higher error values). */ + public static final int ERR_TYPE_GENERIC_PERMANENT = 10; + + /** Error type: SMS protocol permanent error. */ + public static final int ERR_TYPE_SMS_PROTO_PERMANENT = 11; + + /** Error type: MMS protocol permanent error. */ + public static final int ERR_TYPE_MMS_PROTO_PERMANENT = 12; + + /** + * Contains pending messages info. + */ + public static final class PendingMessages implements BaseColumns { + + /** + * Not instantiable. + * @hide + */ + private PendingMessages() { + } + + public static final Uri CONTENT_URI = Uri.withAppendedPath( + MmsSms.CONTENT_URI, "pending"); + + /** + * The type of transport protocol (MMS or SMS). + * <P>Type: INTEGER</P> + */ + public static final String PROTO_TYPE = "proto_type"; + + /** + * The ID of the message to be sent or downloaded. + * <P>Type: INTEGER (long)</P> + */ + public static final String MSG_ID = "msg_id"; + + /** + * The type of the message to be sent or downloaded. + * This field is only valid for MM. For SM, its value is always set to 0. + * <P>Type: INTEGER</P> + */ + public static final String MSG_TYPE = "msg_type"; + + /** + * The type of the error code. + * <P>Type: INTEGER</P> + */ + public static final String ERROR_TYPE = "err_type"; + + /** + * The error code of sending/retrieving process. + * <P>Type: INTEGER</P> + */ + public static final String ERROR_CODE = "err_code"; + + /** + * How many times we tried to send or download the message. + * <P>Type: INTEGER</P> + */ + public static final String RETRY_INDEX = "retry_index"; + + /** + * The time to do next retry. + * <P>Type: INTEGER (long)</P> + */ + public static final String DUE_TIME = "due_time"; + + /** + * The time we last tried to send or download the message. + * <P>Type: INTEGER (long)</P> + */ + public static final String LAST_TRY = "last_try"; + + /** + * The subscription to which the message belongs to. Its value will be + * < 0 if the sub id cannot be determined. + * <p>Type: INTEGER (long) </p> + */ + public static final String SUBSCRIPTION_ID = "pending_sub_id"; + } + + /** + * Words table used by provider for full-text searches. + * @hide + */ + public static final class WordsTable { + + /** + * Not instantiable. + * @hide + */ + private WordsTable() {} + + /** + * Primary key. + * <P>Type: INTEGER (long)</P> + */ + public static final String ID = "_id"; + + /** + * Source row ID. + * <P>Type: INTEGER (long)</P> + */ + public static final String SOURCE_ROW_ID = "source_id"; + + /** + * Table ID (either 1 or 2). + * <P>Type: INTEGER</P> + */ + public static final String TABLE_ID = "table_to_use"; + + /** + * The words to index. + * <P>Type: TEXT</P> + */ + public static final String INDEXED_TEXT = "index_text"; + } + } + + /** + * Carriers class contains information about APNs, including MMSC information. + */ + public static final class Carriers implements BaseColumns { + + /** + * Not instantiable. + * @hide + */ + private Carriers() {} + + /** + * The {@code content://} style URL for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://telephony/carriers"); + + /** + * The {@code content://} style URL to be called from DevicePolicyManagerService, + * can manage DPC-owned APNs. + * @hide + */ + public static final Uri DPC_URI = Uri.parse("content://telephony/carriers/dpc"); + + /** + * The {@code content://} style URL to be called from Telephony to query APNs. + * When DPC-owned APNs are enforced, only DPC-owned APNs are returned, otherwise only + * non-DPC-owned APNs are returned. + * @hide + */ + public static final Uri FILTERED_URI = Uri.parse("content://telephony/carriers/filtered"); + + /** + * The {@code content://} style URL to be called from DevicePolicyManagerService + * or Telephony to manage whether DPC-owned APNs are enforced. + * @hide + */ + public static final Uri ENFORCE_MANAGED_URI = Uri.parse( + "content://telephony/carriers/enforce_managed"); + + /** + * The column name for ENFORCE_MANAGED_URI, indicates whether DPC-owned APNs are enforced. + * @hide + */ + public static final String ENFORCE_KEY = "enforced"; + + /** + * The default sort order for this table. + */ + public static final String DEFAULT_SORT_ORDER = "name ASC"; + + /** + * Entry name. + * <P>Type: TEXT</P> + */ + public static final String NAME = "name"; + + /** + * APN name. + * <P>Type: TEXT</P> + */ + public static final String APN = "apn"; + + /** + * Proxy address. + * <P>Type: TEXT</P> + */ + public static final String PROXY = "proxy"; + + /** + * Proxy port. + * <P>Type: TEXT</P> + */ + public static final String PORT = "port"; + + /** + * MMS proxy address. + * <P>Type: TEXT</P> + */ + public static final String MMSPROXY = "mmsproxy"; + + /** + * MMS proxy port. + * <P>Type: TEXT</P> + */ + public static final String MMSPORT = "mmsport"; + + /** + * Server address. + * <P>Type: TEXT</P> + */ + public static final String SERVER = "server"; + + /** + * APN username. + * <P>Type: TEXT</P> + */ + public static final String USER = "user"; + + /** + * APN password. + * <P>Type: TEXT</P> + */ + public static final String PASSWORD = "password"; + + /** + * MMSC URL. + * <P>Type: TEXT</P> + */ + public static final String MMSC = "mmsc"; + + /** + * Mobile Country Code (MCC). + * <P>Type: TEXT</P> + */ + public static final String MCC = "mcc"; + + /** + * Mobile Network Code (MNC). + * <P>Type: TEXT</P> + */ + public static final String MNC = "mnc"; + + /** + * Numeric operator ID (as String). Usually {@code MCC + MNC}. + * <P>Type: TEXT</P> + */ + public static final String NUMERIC = "numeric"; + + /** + * Authentication type. + * <P>Type: INTEGER</P> + */ + public static final String AUTH_TYPE = "authtype"; + + /** + * Comma-delimited list of APN types. + * <P>Type: TEXT</P> + */ + public static final String TYPE = "type"; + + /** + * The protocol to use to connect to this APN. + * + * One of the {@code PDP_type} values in TS 27.007 section 10.1.1. + * For example: {@code IP}, {@code IPV6}, {@code IPV4V6}, or {@code PPP}. + * <P>Type: TEXT</P> + */ + public static final String PROTOCOL = "protocol"; + + /** + * The protocol to use to connect to this APN when roaming. + * The syntax is the same as protocol. + * <P>Type: TEXT</P> + */ + public static final String ROAMING_PROTOCOL = "roaming_protocol"; + + /** + * Is this the current APN? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String CURRENT = "current"; + + /** + * Is this APN enabled? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String CARRIER_ENABLED = "carrier_enabled"; + + /** + * Radio Access Technology info. + * To check what values are allowed, refer to {@link android.telephony.ServiceState}. + * This should be spread to other technologies, + * but is currently only used for LTE (14) and eHRPD (13). + * <P>Type: INTEGER</P> + * @deprecated this column is no longer supported, use {@link #NETWORK_TYPE_BITMASK} instead + */ + @Deprecated + public static final String BEARER = "bearer"; + + /** + * Radio Access Technology bitmask. + * To check what values can be contained, refer to {@link android.telephony.ServiceState}. + * 0 indicates all techs otherwise first bit refers to RAT/bearer 1, second bit refers to + * RAT/bearer 2 and so on. + * Bitmask for a radio tech R is (1 << (R - 1)) + * <P>Type: INTEGER</P> + * @hide + * @deprecated this column is no longer supported, use {@link #NETWORK_TYPE_BITMASK} instead + */ + @Deprecated + public static final String BEARER_BITMASK = "bearer_bitmask"; + + /** + * Radio technology (network type) bitmask. + * To check what values can be contained, refer to the NETWORK_TYPE_ constants in + * {@link android.telephony.TelephonyManager}. + * Bitmask for a radio tech R is (1 << (R - 1)) + * <P>Type: INTEGER</P> + */ + public static final String NETWORK_TYPE_BITMASK = "network_type_bitmask"; + + /** + * MVNO type: + * {@code SPN (Service Provider Name), IMSI, GID (Group Identifier Level 1)}. + * <P>Type: TEXT</P> + */ + public static final String MVNO_TYPE = "mvno_type"; + + /** + * MVNO data. + * Use the following examples. + * <ul> + * <li>SPN: A MOBILE, BEN NL, ...</li> + * <li>IMSI: 302720x94, 2060188, ...</li> + * <li>GID: 4E, 33, ...</li> + * </ul> + * <P>Type: TEXT</P> + */ + public static final String MVNO_MATCH_DATA = "mvno_match_data"; + + /** + * The subscription to which the APN belongs to + * <p>Type: INTEGER (long) </p> + */ + public static final String SUBSCRIPTION_ID = "sub_id"; + + /** + * The profile_id to which the APN saved in modem + * <p>Type: INTEGER</p> + *@hide + */ + public static final String PROFILE_ID = "profile_id"; + + /** + * Is the apn setting to be set in modem + * <P>Type: INTEGER (boolean)</P> + *@hide + */ + public static final String MODEM_COGNITIVE = "modem_cognitive"; + + /** + * The max connections of this apn + * <p>Type: INTEGER</p> + *@hide + */ + public static final String MAX_CONNS = "max_conns"; + + /** + * The wait time for retry of the apn + * <p>Type: INTEGER</p> + *@hide + */ + public static final String WAIT_TIME = "wait_time"; + + /** + * The time to limit max connection for the apn + * <p>Type: INTEGER</p> + *@hide + */ + public static final String MAX_CONNS_TIME = "max_conns_time"; + + /** + * The MTU size of the mobile interface to which the APN connected + * <p>Type: INTEGER </p> + * @hide + */ + public static final String MTU = "mtu"; + + /** + * Is this APN added/edited/deleted by a user or carrier? + * <p>Type: INTEGER </p> + * @hide + */ + public static final String EDITED = "edited"; + + /** + * Is this APN visible to the user? + * <p>Type: INTEGER (boolean) </p> + * @hide + */ + public static final String USER_VISIBLE = "user_visible"; + + /** + * Is the user allowed to edit this APN? + * <p>Type: INTEGER (boolean) </p> + * @hide + */ + public static final String USER_EDITABLE = "user_editable"; + + /** + * Following are possible values for the EDITED field + * @hide + */ + public static final int UNEDITED = 0; + /** + * @hide + */ + public static final int USER_EDITED = 1; + /** + * @hide + */ + public static final int USER_DELETED = 2; + /** + * DELETED_BUT_PRESENT is an intermediate value used to indicate that an entry deleted + * by the user is still present in the new APN database and therefore must remain tagged + * as user deleted rather than completely removed from the database + * @hide + */ + public static final int USER_DELETED_BUT_PRESENT_IN_XML = 3; + /** + * @hide + */ + public static final int CARRIER_EDITED = 4; + /** + * CARRIER_DELETED values are currently not used as there is no usecase. If they are used, + * delete() will have to change accordingly. Currently it is hardcoded to USER_DELETED. + * @hide + */ + public static final int CARRIER_DELETED = 5; + /** + * @hide + */ + public static final int CARRIER_DELETED_BUT_PRESENT_IN_XML = 6; + + /** + * The owner of the APN. + * <p>Type: INTEGER</p> + * @hide + */ + public static final String OWNED_BY = "owned_by"; + + /** + * Possible value for the OWNED_BY field. + * APN is owned by DPC. + * @hide + */ + public static final int OWNED_BY_DPC = 0; + /** + * Possible value for the OWNED_BY field. + * APN is owned by other sources. + * @hide + */ + public static final int OWNED_BY_OTHERS = 1; + } + + /** + * Contains received SMS cell broadcast messages. + * @hide + */ + public static final class CellBroadcasts implements BaseColumns { + + /** + * Not instantiable. + * @hide + */ + private CellBroadcasts() {} + + /** + * The {@code content://} URI for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://cellbroadcasts"); + + /** + * Message geographical scope. + * <P>Type: INTEGER</P> + */ + public static final String GEOGRAPHICAL_SCOPE = "geo_scope"; + + /** + * Message serial number. + * <P>Type: INTEGER</P> + */ + public static final String SERIAL_NUMBER = "serial_number"; + + /** + * PLMN of broadcast sender. {@code SERIAL_NUMBER + PLMN + LAC + CID} uniquely identifies + * a broadcast for duplicate detection purposes. + * <P>Type: TEXT</P> + */ + public static final String PLMN = "plmn"; + + /** + * Location Area (GSM) or Service Area (UMTS) of broadcast sender. Unused for CDMA. + * Only included if Geographical Scope of message is not PLMN wide (01). + * <P>Type: INTEGER</P> + */ + public static final String LAC = "lac"; + + /** + * Cell ID of message sender (GSM/UMTS). Unused for CDMA. Only included when the + * Geographical Scope of message is cell wide (00 or 11). + * <P>Type: INTEGER</P> + */ + public static final String CID = "cid"; + + /** + * Message code. <em>OBSOLETE: merged into SERIAL_NUMBER.</em> + * <P>Type: INTEGER</P> + */ + public static final String V1_MESSAGE_CODE = "message_code"; + + /** + * Message identifier. <em>OBSOLETE: renamed to SERVICE_CATEGORY.</em> + * <P>Type: INTEGER</P> + */ + public static final String V1_MESSAGE_IDENTIFIER = "message_id"; + + /** + * Service category (GSM/UMTS: message identifier; CDMA: service category). + * <P>Type: INTEGER</P> + */ + public static final String SERVICE_CATEGORY = "service_category"; + + /** + * Message language code. + * <P>Type: TEXT</P> + */ + public static final String LANGUAGE_CODE = "language"; + + /** + * Message body. + * <P>Type: TEXT</P> + */ + public static final String MESSAGE_BODY = "body"; + + /** + * Message delivery time. + * <P>Type: INTEGER (long)</P> + */ + public static final String DELIVERY_TIME = "date"; + + /** + * Has the message been viewed? + * <P>Type: INTEGER (boolean)</P> + */ + public static final String MESSAGE_READ = "read"; + + /** + * Message format (3GPP or 3GPP2). + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_FORMAT = "format"; + + /** + * Message priority (including emergency). + * <P>Type: INTEGER</P> + */ + public static final String MESSAGE_PRIORITY = "priority"; + + /** + * ETWS warning type (ETWS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String ETWS_WARNING_TYPE = "etws_warning_type"; + + /** + * CMAS message class (CMAS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String CMAS_MESSAGE_CLASS = "cmas_message_class"; + + /** + * CMAS category (CMAS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String CMAS_CATEGORY = "cmas_category"; + + /** + * CMAS response type (CMAS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String CMAS_RESPONSE_TYPE = "cmas_response_type"; + + /** + * CMAS severity (CMAS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String CMAS_SEVERITY = "cmas_severity"; + + /** + * CMAS urgency (CMAS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String CMAS_URGENCY = "cmas_urgency"; + + /** + * CMAS certainty (CMAS alerts only). + * <P>Type: INTEGER</P> + */ + public static final String CMAS_CERTAINTY = "cmas_certainty"; + + /** The default sort order for this table. */ + public static final String DEFAULT_SORT_ORDER = DELIVERY_TIME + " DESC"; + + /** + * Query columns for instantiating {@link android.telephony.CellBroadcastMessage} objects. + */ + public static final String[] QUERY_COLUMNS = { + _ID, + GEOGRAPHICAL_SCOPE, + PLMN, + LAC, + CID, + SERIAL_NUMBER, + SERVICE_CATEGORY, + LANGUAGE_CODE, + MESSAGE_BODY, + DELIVERY_TIME, + MESSAGE_READ, + MESSAGE_FORMAT, + MESSAGE_PRIORITY, + ETWS_WARNING_TYPE, + CMAS_MESSAGE_CLASS, + CMAS_CATEGORY, + CMAS_RESPONSE_TYPE, + CMAS_SEVERITY, + CMAS_URGENCY, + CMAS_CERTAINTY + }; + } + + /** + * Constants for interfacing with the ServiceStateProvider and the different fields of the + * {@link ServiceState} class accessible through the provider. + */ + public static final class ServiceStateTable { + + /** + * Not instantiable. + * @hide + */ + private ServiceStateTable() {} + + /** + * The authority string for the ServiceStateProvider + */ + public static final String AUTHORITY = "service-state"; + + /** + * The {@code content://} style URL for the ServiceStateProvider + */ + public static final Uri CONTENT_URI = Uri.parse("content://service-state/"); + + /** + * Generates a content {@link Uri} used to receive updates on a specific field in the + * ServiceState provider. + * <p> + * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the + * {@link ServiceState} while your app is running. You can also use a {@link JobService} to + * ensure your app is notified of changes to the {@link Uri} even when it is not running. + * Note, however, that using a {@link JobService} does not guarantee timely delivery of + * updates to the {@link Uri}. + * + * @param subscriptionId the subscriptionId to receive updates on + * @param field the ServiceState field to receive updates on + * @return the Uri used to observe {@link ServiceState} changes + */ + public static Uri getUriForSubscriptionIdAndField(int subscriptionId, String field) { + return CONTENT_URI.buildUpon().appendEncodedPath(String.valueOf(subscriptionId)) + .appendEncodedPath(field).build(); + } + + /** + * Generates a content {@link Uri} used to receive updates on every field in the + * ServiceState provider. + * <p> + * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the + * {@link ServiceState} while your app is running. You can also use a {@link JobService} to + * ensure your app is notified of changes to the {@link Uri} even when it is not running. + * Note, however, that using a {@link JobService} does not guarantee timely delivery of + * updates to the {@link Uri}. + * + * @param subscriptionId the subscriptionId to receive updates on + * @return the Uri used to observe {@link ServiceState} changes + */ + public static Uri getUriForSubscriptionId(int subscriptionId) { + return CONTENT_URI.buildUpon().appendEncodedPath(String.valueOf(subscriptionId)).build(); + } + + /** + * Used to insert a ServiceState into the ServiceStateProvider as a ContentValues instance. + * + * @param state the ServiceState to convert into ContentValues + * @return the convertedContentValues instance + * @hide + */ + public static ContentValues getContentValuesForServiceState(ServiceState state) { + ContentValues values = new ContentValues(); + values.put(VOICE_REG_STATE, state.getVoiceRegState()); + values.put(DATA_REG_STATE, state.getDataRegState()); + values.put(VOICE_ROAMING_TYPE, state.getVoiceRoamingType()); + values.put(DATA_ROAMING_TYPE, state.getDataRoamingType()); + values.put(VOICE_OPERATOR_ALPHA_LONG, state.getVoiceOperatorAlphaLong()); + values.put(VOICE_OPERATOR_ALPHA_SHORT, state.getVoiceOperatorAlphaShort()); + values.put(VOICE_OPERATOR_NUMERIC, state.getVoiceOperatorNumeric()); + values.put(DATA_OPERATOR_ALPHA_LONG, state.getDataOperatorAlphaLong()); + values.put(DATA_OPERATOR_ALPHA_SHORT, state.getDataOperatorAlphaShort()); + values.put(DATA_OPERATOR_NUMERIC, state.getDataOperatorNumeric()); + values.put(IS_MANUAL_NETWORK_SELECTION, state.getIsManualSelection()); + values.put(RIL_VOICE_RADIO_TECHNOLOGY, state.getRilVoiceRadioTechnology()); + values.put(RIL_DATA_RADIO_TECHNOLOGY, state.getRilDataRadioTechnology()); + values.put(CSS_INDICATOR, state.getCssIndicator()); + values.put(NETWORK_ID, state.getNetworkId()); + values.put(SYSTEM_ID, state.getSystemId()); + values.put(CDMA_ROAMING_INDICATOR, state.getCdmaRoamingIndicator()); + values.put(CDMA_DEFAULT_ROAMING_INDICATOR, state.getCdmaDefaultRoamingIndicator()); + values.put(CDMA_ERI_ICON_INDEX, state.getCdmaEriIconIndex()); + values.put(CDMA_ERI_ICON_MODE, state.getCdmaEriIconMode()); + values.put(IS_EMERGENCY_ONLY, state.isEmergencyOnly()); + values.put(IS_DATA_ROAMING_FROM_REGISTRATION, state.getDataRoamingFromRegistration()); + values.put(IS_USING_CARRIER_AGGREGATION, state.isUsingCarrierAggregation()); + return values; + } + + /** + * An integer value indicating the current voice service state. + * <p> + * Valid values: {@link ServiceState#STATE_IN_SERVICE}, + * {@link ServiceState#STATE_OUT_OF_SERVICE}, {@link ServiceState#STATE_EMERGENCY_ONLY}, + * {@link ServiceState#STATE_POWER_OFF}. + * <p> + * This is the same as {@link ServiceState#getState()}. + */ + public static final String VOICE_REG_STATE = "voice_reg_state"; + + /** + * An integer value indicating the current data service state. + * <p> + * Valid values: {@link ServiceState#STATE_IN_SERVICE}, + * {@link ServiceState#STATE_OUT_OF_SERVICE}, {@link ServiceState#STATE_EMERGENCY_ONLY}, + * {@link ServiceState#STATE_POWER_OFF}. + * <p> + * This is the same as {@link ServiceState#getDataRegState()}. + * @hide + */ + public static final String DATA_REG_STATE = "data_reg_state"; + + /** + * An integer value indicating the current voice roaming type. + * <p> + * This is the same as {@link ServiceState#getVoiceRoamingType()}. + * @hide + */ + public static final String VOICE_ROAMING_TYPE = "voice_roaming_type"; + + /** + * An integer value indicating the current data roaming type. + * <p> + * This is the same as {@link ServiceState#getDataRoamingType()}. + * @hide + */ + public static final String DATA_ROAMING_TYPE = "data_roaming_type"; + + /** + * The current registered voice network operator name in long alphanumeric format. + * <p> + * This is the same as {@link ServiceState#getVoiceOperatorAlphaLong()}. + * @hide + */ + public static final String VOICE_OPERATOR_ALPHA_LONG = "voice_operator_alpha_long"; + + /** + * The current registered operator name in short alphanumeric format. + * <p> + * In GSM/UMTS, short format can be up to 8 characters long. The current registered voice + * network operator name in long alphanumeric format. + * <p> + * This is the same as {@link ServiceState#getVoiceOperatorAlphaShort()}. + * @hide + */ + public static final String VOICE_OPERATOR_ALPHA_SHORT = "voice_operator_alpha_short"; + + + /** + * The current registered operator numeric id. + * <p> + * In GSM/UMTS, numeric format is 3 digit country code plus 2 or 3 digit + * network code. + * <p> + * This is the same as {@link ServiceState#getOperatorNumeric()}. + */ + public static final String VOICE_OPERATOR_NUMERIC = "voice_operator_numeric"; + + /** + * The current registered data network operator name in long alphanumeric format. + * <p> + * This is the same as {@link ServiceState#getDataOperatorAlphaLong()}. + * @hide + */ + public static final String DATA_OPERATOR_ALPHA_LONG = "data_operator_alpha_long"; + + /** + * The current registered data network operator name in short alphanumeric format. + * <p> + * This is the same as {@link ServiceState#getDataOperatorAlphaShort()}. + * @hide + */ + public static final String DATA_OPERATOR_ALPHA_SHORT = "data_operator_alpha_short"; + + /** + * The current registered data network operator numeric id. + * <p> + * This is the same as {@link ServiceState#getDataOperatorNumeric()}. + * @hide + */ + public static final String DATA_OPERATOR_NUMERIC = "data_operator_numeric"; + + /** + * The current network selection mode. + * <p> + * This is the same as {@link ServiceState#getIsManualSelection()}. + */ + public static final String IS_MANUAL_NETWORK_SELECTION = "is_manual_network_selection"; + + /** + * This is the same as {@link ServiceState#getRilVoiceRadioTechnology()}. + * @hide + */ + public static final String RIL_VOICE_RADIO_TECHNOLOGY = "ril_voice_radio_technology"; + + /** + * This is the same as {@link ServiceState#getRilDataRadioTechnology()}. + * @hide + */ + public static final String RIL_DATA_RADIO_TECHNOLOGY = "ril_data_radio_technology"; + + /** + * This is the same as {@link ServiceState#getCssIndicator()}. + * @hide + */ + public static final String CSS_INDICATOR = "css_indicator"; + + /** + * This is the same as {@link ServiceState#getNetworkId()}. + * @hide + */ + public static final String NETWORK_ID = "network_id"; + + /** + * This is the same as {@link ServiceState#getSystemId()}. + * @hide + */ + public static final String SYSTEM_ID = "system_id"; + + /** + * This is the same as {@link ServiceState#getCdmaRoamingIndicator()}. + * @hide + */ + public static final String CDMA_ROAMING_INDICATOR = "cdma_roaming_indicator"; + + /** + * This is the same as {@link ServiceState#getCdmaDefaultRoamingIndicator()}. + * @hide + */ + public static final String CDMA_DEFAULT_ROAMING_INDICATOR = + "cdma_default_roaming_indicator"; + + /** + * This is the same as {@link ServiceState#getCdmaEriIconIndex()}. + * @hide + */ + public static final String CDMA_ERI_ICON_INDEX = "cdma_eri_icon_index"; + + /** + * This is the same as {@link ServiceState#getCdmaEriIconMode()}. + * @hide + */ + public static final String CDMA_ERI_ICON_MODE = "cdma_eri_icon_mode"; + + /** + * This is the same as {@link ServiceState#isEmergencyOnly()}. + * @hide + */ + public static final String IS_EMERGENCY_ONLY = "is_emergency_only"; + + /** + * This is the same as {@link ServiceState#getDataRoamingFromRegistration()}. + * @hide + */ + public static final String IS_DATA_ROAMING_FROM_REGISTRATION = + "is_data_roaming_from_registration"; + + /** + * This is the same as {@link ServiceState#isUsingCarrierAggregation()}. + * @hide + */ + public static final String IS_USING_CARRIER_AGGREGATION = "is_using_carrier_aggregation"; + } + + /** + * Contains carrier identification information for the current subscriptions. + * @see SubscriptionManager#getActiveSubscriptionIdList() + */ + public static final class CarrierIdentification implements BaseColumns { + /** + * Not instantiable. + * @hide + */ + private CarrierIdentification() {} + + /** + * The {@code content://} style URI for this provider. + */ + public static final Uri CONTENT_URI = Uri.parse("content://carrier_identification"); + + /** + * The authority string for the CarrierIdentification Provider + * @hide + */ + public static final String AUTHORITY = "carrier_identification"; + + + /** + * Generates a content {@link Uri} used to receive updates on carrier identity change + * on the given subscriptionId + * <p> + * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the + * carrier identity {@link TelephonyManager#getAndroidCarrierIdForSubscription()} + * while your app is running. You can also use a {@link JobService} to ensure your app + * is notified of changes to the {@link Uri} even when it is not running. + * Note, however, that using a {@link JobService} does not guarantee timely delivery of + * updates to the {@link Uri}. + * + * @param subscriptionId the subscriptionId to receive updates on + * @return the Uri used to observe carrier identity changes + */ + public static Uri getUriForSubscriptionId(int subscriptionId) { + return CONTENT_URI.buildUpon().appendEncodedPath( + String.valueOf(subscriptionId)).build(); + } + + /** + * A user facing carrier name. + * @see TelephonyManager#getAndroidCarrierNameForSubscription() + * <P>Type: TEXT </P> + */ + public static final String NAME = "carrier_name"; + + /** + * A unique carrier id + * @see TelephonyManager#getAndroidCarrierIdForSubscription() + * <P>Type: INTEGER </P> + */ + public static final String CID = "carrier_id"; + + /** + * Contains mappings between matching rules with carrier id for all carriers. + * @hide + */ + public static final class All implements BaseColumns { + /** + * Numeric operator ID (as String). {@code MCC + MNC} + * <P>Type: TEXT </P> + */ + public static final String MCCMNC = "mccmnc"; + + /** + * Group id level 1 (as String). + * <P>Type: TEXT </P> + */ + public static final String GID1 = "gid1"; + + /** + * Group id level 2 (as String). + * <P>Type: TEXT </P> + */ + public static final String GID2 = "gid2"; + + /** + * Public Land Mobile Network name. + * <P>Type: TEXT </P> + */ + public static final String PLMN = "plmn"; + + /** + * Prefix xpattern of IMSI (International Mobile Subscriber Identity). + * <P>Type: TEXT </P> + */ + public static final String IMSI_PREFIX_XPATTERN = "imsi_prefix_xpattern"; + + /** + * Service Provider Name. + * <P>Type: TEXT </P> + */ + public static final String SPN = "spn"; + + /** + * Prefer APN name. + * <P>Type: TEXT </P> + */ + public static final String APN = "apn"; + + /** + * Prefix of Integrated Circuit Card Identifier. + * <P>Type: TEXT </P> + */ + public static final String ICCID_PREFIX = "iccid_prefix"; + + /** + * The {@code content://} URI for this table. + */ + public static final Uri CONTENT_URI = Uri.parse("content://carrier_identification/all"); + } + } +} |