content: /*
   * 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.IntDef;
  import android.annotation.NonNull;
  import android.annotation.RequiresPermission;
  import android.annotation.SdkConstant;
  import android.annotation.SdkConstant.SdkConstantType;
  import android.annotation.SystemApi;
  import android.annotation.TestApi;
  import android.annotation.UnsupportedAppUsage;
  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.ContentObserver;
  import android.database.Cursor;
  import android.database.sqlite.SqliteWrapper;
  import android.net.Uri;
  import android.os.Build;
  import android.os.Parcel;
  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.lang.annotation.Retention;
  import java.lang.annotation.RetentionPolicy;
  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&mdash;while not selected as the default SMS app&mdash;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";
      }
  
      /**
       * Columns in sms_changes table.
       * @hide
       */
      public interface TextBasedSmsChangesColumns {
          /**
           * The {@code content://} style URL for this table.
           * @hide
           */
          public static final Uri CONTENT_URI = Uri.parse("content://sms-changes");
  
          /**
           * Primary key.
           * <P>Type: INTEGER (long)</P>
           * @hide
           */
          public static final String ID = "_id";
  
          /**
           * Triggers on sms table create a row in this table for each update/delete.
           * This column is the "_id" of the row from sms table that was updated/deleted.
           * <P>Type: INTEGER (long)</P>
           * @hide
           */
          public static final String ORIG_ROW_ID = "orig_rowid";
  
          /**
           * Triggers on sms table create a row in this table for each update/delete.
           * This column is the "sub_id" of the row from sms table that was updated/deleted.
           * @hide
           * <P>Type: INTEGER (long)</P>
           */
          public static final String SUB_ID = "sub_id";
  
          /**
           * The type of operation that created this row.
           *    {@link #TYPE_UPDATE} = update op
           *    {@link #TYPE_DELETE} = delete op
           * @hide
           * <P>Type: INTEGER (long)</P>
           */
          public static final String TYPE = "type";
  
          /**
           * One of the possible values for the above column "type". Indicates it is an update op.
           * @hide
           */
          public static final int TYPE_UPDATE = 0;
  
          /**
           * One of the possible values for the above column "type". Indicates it is a delete op.
           * @hide
           */
          public static final int TYPE_DELETE = 1;
  
          /**
           * This column contains a non-null value only if the operation on sms table is an update op
           * and the column "read" is changed by the update op.
           * <P>Type: INTEGER (boolean)</P>
           * @hide
           */
          public static final String NEW_READ_STATUS = "new_read_status";
      }
  
      /**
       * 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
           */
          @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
               */
              @UnsupportedAppUsage
              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
               */
              @UnsupportedAppUsage
              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
               */
              @UnsupportedAppUsage
              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
               */
              @UnsupportedAppUsage
              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
              */
              @UnsupportedAppUsage
              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
               */
              @UnsupportedAppUsage
              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
               */
              @UnsupportedAppUsage
              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}.
               * <p>
               * This is no longer supported since Q, please use
               * {@link android.app.role.RoleManager#createRequestRoleIntent(String)} with
               * {@link android.app.role.RoleManager#ROLE_SMS} instead.
               */
              @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
               * <p>
               * This is no longer supported since Q, please use
               * {@link android.app.role.RoleManager#createRequestRoleIntent(String)} with
               * {@link android.app.role.RoleManager#ROLE_SMS} instead.
               */
              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&lt;String,String&gt;) 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&lt;String,String&gt;) 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>
               * @deprecated it is no longer supported, use {@link
               * TelephonyManager#ACTION_SECRET_CODE} instead
               */
              @Deprecated
              @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";
  
              /**
               * Same as {@link #ACTION_DEFAULT_SMS_PACKAGE_CHANGED} but it's implicit (e.g. sent to
               * all apps) and requires
               * {@link android.Manifest.permission#MONITOR_DEFAULT_SMS_PACKAGE} to receive.
               *
               * @hide
               */
              @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
              public static final String ACTION_DEFAULT_SMS_PACKAGE_CHANGED_INTERNAL =
                      "android.provider.action.DEFAULT_SMS_PACKAGE_CHANGED_INTERNAL";
  
              /**
               * Broadcast action: When SMS-MMS db is being created. If file-based encryption is
               * supported, this broadcast indicates creation of the db in credential-encrypted
               * storage. A boolean is specified in {@link #EXTRA_IS_INITIAL_CREATE} to indicate if
               * this is the initial create of the db.
               *
               * @see #EXTRA_IS_INITIAL_CREATE
               *
               * @hide
               */
              @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
              public static final String ACTION_SMS_MMS_DB_CREATED =
                      "android.provider.action.SMS_MMS_DB_CREATED";
  
              /**
               * Boolean flag passed as an extra with {@link #ACTION_SMS_MMS_DB_CREATED} to indicate
               * whether the DB creation is the initial creation on the device, that is it is after a
               * factory-data reset or a new device. Any subsequent creations of the DB (which
               * happens only in error scenarios) will have this flag set to false.
               *
               * @see #ACTION_SMS_MMS_DB_CREATED
               *
               * @hide
               */
              public static final String EXTRA_IS_INITIAL_CREATE =
                      "android.provider.extra.IS_INITIAL_CREATE";
  
              /**
               * Broadcast intent action indicating that the telephony provider SMS MMS database is
               * corrupted. A boolean is specified in {@link #EXTRA_IS_CORRUPTED} to indicate if the
               * database is corrupted. Requires the
               * {@link android.Manifest.permission#READ_PRIVILEGED_PHONE_STATE permission.
               *
               * @hide
               */
              @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
              @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
              public static final String ACTION_SMS_MMS_DB_LOST =
                      "android.provider.action.SMS_MMS_DB_LOST";
  
              /**
               * Boolean flag passed as an extra with {@link #ACTION_SMS_MMS_DB_LOST} to indicate
               * whether the DB got corrupted or not.
               *
               * @see #ACTION_SMS_MMS_DB_LOST
               *
               * @hide
               */
              public static final String EXTRA_IS_CORRUPTED =
                      "android.provider.extra.IS_CORRUPTED";
  
              /**
               * 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.
       *
       * Thread IDs are determined by the participants in a conversation and can be used to match
       * both SMS and MMS messages.
       *
       * To avoid issues where applications might cache a thread ID, the thread ID of a deleted thread
       * must not be reused to point at a new thread.
       */
      public static final class Threads implements ThreadsColumns {
  
          @UnsupportedAppUsage
          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)}.
           */
          @UnsupportedAppUsage
          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 a set of recipients return its thread ID.
           * <p>
           * If a thread exists containing the provided participants, return its thread ID. Otherwise,
           * this will create a new thread containing the provided participants and return its ID.
           */
          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.");
          }
      }
  
      /**
       * Columns for the "rcs_*" tables used by {@link android.telephony.ims.RcsMessageStore} classes.
       *
       * @hide - not meant for public use
       */
      public interface RcsColumns {
          // TODO(sahinc): Turn this to true once the schema finalizes, so that people can update
          //  their messaging databases. NOTE: move the switch/case update in MmsSmsDatabaseHelper to
          //  the latest version of the database before turning this flag to true.
          boolean IS_RCS_TABLE_SCHEMA_CODE_COMPLETE = false;
  
          /**
           * The authority for the content provider
           */
          String AUTHORITY = "rcs";
  
          /**
           * The URI to start building upon to use {@link com.android.providers.telephony.RcsProvider}
           */
          Uri CONTENT_AND_AUTHORITY = Uri.parse("content://" + AUTHORITY);
  
          /**
           * The value to be used whenever a transaction that expects an integer to be returned
           * failed.
           */
          int TRANSACTION_FAILED = Integer.MIN_VALUE;
  
          /**
           * The value that denotes a timestamp was not set before (e.g. a message that is not
           * delivered yet will not have a DELIVERED_TIMESTAMP)
           */
          long TIMESTAMP_NOT_SET = 0;
  
          /**
           * The table that {@link android.telephony.ims.RcsThread} gets persisted to
           */
          interface RcsThreadColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsThread}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String RCS_THREAD_URI_PART = "thread";
  
              /**
               * The URI to query or modify {@link android.telephony.ims.RcsThread} via the content
               * provider.
               */
              Uri RCS_THREAD_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY, RCS_THREAD_URI_PART);
  
              /**
               * The unique identifier of an {@link android.telephony.ims.RcsThread}
               */
              String RCS_THREAD_ID_COLUMN = "rcs_thread_id";
          }
  
          /**
           * The table that {@link android.telephony.ims.Rcs1To1Thread} gets persisted to
           */
          interface Rcs1To1ThreadColumns extends RcsThreadColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.Rcs1To1Thread}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String RCS_1_TO_1_THREAD_URI_PART = "p2p_thread";
  
              /**
               * The URI to query or modify {@link android.telephony.ims.Rcs1To1Thread}s via the
               * content provider. Can also insert to this URI to create a new 1-to-1 thread. When
               * performing an insert, ensure that the provided content values contain the other
               * participant's ID under the key
               * {@link RcsParticipantColumns.RCS_PARTICIPANT_ID_COLUMN}
               */
              Uri RCS_1_TO_1_THREAD_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      RCS_1_TO_1_THREAD_URI_PART);
  
              /**
               * The SMS/MMS thread to fallback to in case of an RCS outage
               */
              String FALLBACK_THREAD_ID_COLUMN = "rcs_fallback_thread_id";
          }
  
          /**
           * The table that {@link android.telephony.ims.RcsGroupThread} gets persisted to
           */
          interface RcsGroupThreadColumns extends RcsThreadColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsGroupThread}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String RCS_GROUP_THREAD_URI_PART = "group_thread";
  
              /**
               * The URI to query or modify {@link android.telephony.ims.RcsGroupThread}s via the
               * content provider
               */
              Uri RCS_GROUP_THREAD_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      RCS_GROUP_THREAD_URI_PART);
  
              /**
               * The owner/admin of the {@link android.telephony.ims.RcsGroupThread}
               */
              String OWNER_PARTICIPANT_COLUMN = "owner_participant";
  
              /**
               * The user visible name of the group
               */
              String GROUP_NAME_COLUMN = "group_name";
  
              /**
               * The user visible icon of the group
               */
              String GROUP_ICON_COLUMN = "group_icon";
  
              /**
               * The RCS conference URI for this group
               */
              String CONFERENCE_URI_COLUMN = "conference_uri";
          }
  
          /**
           * The view that enables polling from all types of RCS threads at once
           */
          interface RcsUnifiedThreadColumns extends RcsThreadColumns, Rcs1To1ThreadColumns,
                  RcsGroupThreadColumns {
              /**
               * The type of this {@link android.telephony.ims.RcsThread}
               */
              String THREAD_TYPE_COLUMN = "thread_type";
  
              /**
               * Integer returned as a result from a database query that denotes the thread is 1 to 1
               */
              int THREAD_TYPE_1_TO_1 = 0;
  
              /**
               * Integer returned as a result from a database query that denotes the thread is 1 to 1
               */
              int THREAD_TYPE_GROUP = 1;
          }
  
          /**
           * The table that {@link android.telephony.ims.RcsParticipant} gets persisted to
           */
          interface RcsParticipantColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsParticipant}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String RCS_PARTICIPANT_URI_PART = "participant";
  
              /**
               * The URI to query or modify {@link android.telephony.ims.RcsParticipant}s via the
               * content provider
               */
              Uri RCS_PARTICIPANT_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      RCS_PARTICIPANT_URI_PART);
  
              /**
               * The unique identifier of the entry in the database
               */
              String RCS_PARTICIPANT_ID_COLUMN = "rcs_participant_id";
  
              /**
               * A foreign key on canonical_address table, also used by SMS/MMS
               */
              String CANONICAL_ADDRESS_ID_COLUMN = "canonical_address_id";
  
              /**
               * The user visible RCS alias for this participant.
               */
              String RCS_ALIAS_COLUMN = "rcs_alias";
          }
  
          /**
           * Additional constants to enable access to {@link android.telephony.ims.RcsParticipant}
           * related data
           */
          interface RcsParticipantHelpers extends RcsParticipantColumns {
              /**
               * The view that unifies "rcs_participant" and "canonical_addresses" tables for easy
               * access to participant address.
               */
              String RCS_PARTICIPANT_WITH_ADDRESS_VIEW = "rcs_participant_with_address_view";
  
              /**
               * The view that unifies "rcs_participant", "canonical_addresses" and
               * "rcs_thread_participant" junction table to get full information on participants that
               * contribute to threads.
               */
              String RCS_PARTICIPANT_WITH_THREAD_VIEW = "rcs_participant_with_thread_view";
          }
  
          /**
           * The table that {@link android.telephony.ims.RcsMessage} gets persisted to
           */
          interface RcsMessageColumns {
              /**
               * Denotes the type of this message (i.e.
               * {@link android.telephony.ims.RcsIncomingMessage} or
               * {@link android.telephony.ims.RcsOutgoingMessage}
               */
              String MESSAGE_TYPE_COLUMN = "rcs_message_type";
  
              /**
               * The unique identifier for the message in the database - i.e. the primary key.
               */
              String MESSAGE_ID_COLUMN = "rcs_message_row_id";
  
              /**
               * The globally unique RCS identifier for the message. Please see 4.4.5.2 - GSMA
               * RCC.53 (RCS Device API 1.6 Specification)
               */
              String GLOBAL_ID_COLUMN = "rcs_message_global_id";
  
              /**
               * The subscription where this message was sent from/to.
               */
              String SUB_ID_COLUMN = "sub_id";
  
              /**
               * The sending status of the message.
               * @see android.telephony.ims.RcsMessage.RcsMessageStatus
               */
              String STATUS_COLUMN = "status";
  
              /**
               * The creation timestamp of the message.
               */
              String ORIGINATION_TIMESTAMP_COLUMN = "origination_timestamp";
  
              /**
               * The text content of the message.
               */
              String MESSAGE_TEXT_COLUMN = "rcs_text";
  
              /**
               * The latitude content of the message, if it contains a location.
               */
              String LATITUDE_COLUMN = "latitude";
  
              /**
               * The longitude content of the message, if it contains a location.
               */
              String LONGITUDE_COLUMN = "longitude";
          }
  
          /**
           * The table that additional information of {@link android.telephony.ims.RcsIncomingMessage}
           * gets persisted to.
           */
          interface RcsIncomingMessageColumns extends RcsMessageColumns {
              /**
               The path that should be used for referring to
               * {@link android.telephony.ims.RcsIncomingMessage}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String INCOMING_MESSAGE_URI_PART = "incoming_message";
  
              /**
               * The URI to query incoming messages through
               * {@link com.android.providers.telephony.RcsProvider}
               */
              Uri INCOMING_MESSAGE_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      INCOMING_MESSAGE_URI_PART);
  
              /**
               * The ID of the {@link android.telephony.ims.RcsParticipant} that sent this message
               */
              String SENDER_PARTICIPANT_ID_COLUMN = "sender_participant";
  
              /**
               * The timestamp of arrival for this message.
               */
              String ARRIVAL_TIMESTAMP_COLUMN = "arrival_timestamp";
  
              /**
               * The time when the recipient has read this message.
               */
              String SEEN_TIMESTAMP_COLUMN = "seen_timestamp";
          }
  
          /**
           * The table that additional information of {@link android.telephony.ims.RcsOutgoingMessage}
           * gets persisted to.
           */
          interface RcsOutgoingMessageColumns extends RcsMessageColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsOutgoingMessage}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String OUTGOING_MESSAGE_URI_PART = "outgoing_message";
  
              /**
               * The URI to query or modify {@link android.telephony.ims.RcsOutgoingMessage}s via the
               * content provider
               */
              Uri OUTGOING_MESSAGE_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      OUTGOING_MESSAGE_URI_PART);
          }
  
          /**
           * The delivery information of an {@link android.telephony.ims.RcsOutgoingMessage}
           */
          interface RcsMessageDeliveryColumns extends RcsOutgoingMessageColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsOutgoingMessageDelivery}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String DELIVERY_URI_PART = "delivery";
  
              /**
               * The timestamp of delivery of this message.
               */
              String DELIVERED_TIMESTAMP_COLUMN = "delivered_timestamp";
  
              /**
               * The time when the recipient has read this message.
               */
              String SEEN_TIMESTAMP_COLUMN = "seen_timestamp";
          }
  
          /**
           * The views that allow querying {@link android.telephony.ims.RcsIncomingMessage} and
           * {@link android.telephony.ims.RcsOutgoingMessage} at the same time.
           */
          interface RcsUnifiedMessageColumns extends RcsIncomingMessageColumns,
                  RcsOutgoingMessageColumns {
              /**
               * The path that is used to query all {@link android.telephony.ims.RcsMessage} in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String UNIFIED_MESSAGE_URI_PART = "message";
  
              /**
               * The URI to query all types of {@link android.telephony.ims.RcsMessage}s
               */
              Uri UNIFIED_MESSAGE_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      UNIFIED_MESSAGE_URI_PART);
  
              /**
               * The name of the view that unites rcs_message and rcs_incoming_message tables.
               */
              String UNIFIED_INCOMING_MESSAGE_VIEW = "unified_incoming_message_view";
  
              /**
               * The name of the view that unites rcs_message and rcs_outgoing_message tables.
               */
              String UNIFIED_OUTGOING_MESSAGE_VIEW = "unified_outgoing_message_view";
  
              /**
               * The column that shows from which table the message entry came from.
               */
              String MESSAGE_TYPE_COLUMN = "message_type";
  
              /**
               * Integer returned as a result from a database query that denotes that the message is
               * an incoming message
               */
              int MESSAGE_TYPE_INCOMING = 1;
  
              /**
               * Integer returned as a result from a database query that denotes that the message is
               * an outgoing message
               */
              int MESSAGE_TYPE_OUTGOING = 0;
          }
  
          /**
           * The table that {@link android.telephony.ims.RcsFileTransferPart} gets persisted to.
           */
          interface RcsFileTransferColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsFileTransferPart}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String FILE_TRANSFER_URI_PART = "file_transfer";
  
              /**
               * The URI to query or modify {@link android.telephony.ims.RcsFileTransferPart}s via the
               * content provider
               */
              Uri FILE_TRANSFER_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      FILE_TRANSFER_URI_PART);
  
              /**
               * The globally unique file transfer ID for this RCS file transfer.
               */
              String FILE_TRANSFER_ID_COLUMN = "rcs_file_transfer_id";
  
              /**
               * The RCS session ID for this file transfer. The ID is implementation dependent but
               * should be unique.
               */
              String SESSION_ID_COLUMN = "session_id";
  
              /**
               * The URI that points to the content of this file transfer
               */
              String CONTENT_URI_COLUMN = "content_uri";
  
              /**
               * The file type of this file transfer in bytes. The validity of types is not enforced
               * in {@link android.telephony.ims.RcsMessageStore} APIs.
               */
              String CONTENT_TYPE_COLUMN = "content_type";
  
              /**
               * The size of the file transfer in bytes.
               */
              String FILE_SIZE_COLUMN = "file_size";
  
              /**
               * Number of bytes that was successfully transmitted for this file transfer
               */
              String SUCCESSFULLY_TRANSFERRED_BYTES = "transfer_offset";
  
              /**
               * The status of this file transfer
               * @see android.telephony.ims.RcsFileTransferPart.RcsFileTransferStatus
               */
              String TRANSFER_STATUS_COLUMN = "transfer_status";
  
              /**
               * The on-screen width of the file transfer, if it contains multi-media
               */
              String WIDTH_COLUMN = "width";
  
              /**
               * The on-screen height of the file transfer, if it contains multi-media
               */
              String HEIGHT_COLUMN = "height";
  
              /**
               * The duration of the content in milliseconds if this file transfer contains
               * multi-media
               */
              String DURATION_MILLIS_COLUMN = "duration";
  
              /**
               * The URI to the preview of the content of this file transfer
               */
              String PREVIEW_URI_COLUMN = "preview_uri";
  
              /**
               * The type of the preview of the content of this file transfer. The validity of types
               * is not enforced in {@link android.telephony.ims.RcsMessageStore} APIs.
               */
              String PREVIEW_TYPE_COLUMN = "preview_type";
          }
  
          /**
           * The table that holds the information for
           * {@link android.telephony.ims.RcsGroupThreadEvent} and its subclasses.
           */
          interface RcsThreadEventColumns {
              /**
               * The string used in the {@link com.android.providers.telephony.RcsProvider} URI to
               * refer to participant joined events (example URI:
               * {@code content://rcs/group_thread/3/participant_joined_event})
               */
              String PARTICIPANT_JOINED_URI_PART = "participant_joined_event";
  
              /**
               * The string used in the {@link com.android.providers.telephony.RcsProvider} URI to
               * refer to participant left events. (example URI:
               * {@code content://rcs/group_thread/3/participant_left_event/4})
               */
              String PARTICIPANT_LEFT_URI_PART = "participant_left_event";
  
              /**
               * The string used in the {@link com.android.providers.telephony.RcsProvider} URI to
               * refer to name changed events. (example URI:
               * {@code content://rcs/group_thread/3/name_changed_event})
               */
              String NAME_CHANGED_URI_PART = "name_changed_event";
  
              /**
               * The string used in the {@link com.android.providers.telephony.RcsProvider} URI to
               * refer to icon changed events. (example URI:
               * {@code content://rcs/group_thread/3/icon_changed_event})
               */
              String ICON_CHANGED_URI_PART = "icon_changed_event";
  
              /**
               * The unique ID of this event in the database, i.e. the primary key
               */
              String EVENT_ID_COLUMN = "event_id";
  
              /**
               * The type of this event
               *
               * @see RcsEventTypes
               */
              String EVENT_TYPE_COLUMN = "event_type";
  
              /**
               * The timestamp in milliseconds of when this event happened
               */
              String TIMESTAMP_COLUMN = "origination_timestamp";
  
              /**
               * The participant that generated this event
               */
              String SOURCE_PARTICIPANT_ID_COLUMN = "source_participant";
  
              /**
               * The receiving participant of this event if this was an
               * {@link android.telephony.ims.RcsGroupThreadParticipantJoinedEvent} or
               * {@link android.telephony.ims.RcsGroupThreadParticipantLeftEvent}
               */
              String DESTINATION_PARTICIPANT_ID_COLUMN = "destination_participant";
  
              /**
               * The URI for the new icon of the group thread if this was an
               * {@link android.telephony.ims.RcsGroupThreadIconChangedEvent}
               */
              String NEW_ICON_URI_COLUMN = "new_icon_uri";
  
              /**
               * The URI for the new name of the group thread if this was an
               * {@link android.telephony.ims.RcsGroupThreadNameChangedEvent}
               */
              String NEW_NAME_COLUMN = "new_name";
          }
  
          /**
           * The table that {@link android.telephony.ims.RcsParticipantAliasChangedEvent} gets
           * persisted to
           */
          interface RcsParticipantEventColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsParticipantAliasChangedEvent}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String ALIAS_CHANGE_EVENT_URI_PART = "alias_change_event";
  
              /**
               * The new alias of the participant
               */
              String NEW_ALIAS_COLUMN = "new_alias";
          }
  
          /**
           * These values are used in {@link com.android.providers.telephony.RcsProvider} to determine
           * what kind of event is present in the storage.
           */
          interface RcsEventTypes {
              /**
               * Integer constant that is stored in the
               * {@link com.android.providers.telephony.RcsProvider} database that denotes the event
               * is of type {@link android.telephony.ims.RcsParticipantAliasChangedEvent}
               */
              int PARTICIPANT_ALIAS_CHANGED_EVENT_TYPE = 1;
  
              /**
               * Integer constant that is stored in the
               * {@link com.android.providers.telephony.RcsProvider} database that denotes the event
               * is of type {@link android.telephony.ims.RcsGroupThreadParticipantJoinedEvent}
               */
              int PARTICIPANT_JOINED_EVENT_TYPE = 2;
  
              /**
               * Integer constant that is stored in the
               * {@link com.android.providers.telephony.RcsProvider} database that denotes the event
               * is of type {@link android.telephony.ims.RcsGroupThreadParticipantLeftEvent}
               */
              int PARTICIPANT_LEFT_EVENT_TYPE = 4;
  
              /**
               * Integer constant that is stored in the
               * {@link com.android.providers.telephony.RcsProvider} database that denotes the event
               * is of type {@link android.telephony.ims.RcsGroupThreadIconChangedEvent}
               */
              int ICON_CHANGED_EVENT_TYPE = 8;
  
              /**
               * Integer constant that is stored in the
               * {@link com.android.providers.telephony.RcsProvider} database that denotes the event
               * is of type {@link android.telephony.ims.RcsGroupThreadNameChangedEvent}
               */
              int NAME_CHANGED_EVENT_TYPE = 16;
          }
  
          /**
           * The view that allows unified querying across all events
           */
          interface RcsUnifiedEventHelper extends RcsParticipantEventColumns, RcsThreadEventColumns {
              /**
               * The path that should be used for referring to
               * {@link android.telephony.ims.RcsEvent}s in
               * {@link com.android.providers.telephony.RcsProvider} URIs.
               */
              String RCS_EVENT_QUERY_URI_PATH = "event";
  
              /**
               * The URI to query {@link android.telephony.ims.RcsEvent}s via the content provider.
               */
              Uri RCS_EVENT_QUERY_URI = Uri.withAppendedPath(CONTENT_AND_AUTHORITY,
                      RCS_EVENT_QUERY_URI_PATH);
          }
  
          /**
           * Allows RCS specific canonical address handling.
           */
          interface RcsCanonicalAddressHelper {
              /**
               * Returns the canonical address ID for a canonical address, if now row exists, this
               * will add a row and return its ID. This helper works against the same table used by
               * the SMS and MMS threads, but is accessible only by the phone process for use by RCS
               * message storage.
               *
               * @throws IllegalArgumentException if unable to retrieve or create the canonical
               *                                  address entry.
               */
              static long getOrCreateCanonicalAddressId(
                      ContentResolver contentResolver, String canonicalAddress) {
  
                  Uri.Builder uriBuilder = CONTENT_AND_AUTHORITY.buildUpon();
                  uriBuilder.appendPath("canonical-address");
                  uriBuilder.appendQueryParameter("address", canonicalAddress);
                  Uri uri = uriBuilder.build();
  
                  try (Cursor cursor = contentResolver.query(uri, null, null, null)) {
                      if (cursor != null && cursor.moveToFirst()) {
                          return cursor.getLong(cursor.getColumnIndex(CanonicalAddressesColumns._ID));
                      } else {
                          Rlog.e(TAG, "getOrCreateCanonicalAddressId returned no rows");
                      }
                  }
  
                  Rlog.e(TAG, "getOrCreateCanonicalAddressId failed");
                  throw new IllegalArgumentException(
                          "Unable to find or allocate a canonical address 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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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
           */
          @UnsupportedAppUsage
          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.
           *
           * To avoid issues where applications might cache a part ID, the ID of a deleted part must
           * not be reused to point at a new part.
           */
          public static final class Part implements BaseColumns {
  
              /**
               * Not instantiable.
               * @hide
               */
              private Part() {
              }
  
              /**
               * The {@code content://} style URL for this table. Can be appended with a part ID to
               * address individual parts.
               */
              @NonNull
              public static final Uri CONTENT_URI = Uri.withAppendedPath(Mms.CONTENT_URI, "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.
           * For MSIM, this will return APNs for the default subscription
           * {@link SubscriptionManager#getDefaultSubscriptionId()}. To specify subId for MSIM,
           * use {@link Uri#withAppendedPath(Uri, String)} to append with subscription id.
           */
          @NonNull
          public static final Uri CONTENT_URI = Uri.parse("content://telephony/carriers");
  
          /**
           * The {@code content://} style URL for this table. Used for APN query based on current
           * subscription. Instead of specifying carrier matching information in the selection,
           * this API will return all matching APNs from current subscription carrier and queries
           * will be applied on top of that. If there is no match for MVNO (Mobile Virtual Network
           * Operator) APNs, return APNs from its MNO (based on mccmnc) instead. For MSIM, this will
           * return APNs for the default subscription
           * {@link SubscriptionManager#getDefaultSubscriptionId()}. To specify subId for MSIM,
           * use {@link Uri#withAppendedPath(Uri, String)} to append with subscription id.
           */
          @NonNull
          public static final Uri SIM_APN_URI = Uri.parse(
                  "content://telephony/carriers/sim_apn_list");
  
          /**
           * 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. For MSIM, this will return APNs for the default
           * subscription {@link SubscriptionManager#getDefaultSubscriptionId()}. To specify subId
           * for MSIM, use {@link Uri#withAppendedPath(Uri, String)} to append with subscription id.
           * @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>
           * @deprecated Use {@link #SIM_APN_URI} to query APN instead, this API will return
           * matching APNs based on current subscription carrier, thus no need to specify MCC and
           * other carrier matching information. In the future, Android will not support MCC for
           * APN query.
           */
          public static final String MCC = "mcc";
  
          /**
           * Mobile Network Code (MNC).
           * <P>Type: TEXT</P>
           * @deprecated Use {@link #SIM_APN_URI} to query APN instead, this API will return
           * matching APNs based on current subscription carrier, thus no need to specify MNC and
           * other carrier matching information. In the future, Android will not support MNC for
           * APN query.
           */
          public static final String MNC = "mnc";
  
          /**
           * Numeric operator ID (as String). Usually {@code MCC + MNC}.
           * <P>Type: TEXT</P>
           * @deprecated Use {@link #SIM_APN_URI} to query APN instead, this API will return
           * matching APNs based on current subscription carrier, thus no need to specify Numeric
           * and other carrier matching information. In the future, Android will not support Numeric
           * for APN query.
           */
          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>
           * @deprecated Use {@link #SIM_APN_URI} to query APN instead, this API will return
           * matching APNs based on current subscription carrier, thus no need to specify MVNO_TYPE
           * and other carrier matching information. In the future, Android will not support MVNO_TYPE
           * for APN query.
           */
          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>
           * @deprecated Use {@link #SIM_APN_URI} to query APN instead, this API will return
           * matching APNs based on current subscription carrier, thus no need to specify
           * MVNO_MATCH_DATA and other carrier matching information. In the future, Android will not
           * support MVNO_MATCH_DATA for APN query.
           */
          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";
  
          /**
           * If set to {@code true}, then the APN setting will persist to the modem.
           * <p>Type: INTEGER (boolean)</p>
           *@hide
           */
          @SystemApi
          public static final String MODEM_PERSIST = "modem_cognitive";
  
          /**
           * The max number of connections of this APN.
           * <p>Type: INTEGER</p>
           *@hide
           */
          @SystemApi
          public static final String MAX_CONNECTIONS = "max_conns";
  
          /**
           * The wait time for retrying the APN, in milliseconds.
           * <p>Type: INTEGER</p>
           *@hide
           */
          @SystemApi
          public static final String WAIT_TIME_RETRY = "wait_time";
  
          /**
           * The max number of seconds this APN will support its maximum number of connections
           * as defined in {@link #MAX_CONNECTIONS}.
           * <p>Type: INTEGER</p>
           *@hide
           */
          @SystemApi
          public static final String TIME_LIMIT_FOR_MAX_CONNECTIONS = "max_conns_time";
  
          /**
           * The MTU (maximum transmit unit) size of the mobile interface to which the APN is
           * connected, in bytes.
           * <p>Type: INTEGER </p>
           * @hide
           */
          @SystemApi
          public static final String MTU = "mtu";
  
          /**
           * APN edit status. APN could be added/edited/deleted by a user or carrier.
           * see all possible returned APN edit status.
           * <ul>
           *     <li>{@link #UNEDITED}</li>
           *     <li>{@link #USER_EDITED}</li>
           *     <li>{@link #USER_DELETED}</li>
           *     <li>{@link #CARRIER_EDITED}</li>
           *     <li>{@link #CARRIER_DELETED}</li>
           * </ul>
           * <p>Type: INTEGER </p>
           * @hide
           */
          @SystemApi
          public static final String EDITED_STATUS = "edited";
  
          /**
           * {@code true} if this APN visible to the user, {@code false} otherwise.
           * <p>Type: INTEGER (boolean)</p>
           * @hide
           */
          @SystemApi
          public static final String USER_VISIBLE = "user_visible";
  
          /**
           * {@code true} if the user allowed to edit this APN, {@code false} otherwise.
           * <p>Type: INTEGER (boolean)</p>
           * @hide
           */
          @SystemApi
          public static final String USER_EDITABLE = "user_editable";
  
          /**
           * {@link #EDITED_STATUS APN edit status} indicates that this APN has not been edited or
           * fails to edit.
           * <p>Type: INTEGER </p>
           * @hide
           */
          @SystemApi
          public static final @EditStatus int UNEDITED = 0;
  
          /**
           * {@link #EDITED_STATUS APN edit status} indicates that this APN has been edited by users.
           * <p>Type: INTEGER </p>
           * @hide
           */
          @SystemApi
          public static final @EditStatus int USER_EDITED = 1;
  
          /**
           * {@link #EDITED_STATUS APN edit status} indicates that this APN has been deleted by users.
           * <p>Type: INTEGER </p>
           * @hide
           */
          @SystemApi
          public static final @EditStatus int USER_DELETED = 2;
  
          /**
           * {@link #EDITED_STATUS APN edit status} 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;
  
          /**
           * {@link #EDITED_STATUS APN edit status} indicates that this APN has been edited by
           * carriers.
           * <p>Type: INTEGER </p>
           * @hide
           */
          @SystemApi
          public static final @EditStatus int CARRIER_EDITED = 4;
  
          /**
           * {@link #EDITED_STATUS APN edit status} indicates that this APN has been deleted by
           * carriers. CARRIER_DELETED values are currently not used as there is no use case.
           * If they are used, delete() will have to change accordingly. Currently it is hardcoded to
           * USER_DELETED.
           * <p>Type: INTEGER </p>
           * @hide
           */
          public static final @EditStatus int CARRIER_DELETED = 5;
  
          /**
           * {@link #EDITED_STATUS APN edit status} is an intermediate value used to indicate that an
           * entry deleted by the carrier 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 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;
  
          /**
           * The APN set id. When the user manually selects an APN or the framework sets an APN as
           * preferred, all APNs with the same set id as the selected APN should be prioritized over
           * APNs in other sets.
           * <p>Type: INTEGER</p>
           * @hide
           */
          @SystemApi
          public static final String APN_SET_ID = "apn_set_id";
  
          /**
           * Possible value for the {@link #APN_SET_ID} field. By default APNs will not belong to a
           * set. If the user manually selects an APN without apn set id, there is no need to
           * prioritize any specific APN set ids.
           * <p>Type: INTEGER</p>
           * @hide
           */
          @SystemApi
          public static final int NO_APN_SET_ID = 0;
  
          /**
           * A unique carrier id associated with this APN
           * {@see TelephonyManager#getSimCarrierId()}
           * <p>Type: STRING</p>
           */
          public static final String CARRIER_ID = "carrier_id";
  
          /**
           * The skip 464xlat flag. Flag works as follows.
           * {@link #SKIP_464XLAT_DEFAULT}: the APN will skip only APN is IMS and no internet.
           * {@link #SKIP_464XLAT_DISABLE}: the APN will NOT skip 464xlat
           * {@link #SKIP_464XLAT_ENABLE}: the APN will skip 464xlat
           * <p>Type: INTEGER</p>
           *
           * @hide
           */
          public static final String SKIP_464XLAT = "skip_464xlat";
  
          /**
           * Possible value for the {@link #SKIP_464XLAT} field.
           * <p>Type: INTEGER</p>
           *
           * @hide
           */
          public static final int SKIP_464XLAT_DEFAULT = -1;
  
          /**
           * Possible value for the {@link #SKIP_464XLAT} field.
           * <p>Type: INTEGER</p>
           *
           * @hide
           */
          public static final int SKIP_464XLAT_DISABLE = 0;
  
          /**
           * Possible value for the {@link #SKIP_464XLAT} field.
           * <p>Type: INTEGER</p>
           *
           * @hide
           */
          public static final int SKIP_464XLAT_ENABLE = 1;
  
  
          /** @hide */
          @IntDef({
                  UNEDITED,
                  USER_EDITED,
                  USER_DELETED,
                  CARRIER_DELETED,
                  CARRIER_EDITED,
          })
          @Retention(RetentionPolicy.SOURCE)
          public @interface EditStatus {}
  
          /** @hide */
          @IntDef({
                  SKIP_464XLAT_DEFAULT,
                  SKIP_464XLAT_DISABLE,
                  SKIP_464XLAT_ENABLE,
          })
          @Retention(RetentionPolicy.SOURCE)
          public @interface Skip464XlatStatus {}
  
      }
  
      /**
       * 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");
  
          /**
           * The id of the subscription which received this cell broadcast message.
           * <P>Type: INTEGER</P>
           */
          public static final String SUB_ID = "sub_id";
  
          /**
           * 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";
  
          /**
           * The timestamp in millisecond of when the device received the message.
           * <P>Type: BIGINT</P>
           */
          public static final String RECEIVED_TIME = "received_time";
  
          /**
           * Indicates that whether the message has been broadcasted to the application.
           * <P>Type: BOOLEAN</P>
           */
          public static final String MESSAGE_BROADCASTED = "message_broadcasted";
  
          /**
           * The Warning Area Coordinates Elements. This element is used for geo-fencing purpose.
           *
           * The geometry and its coordinates are separated vertical bar, the first item is the
           * geometry type and the remaining items are the parameter of this geometry.
           *
           * Only circle and polygon are supported. The coordinates are represented in Horizontal
           * coordinates format.
           *
           * Coordinate encoding:
           * "latitude, longitude"
           * where -90.00000 <= latitude <= 90.00000 and -180.00000 <= longitude <= 180.00000
           *
           * Polygon encoding:
           * "polygon|lat1,lng1|lat2,lng2|...|latn,lngn"
           * lat1,lng1 ... latn,lngn are the vertices coordinate of the polygon.
           *
           * Circle encoding:
           * "circle|lat,lng|radius".
           * lat,lng is the center of the circle. The unit of circle's radius is meter.
           *
           * Example:
           * "circle|0,0|100" mean a circle which center located at (0,0) and its radius is 100 meter.
           * "polygon|0,1.5|0,1|1,1|1,0" mean a polygon has vertices (0,1.5),(0,1),(1,1),(1,0).
           *
           * There could be more than one geometry store in this field, they are separated by a
           * semicolon.
           *
           * Example:
           * "circle|0,0|100;polygon|0,0|0,1.5|1,1|1,0;circle|100.123,100|200.123"
           *
           * <P>Type: TEXT</P>
           */
          public static final String GEOMETRIES = "geometries";
  
          /**
           * Geo-Fencing Maximum Wait Time in second. The range of the time is [0, 255]. A device
           * shall allow to determine its position meeting operator policy. If the device is unable to
           * determine its position meeting operator policy within the GeoFencing Maximum Wait Time,
           * it shall present the alert to the user and discontinue further positioning determination
           * for the alert.
           *
           * <P>Type: INTEGER</P>
           */
          public static final String MAXIMUM_WAIT_TIME = "maximum_wait_time";
  
          /**
           * 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
          };
  
          /**
           * Query columns for instantiating {@link android.telephony.SmsCbMessage} objects.
           */
          public static final String[] QUERY_COLUMNS_FWK = {
                  _ID,
                  GEOGRAPHICAL_SCOPE,
                  PLMN,
                  LAC,
                  CID,
                  SERIAL_NUMBER,
                  SERVICE_CATEGORY,
                  LANGUAGE_CODE,
                  MESSAGE_BODY,
                  MESSAGE_FORMAT,
                  MESSAGE_PRIORITY,
                  ETWS_WARNING_TYPE,
                  CMAS_MESSAGE_CLASS,
                  CMAS_CATEGORY,
                  CMAS_RESPONSE_TYPE,
                  CMAS_SEVERITY,
                  CMAS_URGENCY,
                  CMAS_CERTAINTY,
                  RECEIVED_TIME,
                  MESSAGE_BROADCASTED,
                  GEOMETRIES,
                  MAXIMUM_WAIT_TIME
          };
      }
  
      /**
       * 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();
              final Parcel p = Parcel.obtain();
              state.writeToParcel(p, 0);
              // Turn the parcel to byte array. Safe to do this because the content values were never
              // written into a persistent storage. ServiceStateProvider keeps values in the memory.
              values.put(SERVICE_STATE, p.marshall());
              return values;
          }
  
          /**
           * The current service state.
           *
           * This is the entire {@link ServiceState} object in byte array.
           *
           * @hide
           */
          public static final String SERVICE_STATE = "service_state";
  
          /**
           * 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#getCdmaNetworkId()}.
           * @hide
           */
          public static final String NETWORK_ID = "network_id";
  
          /**
           * This is the same as {@link ServiceState#getCdmaSystemId()}.
           * @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";
  
          /**
           * The current registered raw data network operator name in long alphanumeric format.
           * <p>
           * This is the same as {@link ServiceState#getOperatorAlphaLongRaw()}.
           * @hide
           */
          public static final String OPERATOR_ALPHA_LONG_RAW = "operator_alpha_long_raw";
  
          /**
           * The current registered raw data network operator name in short alphanumeric format.
           * <p>
           * This is the same as {@link ServiceState#getOperatorAlphaShortRaw()}.
           * @hide
           */
          public static final String OPERATOR_ALPHA_SHORT_RAW = "operator_alpha_short_raw";
      }
  
      /**
       * Contains carrier identification information for the current subscriptions.
       */
      public static final class CarrierId implements BaseColumns {
          /**
           * Not instantiable.
           * @hide
           */
          private CarrierId() {}
  
          /**
           * The {@code content://} style URI for this provider.
           */
          public static final Uri CONTENT_URI = Uri.parse("content://carrier_id");
  
          /**
           * The authority string for the CarrierId Provider
           * @hide
           */
          public static final String AUTHORITY = "carrier_id";
  
  
          /**
           * 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#getSimCarrierId()}
           * 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();
          }
  
          /**
           * Generates a content {@link Uri} used to receive updates on specific carrier identity
           * change on the given subscriptionId returned by
           * {@link TelephonyManager#getSimSpecificCarrierId()}.
           * @see TelephonyManager#ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED
           * <p>
           * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the
           * specific carrier identity {@link TelephonyManager#getSimSpecificCarrierId()}
           * 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 specific carrier identity changes
           */
          @NonNull
          public static Uri getSpecificCarrierIdUriForSubscriptionId(int subscriptionId) {
              return Uri.withAppendedPath(Uri.withAppendedPath(CONTENT_URI, "specific"),
                      String.valueOf(subscriptionId));
          }
  
          /**
           * A user facing carrier name.
           * @see TelephonyManager#getSimCarrierIdName()
           * <P>Type: TEXT </P>
           */
          public static final String CARRIER_NAME = "carrier_name";
  
          /**
           * A unique carrier id
           * @see TelephonyManager#getSimCarrierId()
           * <P>Type: INTEGER </P>
           */
          public static final String CARRIER_ID = "carrier_id";
  
          /**
           * A fine-grained carrier id.
           * The specific carrier ID would be used for configuration purposes, but apps wishing to
           * know about the carrier itself should use the regular carrier ID returned by
           * {@link TelephonyManager#getSimCarrierId()}.
           *
           * @see TelephonyManager#getSimSpecificCarrierId()
           * This is not a database column, only used to notify content observers for
           * {@link #getSpecificCarrierIdUriForSubscriptionId(int)}
           */
          public static final String SPECIFIC_CARRIER_ID = "specific_carrier_id";
  
          /**
           * A user facing carrier name for specific carrier id {@link #SPECIFIC_CARRIER_ID}.
           * @see TelephonyManager#getSimSpecificCarrierIdName()
           * This is not a database column, only used to notify content observers for
           * {@link #getSpecificCarrierIdUriForSubscriptionId(int)}
           */
          public static final String SPECIFIC_CARRIER_ID_NAME = "specific_carrier_id_name";
  
          /**
           * A unique parent carrier id. The parent-child
           * relationship can be used to further differentiate a single carrier by different networks,
           * by prepaid v.s. postpaid. It's an optional field.
           * A carrier id with a valid parent_carrier_id is considered fine-grained specific carrier
           * ID, will not be returned as {@link #CARRIER_ID} but {@link #SPECIFIC_CARRIER_ID}.
           * <P>Type: INTEGER </P>
           * @hide
           */
          public static final String PARENT_CARRIER_ID = "parent_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";
  
              /**
               * Certificate for carrier privilege access rules.
               * <P>Type: TEXT in hex string </P>
               */
              public static final String PRIVILEGE_ACCESS_RULE = "privilege_access_rule";
  
              /**
               * The {@code content://} URI for this table.
               */
              public static final Uri CONTENT_URI = Uri.parse("content://carrier_id/all");
          }
      }
  }
  