/** Copyright (C) 2006 The Android Open Source Project** Licensed under the Apache License, Version 2.0 (the "License");* you may not use this file except in compliance with the License.* You may obtain a copy of the License at** http://www.apache.org/licenses/LICENSE-2.0** Unless required by applicable law or agreed to in writing, software* distributed under the License is distributed on an "AS IS" BASIS,* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.* See the License for the specific language governing permissions and* limitations under the License.*/package android.provider;import android.annotation.SdkConstant;import android.annotation.SdkConstant.SdkConstantType;import android.content.ContentResolver;import android.content.ContentValues;import android.content.Context;import android.content.Intent;import android.database.Cursor;import android.database.sqlite.SqliteWrapper;import android.net.Uri;import android.os.Environment;import android.telephony.SmsMessage;import android.text.TextUtils;import android.util.Log;import android.util.Patterns;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.** @hide*/public final class Telephony {private static final String TAG = "Telephony";private static final boolean DEBUG = true;private static final boolean LOCAL_LOGV = false;// Constructorpublic Telephony() {}/*** Base columns for tables that contain text based SMSs.*/public interface TextBasedSmsColumns {/*** The type of the message* <P>Type: INTEGER</P>*/public static final String TYPE = "type";public static final int MESSAGE_TYPE_ALL = 0;public static final int MESSAGE_TYPE_INBOX = 1;public static final int MESSAGE_TYPE_SENT = 2;public static final int MESSAGE_TYPE_DRAFT = 3;public static final int MESSAGE_TYPE_OUTBOX = 4;public static final int MESSAGE_TYPE_FAILED = 5; // for failed outgoing messagespublic static final int MESSAGE_TYPE_QUEUED = 6; // for messages to send later/*** 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 person ID of the sender* <P>Type: INTEGER (long)</P>*/public static final String PERSON_ID = "person";/*** 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";/*** Indicates whether this message has been seen by the user. The "seen" flag will be* used to figure out whether we need to throw up a statusbar notification or not.*/public static final String SEEN = "seen";/*** The TP-Status value for the message, or -1 if no status has* been received*/public static final String STATUS = "status";public static final int STATUS_NONE = -1;public static final int STATUS_COMPLETE = 0;public static final int STATUS_PENDING = 32;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 content://contacts/people)</P>*/public static final String PERSON = "person";/*** The protocol identifier code* <P>Type: INTEGER</P>*/public static final String PROTOCOL = "protocol";/*** Whether the <code>TP-Reply-Path</code> bit was set on this message* <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";/*** Has the message been locked?* <P>Type: INTEGER (boolean)</P>*/public static final String LOCKED = "locked";/*** Error code associated with sending or receiving this message* <P>Type: INTEGER</P>*/public static final String ERROR_CODE = "error_code";/*** Meta data used externally.* <P>Type: TEXT</P>*/public static final String META_DATA = "meta_data";}/*** Contains all text based SMS messages.*/public static final class Sms implements BaseColumns, TextBasedSmsColumns {public static final Cursor query(ContentResolver cr, String[] projection) {return cr.query(CONTENT_URI, projection, null, null, DEFAULT_SORT_ORDER);}public static final 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 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 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* @return the URI for the new message*/public static Uri addMessageToUri(ContentResolver resolver,Uri uri, String address, String body, String subject,Long date, boolean read, boolean deliveryReport) {return addMessageToUri(resolver, uri, address, body, subject,date, read, deliveryReport, -1L);}/*** 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* @return the URI for the new message*/public static Uri addMessageToUri(ContentResolver resolver,Uri uri, String address, String body, String subject,Long date, boolean read, boolean deliveryReport, long threadId) {ContentValues values = new ContentValues(7);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*/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, Integer.valueOf(0));} else if (markAsRead) {values.put(READ, Integer.valueOf(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.*/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's inbox.*/public static final class Inbox implements BaseColumns, TextBasedSmsColumns {/*** The 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 psuedo-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*/public static Uri addMessage(ContentResolver resolver,String address, String body, String subject, Long date,boolean read) {return addMessageToUri(resolver, CONTENT_URI, address, body,subject, date, read, false);}}/*** Contains all sent text based SMS messages in the SMS app's.*/public static final class Sent implements BaseColumns, TextBasedSmsColumns {/*** The 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 psuedo-subject of the message* @param date the timestamp for the message* @return the URI for the new message*/public static Uri addMessage(ContentResolver resolver,String address, String body, String subject, Long date) {return addMessageToUri(resolver, CONTENT_URI, address, body,subject, date, true, false);}}/*** Contains all sent text based SMS messages in the SMS app's.*/public static final class Draft implements BaseColumns, TextBasedSmsColumns {/*** The content:// style URL for this table*/public static final Uri CONTENT_URI =Uri.parse("content://sms/draft");/*** 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 psuedo-subject of the message* @param date the timestamp for the message* @return the URI for the new message*/public static Uri addMessage(ContentResolver resolver,String address, String body, String subject, Long date) {return addMessageToUri(resolver, CONTENT_URI, address, body,subject, date, true, false);}/*** Save over an existing draft message.** @param resolver the content resolver to use* @param uri of existing message* @param body the new body for the draft message* @return true is successful, false otherwise*/public static boolean saveMessage(ContentResolver resolver,Uri uri, String body) {ContentValues values = new ContentValues(2);values.put(BODY, body);values.put(DATE, System.currentTimeMillis());return resolver.update(uri, values, null, null) == 1;}}/*** Contains all pending outgoing text based SMS messages.*/public static final class Outbox implements BaseColumns, TextBasedSmsColumns {/*** The 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 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* @return the URI for the new message*/public static Uri addMessage(ContentResolver resolver,String address, String body, String subject, Long date,boolean deliveryReport, long threadId) {return addMessageToUri(resolver, CONTENT_URI, address, body,subject, date, true, deliveryReport, threadId);}}/*** Contains all sent text-based SMS messages in the SMS app's.*/public static final class Conversationsimplements BaseColumns, TextBasedSmsColumns {/*** The 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 info about SMS related Intents that are broadcast.*/public static final class Intents {/*** Set by BroadcastReceiver. Indicates the message was handled* successfully.*/public static final int RESULT_SMS_HANDLED = 1;/*** Set by BroadcastReceiver. Indicates a generic error while* processing the message.*/public static final int RESULT_SMS_GENERIC_ERROR = 2;/*** Set by BroadcastReceiver. Indicates insufficient memory to store* the message.*/public static final int RESULT_SMS_OUT_OF_MEMORY = 3;/*** Set by BroadcastReceiver. Indicates the message, while* possibly valid, is of a format or encoding that is not* supported.*/public static final int RESULT_SMS_UNSUPPORTED = 4;/*** Broadcast Action: A new text based SMS message has been received* by the device. The intent will have the following extra* values:</p>** <ul>* <li><em>pdus</em> - An Object[] od 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>*/@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. 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>*/@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. The intent will have the following extra* values:</p>** <ul>* <li><em>transactionId (Integer)</em> - The WAP transaction ID</li>* <li><em>pduType (Integer)</em> - The WAP PDU type</li>* <li><em>header (byte[])</em> - The header of the message</li>* <li><em>data (byte[])</em> - The data payload of the message</li>* <li><em>contentTypeParameters (HashMap<String,String>)</em>* - 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>*/@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>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>*/@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)public static final String SMS_CB_RECEIVED_ACTION ="android.provider.Telephony.SMS_CB_RECEIVED";/*** 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>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>*/@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)public static final String SMS_EMERGENCY_CB_RECEIVED_ACTION ="android.provider.Telephony.SMS_EMERGENCY_CB_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.*/@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, eg,* <code>{@link #RESULT_SMS_OUT_OF_MEMORY}</code>,* indicating the error returned to the network.</li>* </ul>*/@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)public static final String SMS_REJECTED_ACTION ="android.provider.Telephony.SMS_REJECTED";/*** 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 = (Object[]) intent.getSerializableExtra("pdus");String format = intent.getStringExtra("format");byte[][] pduObjs = new byte[messages.length][];for (int i = 0; i < messages.length; i++) {pduObjs[i] = (byte[]) messages[i];}byte[][] pdus = new byte[pduObjs.length][];int pduCount = pdus.length;SmsMessage[] msgs = new SmsMessage[pduCount];for (int i = 0; i < pduCount; i++) {pdus[i] = pduObjs[i];msgs[i] = SmsMessage.createFromPdu(pdus[i], format);}return msgs;}}}/*** Base columns for tables that contain MMSs.*/public interface BaseMmsColumns extends BaseColumns {public static final int MESSAGE_BOX_ALL = 0;public static final int MESSAGE_BOX_INBOX = 1;public static final int MESSAGE_BOX_SENT = 2;public static final int MESSAGE_BOX_DRAFTS = 3;public static final int MESSAGE_BOX_OUTBOX = 4;/*** 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 belong to, for example, 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";/*** Indicates whether this message has been seen by the user. The "seen" flag will be* used to figure out whether we need to throw up a statusbar notification or not.*/public static final String SEEN = "seen";/*** The 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 Content-Type of the message.* <P>Type: TEXT</P>*/public static final String CONTENT_TYPE = "ct_t";/*** The Content-Location of the message.* <P>Type: TEXT</P>*/public static final String CONTENT_LOCATION = "ct_l";/*** The address of the sender.* <P>Type: TEXT</P>*/public static final String FROM = "from";/*** The address of the recipients.* <P>Type: TEXT</P>*/public static final String TO = "to";/*** The address of the cc. recipients.* <P>Type: TEXT</P>*/public static final String CC = "cc";/*** The address of the bcc. recipients.* <P>Type: TEXT</P>*/public static final String BCC = "bcc";/*** The expiry time of the message.* <P>Type: INTEGER</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 specification that this message conform.* <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: TEXT</P>*/public static final String PRIORITY = "pri";/*** The read-report of the message.* <P>Type: TEXT</P>*/public static final String READ_REPORT = "rr";/*** Whether the report is allowed.* <P>Type: TEXT</P>*/public static final String REPORT_ALLOWED = "rpt_a";/*** The response-status of the message.* <P>Type: INTEGER</P>*/public static final String RESPONSE_STATUS = "resp_st";/*** The status of the message.* <P>Type: INTEGER</P>*/public static final String STATUS = "st";/*** The transaction-id of the message.* <P>Type: TEXT</P>*/public static final String TRANSACTION_ID = "tr_id";/*** The retrieve-status of the message.* <P>Type: INTEGER</P>*/public static final String RETRIEVE_STATUS = "retr_st";/*** The 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: TEXT</P>*/public static final String RETRIEVE_TEXT_CHARSET = "retr_txt_cs";/*** The read-status of the message.* <P>Type: INTEGER</P>*/public static final String READ_STATUS = "read_status";/*** The content-class of the message.* <P>Type: INTEGER</P>*/public static final String CONTENT_CLASS = "ct_cls";/*** The delivery-report of the message.* <P>Type: INTEGER</P>*/public static final String DELIVERY_REPORT = "d_rpt";/*** The delivery-time-token of the message.* <P>Type: INTEGER</P>*/public static final String DELIVERY_TIME_TOKEN = "d_tm_tok";/*** The delivery-time of the message.* <P>Type: INTEGER</P>*/public static final String DELIVERY_TIME = "d_tm";/*** The response-text of the message.* <P>Type: TEXT</P>*/public static final String RESPONSE_TEXT = "resp_txt";/*** The sender-visibility of the message.* <P>Type: TEXT</P>*/public static final String SENDER_VISIBILITY = "s_vis";/*** The reply-charging of the message.* <P>Type: INTEGER</P>*/public static final String REPLY_CHARGING = "r_chg";/*** The reply-charging-deadline-token of the message.* <P>Type: INTEGER</P>*/public static final String REPLY_CHARGING_DEADLINE_TOKEN = "r_chg_dl_tok";/*** The reply-charging-deadline of the message.* <P>Type: INTEGER</P>*/public static final String REPLY_CHARGING_DEADLINE = "r_chg_dl";/*** The reply-charging-id of the message.* <P>Type: TEXT</P>*/public static final String REPLY_CHARGING_ID = "r_chg_id";/*** The reply-charging-size of the message.* <P>Type: INTEGER</P>*/public static final String REPLY_CHARGING_SIZE = "r_chg_sz";/*** The previously-sent-by of the message.* <P>Type: TEXT</P>*/public static final String PREVIOUSLY_SENT_BY = "p_s_by";/*** The previously-sent-date of the message.* <P>Type: INTEGER</P>*/public static final String PREVIOUSLY_SENT_DATE = "p_s_d";/*** The store of the message.* <P>Type: TEXT</P>*/public static final String STORE = "store";/*** The mm-state of the message.* <P>Type: INTEGER</P>*/public static final String MM_STATE = "mm_st";/*** The mm-flags-token of the message.* <P>Type: INTEGER</P>*/public static final String MM_FLAGS_TOKEN = "mm_flg_tok";/*** The mm-flags of the message.* <P>Type: TEXT</P>*/public static final String MM_FLAGS = "mm_flg";/*** The store-status of the message.* <P>Type: TEXT</P>*/public static final String STORE_STATUS = "store_st";/*** The store-status-text of the message.* <P>Type: TEXT</P>*/public static final String STORE_STATUS_TEXT = "store_st_txt";/*** The stored of the message.* <P>Type: TEXT</P>*/public static final String STORED = "stored";/*** The totals of the message.* <P>Type: TEXT</P>*/public static final String TOTALS = "totals";/*** The mbox-totals of the message.* <P>Type: TEXT</P>*/public static final String MBOX_TOTALS = "mb_t";/*** The mbox-totals-token of the message.* <P>Type: INTEGER</P>*/public static final String MBOX_TOTALS_TOKEN = "mb_t_tok";/*** The quotas of the message.* <P>Type: TEXT</P>*/public static final String QUOTAS = "qt";/*** The mbox-quotas of the message.* <P>Type: TEXT</P>*/public static final String MBOX_QUOTAS = "mb_qt";/*** The mbox-quotas-token of the message.* <P>Type: INTEGER</P>*/public static final String MBOX_QUOTAS_TOKEN = "mb_qt_tok";/*** The message-count of the message.* <P>Type: INTEGER</P>*/public static final String MESSAGE_COUNT = "m_cnt";/*** The start of the message.* <P>Type: INTEGER</P>*/public static final String START = "start";/*** The distribution-indicator of the message.* <P>Type: TEXT</P>*/public static final String DISTRIBUTION_INDICATOR = "d_ind";/*** The element-descriptor of the message.* <P>Type: TEXT</P>*/public static final String ELEMENT_DESCRIPTOR = "e_des";/*** The limit of the message.* <P>Type: INTEGER</P>*/public static final String LIMIT = "limit";/*** The recommended-retrieval-mode of the message.* <P>Type: INTEGER</P>*/public static final String RECOMMENDED_RETRIEVAL_MODE = "r_r_mod";/*** The recommended-retrieval-mode-text of the message.* <P>Type: TEXT</P>*/public static final String RECOMMENDED_RETRIEVAL_MODE_TEXT = "r_r_mod_txt";/*** The status-text of the message.* <P>Type: TEXT</P>*/public static final String STATUS_TEXT = "st_txt";/*** The applic-id of the message.* <P>Type: TEXT</P>*/public static final String APPLIC_ID = "apl_id";/*** The reply-applic-id of the message.* <P>Type: TEXT</P>*/public static final String REPLY_APPLIC_ID = "r_apl_id";/*** The aux-applic-id of the message.* <P>Type: TEXT</P>*/public static final String AUX_APPLIC_ID = "aux_apl_id";/*** The drm-content of the message.* <P>Type: TEXT</P>*/public static final String DRM_CONTENT = "drm_c";/*** The adaptation-allowed of the message.* <P>Type: TEXT</P>*/public static final String ADAPTATION_ALLOWED = "adp_a";/*** The replace-id of the message.* <P>Type: TEXT</P>*/public static final String REPLACE_ID = "repl_id";/*** The cancel-id of the message.* <P>Type: TEXT</P>*/public static final String CANCEL_ID = "cl_id";/*** The cancel-status of the message.* <P>Type: INTEGER</P>*/public static final String CANCEL_STATUS = "cl_st";/*** The thread ID of the message* <P>Type: INTEGER</P>*/public static final String THREAD_ID = "thread_id";/*** Has the message been locked?* <P>Type: INTEGER (boolean)</P>*/public static final String LOCKED = "locked";/*** Meta data used externally.* <P>Type: TEXT</P>*/public static final String META_DATA = "meta_data";}/*** 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 Threads.COMMON_THREAD or* 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";}/*** Helper functions for the "threads" table used by MMS and SMS.*/public static final class Threads implements ThreadsColumns {private static final String[] ID_PROJECTION = { BaseColumns._ID };private static final String STANDARD_ENCODING = "UTF-8";private static final Uri THREAD_ID_CONTENT_URI = Uri.parse("content://mms-sms/threadID");public static final Uri CONTENT_URI = Uri.withAppendedPath(MmsSms.CONTENT_URI, "conversations");public static final Uri OBSOLETE_THREADS_URI = Uri.withAppendedPath(CONTENT_URI, "obsolete");public static final int COMMON_THREAD = 0;public static final int BROADCAST_THREAD = 1;// No one should construct an instance of this class.private Threads() {}/*** This is a single-recipient version of* getOrCreateThreadId. It's convenient for use with SMS* messages.*/public static long getOrCreateThreadId(Context context, String recipient) {Set<String> recipients = new HashSet<String>();recipients.add(recipient);return getOrCreateThreadId(context, recipients);}/*** Given the recipients list and subject of an unsaved message,* return its thread ID. If the message starts a new thread,* allocate a new thread ID. Otherwise, use the appropriate* existing thread ID.** Find the thread ID of the same set of recipients (in* any order, without any additions). If one* is found, return it. Otherwise, return a unique thread ID.*/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) Log.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 {Log.e(TAG, "getOrCreateThreadId returned no rows!");}} finally {cursor.close();}}Log.e(TAG, "getOrCreateThreadId failed with uri " + uri.toString());throw new IllegalArgumentException("Unable to find or allocate a thread ID.");}}/*** Contains all MMS messages.*/public static final class Mms implements BaseMmsColumns {/*** The content:// style URL for this table*/public static final Uri CONTENT_URI = Uri.parse("content://mms");public static final Uri REPORT_REQUEST_URI = Uri.withAppendedPath(CONTENT_URI, "report-request");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";/*** mailbox = name-addr* name-addr = [display-name] angle-addr* angle-addr = [CFWS] "<" addr-spec ">" [CFWS]*/public static final Pattern NAME_ADDR_EMAIL_PATTERN =Pattern.compile("\\s*(\"[^\"]*\"|[^<>\"]+)\\s*<([^<>]+)>\\s*");/*** quoted-string = [CFWS]* DQUOTE *([FWS] qcontent) [FWS] DQUOTE* [CFWS]*/public static final Pattern QUOTED_STRING_PATTERN =Pattern.compile("\\s*\"([^\"]*)\"\\s*");public static final Cursor query(ContentResolver cr, String[] projection) {return cr.query(CONTENT_URI, projection, null, null, DEFAULT_SORT_ORDER);}public static final Cursor query(ContentResolver cr, String[] projection,String where, String orderBy) {return cr.query(CONTENT_URI, projection,where, null, orderBy == null ? DEFAULT_SORT_ORDER : orderBy);}public static final String getMessageBoxName(int msgBox) {switch (msgBox) {case MESSAGE_BOX_ALL:return "all";case MESSAGE_BOX_INBOX:return "inbox";case MESSAGE_BOX_SENT:return "sent";case MESSAGE_BOX_DRAFTS:return "drafts";case MESSAGE_BOX_OUTBOX:return "outbox";default:throw new IllegalArgumentException("Invalid message box: " + msgBox);}}public static String extractAddrSpec(String address) {Matcher match = NAME_ADDR_EMAIL_PATTERN.matcher(address);if (match.matches()) {return match.group(2);}return address;}/*** Returns true if the address is an email address** @param address the input address to be tested* @return true if address is an email address*/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();}/*** Returns true if the number is a Phone number** @param number the input number to be tested* @return true if number is a Phone number*/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's inbox.*/public static final class Inbox implements BaseMmsColumns {/*** The content:// style URL for this table*/public static final UriCONTENT_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's sent box.*/public static final class Sent implements BaseMmsColumns {/*** The content:// style URL for this table*/public static final UriCONTENT_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's drafts box.*/public static final class Draft implements BaseMmsColumns {/*** The content:// style URL for this table*/public static final UriCONTENT_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's outbox.*/public static final class Outbox implements BaseMmsColumns {/*** The content:// style URL for this table*/public static final UriCONTENT_URI = Uri.parse("content://mms/outbox");/*** The default sort order for this table*/public static final String DEFAULT_SORT_ORDER = "date DESC";}public static final class Addr implements BaseColumns {/*** The ID of MM which this address entry belongs to.*/public static final String MSG_ID = "msg_id";/*** The ID of contact entry in Phone Book.*/public static final String CONTACT_ID = "contact_id";/*** The address text.*/public static final String ADDRESS = "address";/*** Type of address, must be one of PduHeaders.BCC,* PduHeaders.CC, PduHeaders.FROM, PduHeaders.TO.*/public static final String TYPE = "type";/*** Character set of this entry.*/public static final String CHARSET = "charset";}public static final class Part implements BaseColumns {/*** 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";public static final String TEXT = "text";}public static final class Rate {public static final Uri CONTENT_URI = Uri.withAppendedPath(Mms.CONTENT_URI, "rate");/*** When a message was successfully sent.* <P>Type: INTEGER</P>*/public static final String SENT_TIME = "sent_time";}public static final class Intents {private Intents() {// Non-instantiatable.}/*** The extra field to store the contents of the Intent,* which should be an array of Uri.*/public static final String EXTRA_CONTENTS = "contents";/*** The extra field to store the type of the contents,* which should be an array of String.*/public static final String EXTRA_TYPES = "types";/*** The extra field to store the 'Cc' addresses.*/public static final String EXTRA_CC = "cc";/*** The extra field to store the 'Bcc' addresses;*/public static final String EXTRA_BCC = "bcc";/*** The extra field to store the 'Subject'.*/public static final String EXTRA_SUBJECT = "subject";/*** Indicates that the contents of specified URIs were changed.* The application which is showing or caching these contents* should be updated.*/public static final StringCONTENT_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 {/*** The column to distinguish SMS & MMS messages in query results.*/public static final String TYPE_DISCRIMINATOR_COLUMN ="transport_type";public static final Uri CONTENT_URI = Uri.parse("content://mms-sms/");public static final Uri CONTENT_CONVERSATIONS_URI = Uri.parse("content://mms-sms/conversations");public static final Uri CONTENT_FILTER_BYPHONE_URI = Uri.parse("content://mms-sms/messages/byphone");public static final Uri CONTENT_UNDELIVERED_URI = Uri.parse("content://mms-sms/undelivered");public static final Uri CONTENT_DRAFT_URI = Uri.parse("content://mms-sms/draft");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 thread_id ASC,date DESC.*/public static final Uri SEARCH_URI = Uri.parse("content://mms-sms/search");// Constants for message protocol types.public static final int SMS_PROTO = 0;public static final int MMS_PROTO = 1;// Constants for error types of pending messages.public static final int NO_ERROR = 0;public static final int ERR_TYPE_GENERIC = 1;public static final int ERR_TYPE_SMS_PROTO_TRANSIENT = 2;public static final int ERR_TYPE_MMS_PROTO_TRANSIENT = 3;public static final int ERR_TYPE_TRANSPORT_FAILURE = 4;public static final int ERR_TYPE_GENERIC_PERMANENT = 10;public static final int ERR_TYPE_SMS_PROTO_PERMANENT = 11;public static final int ERR_TYPE_MMS_PROTO_PERMANENT = 12;public static final class PendingMessages implements BaseColumns {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</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.*/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.*/public static final String DUE_TIME = "due_time";/*** The time we last tried to send or download the message.*/public static final String LAST_TRY = "last_try";}public static final class WordsTable {public static final String ID = "_id";public static final String SOURCE_ROW_ID = "source_id";public static final String TABLE_ID = "table_to_use";public static final String INDEXED_TEXT = "index_text";}}public static final class Carriers implements BaseColumns {/*** The content:// style URL for this table*/public static final Uri CONTENT_URI =Uri.parse("content://telephony/carriers");/*** The default sort order for this table*/public static final String DEFAULT_SORT_ORDER = "name ASC";public static final String NAME = "name";public static final String APN = "apn";public static final String PROXY = "proxy";public static final String PORT = "port";public static final String MMSPROXY = "mmsproxy";public static final String MMSPORT = "mmsport";public static final String SERVER = "server";public static final String USER = "user";public static final String PASSWORD = "password";public static final String MMSC = "mmsc";public static final String MCC = "mcc";public static final String MNC = "mnc";public static final String NUMERIC = "numeric";public static final String AUTH_TYPE = "authtype";public static final String TYPE = "type";public static final String INACTIVE_TIMER = "inactivetimer";// Only if enabled try Data Connection.public static final String ENABLED = "enabled";// Rules apply based on class.public static final String CLASS = "class";/*** The protocol to be used to connect to this APN.** One of the PDP_type values in TS 27.007 section 10.1.1.* For example, "IP", "IPV6", "IPV4V6", or "PPP".*/public static final String PROTOCOL = "protocol";/*** The protocol to be used to connect to this APN when roaming.** The syntax is the same as protocol.*/public static final String ROAMING_PROTOCOL = "roaming_protocol";public static final String CURRENT = "current";/*** Current status of APN* true : enabled APN, false : disabled APN.*/public static final String CARRIER_ENABLED = "carrier_enabled";/*** Radio Access Technology info* To check what values can hold, refer to ServiceState.java.* This should be spread to other technologies,* but currently only used for LTE(14) and EHRPD(13).*/public static final String BEARER = "bearer";}public static final class Intents {private Intents() {// Not instantiable}/*** Broadcast Action: A "secret code" has been entered in the dialer. Secret codes are* of the form *#*#<code>#*#*. The intent will have the data URI:</p>** <p><code>android_secret_code://<code></code></p>*/public static final String SECRET_CODE_ACTION ="android.provider.Telephony.SECRET_CODE";/*** Broadcast Action: The Service Provider string(s) have been updated. Activities or* services that use these strings should update their display.* The intent will have the following extra values:</p>* <ul>* <li><em>showPlmn</em> - Boolean that indicates whether the PLMN should be shown.</li>* <li><em>plmn</em> - The operator name of the registered network, as a string.</li>* <li><em>showSpn</em> - Boolean that indicates whether the SPN should be shown.</li>* <li><em>spn</em> - The service provider name, as a string.</li>* </ul>* Note that <em>showPlmn</em> may indicate that <em>plmn</em> should be displayed, even* though the value for <em>plmn</em> is null. This can happen, for example, if the phone* has not registered to a network yet. In this case the receiver may substitute an* appropriate placeholder string (eg, "No service").** It is recommended to display <em>plmn</em> before / above <em>spn</em> if* both are displayed.** <p>Note this is a protected intent that can only be sent* by the system.*/public static final String SPN_STRINGS_UPDATED_ACTION ="android.provider.Telephony.SPN_STRINGS_UPDATED";public static final String EXTRA_SHOW_PLMN = "showPlmn";public static final String EXTRA_PLMN = "plmn";public static final String EXTRA_SHOW_SPN = "showSpn";public static final String EXTRA_SPN = "spn";}}
Monday, July 22, 2013
platform_frameworks_base / core / java / android / provider / Telephony.java on ics-mr1-release
https://github.com/android/platform_frameworks_base/blob/ics-mr1-release/core/java/android/provider/Telephony.java#L1095
Subscribe to:
Posts (Atom)