infoX -API接口培訓(xùn)材料(共40張)(PPT 40頁)

1、i短消息API開發(fā)培訓(xùn)2003-01-14華為技術(shù)有限公司第1頁，共40頁。 培訓(xùn)大綱基礎(chǔ)知識(shí)培訓(xùn)（25分鐘）infoX信息平臺(tái)介紹（10分鐘）CMPP2.0 介紹（15分鐘）API 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）開發(fā)應(yīng)用舉例(30)VCDemo VBDemo答疑討論(20分鐘)第2頁，共40頁。infoX短消息信息平臺(tái) 短消息信息平臺(tái)系統(tǒng)概述 短消息信息平臺(tái)功能 信息平臺(tái)維測(cè)和管理 網(wǎng)管與信息平臺(tái)第3頁，共40頁。infoX 信息平臺(tái)主要用途移動(dòng)夢(mèng)網(wǎng)網(wǎng)關(guān)（廣東、江蘇、浙江）短消息互聯(lián)網(wǎng)關(guān)（移動(dòng)，

2、聯(lián)通，固網(wǎng)）固網(wǎng)網(wǎng)關(guān)聯(lián)通在線企業(yè)短消息網(wǎng)關(guān)等第4頁，共40頁。移動(dòng)夢(mèng)網(wǎng)網(wǎng)關(guān)拓?fù)鋱DinfoX-ISMGSP 1SMSC mInternetISMGGNSSMSC 1SP nSCP計(jì)費(fèi)中心第5頁，共40頁?；ヂ?lián)網(wǎng)關(guān)網(wǎng)絡(luò)組網(wǎng)示意圖第6頁，共40頁。短消息信息平臺(tái)支持協(xié)議和遵循規(guī)范SMPP 協(xié)議，CMPP協(xié)議 , SGIP 協(xié)議,SMGP協(xié)議遵循規(guī)范短消息網(wǎng)關(guān)設(shè)備規(guī)范V1.2中國(guó)移動(dòng)通信短消息網(wǎng)關(guān)測(cè)試規(guī)范V1.2中國(guó)移動(dòng)通信資源站實(shí)體與互聯(lián)網(wǎng)短消息網(wǎng)關(guān)接口協(xié)議V1.2神州行夢(mèng)網(wǎng)業(yè)務(wù)SCP與ISMG之間通訊協(xié)議1.0點(diǎn)對(duì)點(diǎn)短消息網(wǎng)間互通協(xié)議V2.0點(diǎn)對(duì)點(diǎn)短消息網(wǎng)間測(cè)試規(guī)范V1.2第7頁，共40頁。inf

3、oX網(wǎng)關(guān)綜合性能指標(biāo) infoX平臺(tái)性能指標(biāo):最大消息處理能力1200條/秒最大緩存消息數(shù)500萬條最大CMPP/SMPP端口數(shù)1000個(gè)最大短消息中心接入數(shù)64個(gè)最大緩存路由信息5000個(gè)第8頁，共40頁。infoX短消息信息平臺(tái) 短消息信息平臺(tái)系統(tǒng)概述 短消息信息平臺(tái)功能 信息平臺(tái)維測(cè)和管理 網(wǎng)管與信息平臺(tái)第9頁，共40頁。信息平臺(tái)功能（一）路由管理接口管理，帳號(hào)管理消息實(shí)時(shí)跟蹤鑒權(quán)管理記憶路由功能第10頁，共40頁。信息平臺(tái)功能（二）鑒權(quán)管理記憶路由功能告警功能業(yè)務(wù)外包特性管理權(quán)限分級(jí)功能第11頁，共40頁。信息平臺(tái)功能（三）主叫路由功能接口限制功能計(jì)費(fèi)流水話單用戶過濾主備接口功能業(yè)務(wù)優(yōu)

4、先級(jí)管理第12頁，共40頁。infoX短消息信息平臺(tái) 短消息信息平臺(tái)系統(tǒng)概述 短消息信息平臺(tái)功能 信息平臺(tái)維測(cè)和管理 網(wǎng)管與信息平臺(tái)第13頁，共40頁。主要功能系統(tǒng)參數(shù)設(shè)置帳號(hào)管理協(xié)議跟蹤網(wǎng)關(guān)短信管理數(shù)據(jù)日常維護(hù)。 綜合網(wǎng)關(guān)維測(cè)臺(tái)第14頁，共40頁。infoX短消息信息平臺(tái) 短消息信息平臺(tái)系統(tǒng)概述 短消息信息平臺(tái)功能 信息平臺(tái)維測(cè)和管理 網(wǎng)管與信息平臺(tái)第15頁，共40頁。網(wǎng)管維護(hù)管理infoXI2000MT SERVER上級(jí)綜合網(wǎng)管統(tǒng)一網(wǎng)管集中監(jiān)控配置管理實(shí)時(shí)告警統(tǒng)計(jì)管理第16頁，共40頁。培訓(xùn)大綱基礎(chǔ)知識(shí)培訓(xùn)（25分鐘）infoX信息平臺(tái)介紹（10分鐘）CMPP2.0 介紹（15分鐘）API

5、 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）開發(fā)應(yīng)用舉例(30)VCDemo VBDemo答疑討論(20分鐘)第17頁，共40頁。SP 和網(wǎng)關(guān)之間消息流建議通訊方式：長(zhǎng)連接 SP ISMGCMPP_CONNECTCMPP_CONNECTt_RESPCMPP_SUBMITCMPP_SUBMIT_RESPCMPP_QUERYcCMPP_QUERY_RESPCMPP_CANCLECMPP_CANCLE_RESPCMPP_DELIVERCMPP_DELIVER_RESP第18頁，共40頁。 培訓(xùn)大綱基礎(chǔ)知識(shí)培訓(xùn)（25

6、分鐘）infoX信息平臺(tái)介紹（10分鐘）CMPP2.0 介紹（15分鐘）API 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）開發(fā)應(yīng)用舉例(30)VCDemo VBDemo答疑討論(20分鐘)第19頁，共40頁。短消息平臺(tái)系統(tǒng)結(jié)構(gòu)SP： 業(yè)務(wù)提供商程序SMEIDLL： 動(dòng)態(tài)庫(kù)接口ISMG： infoX短消息網(wǎng)關(guān)第20頁，共40頁。SMEIDLL接口的優(yōu)點(diǎn)：Sp,CP,ICP,人工臺(tái)、自動(dòng)臺(tái)、維測(cè)臺(tái)等（統(tǒng)稱為ESME擴(kuò)展短消息實(shí)體）可以直接和ISMG按照CMPP或SMPP,SGIP,SMGP協(xié)議通訊，實(shí)現(xiàn)規(guī)范規(guī)定的

7、有關(guān)服務(wù)。ESME和ISMG之間的通訊直接通過CMPP，SMPP等協(xié)議，是十分煩瑣的，而且有許多工作是公共的，所以在M900 INtess-SMAX II系統(tǒng)中提供了一些API函數(shù)，供ESME(SP,CP)直接使用，而不用ESME處理低層的TCPIP通信，及ISMG的握手等工作。通過這些API函數(shù)，將CMPP,SMPP等協(xié)議以API函數(shù)的形式提供給ESME使用。第21頁，共40頁。SMEIDLL基本功能1. 低層鏈路出現(xiàn)故障時(shí)，重連鏈路，提示上層。2. 和ISMG的定時(shí)握手。3. 提供實(shí)現(xiàn)CMPP和SMPP協(xié)議的API函數(shù)。API函數(shù)應(yīng)用說明第22頁，共40頁。 培訓(xùn)大綱基礎(chǔ)知識(shí)培訓(xùn)（25分鐘

8、）infoX信息平臺(tái)介紹（10分鐘）CMPP2.0 介紹（15分鐘）API 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）開發(fā)應(yīng)用舉例(30)VCDemo VBDemo答疑討論(20分鐘)第23頁，共40頁。VC中如何調(diào)用動(dòng)態(tài)鏈接庫(kù)Implict方式：必須包含三要素：1. 在一個(gè).h文件中，聲明要調(diào)用的dll函數(shù)。示例為export.h(該.h文件是生成dll時(shí)創(chuàng)建的)。2. 連接一個(gè).lib文件(SMEIDLL.lib)，該文件包含dll的入口地址，用于程序運(yùn)行時(shí)，操作系統(tǒng)來訪問該dll。示例為SMEIDLL.

9、lib (該.lib文件是生成dll時(shí)創(chuàng)建的)。3.在系統(tǒng)目錄下安裝.dll文件(SMEIDLL.dll)。第24頁，共40頁。初始化接口：/事件：點(diǎn)擊主界面的“初始化”按鈕void CDemoDlg:OnInit() / TODO: Add your control notification handler code here/初始化接口：編碼協(xié)議、通訊協(xié)議、通訊協(xié)議參數(shù)int iRet;iRet=IFInitInterface( 3,1,8 5016 5000);if(iRet!=0)MessageBox(初始化套接字成功!,MB_OK,0);elseMessageBox(初始化套接字失敗

10、!,MB_OK,0);第25頁，共40頁。登陸：/事件：點(diǎn)擊主界面的“初始化”按鈕void CDemoDlg:OnLogin() / TODO: Add your control notification handler code here/登錄短訊中心：接口名、接口密碼int iRet;iRet=Login_R(vp,);if(iRet!=0)MessageBox(登錄成功!,MB_OK,0);elseMessageBox(登錄失敗!,MB_OK,0);第26頁，共40頁。發(fā)送消息：/事件：點(diǎn)擊主界面的“發(fā)送短訊”按鈕void CDemoDlg:OnSendSM() / TODO: Add

11、your control notification handler code here/向短訊中心提交短消息，返回失敗原因int iRet;unsigned long* SM_ID;/返回：短消息unsigned char* FCS;unsigned long UDLen;LPCTSTR UserData;UserData=dfdgf;UDLen=strlen(UserData); iRet=SubmitAExEx(2,1 2,1,968,0,0,0,0,0,0,0, 5000,5000, 100,0,UDLen,UserData,SM_ID,FCS);if(iRet

12、=0)MessageBox(發(fā)送成功!,MB_OK,0);elseMessageBox(發(fā)送失敗!,MB_OK,0); 第27頁，共40頁。獲取消息：/事件：點(diǎn)擊主界面的“獲取消息”按鈕void CDemoDlg:OnGetSM() / TODO: Add your control notification handler code here/獲取短消息的內(nèi)容 int iRet;ULONG* sm_ID = new ULONG;unsigned char* DestTON = new unsigned char;unsigned char* DestNPI = new unsigned cha

13、r;char* DestAddr = new char;unsigned char* OrgTON = new unsigned char; unsigned char* OrgNPI = new unsigned char;char* OrgAddr =new char;unsigned char* PRI = new unsigned char;unsigned char* RP = new unsigned char;unsigned char* UDHI = new unsigned char;unsigned char* PID = new unsigned char;unsigne

14、d char* DCS = new unsigned char;char* TimeStamp = new char;unsigned long * UDLen = new unsigned long;char* UserData = new char;第28頁，共40頁。 iRet = GetDeliverSMExEx(sm_ID,DestTON,DestNPI,DestAddr,OrgTON,OrgNPI, OrgAddr,PRI,RP, UDHI,PID, DCS,TimeStamp, UDLen,UserData);if(iRet = 0)MessageBox(接收成功！,MB_OK,

15、0);CGetSMDlg dlg; /在此添加代碼，在listbox框中顯示該新短訊的各種狀態(tài)。 dlg.DoModal();elseMessageBox(接收失??！,MB_OK,0);第29頁，共40頁。演示一個(gè)DEMO程序。第30頁，共40頁。VB中如何調(diào)用動(dòng)態(tài)鏈接庫(kù)第31頁，共40頁。利用事件驅(qū)動(dòng)，設(shè)計(jì)一個(gè)主界面：第32頁，共40頁。IFInitInterface調(diào)用方法：事件：點(diǎn)擊主界面的“初始化”按鈕功能:初始化套接字,準(zhǔn)備連接Private Sub cmdInitSocket_Click()Dim bRet As BooleanDim ulRet As LongDim iCount

16、 As IntegerStatusBar1.Panels(1).Text = ulRet = IFInitInterface(CodeProtocol + 1, DriverProtocol + 1, _ Trim(DriverParam)fStatusform.ProgressBar1.Value = 100Unload fStatusformIf ulRet 0 Then MsgBox 初始化套接字成功! StatusBar1.Panels(1).Text = 初始化連接成功Else MsgBox 初始化失敗! StatusBar1.Panels(1).Text = 初始化連接失敗End

17、IfEnd Sub第33頁，共40頁。Login_R調(diào)用方法：事件：點(diǎn)擊主界面的“登錄服務(wù)器”按鈕功能:登錄服務(wù)器Private Sub cmdLogin_Click()Dim bRet As BooleanDim ulRet As LongStatusBar1.Panels(1).Text = ulRet = Login_R(Trim(SystemID), Trim(Password)If ulRet 0 Then MsgBox 登錄成功! StatusBar1.Panels(1).Text = 登錄成功Else MsgBox 登錄失敗! StatusBar1.Panels(1).Text

18、= 登錄失敗End IfEnd Sub第34頁，共40頁。SubmitAExEx調(diào)用方法：事件：點(diǎn)擊主界面的“發(fā)送短訊”按鈕功能:向服務(wù)器提交短訊信息Private Sub cmdSubmit_Click()Dim result As IntegerDim UDLen As LongStatusBar1.Panels(1).Text = Dim UserData As StringUserData = test infoUDLen = Len(UserData)result = SubmitAExEx(OrgTON, OrgNPI, Trim(OrgAddr), DestTON, DestNP

19、I, _ DestAddr, PRI, RD, RP, SRR, MR, DCS * 4, PID, _ Trim(Schedule), Trim(Expire), Default_ID, UDHI, UDLen, UserData, SM_ID, FCS)If result = 0 Then MsgBox 發(fā)送成功! StatusBar1.Panels(1).Text = 發(fā)送成功Else MsgBox 發(fā)送失敗! StatusBar1.Panels(1).Text = 發(fā)送失敗End IfEnd Sub第35頁，共40頁。取Deliver消息的調(diào)用方法：事件：點(diǎn)擊主界面的“獲取消息”按鈕功

20、能:判斷是否有新短訊發(fā)來,如果有,則獲取該短訊的信息Private Sub cmdGetMsg_Click()StatusBar1.Panels(1).Text = GetMsgEnd Sub功能: 公共函數(shù)。判斷是否有新短訊發(fā)來；如果有, 則獲取該短訊的信息Sub GetMsg()Dim result As IntegerHDM_TimeOut = 2000result = HasDeliverMessage(HDM_TimeOut)If result = 0 Then MsgBox 你有新短訊! StatusBar1.Panels(1).Text = 有新短訊Else StatusBar1

21、.Panels(1).Text = 無新短訊End IfIf result = 0 Then result = GetDeliverSMExEx(SM_ID_R, DestTON_R, DestNPI_R, DestAddr_R, OrgTON_R, OrgNPI_R, OrgAddr_R, PRI_R, RP_R, UDHI_R, PID_R, DCS_R, TimeStamp_R, UDLen_R, UserData_R)第36頁，共40頁。 If result = 0 Then MsgBox 接收短訊成功! StatusBar1.Panels(1).Text = 接受短訊成功 Set f

22、NewSMForm = New frmNewSM fNewSMForm.List1.AddItem 短消息的ID： + CStr(SM_ID_R) fNewSMForm.List1.AddItem 目標(biāo)地址號(hào)碼類型： + CStr(DestTON_R) fNewSMForm.List1.AddItem 目標(biāo)地址編碼方案： + CStr(DestNPI_R) fNewSMForm.List1.AddItem 目標(biāo)地址： + DestAddr_R fNewSMForm.List1.AddItem 源地址號(hào)碼類型： + CStr(OrgTON_R) fNewSMForm.List1.AddItem 源地址編碼方案： + CStr(OrgNPI_R) fNewSMForm.List1.AddItem 源地址： + OrgAddr_R fNewSMForm.List1.AddItem 回應(yīng)路徑： + CStr(RP_R) fNewSMForm.List1.AddItem 頭結(jié)構(gòu)指示： + CStr(UDHI_R) fNewSMFor