Android MMS模块数据存取 (转)

http://blog.csdn.net/yy228/article/details/7988986

数据表

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 条，用于确定是否有被锁定的消息