短彩信相關(guān)設(shè)計(jì)文檔.doc

copyright of archermind i 短彩信相關(guān)設(shè)計(jì)文檔短彩信相關(guān)設(shè)計(jì)文檔 copyright of archermind ii 文檔管理信息表文檔管理信息表 主題主題 版本版本 內(nèi)容內(nèi)容 關(guān)鍵字關(guān)鍵字 參考文檔參考文檔 創(chuàng)建時(shí)間創(chuàng)建時(shí)間 創(chuàng)建人創(chuàng)建人 最新發(fā)布日期最新發(fā)布日期 文檔變更紀(jì)錄文檔變更紀(jì)錄 更改人更改人日期日期更改內(nèi)容更改內(nèi)容 張飛、張健2012-1-5創(chuàng)建文件 copyright of archermind iii 目目 錄錄 1開(kāi)發(fā)規(guī)劃開(kāi)發(fā)規(guī)劃.1 1.1背景說(shuō)明.1 1.2中國(guó)移動(dòng)規(guī)范需求.1 1.3開(kāi)發(fā)環(huán)境和工具.1 1.4開(kāi)發(fā)規(guī)范.1 2總體設(shè)計(jì)總體設(shè)計(jì).2 2.1基本設(shè)計(jì)描述.2 .1系統(tǒng)總體邏輯結(jié)構(gòu)圖2 2.2模塊列表.3 3數(shù)據(jù)結(jié)構(gòu)數(shù)據(jù)結(jié)構(gòu).4 3.1數(shù)據(jù)庫(kù)表列表.4 3.2原短彩信數(shù)據(jù)庫(kù)基礎(chǔ)下增加的三個(gè)表結(jié)構(gòu).4 4接口規(guī)范接口規(guī)范.6 4.1對(duì)于安全信箱數(shù)據(jù)庫(kù)操作接口.6 5模塊設(shè)計(jì)模塊設(shè)計(jì).7 5.1sim 卡信箱設(shè)計(jì).7 .1模塊設(shè)計(jì)描述7 .2模塊界面描述9 5.2信箱模式設(shè)計(jì).11 .1模塊設(shè)計(jì)描述11 6附錄附錄.14 6.1總結(jié).14 參考資料.14 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 1 1 1開(kāi)發(fā)規(guī)劃 1.11.1背景說(shuō)明背景說(shuō)明 信箱模式是中國(guó)移動(dòng)針對(duì) android 手機(jī)定制的一個(gè)模塊，專門(mén)針對(duì)使用習(xí)慣信箱模式 的用戶開(kāi)發(fā)的，與 android 自帶的會(huì)話模式短彩信相輔相成，共同構(gòu)造了短彩信的應(yīng)用程 序。 1.21.2中國(guó)移動(dòng)規(guī)范需求中國(guó)移動(dòng)規(guī)范需求 信息菜單下設(shè)置收件箱、發(fā)件箱、草稿、已發(fā)信息 4 個(gè)文件夾。收件箱保存客戶接收 到的信息；發(fā)件箱保存正在發(fā)送的信息；草稿保存客戶已編輯的草稿信息；已發(fā)信息保存 客戶已經(jīng)成功發(fā)送的信息。 1.31.3開(kāi)發(fā)環(huán)境和工具開(kāi)發(fā)環(huán)境和工具 開(kāi)發(fā)工具 工具工具作用作用 java進(jìn)行應(yīng)用程序的編寫(xiě)語(yǔ)言 eclipse編寫(xiě)工具 vm對(duì)于編寫(xiě)好的應(yīng)用程序進(jìn)行編譯 1.41.4開(kāi)發(fā)規(guī)范開(kāi)發(fā)規(guī)范 文檔名稱文檔名稱位置位置 java 語(yǔ)言編碼規(guī)范 android 語(yǔ)言規(guī)范 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 2 2 2總體設(shè)計(jì) 2.12.1基本設(shè)計(jì)描述基本設(shè)計(jì)描述 信箱模式設(shè)計(jì)思路為在用戶進(jìn)入 mms 時(shí)，可以根據(jù)用戶的使用習(xí)慣自由選擇使用會(huì)話 模式或者是信箱模式進(jìn)行短彩信的管理，如果用戶選擇進(jìn)入的是信箱模式，可以通過(guò) menu 選項(xiàng)切換回會(huì)話模式，同樣可以使用類似方法切換回信箱模式。 信箱模式中主要包括如下幾個(gè)模塊：1. 新建信息 2. 幾種常用信息箱體 3. sim 卡 信箱管理 4. 安全信箱進(jìn)入入口 對(duì)于各種箱體信息的操作為大部分手機(jī)的模式，不再詳細(xì)說(shuō)明。 對(duì)于安全信箱的設(shè)計(jì)是以信箱模式為基礎(chǔ)，增加了一個(gè)登陸界面，只有登陸成功后才 會(huì)進(jìn)入信箱模式，由于處于相對(duì)保密性，使得搜索等程序不能查看到安全信箱的內(nèi)容，這 里對(duì)于存儲(chǔ)安全信箱的信息專門(mén)做了一個(gè)獨(dú)立的數(shù)據(jù)庫(kù)進(jìn)行存儲(chǔ)。 sim 卡信箱的設(shè)計(jì)時(shí)，由于直接讀取 sim 卡信息較為耗時(shí)，為了使得用戶體驗(yàn)最好， 在開(kāi)機(jī)的時(shí)候會(huì)在本地同步 sim 卡中的信息，在操作 sim 卡信息時(shí)同時(shí)操作本地?cái)?shù)據(jù)， 使得其完全同步，而在 sim 卡信箱中顯示的是本地?cái)?shù)據(jù)，這樣會(huì)使得用戶的體驗(yàn)更加流暢。 .1 系統(tǒng)總體邏輯結(jié)構(gòu)圖 信箱模式為短彩信模塊的一個(gè)子模塊，這里主要繪制出了信箱模式的結(jié)構(gòu)圖，會(huì)話模 式為谷歌 android 信息機(jī)制，這里不再進(jìn)行累述。 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 3 2.22.2模塊列表模塊列表 下表主要對(duì)于信箱模式中的幾個(gè)模塊進(jìn)行了羅列 模塊名稱模塊名稱(英文英文)功能功能 收件箱存用戶接收到的信息 發(fā)件箱保存正在發(fā)送的信息 已發(fā)送保存用戶已經(jīng)成功發(fā)送的信息 草稿箱保存用戶已編輯的草稿信息 sim 卡信箱存儲(chǔ)從 sim 卡中同步過(guò)來(lái)的短信 安全信箱保存用戶的私密信息，需要密碼才能進(jìn)入 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 4 3 3數(shù)據(jù)結(jié)構(gòu) 3.13.1數(shù)據(jù)庫(kù)表列表數(shù)據(jù)庫(kù)表列表 表名表名作用作用 safety_mms_info存儲(chǔ)彩信附件相關(guān)的信息 safety_mms_sms_info存儲(chǔ)短彩信基本數(shù)據(jù)信息 icc_sms用來(lái)同步 sim 卡中存儲(chǔ)的信息 3.23.2原短彩信數(shù)據(jù)庫(kù)基礎(chǔ)下增加的三個(gè)表結(jié)構(gòu)原短彩信數(shù)據(jù)庫(kù)基礎(chǔ)下增加的三個(gè)表結(jié)構(gòu) 安全信箱數(shù)據(jù)庫(kù)設(shè)計(jì)-彩信數(shù)據(jù)表設(shè)計(jì) 字段類型描述 _idinteger 主鍵約束 msg_idinteger 對(duì)應(yīng)于移動(dòng)前原數(shù)據(jù)庫(kù)中的信息 id attachment_uritext 附件 uri sizelong 彩信大小 message_typeinteger 彩信類型(彩信|彩信通知) 安全信箱數(shù)據(jù)庫(kù)設(shè)計(jì)-基本數(shù)據(jù)表設(shè)計(jì) 字段類型描述 _idinteger 主鍵約束 msg_idinteger 對(duì)應(yīng)于移動(dòng)前原數(shù)據(jù)庫(kù)中的信息 id nametext 聯(lián)系人姓名 addresstext 聯(lián)系人號(hào)碼 msg_typeinteger 短信(1027)|彩信(1024) typeinteger 信息對(duì)應(yīng)箱體(發(fā)件箱、收件箱、已發(fā)送) bodytext 短信內(nèi)容 timelong 發(fā)送|接收時(shí)間 subjecttext 信息主題 header_uritext 聯(lián)系人頭像圖片的 uri statusinteger 信息狀態(tài)(發(fā)送失敗、消息報(bào)告等) readinteger 該信息是否已讀 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 5 sim 卡信箱數(shù)據(jù)庫(kù)設(shè)計(jì) 字段類型描述 _idinteger 主鍵約束 index_on_iccinteger 該短信在 sim 卡中存貯的位置 addresstext 對(duì)方號(hào)碼 transport_typetext 信息類型 dateinteger 短息日期 statusinteger 短息狀態(tài) lockedinteger 該短信是否被鎖定 erro_codeinteger 默認(rèn)為 0，目前沒(méi)有用到 bodytext 信息內(nèi)容 service_center_addresstext 服務(wù)中心號(hào)碼 deletedinteger 該信息是否被刪除 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 6 4 4接口規(guī)范 由于開(kāi)發(fā)時(shí)間有限，在開(kāi)發(fā)過(guò)程中沒(méi)有專門(mén)針對(duì)信箱模式進(jìn)行接口設(shè)計(jì)，大部分功能 接口使用的是原會(huì)話模式短彩信機(jī)制的接口，對(duì)于安全信箱是屬于獨(dú)立于短彩信的機(jī) 制因此有安全信箱的數(shù)據(jù)操作接口設(shè)計(jì)。 4.14.1對(duì)于安全信箱數(shù)據(jù)庫(kù)操作接口對(duì)于安全信箱數(shù)據(jù)庫(kù)操作接口 在 telephonyprovider 中增加了 safetycontentprovider 用于對(duì)安全信箱數(shù)據(jù)庫(kù)的操作；在 mms 應(yīng)用中，設(shè)計(jì)了一個(gè) safetyoperation 類用于對(duì)安全信箱數(shù)據(jù)庫(kù)接口的調(diào)用，在下面列 舉幾個(gè)常用的方法 1.public void movesmstosafety(int msgid) 根據(jù)短信 id 將短信移動(dòng)到安全信箱中 2.public boolean movemessagetonormal(int safetymsgid) 根據(jù)安全信箱中的信息 id 將信息移動(dòng)到原短信數(shù)據(jù)庫(kù)中 3.public cursor querysafetymessagebyid(int id) 根據(jù)信息 id 查詢出單條安全信箱中的信息 4.public uri insertsmstosafetybox(safetymessagemodel model) 將一條信息插入到安全信箱中 5.public int deletesafetysms(int id) 根據(jù) id 刪除一條安全信箱中的信息 6.public cursor queryallinformations(int box, int msgtype) 根據(jù)信箱類型以及信息類型查詢出該信箱中的所有信息 7. public int querysafetymessagecount() 查詢安全信箱的信息數(shù)量 8. public int querysafetymessagecount(int type) 查詢安全信箱中某一箱體的信息計(jì)數(shù) n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 7 5 5模塊設(shè)計(jì) 5.15.1sim 卡信箱設(shè)計(jì)卡信箱設(shè)計(jì) .1 模塊設(shè)計(jì)描述 由于從 sim 卡中讀取短信數(shù)據(jù)速度很慢，為了優(yōu)化用戶體驗(yàn)，sim 卡信箱中 的短信數(shù)據(jù)完全來(lái)自于本地?cái)?shù)據(jù)庫(kù)中的表：icc_sms，該數(shù)據(jù)庫(kù)中的數(shù)據(jù)完全同步 自 sim 卡中所存儲(chǔ)的短信數(shù)據(jù)，確保本地?cái)?shù)據(jù)與 sim 卡中的短信數(shù)據(jù)在進(jìn)行增、 刪、改等操作后仍能完全保持一致： （1）每次開(kāi)機(jī)收到開(kāi)機(jī)廣播后，會(huì)掃描 sim 卡，將 sim 卡中存儲(chǔ)的短信同 步到本地?cái)?shù)據(jù)庫(kù)的 icc_sms 表中，同步完成之前無(wú)法進(jìn)入 sim 卡信箱。 if(action.eqauls(intent.action_boot_completed) /接收開(kāi)機(jī)廣播 boot_completed = false; / boot_completed 為 false 時(shí)不能進(jìn)入 sim 卡信箱 arraylist messages = smsmanager.getallmessagesfromicc(); /獲取 sim 卡中存儲(chǔ)的所有短信 for(int i=0;i0) cursor.movetonext(); scaddr = cursor.getstring(0); date = cursor.getlong(1); type = cursor.getint(2); /獲取需要移動(dòng)的短信數(shù)據(jù) 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); /將需要移動(dòng)的短信數(shù)據(jù)存儲(chǔ)到本地?cái)?shù)據(jù)庫(kù) 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); /將需要移動(dòng)的短信數(shù)據(jù)存儲(chǔ)到 sim 卡中 （6）sim 卡信箱支持短信復(fù)制到手機(jī)內(nèi)存、單挑刪除、多條刪除、回復(fù)、轉(zhuǎn)發(fā)、 呼叫對(duì)方號(hào)碼、查看 sim 卡短信存儲(chǔ)狀態(tài)等操作。 .2 模塊界面描述 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 10 1.在短彩信設(shè)置界面中有個(gè)選項(xiàng)默認(rèn)短信存儲(chǔ)到 sim 卡，如果選中后會(huì)在接收到新 的短信時(shí)將信息存儲(chǔ)到 sim 卡中； 2.進(jìn)入 sim 卡信箱列表界面后，針對(duì)某一信息長(zhǎng)按會(huì)有如圖 2 的各項(xiàng)操作 圖 1 圖 2 3.在短彩信列表界面中會(huì)有刪除全部信息以及查看 sim 卡信息存儲(chǔ)狀態(tài)，如圖 3 4.在會(huì)話模式中可以將某一條選中的短信移動(dòng)到 sim 卡信箱中 圖 3 圖 4 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 11 5.25.2信箱模式設(shè)計(jì)信箱模式設(shè)計(jì) .1 模塊設(shè)計(jì)描述 信箱模式的設(shè)計(jì)是區(qū)別與谷歌原短彩信機(jī)制中的會(huì)話模式，會(huì)話模式是針對(duì)與聯(lián)系人 而建立的閱讀信息的模式，而信箱模式是根據(jù)中移動(dòng)要求，根據(jù)信息的狀態(tài)專門(mén)設(shè)計(jì)的一 種信息查看模式，其中包括了新建信息、收件箱、發(fā)件箱、已發(fā)送、草稿箱、sim 卡信箱 以及安全信箱等，在每種箱體右側(cè)會(huì)有該箱體內(nèi)有多少條信息，而如 sim 卡信息未未讀 22 條，總共有 47 條，收件箱也會(huì)如此顯示，只有所有未讀信息都已讀或者刪除才會(huì)如其他箱 體顯示為數(shù)目，如圖（1） 。 （1） (2) 新建信息與會(huì)話模式中的新建信息點(diǎn)擊后為同一頁(yè)面，因此不做詳細(xì)描述； 對(duì)于收件箱，一般收到的短彩信都是會(huì)保存在收件箱中的，如果新收到的信息還未讀， 那么就會(huì)高亮顯示以區(qū)分已讀短信。彩信的話會(huì)在右側(cè)有附件圖標(biāo)顯示以區(qū)分短信和彩信。 而對(duì)于信息的操作有 3 種方式，一種為長(zhǎng)按事件（2） ，一種為 menu 事件（4） ，再就 是單擊事件。 收件箱、發(fā)件箱、已發(fā)送、草稿箱為同一類型，跳轉(zhuǎn)到同一頁(yè)面進(jìn)行列表顯示，而根 據(jù)箱體的不同，長(zhǎng)按事件會(huì)有不同的操作，例如收件箱中會(huì)有回復(fù)，而其余幾個(gè)箱體中就 沒(méi)有等；menu 事件為新建事件與刪除事件，而此處的刪除事件為多刪事件，將進(jìn)入另一個(gè) 專門(mén)刪除信息的工作界面進(jìn)行數(shù)據(jù)的刪除，如圖（3） n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 12 （3） （4） （5） 發(fā)件箱中的信息是用戶在信息編輯界面編輯完信息并發(fā)送后信息會(huì)先保存在發(fā)件箱中， 如果發(fā)送成功就會(huì)轉(zhuǎn)移到已發(fā)送信箱中去，而發(fā)送失敗的信息會(huì)一直保存在發(fā)件箱中。 草稿箱為用戶保存的草稿信息，由于信箱模式并沒(méi)有專門(mén)設(shè)計(jì)一套數(shù)據(jù)存儲(chǔ)結(jié)構(gòu)，所 以針對(duì)于一個(gè)號(hào)碼只可以保存一條草稿信息。 當(dāng)然在每個(gè)界面中都提供多項(xiàng)刪除信息功能(3)。 sim 卡信息的功能比較特殊，因此專門(mén)作為一個(gè)章節(jié)進(jìn)行描述。 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 13 安全信箱是為了使用戶將一些私密信息保存起來(lái)而專門(mén)設(shè)計(jì)的，用戶必須登錄后才能 進(jìn)入安全信箱查看內(nèi)容。 安全信箱為基于信箱模式而設(shè)計(jì)的，因此界面操作幾乎相同。 設(shè)計(jì)思路為用戶收到信息后，都是保存在普通信息的，用戶可以將需要保密的信息移 動(dòng)到安全信箱中，在安全信箱中提供了發(fā)件箱、收件箱、已發(fā)送，對(duì)應(yīng)于移動(dòng)前的信箱。 當(dāng)然，用戶可以將安全信箱中的信息再次移動(dòng)到普通信箱中去。注：在安全信箱中設(shè)計(jì)的 新信息只是為了方便用戶編輯信息發(fā)送信息，并不是在安全信箱中編輯的信息發(fā)送后就會(huì) 存儲(chǔ)在安全信箱相應(yīng)信箱中。 安全信箱的數(shù)據(jù)存儲(chǔ)與普通信箱的數(shù)據(jù)存儲(chǔ)不為同一數(shù)據(jù)庫(kù)，因此，常見(jiàn)的專門(mén)對(duì)應(yīng) 于 android 短彩信的查看工具或者短彩信搜索功能是看不到安全信箱中的信息的。 n831 項(xiàng)目.短彩信信箱模式設(shè)計(jì)文檔 14 6 6附錄 6.16.1總結(jié)總結(jié) 對(duì)于信箱模式下的設(shè)計(jì)中，在進(jìn)入某一箱體后，由于是將短信或者彩信加載完成后才 會(huì)顯示出來(lái)，所以在手機(jī)存儲(chǔ)的短信和彩信數(shù)量過(guò)大的時(shí)候，會(huì)有一些延時(shí)，我們做 了數(shù)據(jù)加載進(jìn)度條進(jìn)行等待；對(duì)于列表的刷新，由于數(shù)據(jù)的處理加載比較耗時(shí)，考慮 到用戶使用的流暢問(wèn)題，因此在進(jìn)入某一箱體后沒(méi)有做即時(shí)刷新數(shù)據(jù)處理，只是在箱 體列表后面對(duì)于某一箱體數(shù)量的計(jì)數(shù)做了即時(shí)刷新處理；對(duì)于安全信箱中，由于彩