infoX -API接口培训材料(共40张)(PPT 40页)

1、i短消息API开发培训2003-01-14华为技术有限公司第1页，共40页。 培训大纲基础知识培训（25分钟）infoX信息平台介绍（10分钟）CMPP2.0 介绍（15分钟）API 函数讲解(45分钟)smeidll 函数接口介绍（25分钟）Unix 函数接口介绍（10分钟）Java 函数接口介绍（10分钟）开发应用举例(30)VCDemo VBDemo答疑讨论(20分钟)第2页，共40页。infoX短消息信息平台 短消息信息平台系统概述 短消息信息平台功能 信息平台维测和管理 网管与信息平台第3页，共40页。infoX 信息平台主要用途移动梦网网关（广东、江苏、浙江）短消息互联网关（移动，

2、联通，固网）固网网关联通在线企业短消息网关等第4页，共40页。移动梦网网关拓扑图infoX-ISMGSP 1SMSC mInternetISMGGNSSMSC 1SP nSCP计费中心第5页，共40页。互联网关网络组网示意图第6页，共40页。短消息信息平台支持协议和遵循规范SMPP 协议，CMPP协议 , SGIP 协议,SMGP协议遵循规范短消息网关设备规范V1.2中国移动通信短消息网关测试规范V1.2中国移动通信资源站实体与互联网短消息网关接口协议V1.2神州行梦网业务SCP与ISMG之间通讯协议1.0点对点短消息网间互通协议V2.0点对点短消息网间测试规范V1.2第7页，共40页。inf

3、oX网关综合性能指标 infoX平台性能指标:最大消息处理能力1200条/秒最大缓存消息数500万条最大CMPP/SMPP端口数1000个最大短消息中心接入数64个最大缓存路由信息5000个第8页，共40页。infoX短消息信息平台 短消息信息平台系统概述 短消息信息平台功能 信息平台维测和管理 网管与信息平台第9页，共40页。信息平台功能（一）路由管理接口管理，帐号管理消息实时跟踪鉴权管理记忆路由功能第10页，共40页。信息平台功能（二）鉴权管理记忆路由功能告警功能业务外包特性管理权限分级功能第11页，共40页。信息平台功能（三）主叫路由功能接口限制功能计费流水话单用户过滤主备接口功能业务优

4、先级管理第12页，共40页。infoX短消息信息平台 短消息信息平台系统概述 短消息信息平台功能 信息平台维测和管理 网管与信息平台第13页，共40页。主要功能系统参数设置帐号管理协议跟踪网关短信管理数据日常维护。 综合网关维测台第14页，共40页。infoX短消息信息平台 短消息信息平台系统概述 短消息信息平台功能 信息平台维测和管理 网管与信息平台第15页，共40页。网管维护管理infoXI2000MT SERVER上级综合网管统一网管集中监控配置管理实时告警统计管理第16页，共40页。培训大纲基础知识培训（25分钟）infoX信息平台介绍（10分钟）CMPP2.0 介绍（15分钟）API

5、 函数讲解(45分钟)smeidll 函数接口介绍（25分钟）Unix 函数接口介绍（10分钟）Java 函数接口介绍（10分钟）开发应用举例(30)VCDemo VBDemo答疑讨论(20分钟)第17页，共40页。SP 和网关之间消息流建议通讯方式：长连接 SP ISMGCMPP_CONNECTCMPP_CONNECTt_RESPCMPP_SUBMITCMPP_SUBMIT_RESPCMPP_QUERYcCMPP_QUERY_RESPCMPP_CANCLECMPP_CANCLE_RESPCMPP_DELIVERCMPP_DELIVER_RESP第18页，共40页。 培训大纲基础知识培训（25

6、分钟）infoX信息平台介绍（10分钟）CMPP2.0 介绍（15分钟）API 函数讲解(45分钟)smeidll 函数接口介绍（25分钟）Unix 函数接口介绍（10分钟）Java 函数接口介绍（10分钟）开发应用举例(30)VCDemo VBDemo答疑讨论(20分钟)第19页，共40页。短消息平台系统结构SP： 业务提供商程序SMEIDLL： 动态库接口ISMG： infoX短消息网关第20页，共40页。SMEIDLL接口的优点：Sp,CP,ICP,人工台、自动台、维测台等（统称为ESME扩展短消息实体）可以直接和ISMG按照CMPP或SMPP,SGIP,SMGP协议通讯，实现规范规定的

7、有关服务。ESME和ISMG之间的通讯直接通过CMPP，SMPP等协议，是十分烦琐的，而且有许多工作是公共的，所以在M900 INtess-SMAX II系统中提供了一些API函数，供ESME(SP,CP)直接使用，而不用ESME处理低层的TCPIP通信，及ISMG的握手等工作。通过这些API函数，将CMPP,SMPP等协议以API函数的形式提供给ESME使用。第21页，共40页。SMEIDLL基本功能1. 低层链路出现故障时，重连链路，提示上层。2. 和ISMG的定时握手。3. 提供实现CMPP和SMPP协议的API函数。API函数应用说明第22页，共40页。 培训大纲基础知识培训（25分钟

8、）infoX信息平台介绍（10分钟）CMPP2.0 介绍（15分钟）API 函数讲解(45分钟)smeidll 函数接口介绍（25分钟）Unix 函数接口介绍（10分钟）Java 函数接口介绍（10分钟）开发应用举例(30)VCDemo VBDemo答疑讨论(20分钟)第23页，共40页。VC中如何调用动态链接库Implict方式：必须包含三要素：1. 在一个.h文件中，声明要调用的dll函数。示例为export.h(该.h文件是生成dll时创建的)。2. 连接一个.lib文件(SMEIDLL.lib)，该文件包含dll的入口地址，用于程序运行时，操作系统来访问该dll。示例为SMEIDLL.

9、lib (该.lib文件是生成dll时创建的)。3.在系统目录下安装.dll文件(SMEIDLL.dll)。第24页，共40页。初始化接口：/事件：点击主界面的“初始化”按钮void CDemoDlg:OnInit() / TODO: Add your control notification handler code here/初始化接口：编码协议、通讯协议、通讯协议参数int iRet;iRet=IFInitInterface( 3,1,8 5016 5000);if(iRet!=0)MessageBox(初始化套接字成功!,MB_OK,0);elseMessageBox(初始化套接字失败

10、!,MB_OK,0);第25页，共40页。登陆：/事件：点击主界面的“初始化”按钮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页。发送消息：/事件：点击主界面的“发送短讯”按钮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(发送成功!,MB_OK,0);elseMessageBox(发送失败!,MB_OK,0); 第27页，共40页。获取消息：/事件：点击主界面的“获取消息”按钮void CDemoDlg:OnGetSM() / TODO: Add your control notification handler code here/获取短消息的内容 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框中显示该新短讯的各种状态。 dlg.DoModal();elseMessageBox(接收失败！,MB_OK,0);第29页，共40页。演示一个DEMO程序。第30页，共40页。VB中如何调用动态链接库第31页，共40页。利用事件驱动，设计一个主界面：第32页，共40页。IFInitInterface调用方法：事件：点击主界面的“初始化”按钮功能:初始化套接字,准备连接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调用方法：事件：点击主界面的“登录服务器”按钮功能:登录服务器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调用方法：事件：点击主界面的“发送短讯”按钮功能:向服务器提交短讯信息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 发送成功! StatusBar1.Panels(1).Text = 发送成功Else MsgBox 发送失败! StatusBar1.Panels(1).Text = 发送失败End IfEnd Sub第35页，共40页。取Deliver消息的调用方法：事件：点击主界面的“获取消息”按钮功

20、能:判断是否有新短讯发来,如果有,则获取该短讯的信息Private Sub cmdGetMsg_Click()StatusBar1.Panels(1).Text = GetMsgEnd Sub功能: 公共函数。判断是否有新短讯发来；如果有, 则获取该短讯的信息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 目标地址号码类型： + CStr(DestTON_R) fNewSMForm.List1.AddItem 目标地址编码方案： + CStr(DestNPI_R) fNewSMForm.List1.AddItem 目标地址： + DestAddr_R fNewSMForm.List1.AddItem 源地址号码类型： + CStr(OrgTON_R) fNewSMForm.List1.AddItem 源地址编码方案： + CStr(OrgNPI_R) fNewSMForm.List1.AddItem 源地址： + OrgAddr_R fNewSMForm.List1.AddItem 回应路径： + CStr(RP_R) fNewSMForm.List1.AddItem 头结构指示： + CStr(UDHI_R) fNewSMFor