Android Mms專題之：Mms源碼結構

從軟件的功能角度來講，Mms分為對話列表，消息列表，短信編輯，彩信編輯，短信顯示，彩信顯示和配置。
從實現的角度來看，它分為GUI展示層，發送/接收，彩信解析，彩信附件，信息數據等，這些分類對應著源碼中的各種包。

源碼導航

Mms的源碼的位置在於Android/packages/apps/Mms
其中Mms/src/com/android/mms裡面都是Mms相關的代碼，而Mms/src/org/w3c/dom裡面是一個類庫，主要用於彩信格式的解析和顯示。這裡主要講一下Mms/src/com/android/mms下面的一些包和類的主要用途。
ui---GUI展示層，用於展示對話列表，消息列表，消息編輯頁，彩信附件編輯，彩信展示，播放幻燈片。負責直接與用戶交互。

• ConversationListAdapter.java---對話列表的Adapter用於給顯示層ConversationList綁定數據。

• ConversationListItemData.java---代表對話列表中的每一項的數據結構，裡面含有要在對話列表中展示的信息。

• ConversationList.java------這是對話列表的顯示窗口Activity，它是一個ListActivity，這幾個類都是對話列表的相關類，用於顯示，編輯和管理所有的對話。

• ComposeMessageActivity.java----這個是核心的窗口Activity，編輯信息，顯示一條對話Thread中的所有往來信息。MessageListView會加在其上面，另外，AttachmentEditor也會加在其上面。這個Activity也負責響應外部應用程序，發送SENDTO或SEND等請求Intent，比如外部應用想要發送信息，等就由這個Activity來響應。

• MessageItem.java---代表一個信息的抽象數據，它包含了信息相關的所有內容，比如信息的主題，消息內容，來信地址，附件內容等等。它的所有數據都是公共的內部成員，都可以直接訪問。

• MessageListAdapter.java---用於給消息列表顯示層（由ComposeMessageActivity創建，綁定到MessageListView上）綁定數據。

• MessageListView.java---用於顯示消息列表，繼承自ListView，其生命周期由ComposeMessageActivity來控制，顯示與否也由它來控制。

• MessageListItem.java---是一個布局，用於顯示和控制消息列表中的每一個消息的顯示。

• AttachmentTypeSelectorAdapter.java---用於添加附件件時的一個支持的附件列表，它就是一個菜單。

• AttachmentEditor.java---用於在編輯MMS彩信信息時，顯示已添加的附件，它的生命周期由ComposeMessageActivity來控制，顯示與否也是由ComposeMessageActivity來控制，當有彩信附件時，它就會顯示，否則就被Hide。它是一個布局管理器，管理著下面四個布局，根據附件的類型動態的顯示下面四個View中的某一個。

• AudioAttachmentView.java---在編輯信息器中用於顯示音頻附件，它是繼承自線性布局。並不在代碼中直接使用，而是在布局文件中來當成布局管理器使用。

• ImageAttachmentView.java---在編輯信息器中用於顯示圖片附件，它是繼承自線性布局。並不在代碼中直接使用，而是在布局文件中來當成布局管理器使用。

• SlideshowAttachmentView.java---在編輯信息器中用於顯示幻燈片附件，它是繼承自線性布局。並不在代碼中直接使用，而是在布局文件中來當成布局管理器使用。

• VideoAttachmentView.java---在編輯信息器中用於顯示視頻附件，它是繼承自線性布局。並不在代碼中直接使用，而是在布局文件中來當成布局管理器使用。

• SlideshowActivity.java—用來全屏播放幻燈片，也即幻燈片的展示，因為彩信的創建和播放都是以幻燈片的方式進行的，也即一張一張的，每張上面可以文字，圖片，視頻和音頻，每一張有浏覽時長。

• SlideshowEditActivity.java---以列表方式管理幻燈片，也即是把所有的幻燈片用列表顯示出來，用戶可添加一頁幻燈片，也可以點擊進入編輯某頁幻燈片，用於創建和編輯幻燈片。

• SlideshowEditor.java---用於編輯某頁幻燈片，比如添加元素，刪除元素和替換元素，這裡的元素可以是圖片，視頻，音頻和文字。也可以用於編輯整頁幻燈片，比如刪除某頁幻燈片，調整這頁幻燈片在所有幻燈片中的位置等。它是一個具體操作幻燈片的封裝，SlideEditorActivity創建它並使用它來完成紀燈片的編輯。

• SlideshowPresenter.java---用於展示所有的幻燈片，也就是播放所有的幻燈片。由SlideshowActivity來創建和使用。

• SlideViewInterface.java---定義了一些用於顯示一頁幻燈片中的內容的接口，如設置圖像，設置視頻，設置音頻，播放視頻，播放音頻，暫停，隨機定位等等。附件顯示的View：AudioAttachmentView，ImageAttachmentView，SlideshowAttachmentView和VideoAttachmentView均實現了此接口，這樣AttachmentEditor就可以用統一的接口來控制內容的播放，而不用關心具體的內容是什麼。

• SlideEditorActivity.java---用於編輯某頁幻燈片，比如添加音頻，添加視頻，添加圖像，添加文字等。它只是提供用戶界面，讓用戶來操作各種按扭以達到添加元素，替換元素或是刪除元素。而對具體的幻燈片的操作是通過SlideshowEditor來完成的，它主要負責與用戶交互。

• SlideListItemView.java--- SlideshowEditActivity中列表的每一項的布局管理，繼承自LinearLayout。

• MmsThumbnailPresenter.java---用於在消息列表中，顯示彩信的縮略圖，因為彩信的內容不固定，可能是圖片，可能是音頻，可能是視頻也可能是幻燈片，所以用這個類來處理並顯示彩信的縮略圖。

• MessagingPreferenceActivity.java---Mms的配置信息編輯器，用來編輯和更改配置信息，繼承息PreferenceActivity。它負責與用戶交互，顯示和更改配置。在Mms啟動時，MmsConfig會從SharedPreference中讀出配置信息，在運行時其他的類的配置信息都是從MmsConfig中獲取的，MmsConfig提供了很多Get方法以獲取配置信息。

• Presenter.java---用來展示附件的一個抽象類。
• PresenterFactory.java---工廠方法。
• RecipientsAdapter.java
• RecipientsEditor.java---用於顯示信息編輯頁面上面的收信人的編輯框，它可以有自動補全的功能，補全的數據由RecipientsAdapter來提供。
• ViewInterface.java---代表一個View的基類，用於Slideshow顯示內容或是取縮略圖。可以取View的長寬高等。
• BasicSlideEditorView.java---編輯某一頁幻燈片時所用的布局，也就是在SlideEditorActivity.java中使用。
• EditSlideDurationActivity.java---顧名思義，用於編輯某一頁幻燈片的浏覽時長。
• ManageSimMessages.java---這個是在設置中使用的，用來管理SIM裡的消息。在設置中有一項是管理SIM卡上面的消息。在Mms的設置Settings中有一個選項可以設置是把信息存儲在SIM卡，還是存儲在手機裡。在收信時SmsReceiverService會查看這個設置然後把收到的信息寫到相應的地址。ManageSimMessages也是以列表方式顯示SIM裡面的信息，提供了二個菜單：把信息存入手機和刪除。
• NumberPickerButton.java---用於顯示選擇數字的按扭，在配置裡面用。
• NumberPickerDialog.java---用於顯示選擇數字的對話框，在配置裡面用。
• NumberPicker.java---用於在配置的時候選擇數字。這幾個NumerPicker主要是用於Settings中的。

• DeliveryReportActivity.java---信息發送情況報告。以列表的方式來顯示
• DeliveryReportAdapter.java---相應的Adapter
• DeliveryReportItem.java---相應的數據，每一項的數據
• DeliveryReportListItem.java---相應每一項的布局。

data---用於操作當前正在編輯的信息的相關數據，比如聯系人列表，比如當前對話，比如當前消息。負責管理當前正在編輯的信息和當前所處的對話以及當前信息用到的聯系人。這些類都是在編輯信息的時候使用，由於這些多半都是用來管理數據的，而又無法直接做為對象傳遞給編輯器。所以它們的很多方法都是靜態的，也就是這些類都近似單鍵。

• WorkingMessage.java---用來管理當前正在編輯的消息，它從創建，草稿到發送完成後一直存在，只要打開了編輯信息的頁面就會創建一個WorkingMessage，直到退出編輯頁面。
• Conversation.java---用來管理對話Threads，通常用來管理當前的對話，也就是進入的對話和正在進行操作的對話，它也用來管理對話列表，比如查詢對話列表。
• Contact.java---用來代表一個聯系人的信息，和管理聯系人，加載聯系人信息，其中還有相應的Cache。因為一個聯系人的數據是比較多的包含名字，名，姓，各種電話號碼，各種地址等等。因為Mms中直接使用Contact來作為聯系人，所有信息都是直接從其中獲取。另外，由於信息交互中也會涉及到聯系人，因為收發���時可以直接使用一串電話號碼，這時就需要有如添加聯系人的功能。Contact中有很多異步的操作，比如加載聯系人信息的時候或者更新Cache的時候都需要異步操作以不阻塞調用者。
• ContactList.java---是一個Contact的List列表它繼承自ArrayList<Contact>。用來管理一個Contact列表，或管理多個Contact。因為每個信息可以發送給多個聯系人，這時就需要用到ContactList來管理這些收信人。也提供了一些方便存儲和傳遞Contact的方法，比如把多個Contact轉成String，或者轉成String數組等。
• RecipientIdCache.java---用於保存所用到的Contact的Id和地址（電話）。每次WorkingMessage會更新這個Cache，然後ContactList會優先從這個Cache中查詢聯絡人。

dom---用於解析彩信內容smil的工具包
drm---用於處理DRM的媒體文件的工具包
layout---為了滿足特殊需要而改寫的布局元素
model---這裡面定義了彩信支持的附件數據結構和附件的組織方式。彩信可包含的內容有圖片，視頻，音頻和文字。這些內容可以單獨存在，也可以組合在一起。如果組合在一起就變成了幻燈片。用戶可以用幻燈片的方式來創建含有多個媒體的附件，圖文並茂的展示。每張幻燈片上面可以加視頻，音頻，圖片和文字，但通常一張幻燈片上面只允許加一個圖片或視頻，文字是都可以添加的，音頻在沒有視頻的情況下只可以添加的。播放的時候可以設置每張幻燈片的播放時長，以及文字的滾動速度等等。

• CarrierContentRestriction.java---是具體的彩信附件檢查站，對於不支持的附件，或者附件大小超出限制，或者圖像分辨率不對，或者圖像超出尺寸，會拋出異常：UnsupportedContentTypeException，ResolutionException，ExceedMessageSizeException，ContentRestrictionException。
• ContentRestriction.java是用於檢查附件的接口，外部直接使用這相接口，而具體實現是CarrierContentRestriction
• ContentRestrictionFactory.java是創建附件檢查的工廠方法。外部通過這個工廠來創建一個ContentRestriction對象，然後使用其中定義的檢查方法來進行附件內部檢查。
• SmilHelper.java用於解析和處理附件中的Smil的工具類。
• IModelChangedObserver.java接口，用於監聽附件內容有變化。

• Model.java---彩信附件的數據組織方式和管理方式是每一個附件都是一個Model的子類，它不但用於管理附件的具體數據，比如Uri，大小，文件名，位置等，也可以用於在GUI顯示附件和查看附件。
• LayoutModel.java---繼承自Model用於管理可視的附件的布局的類。它用來管理RegionModel等的基本元素。它就好比ViewGroup或LinearLayout，RelativeLayout等一些布局管理器，用來組織並管理布局基本元素也就是RegionModel的子類ImageModel，TextModel和VideoModel。
• RegionModel.java---繼承自Model用於管理可視附件和布局，比如圖像，視頻和文字。特別是在顯示可視附件的時候，用於控制可視附件在屏幕中的位置。一個RegionModel代表著一張幻燈片上的一塊區域，它是幻燈片上的布局基本元素。好比UI元素中的View，但多在使用時都是使用它的子類，也就是ImageModel，TextModel和VideoModel。
• RegionMediaModel.java---繼承自MediaModel，是用於多媒體附件中的可視部分的布局控制，主要用在附件的顯示和播放幻燈片時的控制。它的子類是ImageModel，TextModel和VideoModel。
• MediaModel.java---繼承自Model，代表媒體的數據結構，管理具體的附件數據，同時也用於管理附件的顯示控制，比如圖像的顯示，音頻和視頻的播放控制等。
• MediaModelFactory.java---用於從一個Pdu附件中解析出來MediaModel，也就是把Pdu轉化為Mms內部的附件數據。
• ImageModel.java—繼承自RegionMediaModel用於管理圖像附件和控制圖像附件的顯示。

• VideoModel.java---繼承自RegionMediaModel用於管理視頻附件和控制視頻附件的播放。
• AudioModel.java----繼承自MediaModel用於管理音頻附件和控制音頻附件的播放
• SlideModel.java----繼承自Model用於管理一組附件，這些附件同一次顯示給用戶。就好像幻燈片的一片一樣，每一個SlideModel裡面有一個可以存儲Model的列表，可以包含文字，音頻，圖像或視頻，其上面的附件同時顯示出來。
• SlideshowModel.java---繼承自Model，用於管理一個彩信中的所有附件。其內含有一個存儲SlideModel的列表，用於保存和控制一條彩信中的所有附件。另外它也負責顯示這些附件，把一個個SlideModel組織起來，播放。它也負責著把這些Mms形式的附件（各種Model）轉化為Android的附件Pdu，和從Pdu提出各自Model，因為Slideshow是應用程序層的彩信處理方式，而能發送和接收的彩信數據是Pdu。
• TextModel.java---繼承自RegionMediaModel用於管理文字附件和控制文字附件的顯示，比如按時間來滾動

util---這裡面是整個Mms共享的工具類，其中全部都是單鍵或是直接使用類，不可以創建對象和以對象方式來使用

• AddressUtils.java---關於地址的工具類，目前只有一個getFrom()方法，用於獲取發信人地址。
• DraftCache.java---用於標識哪些對話Thread有Draft，哪些沒有，也就是用於管理和查詢對話的草稿狀態，有草稿還是沒有。它裡面維護了一個HashSet，裡面包含了所有含有草稿的Thread Id。它裡面也有一個HashSet用於存儲OnDraftChangedListener，即當Thread的Draft狀態有變化時，DraftCache會調用相應的Listener以告知相應模塊，這個對話的草稿狀態有所變化。可以通過DraftCache.setDraftState(threadId, state)來設置某個對話的草稿狀態; 可以通過DraftCache.hasDraft(threadId)來查詢某個對話是否含有草稿。
• Recycler.java---是一個抽象的工具類，裡面定義了SmsRecycler和MmsRecycler，用於刪除陳舊的消息，或者刪除超過信息數量限制的信息。使用方法都是Recycler.getSmsRecycler.deleteOldMessages(context) 或者Recycler.getMmsRecycler.deleteOldMessages(context)
• SmileyParser.java---把標點式的表情符號轉化為圖形的表情，比如把用圖標笑臉來代替。
• DownloadManager.java---不要被名字騙到，它並不是真正意義上的下載管理器，因為它並不負責任何與下載文件過程或下載文件的管理。它是用於管理與下載相關的配置信息，比如是否是自動下載，以及下載過程的各種通知，比如Notification Bar和Toast提示等。

• RateController.java
• SendingProgressTokenManager.java

transaction---對於Mms來講是最底層的一個包，用戶不可見，它負責發信息的最後處理和收信息的最初處理。主要是負責發送信息和接收信息。它並不是真正的發送和接收信息。是由系統Frameworks裡面來負責接收和發送信息。這個包只是對於Mms應用層來講是發送和接收。

• AbstractRetryScheme.java
• DefaultRetryScheme.java—這二個類是實現一種Retry機制，因為信息的發送與接收會受到環境的限制，比如現在手機沒信號，或是網絡連接不成功，那麼就會把信息放到Pending隊列裡面，等一段時間再重新嘗試發送與接收。這裡的二個類就是為了實現此Retry機制。
• HttpUtils.java—彩信發送與接收的最底層實現者，它負責用HTTP協議接收和發送彩信到MMSC彩信服務中心。
• MessageSender.java—像其名字所預示的那樣，它是為了發送信息而封裝的一個接口，它裡面只有一個方法sendMessage()，UI層只需要調用實現了這個接口的類即可發送信息。
• MessagingNotification.java—專門負責在Status Bar上面做Notification，比如新接收到了信息，或是信息發送失敗，或是接收失敗等。它被UI層，和底邏輯層共用著。
• MmsMessageSender.java—繼承自MessageSender，專門用於發送彩信。它並不是做發送的事情，而是做一些錯誤檢查和前期准備工作，然後啟動TransactionService來做發送相關的事情。
• NotificationTransaction.java—繼承自Transaction，負責接收彩信和更新通知(Notification)。當有一個新彩信時，Frameworks會先發出一個短信，稱作彩信通知(NotificationIndication)，其內含有彩信相關的信息(MMSC, 彩信的ContentLocation(URL)等)，之後是由應用程序自己去MMSC用ContentLocation取彩信。這個NotificationTransaction就是專門用於處理彩信通知的，它會從MMSC上取出彩信數據（Pdu），把它寫入數據庫中，然後更新Notification。需要注意的是，只有彩信的設置是自動獲取(“auto retrieve”)時，它才會去下載彩信，否則，它只處理彩信通知(Notification Indication)，而不去下載彩信。
• Observable.java—裡面定義了觀察對象，Transaction是它的一個子類，其他的實體Transaction都是觀察對象，裡面有一個列表保存著觀察者的引用，當一個Transaction完成時，或是有異常時就會調用notifyObservers()方法來把狀態通知給觀察者。
• Observer.java—觀察者，TransactionService實現了這個接口。它是所有Transaction的觀察者，以監聽他們的狀態和處理結果，因為所有的Transaction都 是異步的，所以才用觀察模式來通知Transaction的處理結果。
• PrivilegedSmsReceiver.java—繼承自SmsReceiver短信收信的事件監聽者，負責監聽新短信事件android.provider.Telephony.Intents.SMS_RECEIVED_ACTION(“android.provider.Telephony.SMS_RECEIVED”);當接收到這個Intent時表明有一個新短信。它會喚起SmsReceiverServier來處理短信。
• ProgressCallbackEntity.java

• PushReceiver.java—一個BroadcastReceiver專門用於接收彩信事件android.provider.Telephony.WAP_PUSH_RECEIVED_ACTION(“android.provider.Telephony.WAP_PUSH_RECEIVED”)，它會先做一些預處理，然後啟動TransactionService，TransactionService又會創建NotificationTransaction來處理這個彩信通知。
• ReadRecTransaction.java
• RetrieveTransaction.java—繼承自Transaction，用於主動獲取彩信數據。當彩信設置為非自動獲取時，需要用戶觸發獲取，TransactionService會創建一個RetrieveTransaction來獲取彩信數據(Pdu)，存入數據庫，更新Notification等。
• RetryScheduler.java
• SendTransaction.java—繼承自Transaction，用於發送彩信數據。
• SimFullReceiver.java
• SmsMessageSender.java—發送短信的封裝，繼承自MessageSender。它會啟動SmsReceiverService來發送。
• SmsReceiver.java—是一個BroadcastReceiver，不要被其名字唬到，它並不負責接收新短信通知，相反，它用於發送信息，接收發送信息請求，並喚起SmsReceiverService來處理發送。這裡可能是Android命名規則的原因，Android裡的四大組件都喜歡把其組件的名字加上，比如ComposeMessageActivity，是一個Activity，TransactionService是一個Service，而這裡SmsReceiver是一個BroadcastReceiver，它與接收短信(receiving Sms)沒有關系。當然了，這完全是一個糟糕的命名。

• SmsReceiverService.java—它是一個Service，專門用於處理短信的發送與接收。它是由SmsReceiver和PrivilegedSmsReceiver監聽事件，然後啟動它的，自己並不會監聽Intent事件。
• SmsRejectedReceiver.java
• SmsSingleRecipientSender.java—繼承自SmsMessageSender，它針對一個收信人，調用Frameworks層接口發送信息，對於Mms應用來說，這是發送短信的最後一站，對就是說對於應用來說，它會把短信發送出去。
• TransactionBundle.java—Transaction所用的一個數據結構，用於給Transaction傳送數據。
• Transaction.java—各種Transaction的基類，它裡面定義了二個方法getPdu()，sendPdu()這二個方法是從MMSC取彩信數據，和向MMSC發送數據。它是對HttpUtils的一層包裝。
• TransactionService.java—是一個Service，接收各種Transaction請求，然後處理Transaction。每個Transaction都 會開啟新的線程異步的處理，所以當處理完成時又會通過Observer來通知TransactionService。
• TransactionSettings.java—彩信相關配置信息的數據結構，比如MMSC，Proxy，Port等。請求方可能會提供這些數據，如果提供就使用；否則就會從Telephony數據庫加載默認的數據，這些數據與運營商和APN的設置有關。
• TransactionState.java—標識每一個Transaction處理情況的數據結構，很簡單，只是標明處理成功還是失敗，用於Transaction回調Observer(TransactionService)時用。

還有com/android/mms根目錄下面的一些文件，其中絕大多數是定義的基類異常和一些公共的類。

• MmsApp.java---Mms Application會在應用進程啟動的時候做一些必要的初始化工作，比如配置，下載，聯系人，對話，Smiley解析器和通知等。
• MmsConfig.java---管理Mms的一些常用配置，比如彩信大小上限，彩信圖片尺寸上限，收信人的個數上限等等。這些配置信息是保存在在res/xml/mms_config.xml裡面。MmsApp在初始化時會調用MmsConfig.init()，在這裡面會調用loadMmsSettings來解析mms_config.xml從而得到所需要的配置信息。其他的模塊只通過MmsConfig來訪問這些配置信息。
• LogTag.java---有關日志跟蹤信息的控制。它可以方便的控制日志輸出級別。但是實際上整個Mms代碼中使用這個LogTag的地方並不多。