Android MMS模块数据存取

Android MMS模块数据存取

数据存储 MMS SMS android 

数据表

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