Messaging 数据库结构入门指南

Messaging 数据库结构入门指南

适合刚接触短信应用开发的同学，帮助快速理解数据是怎么存储的。

一、整体概览

短信应用的数据存在一个叫bugle_db的 SQLite 数据库里。
核心文件是：

src/com/android/messaging/datamodel/DatabaseHelper.java

整个数据库可以用一句话概括：

会话（Conversations）包含消息（Messages），消息包含附件（Parts），参与者（Participants）关联到会话。

二、核心表结构

1. conversations — 会话表

作用：每一行代表一个聊天窗口（一个联系人或一个群组）。

提示：打开短信列表，每一行对应这张表的一条记录。

2. messages — 消息表

作用：存储每一条具体的短信/彩信/RCS 消息。

提示：进入某个会话后，聊天气泡列表对应这张表的记录，通过conversation_id过滤。

3. parts — 附件/内容表

作用：存储消息的具体内容，包括文字、图片、音频、视频等。
一条消息（message）可以有多个 part（比如彩信里同时有文字和图片）。

提示：

• 普通短信：一条 message 对应一个 part，content_type = "text/plain"，正文在text字段。
• 彩信/RCS：一条 message 可能对应多个 part，分别存图片、文字等。

4. participants — 参与者表

作用：存储所有联系人/自己的信息，类似一个本地通讯录缓存。

提示：sub_id = -1的记录代表对方联系人，sub_id >= 0的代表本机 SIM 卡（即"自己"）。

5. conversation_participants — 会话参与者关联表

作用：多对多关联表，记录哪些参与者在哪个会话里（群发/群聊用）。

三、表关系图

participants (参与者) │ │ sender_id / self_id ▼ conversations (会话) ──────────── conversation_participants │ │ │ conversation_id │ participant_id ▼ ▼ messages (消息) participants │ │ message_id ▼ parts (附件/内容)

四、常见查询场景

查询某个会话的所有消息

SELECTm.*,p.text,p.content_type,p.uriFROMmessages mJOINparts pONp.message_id=m._idWHEREm.conversation_id=?ORDERBYm.received_timestampASC;

查询所有未读消息数

SELECTCOUNT(*)FROMmessagesWHEREread=0;

查询某个会话的参与者

SELECTpt.*FROMparticipants ptJOINconversation_participants cpONcp.participant_id=pt._idWHEREcp.conversation_id=?;

五、删除级联规则

数据库设置了ON DELETE CASCADE，删除时会自动清理关联数据：

删除 conversation → 自动删除所有关联的 messages 和 parts 删除 message → 自动删除所有关联的 parts

所以删会话不需要手动清消息，数据库会自动处理。

六、RCS 扩展字段说明

如果你看到字段名以rcs_开头，这些是 RCS（富媒体通信服务，即"5G消息"）的扩展字段，普通短信不会用到，新手可以先忽略。

七、Content Provider URI

应用通过以下 URI 访问数据（不直接操作 SQLite）：

文档基于 Messaging 实际代码生成，核心文件：DatabaseHelper.java