Android MMS模块数据存取
数据表
MMS 模块总共包含 17 张表： addr 、 android_metadata 、 attachments 、 canonical_addresses 、 drm 、 part 、 pdu 、 pending_msgs 、 rate 、 raw 、 sms 、 sr_pending 、 threads 、 words 、 words_content 、 words_segdir 、 words_segments 。
其中， pending_msgs 表用于存储待发送或下载的短信与彩信（有待证实）， 使用 pdu 中的触发器进行插入和删除。 raw 表用于存储接收中的长短信或分段彩信通知。 drm 用于彩信权限管理。 words 开头的表存储了短彩信中的单词 ，用于搜索时使用。 attachments 、 rate 、 sr_pending 表作用未知 。 android_metadata 表存储的是语言信息，就一条记录。
下面是一些常用表的字段及其说明：
threads 表
| 列名 |
类型 |
说明 |
| _id |
integer |
唯一标识，自增，从 1 开始 |
| date |
integer |
会话最新更新时间 |
| message_count |
integer |
当前会话所包含的消息数量 |
| recipient_ids |
text |
接收者（ canonical_addresses 表的 id ）列表，所有接收者以空格隔开 |
| snippet |
text |
最新更新的消息的内容（彩信为主题，短信为正文） |
| snippet_cs |
integer |
snippet 的编码方式，彩信： UTF-8 为 106 ，短信为 0 |
| read |
integer |
是否有未读信息： 0- 未读， 1- 已读 |
| type |
integer |
会话类型， 0- 普通会话（只有一个接收者）， 1- 广播会话（多个接收者） |
| error |
integer |
发送失败的消息（ type=5 ）的数量 |
| has_attachment |
integer |
是否有附件： 0- 无， 1- 有 |
sms 表
| 列名 |
类型 |
说明 |
| _id |
integer |
唯一标识，自增，从 1 开始 |
| thread_id |
integer |
threads 表的 id |
| address |
text |
接收者手机号码，对于一个会话，有可能含有多个接收者，每个人都将收到一条短信 |
| person |
integer |
联系人（模块）列表里的序号，陌生人为 null |
| date |
integer |
时间，以豪秒来表示 |
| protocol |
integer |
协议，分为： 0-SMS_RPOTO ， 1-MMS_PROTO 。成功发送后设置。 |
| read |
integer |
是否阅读： 0- 未读， 1- 已读 |
| status |
integer |
状态： -1 默认值， 0-complete ， 64-pending ， 128-failed |
| type |
integer |
ALL=0;INBOX=1;SENT=2;DRAFT=3;OUTBOX=4;FAILED=5;QUEUED=6; |
| reply_path_present |
integer |
TP-Reply-Path 位的值 0/1 |
| subject |
text |
短信的主题，默认为空 |
| body |
text |
短信内容 |
| service_center |
text |
短信服务中心号码编号 |
| locked |
integer |
此条短信是否已由用户锁定， 0- 未锁定， 1- 已锁定 |
| error_code |
integer |
错误代码，有哪些值暂时未知 |
| seen |
integer |
用于指明该消息是否已被用户看到（非阅读，点开会话列表即可，不用打开会话），仅对收到的消息有用 |
pdu 表
| 列名 |
类型 |
说明 |
| _id |
integer |
唯一标识，自增，从 1 开始 |
| thread_id |
integer |
threads 表的 id |
| date |
integer |
时间，以秒来表示（与短信的不同） |
| msg_box |
integer |
此条彩信属于哪个信箱， all 为 0 ， inbox 为 1 ， sent 为 2 ， draft 为 3 ， outbox 为 4 ， failed 为 5 |
| read |
integer |
此条彩信是否已读： 0- 未读， 1- 已读 |
| m_id |
text |
Message-ID ，由彩信服务器分配的消息 id |
| sub |
text |
此条彩信主题 |
| sub_cs |
integer |
此条彩信主题编码方式： UTF-8 为 106 |
| ct_t |
text |
彩信对应的 Content-Type 是 application/vnd.wap.multipart.related |
| ct_l |
text |
X-Mms-Content-Location |
| exp |
integer |
X-Mms-Expiry ，彩信有效期 |
| m_cls |
text |
X-Mms-Message-Class ，此条彩信的用途： auto ， advertisement ， personal ， informational |
| m_type |
integer |
X-Mms-Message-Type ，由 MMS 协议定义的彩信类型，其中 send-req 为 128 、 notification-ind 为 130 、 retrieve-conf 为 132 |
| v |
integer |
X-Mms-MMS-Version ，此条彩信对应的 MMS 协议的版本号， 1.0 16 ， 1.1 17 ， 1.2 18 ， 1.3 19 |
| m_size |
integer |
X-Mms-MessageSize |
| pri |
integer |
X-Mms-Priority ，此条彩信的优先级， normal 129 ， low 128 ， high 130 |
| rr |
integer |
X-Mms-Read-Report ，此条彩信的阅读报告， 129 |
| rpt_a |
integer |
X-Mms-Report-Allowed |
| resp_st |
integer |
X-Mms-Response-Status |
| st |
integer |
该彩信的下载状态，未启动 -128 ，下载中 -129 ，传输失败 -130 ，保存失败 -135 |
| tr_id |
text |
X-Mms-Transaction-Id ，事务标识 |
| retr_st |
integer |
X-Mms-Retrieve-Status |
| retr_txt |
text |
X-Mms-Retrieve-Text |
| retr_txt_cs |
integer |
RETRIEVE_TEXT 的编码方式 |
| read_status |
integer |
X-Mms-Read-Status |
| ct_cls |
integer |
X-Mms-Content-Class |
| resp_txt |
text |
X-Mms-Response-Text |
| d_tm |
integer |
X-Mms-Delivery-Time |
| d_rpt |
integer |
X-Mms-Delivery-Report ，此条彩信的传输报告，是 -128 ，否 - 129 |
| locked |
integer |
此条彩信是否已由用户锁定， 0- 未锁定， 1- 已锁定 |
| seen |
integer |
用于指明该消息是否已被用户看到（非阅读，点开会话列表即可，不用打开会话），仅对收到的消息有用 |
part 表
| 列名 |
类型 |
说明 |
| _id |
integer |
唯一标识，自增，从 1 开始 |
| mid |
integer |
pdu 表的 id |
| seq |
integer |
标志 part 的顺序，若 ct 为 application/smil ，则为 -1 ，否则为 0 |
| ct |
text |
此 PART 内容类型，如果是彩信始末： application/smil ； 如果是文本附件： text/plain ； 图像附件： jpg ： image/jpeg ， gif ： image/gif ； 音频附件： audio/mpeg |
| name |
text |
该 PART 的名字 |
| chset |
integer |
该 PART 的编码方式， UTF-8 为 106 |
| cd |
text |
CONTENT_DISPOSITION |
| fn |
text |
该 PART 的文件名称 |
| cid |
text |
CONTENT_ID ，该 PART 内容的 id |
| cl |
text |
该 PART 的文件的位置 |
| ctt_s |
integer |
CONTENT_TYPE 内容类型在消息中的起始位置， 未在代码中设置 |
| ctt_t |
text |
CONTENT_TYPE 内容类型的类型， 未在代码中设置 |
| _data |
text |
彩信附件在手机上的地址 |
| text |
text |
如果是彩信始末，为彩信的 SMIL 内容；如果是文本附件，为附件内容；如果是视频、音频附件，此参数为空 |
addr 表
| 列名 |
类型 |
说明 |
| _id |
integer |
唯一标识，自增，从 1 开始 |
| msg_id |
integer |
pdu 表的 id |
| contact_id |
integer |
电话本中联系人的 id |
| address |
text |
电话号码，如果为 insert-address-token 且 type 为 151 ，说明为本机号码 |
| type |
integer |
电话号码的类型，必须为 PduHeaders.BCC-129 ， PduHeaders.CC-130 ， PduHeaders.FROM-137 ， PduHeaders.TO-151 之一 |
| charset |
integer |
电话号码编码方式 |
canonical_addresses 表
| 列名 |
类型 |
说明 |
| _id |
integer |
唯一标识，自增，从 1 开始 |
| address |
text |
所有曾经使用过的接收者的电话号码，用于 threads 表标识会话 |
ContentProvider
MMS 模块的数据存储主要依赖三个 ContentProvider ： SmsProvider 、 MmsProvider 、 MmsSmsProvider ，以及一个辅助类 Telephony 。
其中， SmsProvider 用于短信相关数据的存取， MmsProvider 用于彩信相关数据的存取， MmsSmsProvider 则用于短彩信通用数据的存取，如会话信息、接收者、草稿（公共属性）等。
Telephony 则提供了一系列 Uri 、常量字符串、列名数组、方法以方便用户使用这三个 ContentProvider 。
SmsProvider
短信的 uri 以 content://sms 开头。
可以使用 Telephony 中的 Sms 类提供的公共变量进行构造 Uri ，甚至使用其中提供的一些 addMessage （将信息存入各个不同的信箱）、 saveMessage （更新已存在的草稿）、 addMessageToUri （插入数据到指定 Uri ）、 moveMessageToFolder （将信息移到某一信箱）方法简化操作。
UriMatcher 中配置了 27 种类型：
| AUTHORITY |
PATH |
类型 |
说明 |
| sms |
SMS_ALL |
所有短信 |
|
| sms |
# |
SMS_ALL_ID |
指定了_id 的短信 |
| sms |
inbox |
SMS_INBOX |
位于收件箱的短信 |
| sms |
inbox/# |
SMS_INBOX_ID |
位于收件箱的指定了_id 的短信 |
| sms |
sent |
SMS_SENT |
已成功发送出去的短信 |
| sms |
sent/# |
SMS_SENT_ID |
已成功发送出去的指定了_id 的短信 |
| sms |
draft |
SMS_DRAFT |
位于草稿箱的短信 |
| sms |
draft |
SMS_DRAFT_ID |
位于草稿箱的指定了_id 的短信 |
| sms |
outbox |
SMS_OUTBOX |
已从队列中取出进行处理但未成功发送出去的短信 |
| sms |
outbox/# |
SMS_OUTBOX_ID |
已从队列中取出进行处理但未成功发送出去的指定了_id 的短信 |
| sms |
undelivered |
SMS_UNDELIVERED |
未成功发送出去的短信（包括发送失败、草稿、队列中的） |
| sms |
failed |
SMS_FAILED |
发送失败的短信 |
| sms |
failed/# |
SMS_FAILED_ID |
发送失败的指定了_id 的短信 |
| sms |
queued |
SMS_QUEUED |
队列中的短信 |
| sms |
conversations |
SMS_CONVERSATIONS |
所有会话包含的短信数量、内容、会话id |
| sms |
conversations/* |
SMS_CONVERSATIONS_ID |
指定会话id 的短信 |
| sms |
raw |
SMS_RAW_MESSAGE |
raw 表中的短信（临时短信，用于接收长短信时使用） |
| sms |
attachments |
SMS_ATTACHMENT |
往attachments 表中插入或查询信息 |
| sms |
attachments/# |
SMS_ATTACHMENT_ID |
从attachments 表中查询指定sms_id 的信息 |
| sms |
threadID |
SMS_NEW_THREAD_ID |
往canonical_addresses 表中插入信息 |
| sms |
threadID/* |
SMS_QUERY_THREAD_ID |
查询canonical_addresses 中所有信息 |
| sms |
status/# |
SMS_STATUS_ID |
查询或更新指定id 的短信（没有什么特殊功能，有可能没用上） |
| sms |
sr_pending |
SMS_STATUS_PENDING |
对sr_pending 表进行操作时用的 |
| sms |
icc |
SMS_ALL_ICC |
所有存在SIM/UIM 卡上的短信 |
| sms |
icc/# |
SMS_ICC |
指定id 的存在SIM/UIM 卡上的短信 |
| sms |
sim |
SMS_ALL_ICC |
所有存在SIM/UIM 卡上的短信 |
| sms |
sim/# |
SMS_ICC |
指定id 的存在SIM/UIM 卡上的短信 |
MmsProvider
短信的 uri 以 content://mms 开头。
可以使用 Telephony 中的 Mms 类提供的公共变量进行构造 Uri ，甚至使用其中提供的一些 query （查询）、 isEmailAddress 、 isPhoneNumber 方法简化操作。
UriMatcher 中配置了 21 种类型：
| AUTHORITY |
PATH |
类型 |
说明 |
| mms |
MMS_ALL |
所有彩信 |
|
| mms |
# |
MMS_ALL_ID |
指定了id 的彩信 |
| mms |
inbox |
MMS_INBOX |
位于收件箱的彩信 |
| mms |
inbox/# |
MMS_INBOX_ID |
位于收件箱的指定了_id 的彩信 |
| mms |
sent |
MMS_SENT |
已成功发送出去的彩信 |
| mms |
sent/# |
MMS_SENT_ID |
已成功发送出去的指定了_id 的彩信 |
| mms |
drafts |
MMS_DRAFTS |
位于草稿箱的彩信 |
| mms |
drafts/# |
MMS_DRAFTS_ID |
位于草稿箱的指定了_id 的彩信 |
| mms |
outbox |
MMS_OUTBOX |
已开始进行处理但未成功发送出去的短信 |
| mms |
outbox/# |
MMS_OUTBOX_ID |
已开始进行处理但未成功发送出去的指定了_id 的短信 |
| mms |
part |
MMS_ALL_PART |
对part 表的查询与删除 |
| mms |
#/part |
MMS_MSG_PART |
对part 表的指定了msg_id 的记录的增、删、改、查 |
| mms |
part/# |
MMS_PART_ID |
对part 表的指定了id 的记录的删、改、查 |
| mms |
#/addr |
MMS_MSG_ADDR |
对addr 表的指定了msg_id 的记录的增、删、查 |
| mms |
rate |
MMS_SENDING_RATE |
查询rate 表中的信息，删除1 小时以前的记录并插入新记录 |
| mms |
report-status/# |
MMS_REPORT_STATUS |
查询指定id 的彩信的状态（SQL 语句很复杂） |
| mms |
report-request/# |
MMS_REPORT_REQUEST |
查询指定id 的，addr 表的type 为151 的彩信（同report-status 一起使用） |
| mms |
drm |
MMS_DRM_STORAGE |
对drm 表的删除与插入 |
| mms |
drm/# |
MMS_DRM_STORAGE_ID |
对指定了id 的drm 表的数据的查询 |
| mms |
threads |
MMS_THREADS |
对pdu 表按thread_id 分组统计（即获取所有包含彩信的thread_id ） |
| mms |
scrapSpace |
MMS_SCRAP_SPACE |
当添加附件时选择拍照，用于获取临时存储空间时使用 |
MmsSmsProvider
该 ContentProvider 的 uri 以 content://mms-sms 开头。
可以使用 Telephony 中的 MmsSms 类提供的公共变量进行构造 Uri 。
UriMatcher 中配置了 18 种类型：
| AUTHORITY |
PATH |
类型 |
说明 |
| mms-sms |
conversations |
URI_CONVERSATIONS |
用于删除所有会话或查询所有会话（查询分两种模式：1 、指定了simple 为true ，则仅仅从threads 表中查询数据；2 、未指定，则分别从sms 和pdu 表查询最新的不算草稿的短信和彩信） |
| mms-sms |
complete-conversations |
URI_COMPLETE_CONVERSATION |
查询已完成的消息（包括非草稿短彩信，已完全接收或已发送出去的彩信） |
| mms-sms |
conversations/# |
URI_CONVERSATIONS_MESSAGES |
用于查询（指定id 的会话的消息）、删除、更新（分别更新pdu 和sms 表）指定id 的会话 |
| mms-sms |
conversations/#/recipients |
URI_CONVERSATIONS_RECIPIENTS |
用于查询指定id 的会话 |
| mms-sms |
conversations/#/subject |
URI_CONVERSATIONS_SUBJECT |
同上 |
| mms-sms |
conversations/obsolete |
URI_OBSOLETE_THREADS |
用于删除没有消息的会话 |
| mms-sms |
messages/byphone/* |
URI_MESSAGES_BY_PHONE |
用于查询接收者中包含指定电话号码的消息 |
| mms-sms |
threadID |
URI_THREAD_ID |
获取指定接收者（附加的查询参数recipient ）的会话id ，若不存在，新增 |
| mms-sms |
canonical-address/# |
URI_CANONICAL_ADDRESS |
查询或更新指定id 的canonical_address 表中的数据 |
| mms-sms |
canonical-addresses |
URI_CANONICAL_ADDRESSES |
查询canonical_address 表中的数据 |
| mms-sms |
search |
URI_SEARCH |
从短信和彩信中搜索符合给定的pattern 的数据 |
| mms-sms |
searchSuggest |
URI_SEARCH_SUGGEST |
从word 表中搜索符合给定的pattern 的数据，上限50 条 |
| mms-sms |
pending |
URI_PENDING_MSG |
查询( 可指定protocol 为sms 或mms ，message 为某个msg_id) 或更新pending_msgs 表 |
| mms-sms |
undelivered |
URI_UNDELIVERED_MSG |
查询所有未成功发送的短信与彩信 |
| mms-sms |
notifications |
URI_NOTIFICATIONS |
无代码处理 |
| mms-sms |
draft |
URI_DRAFT |
查询所有短信与彩信的草稿，最多输出threadid 与id 列 |
| mms-sms |
locked |
URI_FIRST_LOCKED_MESSAGE_ALL |
查询所有会话中的被锁定的消息，仅输出1 条，用于确定是否有被锁定的消息 |
| mms-sms |
locked/# |
URI_FIRST_LOCKED_MESSAGE_BY_THREAD_ID |
查询指定threadId 的会话中的被锁定的消息，仅输出1 条，用于确定是否有被锁定的消息 |