MAS2.0二次開發(fā)手冊(總則)

1、MAS2.0 二次開發(fā)手冊1MAS2.0 二次開發(fā)手冊總 則V1.1嘉訊軟件2008-11MAS2.0 二次開發(fā)手冊2修訂記錄ID修訂歷史修改人日期1初稿 V1.0鄧必國2008-07-072優(yōu)化 V1.1鄧必國2008-11-24MAS2.0 二次開發(fā)手冊3目目 錄錄1 .32引言.42.1編寫目的.42.2應(yīng)用范圍.42.3背景說明.42.4相關(guān)術(shù)語與縮略語解釋.43概述.44運(yùn)行環(huán)境.55三種通信擴(kuò)展方式對比.56MAS 服務(wù)插件規(guī)范.56.1企業(yè)應(yīng)用與應(yīng)用插件的區(qū)別.56.2MAS“插件管理”模塊使用.66.2.1新建企業(yè)應(yīng)用或應(yīng)用插件.66.2.2啟動企業(yè)應(yīng)用或應(yīng)用插件.76.2.3

2、停止企業(yè)應(yīng)用或應(yīng)用插件.76.2.4修改企業(yè)應(yīng)用或應(yīng)用插件.77MAS 業(yè)務(wù)管理鑒權(quán)介紹.88插件管理接口.98.1接口說明.98.2接口說明.98.2.1流程說明.98.2.2數(shù)據(jù)定義.118.2.3接口定義.118.3插件管理范例.148.3.1新建插件.158.3.2確認(rèn) MAS 運(yùn)行環(huán)境.158.3.3MAS 插件管理服務(wù) URL.168.3.4準(zhǔn)備代碼.169WEB 服務(wù)公共數(shù)據(jù)定義.189.1命名空間.189.2WEB 服務(wù)調(diào)用方式.189.3XML 數(shù)據(jù)類型.189.4XML Schema 數(shù)據(jù)類型定義.199.4.1TimeMetricsValues.199.4.2TimeMe

3、tric .199.4.3ServiceError.199.4.4SimpleReference.19MAS2.0 二次開發(fā)手冊49.4.5CMAbility.209.4.6MessageNotificationType.209.5公共異常定義.209.5.1業(yè)務(wù)異常.209.5.2策略異常.229.6AnyUri 格式說明.2410接口開發(fā)指導(dǎo).2411參考文檔.24MAS2.0 二次開發(fā)手冊51引言1.1編寫目的本文檔描述了 MAS2.0 二次開發(fā)的方法，文檔的使用對象為 MAS 開發(fā)人員、數(shù)字化部隊、SI 工程技術(shù)人員、SI 開發(fā)人員、集團(tuán)客戶技術(shù)人員。1.2應(yīng)用范圍本文檔的讀者需要有一

4、定的通信知識、WEB 知識、移動業(yè)務(wù)、WebService 相關(guān)知識。1.3背景說明1.4相關(guān)術(shù)語與縮略語解釋縮寫詞英文解析中文解析MASMobile Agent Server移動代理服務(wù)器HTTPHypertext Transfer Protocol超文本傳輸協(xié)議HTTPSSecure HTTP加密的 HTTP 協(xié)議SOAPSimple Object Access Protocol簡單對象訪問協(xié)議UCAUnified Communication Agent統(tǒng)一通信代理WSWebServiceWeb 服務(wù)接口SMSShort Message Service短消息服務(wù)MMSMultimedia

5、Messaging Service彩信服務(wù)2概述MAS 服務(wù)器作為溝通集團(tuán)客戶 IT 應(yīng)用環(huán)境與移動網(wǎng)絡(luò)之間的橋梁，根據(jù) MAS 服務(wù)器所處地位，可以將 MAS 服務(wù)器的應(yīng)用分為三個層次。作為集團(tuán)客戶應(yīng)用系統(tǒng)的統(tǒng)一移動接入手段：為集團(tuán)客戶應(yīng)用系統(tǒng)提供包括短信、彩信、USSD、WAP、WEB、定位等在內(nèi)的統(tǒng)一通信能力。功能的側(cè)重點是提供通信能力的支持。在這個層次，MAS 作為統(tǒng)一移動接入能力提供者，不參與業(yè)務(wù)的核心邏輯；實現(xiàn)集團(tuán)客戶應(yīng)用的移動化 提供新業(yè)務(wù)：可以在 MAS 服務(wù)器上運(yùn)行一個或多個應(yīng)用模塊來擴(kuò)展 MAS 的業(yè)務(wù)能力。MAS2.0 二次開發(fā)手冊6本文主要描述上面第一個層次的擴(kuò)充能力：

6、如何對通信能力進(jìn)行擴(kuò)展。目前 MAS 服務(wù)器支持二次開發(fā)的通信能力有：短信彩信wappush此外，還提供 MAS2.0 與應(yīng)用插件之間的插件管理功能接口。支持的接口方式有：DB 方式WebService 方式內(nèi)部 API 方式。3運(yùn)行環(huán)境MAS2.0 運(yùn)行環(huán)境MAS 管理平臺環(huán)境（或模擬管理平臺）短信網(wǎng)關(guān)（或模擬網(wǎng)關(guān)）彩信網(wǎng)關(guān)（或模擬網(wǎng)關(guān)）4三種通信擴(kuò)展方式對比DB 接口：適應(yīng)性強(qiáng)，任何語言都有操作數(shù)據(jù)庫的能力。但運(yùn)行效率一般，每次操作都要跟硬盤打交道。是移動規(guī)范接口。WebService 接口：開發(fā)容易，但在多語言交互時調(diào)試比較困難，運(yùn)行效率比較低。是移動規(guī)范接口。內(nèi)部 API：開發(fā)容易，運(yùn)

7、行效率高，接口豐富且擴(kuò)展新接口也很方便，目前只支持JAVA 語言。性能易用性功能完善性DB 接口一般容易一般WebService 接口低容易一般內(nèi)部 API高容易豐富MAS2.0 二次開發(fā)手冊75MAS 服務(wù)插件規(guī)范5.1企業(yè)應(yīng)用與應(yīng)用插件的區(qū)別企業(yè)應(yīng)用與應(yīng)用插件在物理上并沒有什么區(qū)別，是一個邏輯上的概念。開發(fā)了一段代碼后，需要把它接入 MAS，我們即可以把這段代碼叫做企業(yè)應(yīng)用，也可以叫做應(yīng)用插件。它們之間的區(qū)別是，如果是應(yīng)用插件就需要向先向它們之間的區(qū)別是，如果是應(yīng)用插件就需要向先向 MAS 注冊成功后才能使用注冊成功后才能使用 MAS 的通信的通信能力，而企業(yè)應(yīng)用就不需要注冊就可直接使用能

8、力，而企業(yè)應(yīng)用就不需要注冊就可直接使用 MAS 通信能力。通信能力。應(yīng)用插件需要關(guān)注后面章節(jié)的插件管理接口，企業(yè)應(yīng)用不需要關(guān)注。5.2MAS“插件管理”模塊使用MAS 服務(wù)器提供了配置工具，指定對于某個集團(tuán)客戶應(yīng)用系統(tǒng)或應(yīng)用插件，通過WebService 方式通信適配插件或數(shù)據(jù)庫方式通信適配插件或 API 通信適配器接入 MAS 服務(wù)器。插件管理模塊在 MAS2.0“配置中心”“插件管理”里面。MAS2.0 二次開發(fā)手冊.1新建企業(yè)應(yīng)用或應(yīng)用插件新建企業(yè)應(yīng)用或應(yīng)用插件圖圖 5-15-1 新建企業(yè)應(yīng)用新建企業(yè)應(yīng)用新建應(yīng)用時的注意事項：應(yīng)用類型有兩類：企業(yè)應(yīng)用、應(yīng)用插件。通信接口

9、方式可以選擇：WebService、DB、API圖圖 5-25-2 新建成功后新建成功后.2啟動企業(yè)應(yīng)用或應(yīng)用插件啟動企業(yè)應(yīng)用或應(yīng)用插件新建了一個企業(yè)應(yīng)用或插件后，需要先啟動該企業(yè)應(yīng)用或插件后才能使用。點擊MAS2.0 二次開發(fā)手冊9“運(yùn)行”鏈接。圖圖 5-35-3 啟動企業(yè)應(yīng)用或應(yīng)用插件啟動企業(yè)應(yīng)用或應(yīng)用插件.3停止企業(yè)應(yīng)用或應(yīng)用插件停止企業(yè)應(yīng)用或應(yīng)用插件如果要禁止某個企業(yè)應(yīng)用或應(yīng)用插件，在頁面上點擊“暫?！辨溄?。圖圖 5-45-4 停止企業(yè)應(yīng)用或應(yīng)用插件停止企業(yè)應(yīng)用或應(yīng)用插件.4修改企業(yè)應(yīng)用或應(yīng)用插件修改企業(yè)應(yīng)用或應(yīng)用插件如要修改企業(yè)應(yīng)用或應(yīng)

10、用插件的信息，在插件管理的頁面點擊“編輯” 。注意，只有“暫停”狀態(tài)的才能修改。部分信息不能修改，如通信接口方式等。MAS2.0 二次開發(fā)手冊10圖圖 5-55-5 停止企業(yè)應(yīng)用或應(yīng)用插件停止企業(yè)應(yīng)用或應(yīng)用插件6MAS 業(yè)務(wù)管理鑒權(quán)介紹MAS2.0 上插件的業(yè)務(wù)管理實行二級控制，首先受 MAS 管理平臺的控制，其次是MAS 的業(yè)務(wù)管理控制。必須滿足：插件請求的通信能力必須滿足：插件請求的通信能力=MAS 給插件開通的通力給插件開通的通力=MAS管理平臺給管理平臺給 MAS 開通的能力。開通的能力。舉例 1：MAS 管理平臺給 MAS 開通短信、彩信、PUSHMAIL 業(yè)務(wù)，MAS 沒有給P02

11、0000000000456 插件開通任何能力，P020000000000456 向 MAS 注冊（請求短信能力） ，會失敗，無法使用 MAS 的通信能力。舉例 2：MAS 管理平臺給 MAS 開通短信、彩信、PUSHMAIL 業(yè)務(wù)，MAS 給P020000000000456 插件開通短信能力，P020000000000456 向 MAS 注冊（請求短信能力） ，注冊成功。插件可以使用 MAS 的短信能力。舉例 3：MAS 管理平臺給 MAS 開通短信、彩信、PUSHMAIL 業(yè)務(wù)，MAS 給MAS2.0 二次開發(fā)手冊11P020000000000456 插件只開通短信能力，P020000000

12、000456 向 MAS 注冊（請求短信、彩信能力） ，注冊失敗。MAS 給插件開通的能力在插件管理頁面上查看。圖圖 6-16-1 企業(yè)應(yīng)用或應(yīng)用插件通信能力查看企業(yè)應(yīng)用或應(yīng)用插件通信能力查看MAS 管理平臺給 MAS 開通的能力在“系統(tǒng)管理”“設(shè)備配置管理”“業(yè)務(wù)能力查看”查看。圖圖 6-26-2 管理平臺給管理平臺給 MASMAS 開通的通信能力查看開通的通信能力查看7插件管理接口7.1接口說明接口說明插件管理接口實現(xiàn)對應(yīng)用插件的注冊、注銷、暫停和恢復(fù)，各插件通過此接口報告插件狀態(tài)。插件管理具體內(nèi)容包括：插件的注冊、注銷、啟用、暫停插件狀態(tài)報告。WebService 方式通信適配插件作為插

13、件管理模塊的代理，實現(xiàn)插件管理相關(guān)操作信息的處理和轉(zhuǎn)發(fā)。MAS2.0 二次開發(fā)手冊127.2接口說明.1流程說明流程說明插件管理流程如下：APRegistrationReqWebService方式通信適配插件應(yīng)用插件APRegistrationRspAPStatusRepReqAPStatusRepRspPauseAPReqPauseAPRspRecoveryAPReqRecoveryAPRspAPLogOutReqAPLogOutRsp圖圖 7-17-1 插件管理流程示意圖插件管理流程示意圖MAS 服務(wù)器系統(tǒng)中應(yīng)用插件必須注冊通過后方可使用，WebService 方式通信適配

14、插件將該請求轉(zhuǎn)發(fā)到插件管理模塊并獲得結(jié)果，將結(jié)果封裝在響應(yīng)消息中返回給應(yīng)用插件，注冊及響應(yīng)過程通過 APRegistration 操作實現(xiàn)。應(yīng)用插件注冊通過后，要周期性地進(jìn)行狀態(tài)匯報并獲取響應(yīng)，狀態(tài)報告及響應(yīng)過程通過 APStatusRep 操作完成。在應(yīng)用插件運(yùn)行過程中，根據(jù)從 MAS 統(tǒng)一服務(wù)平臺得到的業(yè)務(wù)能力信息，插件管理模塊可以主動地發(fā)出命令，暫?；蚧謴?fù)特定的插件，這些指令經(jīng) WebService 方式通信適配插件通知給應(yīng)用插件，通過 PauseAP 和 RecoveryAP 兩個操作實現(xiàn)。在應(yīng)用插件結(jié)束之前，應(yīng)用插件主動發(fā)起注銷操作 APLogOut?？紤]到一個應(yīng)用插件可能包含多個進(jìn)

15、程，因此在上述流程中，注冊、狀態(tài)上報和注銷為進(jìn)程級，而暫停和恢復(fù)為插件級。當(dāng)插件管理模塊發(fā)現(xiàn)插件進(jìn)程異常或資源占用超過閥值時，并不停止該進(jìn)程，而是提示告警給指定人員。MAS2.0 二次開發(fā)手冊13插件分為提供 Web 服務(wù)端和不提供 Web 服務(wù)端兩種。對于提供 Web 服務(wù)端的情況，要在插件注冊操作中指明服務(wù)端的 URL，對插件的暫停和恢復(fù)可以通過 PauseAP 和RecoveryAP 操作，或在狀態(tài)上報響應(yīng)中體現(xiàn)；對于不提供 Web 服務(wù)端的情況，對插件的暫停和恢復(fù)命令只能在狀態(tài)上報響應(yīng)中體現(xiàn)。.2數(shù)據(jù)定義數(shù)據(jù)定義注冊結(jié)果：APRegResult數(shù)據(jù)結(jié)構(gòu)：枚舉名稱名稱描述

16、描述success注冊成功illegalAP插件不被允許，注冊失敗CMAbilityNotSup不支持所要求的通信能力，注冊失敗repeatedReg重復(fù)注冊，注冊成功svcAddrMismatch注冊請求中的插件 Web 服務(wù)端地址與之前的同一插件其它進(jìn)程注冊請求中的插件 Web 服務(wù)端地址不一致，注冊失敗。AP 運(yùn)行狀態(tài)：APStatusType數(shù)據(jù)結(jié)構(gòu)：枚舉名稱名稱描述描述Normal狀態(tài)正常OutofActiveTime超過有效期NeedRegistration未注冊，需要先注冊O(shè)utofService已經(jīng)注銷Closed插件進(jìn)程已被 mas 服務(wù)器強(qiáng)行關(guān)閉WaitingforConf

17、irm插件的注冊請求等待審批中注銷結(jié)果：APLogoutResult數(shù)據(jù)結(jié)構(gòu)：枚舉名稱名稱描述描述success注銷成功illegalAPid插件 id 不合法，注銷失敗repeatedLogout重復(fù)注銷請求.3接口定義接口定義插件注冊由應(yīng)用插件 AP 發(fā)起進(jìn)行注冊：操作：APRegistration業(yè)務(wù)觸發(fā)條件：AP 插件啟動后，需要自動向 WebService 適配插件進(jìn)行注冊。注冊成MAS2.0 二次開發(fā)手冊14功后才能進(jìn)行其他的正常的調(diào)用，否則，WebService 適配插件會拒絕該插件后續(xù)的所有操作。輸入：APRegistrationReq參數(shù)參數(shù)類型類型可選性可選

18、性描述描述Apidxsd: stringMAP 插件的標(biāo)識APPidxsd:intMAP 插件的 PIDHostIPxsd: stringM主機(jī)所在的 ip 地址MessageNotificationMessageNotificationTypeMAP 插件所需的通信能力及各通信能力對應(yīng)的 Web 服務(wù) URL，若對應(yīng)某通信能力，Web URL不填，表示對于該應(yīng)用能力，應(yīng)用插件不提供服務(wù)端。APWSURIxsd: anyURIO應(yīng)用插件對應(yīng)的 WEB 服務(wù)端URL，若為空，則表示該應(yīng)用插件不提供服務(wù)端。輸出：APRegistrationRsp參數(shù)參數(shù)類型類型可選性可選性描述描述RegResul

19、tAPRegResultM注冊響應(yīng)結(jié)果NextIntervalxsd:intM表示 AP 的后續(xù)狀態(tài)上報時間間隔（單位為秒）差錯：業(yè)務(wù)異常：SVC0001 - 業(yè)務(wù)錯誤.策略異常：POL0001 - 策略錯誤.插件狀態(tài)信息上報由應(yīng)用插件 AP 發(fā)起，報告插件的狀態(tài)。操作：APStatusRep業(yè)務(wù)觸發(fā)條件：在插件運(yùn)行過程中，需要周期性地上報自己的運(yùn)行狀態(tài)。上報周期可以由 MAS 服務(wù)器進(jìn)行控制。在狀態(tài)上報響應(yīng)消息中，MAS 服務(wù)器將后續(xù)狀態(tài)上報時間間隔反饋給 AP，之后 AP 按照這個間隔進(jìn)行上報插件狀態(tài)。狀態(tài)上報響應(yīng)消息中還可攜帶需要應(yīng)用插件執(zhí)行的管理命令，對于不提供服務(wù)端的應(yīng)用插件，狀態(tài)上

20、報響應(yīng)是向應(yīng)用插件發(fā)送管理命令的唯一手段。輸入：APStatusRepReq參數(shù)參數(shù)類型類型可選性可選性描述描述MAS2.0 二次開發(fā)手冊15APidxsd:stringMAP 插件的標(biāo)識APStatusAPStatusTypeM插件運(yùn)行狀態(tài)APPidxsd:intMAP 插件的 PID輸出：APStatusRepRsp參數(shù)參數(shù)類型類型可選性可選性描述描述NextCommandxsd:stringO需要插件執(zhí)行的管理命令，pause 代表暫停，recovery 代表恢復(fù)，不填表示無命令。NextIntervalxsd：intO插件的后續(xù)上報時間間隔（單位為秒） ，不填表示同上次時間間隔差錯：業(yè)

21、務(wù)異常：SVC0002 - 不合法的輸入值.策略異常：POL0001 - 策略錯誤.注銷插件由應(yīng)用插件 AP 發(fā)起進(jìn)行注銷插件進(jìn)程。操作：APLogOut業(yè)務(wù)觸發(fā)條件：應(yīng)用插件 AP 的進(jìn)程在結(jié)束之前，調(diào)用此接口進(jìn)行注銷。注銷后的進(jìn)程若重新使用，需要重新進(jìn)行注冊。輸入：APLogOutReq參數(shù)參數(shù)類型類型可選性可選性描述描述APidxsd:stringMAP 插件的標(biāo)識APPidxsd:intMAP 插件的 PID輸出：APLogOutRsp參數(shù)參數(shù)類型類型可選性可選性描述描述LogoutResultAPLogoutResultM注銷響應(yīng)結(jié)果差錯：業(yè)務(wù)異常：SVC0001 - 業(yè)務(wù)錯誤.策略

22、異常：POL0001 - 策略錯誤.插件暫停MAS2.0 二次開發(fā)手冊16此接口用于暫停 AP 的業(yè)務(wù)功能，由 WebService 插件發(fā)起。只有當(dāng)應(yīng)用插件有 Web 服務(wù)端的情況，才能使用該操作。操作：PauseAPWebService 方式通信適配插件根據(jù)插件管理模塊的要求，暫停 AP 的業(yè)務(wù)功能。如果插件要重新啟用，需要在注銷后由插件重新發(fā)起注冊請求；或者由 WebService 插件重新啟動 AP。輸入：PauseAPReq參數(shù)參數(shù)類型類型可選性可選性描述描述APidxsd:stringMAP 插件的標(biāo)識輸出：PauseAPRsp參數(shù)參數(shù)類型類型可選性可選性描述描述ACKxsd:Bo

23、oleanMtrue 表示成功，false 表示失敗。差錯：業(yè)務(wù)異常：SVC0001 - 業(yè)務(wù)錯誤.策略異常：POL0001 - 策略錯誤.插件恢復(fù)此接口用于恢復(fù) AP 的業(yè)務(wù)功能，由 WebService 方式通信適配插件發(fā)起，僅當(dāng)應(yīng)用插件有 Web 服務(wù)端時有效。操作：RecoveryAPWebService 方式通信適配插件根據(jù)業(yè)務(wù)要求，恢復(fù)已暫停的 AP 的業(yè)務(wù)功能。輸入：RecoveryAPReq參數(shù)參數(shù)類型類型可選性可選性描述描述APidxsd:stringMAP 插件的標(biāo)識輸出：RecoveryAPRsp參數(shù)參數(shù)類型類型可選性可選性描述描述ACKxsd:BooleanMtrue

24、表示成功，false 表示失敗。差錯：業(yè)務(wù)異常：SVC0001 - 業(yè)務(wù)錯誤.策略異常：MAS2.0 二次開發(fā)手冊17POL0001 - 策略錯誤7.3插件管理范例本節(jié)列舉一個 java 語言開發(fā)插件管理的示例，webservice 開發(fā)包采用 axis1.4。.1新建插件新建插件在“配置中心”“插件管理”里面新建一個 ID 為 123 的插件。圖圖 7-2 新建一個新建一個 ID 為為 123 的應(yīng)用插件的應(yīng)用插件類型選擇“應(yīng)用插件” ， “插件內(nèi)部標(biāo)識”為“123” ，插件“名稱”自定義一個有業(yè)務(wù)含義的。 “通信接口方式”選擇“WebService” 。把下面的“短信應(yīng)用”

25、選中，表示給這個插件開通短信通力。.2確認(rèn)確認(rèn) MAS 運(yùn)行環(huán)境運(yùn)行環(huán)境剛新建的插件的狀態(tài)為“需要注冊” 。點擊“運(yùn)行”啟運(yùn)插件，如果不啟動插件，插件是不能注冊成功的。注意：插件標(biāo) P020000000000123 是 MAS 根據(jù)移動規(guī)范自動生成的，新建的時候只需要輸入后面三位，見圖 7-2。MAS2.0 二次開發(fā)手冊18圖圖 7-3 剛建的剛建的 123 應(yīng)用插件應(yīng)用插件要確保 MAS 已經(jīng)運(yùn)行正常，并在“系統(tǒng)管理”“設(shè)備配置管理”“業(yè)務(wù)能力查看”中看到管理平臺已經(jīng)給 123 插件開通了短信能力。如下圖：圖圖 7-4 管理平臺給管理平臺給 123 插件開通了短信能力插件開通

26、了短信能力.3MAS 插件管理服務(wù)插件管理服務(wù) URLMAS 的插件服務(wù)地址是：http:/mas_ip:port/services/cmcc_mas_wbs插件服務(wù)的 WSDL 在：http:/mas_ip:port/services/cmcc_mas_wbs?wsdl.4準(zhǔn)備代碼準(zhǔn)備代碼用 axis1.4 的 wsdl2java 工具生成 java 代碼。運(yùn)行命令java org.apache.axis.wsdl.WSDL2Java -server-side -skeletonDeploy true cmcc_mas_wbs_v1.1.0.wsdl(這里的”

27、cmcc_mas_wbs_v1.1.0.wsdl”是指 wsdl 文件的路徑，可以寫成“http:/mas_ip:port/services/cmcc_mas_wbs” ，也可以下載到本地)。注意要設(shè)置 java 環(huán)境變量，且將 axis 的 lib 包添加到 path 中，生成代碼的目錄結(jié)構(gòu)如下MAS2.0 二次開發(fā)手冊插件注冊插件注冊插件在使用之前需要向 MAS 注冊，調(diào)用如下代碼即可完成注冊Cmcc_mas_wbs_ServiceLocator locator = new Cmcc_mas_wbs_ServiceLocator();/http:/192.1

28、68.0.238/service/cmcc_mas_wbs是MAS的插件服務(wù)URLlocator.setcmcc_mas_wbsEndpointAddress(38/service/cmcc_mas_wbs);Cmcc_mas_wbs_PortType type = locator.getcmcc_mas_wbs();APRegistrationReq rep = new APRegistrationReq();rep.setApid(P020000000000123);/ 插件idrep.setAPPid(5346); / 插件進(jìn)程id/ 插件的服務(wù)管理地址

29、，比如管理平臺關(guān)閉了該插件的能力，這時MAS要通知插件，就通知到這個地址。rep.setAPWSURI(new URI(18/service/cmcc_mas_wbs);/ 插件暫停、恢復(fù)回調(diào)服務(wù)地址rep.setHostIP(18); / 插件運(yùn)行的主機(jī)ipMessageNotificationType notification = new MessageNotificationType1;/設(shè)置插件請求短信能力。注意此處請求的能力不能超過MAS給插件開通的能力，否則插件會注冊失敗。notification0.setCMAbility(

30、CMAbility.SMSbility);/插件的短信服務(wù)回調(diào)地址，用來收狀態(tài)報告與MO短信notification0.setWSURI(new URInew URI(18/service/cmcc_mas_wbs);MAS2.0 二次開發(fā)手冊20rep.setMessageNotification(notification);/ 插件通信回調(diào)服務(wù)地址（如狀態(tài)報告，mo上行短信）APRegistrationRsp rsp = type.APRegistration(rep);APRegResult result = rsp.getRegResult();/ 注

31、意要在MAS2上新建一個插件，并啟動，并保持插件請求的通信能力在MAS允許的范圍內(nèi)，否則注刪不會成功if(APRegResult._success.equals(result.getValue()System.out.println(注冊成功); / 注冊成功后就可以使用MAS的短信能力了。elseSystem.out.println(注冊失敗);如果注冊成功，插件管理里的插件狀態(tài)會改為正常。心跳（狀態(tài)上報）心跳（狀態(tài)上報）插件在注冊成功后，必須在規(guī)定時間內(nèi)（注冊時返回的 nextInterval 參數(shù)值）上報自己的狀態(tài)，與 MAS 服務(wù)器保持心跳。否則插件后續(xù)不能

32、繼續(xù)使用 MAS 的通信能力。APStatusRepReq statusReq = new APStatusRepReq();statusReq.setAPid(P020000000000123);statusReq.setAPPid(5346);statusReq.setAPStatus(APStatusType.Normal);APStatusRepRsp statusRsp = type.APStatusRep(statusReq);String nextCmd = statusRsp.getNextCommand();/ 需要插件執(zhí)行的管理命令int nextInt = statusR

33、sp.getNextInterval(); / 下一次狀態(tài)上報時間間隔插件注銷插件注銷調(diào)用 APLogOut 方法可以注銷插件，如下所示APLogOutReq logOutRep = new APLogOutReq();logOutRep.setAPid(P020000000000123);logOutRep.setAPPid(5346);APLogOutRsp logOutRsp = type.APLogOut(logOutRep);if(APLogoutResult._success.equals(logOutRsp.getLogoutResult()Syste

34、m.out.println(注銷成功);elseMAS2.0 二次開發(fā)手冊21System.out.println(注銷失敗);8Web 服務(wù)公共數(shù)據(jù)定義8.1命名空間命名空間公共數(shù)據(jù)類型的命名空間參見：/schema/common/v2_0公共異常的命名空間參見：/wsdl/common_faults/v2_08.2WEB 服務(wù)調(diào)用方式服務(wù)調(diào)用方式WEB 服務(wù)應(yīng)支持 HTTP 上的 SOAP 調(diào)用，使集團(tuán)客戶應(yīng)用系統(tǒng)以及各插件可通過 HTTP方式與服務(wù)器進(jìn)行通信。8.3XML 數(shù)據(jù)類型數(shù)據(jù)類型XML 數(shù)據(jù)類型參見 X

35、ML Schema（W3C Recommendation (2 May 2001): XML Schema Part 2: Datatypes） 。8.4XML Schema 數(shù)據(jù)類型定義數(shù)據(jù)類型定義.1TimeMetricsValues數(shù)據(jù)類型為枚舉型。值值描述描述Millisecond毫秒Second秒Minute分Hour小時Day日Week星期Month月Year年MAS2.0 二次開發(fā)手冊.2TimeMetric數(shù)據(jù)類型為結(jié)構(gòu)。名稱名稱類型類型描述描述MetricTimeMetricValues計量單位Unitsxsd:int數(shù)值.

36、3ServiceError數(shù)據(jù)類型為結(jié)構(gòu)。名稱名稱類型類型描述描述MessageIdxsd:string消息標(biāo)識Textxsd:string消息說明Variablesxsd:string 0.unbounded變量.4SimpleReference數(shù)據(jù)類型為結(jié)構(gòu)。名稱名稱類型類型描述描述Endpointxsd:anyURI端口InterfaceNamexsd:string接口名稱Correlatorxsd:string關(guān)聯(lián)標(biāo)識.5CMAbility數(shù)據(jù)類型為枚舉。值值描述描述SMSbility對短信能力的需求MMSAbility對彩信能力的需求WAPAbilit

37、y對WAP能力的需求USSDAbility對USSD能力的需求LBSAbility對LBS能力的需求GPRSAbility對GPRS能力的需求MAS2.0 二次開發(fā)手冊.6MessageNotificationType用于集團(tuán)客戶應(yīng)用系統(tǒng)和應(yīng)用插件通知通信能力需求及所提供的 web 服務(wù)端地址。數(shù)據(jù)類型為結(jié)構(gòu)：名稱名稱類型類型描述描述CMAbilityCMAbility對應(yīng)某一個通信能力WSURIxsd:anyURI對應(yīng)該通信能力，應(yīng)用系統(tǒng)或插件提供的 WEB 服務(wù)端地址8.5公共異常定義公共異常定義.1業(yè)務(wù)異常業(yè)務(wù)異常業(yè)務(wù)異常消息使用保留的消息標(biāo)識符SVC

38、 ，并使用從 0001 到 0999 的號碼來定義。其中 0001 至 0199 被保留作公共差錯定義，0200 至 0999 作為其它 Web Service 指定用途。從1000至9999為自定義。名稱名稱類型類型描述描述MessageIdxsd:string消息標(biāo)識符，前綴為SVCTextxsd:string消息文本，可變可替代部分用%來標(biāo)識Variablesxsd:string 0.unbounded替代文本字串中的可變部分SVC0001: 業(yè)務(wù)錯誤名稱名稱描述描述Message IdSVC0001Text發(fā)生了一個業(yè)務(wù)錯誤。錯誤代碼是%1Variables%1來自業(yè)務(wù)的錯誤碼。SVC

39、0002: 不合法的輸入值名稱名稱描述描述Message IdSVC0002Text消息部分%1有不合法的輸入值。Variables%1消息部分。SVC0003: 不合法的輸入值包含部分合法值名稱名稱描述描述Message IdSVC0003Text消息部分%1有不合法的輸入值，%2是合法值。Variables%1消息部分；%2合法值列表。SVC0004: 不合法地址MAS2.0 二次開發(fā)手冊24名稱名稱描述描述Message IdSVC0004Text消息部分%1未提供合法地址。Variables%1消息部分。SVC0005: 重復(fù)關(guān)聯(lián)符名稱名稱描述描述Message IdSVC0005Te

40、xt消息部分%2中描述的關(guān)聯(lián)符%1是重復(fù)的。Variables%1關(guān)聯(lián)符。%2消息部分。SVC0006: 不合法的組名稱名稱描述描述Message IdSVC0006Text消息部分%2中的組%1不是一個合法的組。Variables%1不合法的組的標(biāo)識符。%2消息部分。SVC0902: 因內(nèi)容過濾，被拒絕名稱名稱描述描述Message IdSVC0902Text因內(nèi)容過濾，被拒絕Variables無。.2策略異常策略異常策略異常消息使用保留的消息標(biāo)識符POL ，并使用從 0001 到 0999 的號碼來定義。其中 0001 至 0199 被保留作公共差錯定義，0200 至 0999 作為其它 Web Service 指定用途。從1000至9999為自定義。名稱名稱類型類型描述描述MessageIdxsd:string消息標(biāo)識符，前綴為POLTextxsd:string消息文本，可變可替代部分用%來標(biāo)識。Variablesxsd:string 1.unbounded替代文本字串中的可變部分。POL0001: 策略錯誤名稱名稱描述描述Message IdPOL0001Text發(fā)生了一個策略錯誤。錯誤代碼是%1。Variables%1來自業(yè)務(wù)的錯誤碼。POL0003: 過多的地址名稱名稱描述描述MAS2.0 二次開發(fā)手冊25Message IdPOL0003Text