短彩信相关设计文档.doc

copyright of archermind i 短彩信相关设计文档短彩信相关设计文档 copyright of archermind ii 文档管理信息表文档管理信息表 主题主题 版本版本 内容内容 关键字关键字 参考文档参考文档 创建时间创建时间 创建人创建人 最新发布日期最新发布日期 文档变更纪录文档变更纪录 更改人更改人日期日期更改内容更改内容 张飞、张健2012-1-5创建文件 copyright of archermind iii 目目 录录 1开发规划开发规划.1 1.1背景说明.1 1.2中国移动规范需求.1 1.3开发环境和工具.1 1.4开发规范.1 2总体设计总体设计.2 2.1基本设计描述.2 .1系统总体逻辑结构图2 2.2模块列表.3 3数据结构数据结构.4 3.1数据库表列表.4 3.2原短彩信数据库基础下增加的三个表结构.4 4接口规范接口规范.6 4.1对于安全信箱数据库操作接口.6 5模块设计模块设计.7 5.1sim 卡信箱设计.7 .1模块设计描述7 .2模块界面描述9 5.2信箱模式设计.11 .1模块设计描述11 6附录附录.14 6.1总结.14 参考资料.14 n831 项目.短彩信信箱模式设计文档 1 1 1开发规划 1.11.1背景说明背景说明 信箱模式是中国移动针对 android 手机定制的一个模块，专门针对使用习惯信箱模式 的用户开发的，与 android 自带的会话模式短彩信相辅相成，共同构造了短彩信的应用程 序。 1.21.2中国移动规范需求中国移动规范需求 信息菜单下设置收件箱、发件箱、草稿、已发信息 4 个文件夹。收件箱保存客户接收 到的信息；发件箱保存正在发送的信息；草稿保存客户已编辑的草稿信息；已发信息保存 客户已经成功发送的信息。 1.31.3开发环境和工具开发环境和工具 开发工具 工具工具作用作用 java进行应用程序的编写语言 eclipse编写工具 vm对于编写好的应用程序进行编译 1.41.4开发规范开发规范 文档名称文档名称位置位置 java 语言编码规范 android 语言规范 n831 项目.短彩信信箱模式设计文档 2 2 2总体设计 2.12.1基本设计描述基本设计描述 信箱模式设计思路为在用户进入 mms 时，可以根据用户的使用习惯自由选择使用会话 模式或者是信箱模式进行短彩信的管理，如果用户选择进入的是信箱模式，可以通过 menu 选项切换回会话模式，同样可以使用类似方法切换回信箱模式。 信箱模式中主要包括如下几个模块：1. 新建信息 2. 几种常用信息箱体 3. sim 卡 信箱管理 4. 安全信箱进入入口 对于各种箱体信息的操作为大部分手机的模式，不再详细说明。 对于安全信箱的设计是以信箱模式为基础，增加了一个登陆界面，只有登陆成功后才 会进入信箱模式，由于处于相对保密性，使得搜索等程序不能查看到安全信箱的内容，这 里对于存储安全信箱的信息专门做了一个独立的数据库进行存储。 sim 卡信箱的设计时，由于直接读取 sim 卡信息较为耗时，为了使得用户体验最好， 在开机的时候会在本地同步 sim 卡中的信息，在操作 sim 卡信息时同时操作本地数据， 使得其完全同步，而在 sim 卡信箱中显示的是本地数据，这样会使得用户的体验更加流畅。 .1 系统总体逻辑结构图 信箱模式为短彩信模块的一个子模块，这里主要绘制出了信箱模式的结构图，会话模 式为谷歌 android 信息机制，这里不再进行累述。 n831 项目.短彩信信箱模式设计文档 3 2.22.2模块列表模块列表 下表主要对于信箱模式中的几个模块进行了罗列 模块名称模块名称(英文英文)功能功能 收件箱存用户接收到的信息 发件箱保存正在发送的信息 已发送保存用户已经成功发送的信息 草稿箱保存用户已编辑的草稿信息 sim 卡信箱存储从 sim 卡中同步过来的短信 安全信箱保存用户的私密信息，需要密码才能进入 n831 项目.短彩信信箱模式设计文档 4 3 3数据结构 3.13.1数据库表列表数据库表列表 表名表名作用作用 safety_mms_info存储彩信附件相关的信息 safety_mms_sms_info存储短彩信基本数据信息 icc_sms用来同步 sim 卡中存储的信息 3.23.2原短彩信数据库基础下增加的三个表结构原短彩信数据库基础下增加的三个表结构 安全信箱数据库设计-彩信数据表设计 字段类型描述 _idinteger 主键约束 msg_idinteger 对应于移动前原数据库中的信息 id attachment_uritext 附件 uri sizelong 彩信大小 message_typeinteger 彩信类型(彩信|彩信通知) 安全信箱数据库设计-基本数据表设计 字段类型描述 _idinteger 主键约束 msg_idinteger 对应于移动前原数据库中的信息 id nametext 联系人姓名 addresstext 联系人号码 msg_typeinteger 短信(1027)|彩信(1024) typeinteger 信息对应箱体(发件箱、收件箱、已发送) bodytext 短信内容 timelong 发送|接收时间 subjecttext 信息主题 header_uritext 联系人头像图片的 uri statusinteger 信息状态(发送失败、消息报告等) readinteger 该信息是否已读 n831 项目.短彩信信箱模式设计文档 5 sim 卡信箱数据库设计 字段类型描述 _idinteger 主键约束 index_on_iccinteger 该短信在 sim 卡中存贮的位置 addresstext 对方号码 transport_typetext 信息类型 dateinteger 短息日期 statusinteger 短息状态 lockedinteger 该短信是否被锁定 erro_codeinteger 默认为 0，目前没有用到 bodytext 信息内容 service_center_addresstext 服务中心号码 deletedinteger 该信息是否被删除 n831 项目.短彩信信箱模式设计文档 6 4 4接口规范 由于开发时间有限，在开发过程中没有专门针对信箱模式进行接口设计，大部分功能 接口使用的是原会话模式短彩信机制的接口，对于安全信箱是属于独立于短彩信的机 制因此有安全信箱的数据操作接口设计。 4.14.1对于安全信箱数据库操作接口对于安全信箱数据库操作接口 在 telephonyprovider 中增加了 safetycontentprovider 用于对安全信箱数据库的操作；在 mms 应用中，设计了一个 safetyoperation 类用于对安全信箱数据库接口的调用，在下面列 举几个常用的方法 1.public void movesmstosafety(int msgid) 根据短信 id 将短信移动到安全信箱中 2.public boolean movemessagetonormal(int safetymsgid) 根据安全信箱中的信息 id 将信息移动到原短信数据库中 3.public cursor querysafetymessagebyid(int id) 根据信息 id 查询出单条安全信箱中的信息 4.public uri insertsmstosafetybox(safetymessagemodel model) 将一条信息插入到安全信箱中 5.public int deletesafetysms(int id) 根据 id 删除一条安全信箱中的信息 6.public cursor queryallinformations(int box, int msgtype) 根据信箱类型以及信息类型查询出该信箱中的所有信息 7. public int querysafetymessagecount() 查询安全信箱的信息数量 8. public int querysafetymessagecount(int type) 查询安全信箱中某一箱体的信息计数 n831 项目.短彩信信箱模式设计文档 7 5 5模块设计 5.15.1sim 卡信箱设计卡信箱设计 .1 模块设计描述 由于从 sim 卡中读取短信数据速度很慢，为了优化用户体验，sim 卡信箱中 的短信数据完全来自于本地数据库中的表：icc_sms，该数据库中的数据完全同步 自 sim 卡中所存储的短信数据，确保本地数据与 sim 卡中的短信数据在进行增、 删、改等操作后仍能完全保持一致： （1）每次开机收到开机广播后，会扫描 sim 卡，将 sim 卡中存储的短信同 步到本地数据库的 icc_sms 表中，同步完成之前无法进入 sim 卡信箱。 if(action.eqauls(intent.action_boot_completed) /接收开机广播 boot_completed = false; / boot_completed 为 false 时不能进入 sim 卡信箱 arraylist messages = smsmanager.getallmessagesfromicc(); /获取 sim 卡中存储的所有短信 for(int i=0;i0) cursor.movetonext(); scaddr = cursor.getstring(0); date = cursor.getlong(1); type = cursor.getint(2); /获取需要移动的短信数据 values.put(“index_on_icc“,iccindex); values.put(“address“,number); values.put(“date“,date); if(type = 1) values.put(“status“,1); if(type = 2) values.put(“status“,5); if(type = 5) values.put(“status“,7); values.put(“body“,item.mbody); values.put(“service_center_address“,scaddr); values.put(“deleted“, 0); mcontentresolver.insert(uri.parse(“content:/sms/icc_sms“), values); /将需要移动的短信数据存储到本地数据库 icc_sms 表中 if (type = 1 ) /inbox smanager.copymessagetoicc(phonenumberuworkportionto calledpartybcdwithlength(scaddr), pdu, 1); if (type = 2 ) /sent smanager.copymessagetoicc(subpdu.encodedscaddress, subpdu.encodedmessage, 5); if (type = 5 ) /sent fail smanager.copymessagetoicc(subpdu.encodedscaddress, subpdu.encodedmessage, 7); /将需要移动的短信数据存储到 sim 卡中 （6）sim 卡信箱支持短信复制到手机内存、单挑删除、多条删除、回复、转发、 呼叫对方号码、查看 sim 卡短信存储状态等操作。 .2 模块界面描述 n831 项目.短彩信信箱模式设计文档 10 1.在短彩信设置界面中有个选项默认短信存储到 sim 卡，如果选中后会在接收到新 的短信时将信息存储到 sim 卡中； 2.进入 sim 卡信箱列表界面后，针对某一信息长按会有如图 2 的各项操作 图 1 图 2 3.在短彩信列表界面中会有删除全部信息以及查看 sim 卡信息存储状态，如图 3 4.在会话模式中可以将某一条选中的短信移动到 sim 卡信箱中 图 3 图 4 n831 项目.短彩信信箱模式设计文档 11 5.25.2信箱模式设计信箱模式设计 .1 模块设计描述 信箱模式的设计是区别与谷歌原短彩信机制中的会话模式，会话模式是针对与联系人 而建立的阅读信息的模式，而信箱模式是根据中移动要求，根据信息的状态专门设计的一 种信息查看模式，其中包括了新建信息、收件箱、发件箱、已发送、草稿箱、sim 卡信箱 以及安全信箱等，在每种箱体右侧会有该箱体内有多少条信息，而如 sim 卡信息未未读 22 条，总共有 47 条，收件箱也会如此显示，只有所有未读信息都已读或者删除才会如其他箱 体显示为数目，如图（1） 。 （1） (2) 新建信息与会话模式中的新建信息点击后为同一页面，因此不做详细描述； 对于收件箱，一般收到的短彩信都是会保存在收件箱中的，如果新收到的信息还未读， 那么就会高亮显示以区分已读短信。彩信的话会在右侧有附件图标显示以区分短信和彩信。 而对于信息的操作有 3 种方式，一种为长按事件（2） ，一种为 menu 事件（4） ，再就 是单击事件。 收件箱、发件箱、已发送、草稿箱为同一类型，跳转到同一页面进行列表显示，而根 据箱体的不同，长按事件会有不同的操作，例如收件箱中会有回复，而其余几个箱体中就 没有等；menu 事件为新建事件与删除事件，而此处的删除事件为多删事件，将进入另一个 专门删除信息的工作界面进行数据的删除，如图（3） n831 项目.短彩信信箱模式设计文档 12 （3） （4） （5） 发件箱中的信息是用户在信息编辑界面编辑完信息并发送后信息会先保存在发件箱中， 如果发送成功就会转移到已发送信箱中去，而发送失败的信息会一直保存在发件箱中。 草稿箱为用户保存的草稿信息，由于信箱模式并没有专门设计一套数据存储结构，所 以针对于一个号码只可以保存一条草稿信息。 当然在每个界面中都提供多项删除信息功能(3)。 sim 卡信息的功能比较特殊，因此专门作为一个章节进行描述。 n831 项目.短彩信信箱模式设计文档 13 安全信箱是为了使用户将一些私密信息保存起来而专门设计的，用户必须登录后才能 进入安全信箱查看内容。 安全信箱为基于信箱模式而设计的，因此界面操作几乎相同。 设计思路为用户收到信息后，都是保存在普通信息的，用户可以将需要保密的信息移 动到安全信箱中，在安全信箱中提供了发件箱、收件箱、已发送，对应于移动前的信箱。 当然，用户可以将安全信箱中的信息再次移动到普通信箱中去。注：在安全信箱中设计的 新信息只是为了方便用户编辑信息发送信息，并不是在安全信箱中编辑的信息发送后就会 存储在安全信箱相应信箱中。 安全信箱的数据存储与普通信箱的数据存储不为同一数据库，因此，常见的专门对应 于 android 短彩信的查看工具或者短彩信搜索功能是看不到安全信箱中的信息的。 n831 项目.短彩信信箱模式设计文档 14 6 6附录 6.16.1总结总结 对于信箱模式下的设计中，在进入某一箱体后，由于是将短信或者彩信加载完成后才 会显示出来，所以在手机存储的短信和彩信数量过大的时候，会有一些延时，我们做 了数据加载进度条进行等待；对于列表的刷新，由于数据的处理加载比较耗时，考虑 到用户使用的流畅问题，因此在进入某一箱体后没有做即时刷新数据处理，只是在箱 体列表后面对于某一箱体数量的计数做了即时刷新处理；对于安全信箱中，由于彩