infoX -API接口培訓(xùn)材料

1、1i i短消息短消息APIAPI開發(fā)培訓(xùn)開發(fā)培訓(xùn)2003-01-14HUAWEIHUAWEI 培訓(xùn)大綱b基礎(chǔ)知識培訓(xùn)（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）b開發(fā)應(yīng)用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEI HUAWEIHUAWEIinfoX 信息平臺主要用途b移動夢網(wǎng)網(wǎng)關(guān)（廣東、江蘇、浙江）b短消息互聯(lián)網(wǎng)關(guān)（移動，聯(lián)通，固網(wǎng)）b固網(wǎng)網(wǎng)關(guān)b聯(lián)通在線b企業(yè)短消息網(wǎng)關(guān)等HUAWEI

2、HUAWEIinfoX-ISMGSP 1SMSC mInternetISMGGNSSMSC 1SP nSCP計(jì)費(fèi)中心計(jì)費(fèi)中心HUAWEIHUAWEI互聯(lián)網(wǎng)關(guān)網(wǎng)絡(luò)組網(wǎng)示意圖HUAWEIHUAWEI短消息信息平臺支持協(xié)議和遵循規(guī)范n短消息網(wǎng)關(guān)設(shè)備規(guī)范V1.2n中國移動通信短消息網(wǎng)關(guān)測試規(guī)范V1.2n中國移動通信資源站實(shí)體與互聯(lián)網(wǎng)短消息網(wǎng)關(guān)接口協(xié)議V1.2n神州行夢網(wǎng)業(yè)務(wù)SCP與ISMG之間通訊協(xié)議1.0n點(diǎn)對點(diǎn)短消息網(wǎng)間互通協(xié)議V2.0n點(diǎn)對點(diǎn)短消息網(wǎng)間測試規(guī)范V1.2HUAWEIHUAWEI HUAWEIHUAWEI HUAWEIHUAWEI信息平臺功能（一）b路由管理b接口管理，帳號管理b消息

3、實(shí)時(shí)跟蹤b鑒權(quán)管理b記憶路由功能HUAWEIHUAWEI信息平臺功能（二）b鑒權(quán)管理b記憶路由功能b告警功能b業(yè)務(wù)外包特性b管理權(quán)限分級功能HUAWEIHUAWEI信息平臺功能（三）b主叫路由功能b接口限制功能b計(jì)費(fèi)流水話單b用戶過濾b主備接口功能b業(yè)務(wù)優(yōu)先級管理HUAWEIHUAWEI HUAWEIHUAWEI主要功能系統(tǒng)參數(shù)設(shè)置帳號管理協(xié)議跟蹤網(wǎng)關(guān)短信管理數(shù) 據(jù) 日 常 維護(hù)。 綜合網(wǎng)關(guān)維測臺HUAWEIHUAWEI HUAWEIHUAWEI網(wǎng)管維護(hù)管理infoXI2000MT SERVER上級綜合網(wǎng)管上級綜合網(wǎng)管統(tǒng)一網(wǎng)管統(tǒng)一網(wǎng)管集中監(jiān)控集中監(jiān)控配置管理配置管理實(shí)時(shí)告警實(shí)時(shí)告警統(tǒng)計(jì)管理統(tǒng)計(jì)

4、管理HUAWEIHUAWEI培訓(xùn)大綱b基礎(chǔ)知識培訓(xùn)（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）b開發(fā)應(yīng)用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEISP 和網(wǎng)關(guān)之間消息流建議通訊方式：長連接 SP ISMGCMPP_CONNECTCMPP_CONNECTt_RESPCMPP_SUBMITCMPP_SUBMIT_RESPCMPP_QUERYcCMPP_QUERY_RESPCMPP_CAN

5、CLECMPP_CANCLE_RESPCMPP_DELIVERCMPP_DELIVER_RESPHUAWEIHUAWEI 培訓(xùn)大綱b基礎(chǔ)知識培訓(xùn)（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）b開發(fā)應(yīng)用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEI短消息平臺系統(tǒng)結(jié)構(gòu)短消息平臺系統(tǒng)結(jié)構(gòu)bSP： 業(yè)務(wù)提供商程序bSMEIDLL： 動態(tài)庫接口bISMG： infoX短消息網(wǎng)關(guān)HUAWEIHUAWE

6、ISMEIDLL接口的優(yōu)點(diǎn)：接口的優(yōu)點(diǎn)：bSp,CP,ICP,人工臺、自動臺、維測臺等（統(tǒng)稱為ESME擴(kuò)展短消息實(shí)體）可以直接和ISMG按照CMPP或SMPP,SGIP,SMGP協(xié)議通訊，實(shí)現(xiàn)規(guī)范規(guī)定的有關(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使用。HUAWEIHUAWEISMEID

7、LL基本功能基本功能b1. 低層鏈路出現(xiàn)故障時(shí)，重連鏈路，提示上層。b2. 和ISMG的定時(shí)握手。b3. 提供實(shí)現(xiàn)CMPP和SMPP協(xié)議的API函數(shù)。API函數(shù)應(yīng)用說明HUAWEIHUAWEI 培訓(xùn)大綱b基礎(chǔ)知識培訓(xùn)（25分鐘）infoX信息平臺介紹（10分鐘）CMPP2.0 介紹（15分鐘）bAPI 函數(shù)講解(45分鐘)smeidll 函數(shù)接口介紹（25分鐘）Unix 函數(shù)接口介紹（10分鐘）Java 函數(shù)接口介紹（10分鐘）b開發(fā)應(yīng)用舉例(30)VCDemo VBDemob答疑討論(20分鐘)HUAWEIHUAWEIVC中如何調(diào)用動態(tài)鏈接庫中如何調(diào)用動態(tài)鏈接庫Implict方式：方式：必須

8、包含三要素：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.lib (該.lib文件是生成dll時(shí)創(chuàng)建的)。3.在系統(tǒng)目錄下安裝.dll文件(SMEIDLL.dll)。HUAWEIHUAWEI初始化接口：初始化接口：/事件：點(diǎn)擊主界面的事件：點(diǎn)擊主界面的“初始化初始化”按鈕按鈕void CDemoDlg:OnInit() / TODO: Add your control notification

9、 handler code here/初始化接口：編碼協(xié)議、通訊協(xié)議、通訊協(xié)議參數(shù)初始化接口：編碼協(xié)議、通訊協(xié)議、通訊協(xié)議參數(shù)int iRet;iRet=IFInitInterface( 3,1,8 5016 5000);if(iRet!=0)MessageBox(初始化套接字成功初始化套接字成功!,MB_OK,0);elseMessageBox(初始化套接字失敗初始化套接字失敗!,MB_OK,0);HUAWEIHUAWEI登陸：登陸：/事件：點(diǎn)擊主界面的事件：點(diǎn)擊主界面的“初始化初始化”按鈕按鈕void CDemoDlg:OnLogin() / TODO: Add yo

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

11、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=0)MessageBox(發(fā)送成功發(fā)送成功!

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

13、ew unsigned char;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 unsign

14、ed char;unsigned char* DCS = new unsigned char;char* TimeStamp = new char;unsigned long * UDLen = new unsigned long;char* UserData = new char;HUAWEIHUAWEI iRet = GetDeliverSMExEx(sm_ID,DestTON,DestNPI,DestAddr,OrgTON,OrgNPI, OrgAddr,PRI,RP, UDHI,PID, DCS,TimeStamp, UDLen,UserData);if(iRet = 0)Messag

15、eBox(接收成功！接收成功！,MB_OK,0);CGetSMDlg dlg; /在此添加代碼，在在此添加代碼，在listbox框中顯示該新短訊的各種狀態(tài)。框中顯示該新短訊的各種狀態(tài)。 dlg.DoModal();elseMessageBox(接收失??！接收失?。?MB_OK,0);HUAWEIHUAWEI演示一個(gè)DEMO程序。HUAWEIHUAWEI在公共模塊中，全局聲明對動態(tài)鏈接庫 (DLL) 中外部過程的引用。利用public declare function來聲明,示例（IFInitInterface 是dll中的一個(gè)函數(shù)）：Public Declare Function IFInit

16、Interface Lib smeidll.dll (ByVal dwCodeProtocol As Long,ByVal dwDriverProtocol As Long,ByVal pDriverParam As String ) As LongVB中如何調(diào)用動態(tài)鏈接庫中如何調(diào)用動態(tài)鏈接庫HUAWEIHUAWEI登錄SMSC用戶修改配置參數(shù)初始化套接字,準(zhǔn)備連接獲取新短訊啟動定時(shí)器發(fā)送新短訊定時(shí)器控件利用事件驅(qū)動，設(shè)計(jì)一個(gè)主界面：利用事件驅(qū)動，設(shè)計(jì)一個(gè)主界面：HUAWEIHUAWEIIFInitInterface調(diào)用方法：調(diào)用方法：事件：點(diǎn)擊主界面的事件：點(diǎn)擊主界面的“初始化初始化”按鈕按

17、鈕功能功能:初始化套接字初始化套接字,準(zhǔn)備連接準(zhǔn)備連接Private Sub cmdInitSocket_Click()Dim bRet As BooleanDim ulRet As LongDim iCount As IntegerStatusBar1.Panels(1).Text = ulRet = IFInitInterface(CodeProtocol + 1, DriverProtocol + 1, _ Trim(DriverParam)fStatusform.ProgressBar1.Value = 100Unload fStatusformIf ulRet 0 Then MsgB

18、ox 初始化套接字成功初始化套接字成功! StatusBar1.Panels(1).Text = 初始化連接成功初始化連接成功Else MsgBox 初始化失敗初始化失敗! StatusBar1.Panels(1).Text = 初始化連接失敗初始化連接失敗End IfEnd SubHUAWEIHUAWEILogin_R調(diào)用方法：調(diào)用方法：事件：點(diǎn)擊主界面的事件：點(diǎn)擊主界面的“登錄服務(wù)器登錄服務(wù)器”按鈕按鈕功能功能:登錄服務(wù)器登錄服務(wù)器Private Sub cmdLogin_Click()Dim bRet As BooleanDim ulRet As LongStatusBar1.Panel

19、s(1).Text = ulRet = Login_R(Trim(SystemID), Trim(Password)If ulRet 0 Then MsgBox 登錄成功登錄成功! StatusBar1.Panels(1).Text = 登錄成功登錄成功Else MsgBox 登錄失敗登錄失敗! StatusBar1.Panels(1).Text = 登錄失敗登錄失敗End IfEnd SubHUAWEIHUAWEISubmitAExEx調(diào)用方法：調(diào)用方法：事件：點(diǎn)擊主界面的事件：點(diǎn)擊主界面的“發(fā)送短訊發(fā)送短訊”按鈕按鈕功能功能:向服務(wù)器提交短訊信息向服務(wù)器提交短訊信息Private Sub

20、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, DestNPI, _ DestAddr, PRI, RD, RP, SRR, MR, DCS * 4, PID, _ Trim(Schedule), Trim(Expire), Defa

21、ult_ID, UDHI, UDLen, UserData, SM_ID, FCS)If result = 0 Then MsgBox 發(fā)送成功發(fā)送成功! StatusBar1.Panels(1).Text = 發(fā)送成功發(fā)送成功Else MsgBox 發(fā)送失敗發(fā)送失敗! StatusBar1.Panels(1).Text = 發(fā)送失敗發(fā)送失敗End IfEnd SubHUAWEIHUAWEI取取Deliver消息的調(diào)用方法：消息的調(diào)用方法：事件：點(diǎn)擊主界面的事件：點(diǎn)擊主界面的“獲取消息獲取消息”按鈕按鈕功能功能:判斷是否有新短訊發(fā)來判斷是否有新短訊發(fā)來,如果有如果有,則獲取該短訊的信息則獲取該

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

23、新短訊Else StatusBar1.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)HUAWEIHUAWEI If result = 0 Then MsgBox 接收短訊成功! StatusBar1.Panel

24、s(1).Text = 接受短訊成功 Set fNewSMForm = New frmNewSM fNewSMForm.List1.AddItem 短消息的ID： + CStr(SM_ID_R) fNewSMForm.List1.AddItem 目標(biāo)地址號碼類型： + CStr(DestTON_R) fNewSMForm.List1.AddItem 目標(biāo)地址編碼方案： + CStr(DestNPI_R) fNewSMForm.List1.AddItem 目標(biāo)地址： + DestAddr_R fNewSMForm.List1.AddItem 源地址號碼類型： + 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) fNewS