infoX-API接口培训材料.ppt

i短消息API开发培训,2003-01-14,华为技术有限公司,培训大纲,基础知识培训（25分钟）infoX信息平台介绍（10分钟）CMPP2.0介绍（15分钟）API函数讲解(45分钟)smeidll函数接口介绍（25分钟）Unix函数接口介绍（10分钟）Java函数接口介绍（10分钟）开发应用举例(30)VCDemoVBDemo答疑讨论(20分钟),infoX短消息信息平台,短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台,infoX信息平台主要用途,移动梦网网关（广东、江苏、浙江）短消息互联网关（移动，联通，固网）固网网关联通在线企业短消息网关等,移动梦网网关拓扑图,infoX-ISMG,SP1,SMSCm,Internet,ISMG,GNS,SMSC1,SPn,SCP,计费中心,互联网关网络组网示意图,短消息信息平台支持协议和遵循规范,SMPP协议，CMPP协议,SGIP协议,SMGP协议遵循规范短消息网关设备规范V1.2中国移动通信短消息网关测试规范V1.2中国移动通信资源站实体与互联网短消息网关接口协议V1.2神州行梦网业务SCP与ISMG之间通讯协议1.0点对点短消息网间互通协议V2.0点对点短消息网间测试规范V1.2,infoX网关综合性能指标,infoX平台性能指标:最大消息处理能力1200条/秒最大缓存消息数500万条最大CMPP/SMPP端口数1000个最大短消息中心接入数64个最大缓存路由信息5000个,infoX短消息信息平台,短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台,信息平台功能（一）,路由管理接口管理，帐号管理消息实时跟踪鉴权管理记忆路由功能,信息平台功能（二）,鉴权管理记忆路由功能告警功能业务外包特性管理权限分级功能,信息平台功能（三）,主叫路由功能接口限制功能计费流水话单用户过滤主备接口功能业务优先级管理,infoX短消息信息平台,短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台,主要功能系统参数设置帐号管理协议跟踪网关短信管理数据日常维护。,综合网关维测台,infoX短消息信息平台,短消息信息平台系统概述短消息信息平台功能信息平台维测和管理网管与信息平台,网管维护管理,统一网管集中监控配置管理实时告警统计管理,培训大纲,基础知识培训（25分钟）infoX信息平台介绍（10分钟）CMPP2.0介绍（15分钟）API函数讲解(45分钟)smeidll函数接口介绍（25分钟）Unix函数接口介绍（10分钟）Java函数接口介绍（10分钟）开发应用举例(30)VCDemoVBDemo答疑讨论(20分钟),SP和网关之间消息流建议通讯方式：长连接,培训大纲,基础知识培训（25分钟）infoX信息平台介绍（10分钟）CMPP2.0介绍（15分钟）API函数讲解(45分钟)smeidll函数接口介绍（25分钟）Unix函数接口介绍（10分钟）Java函数接口介绍（10分钟）开发应用举例(30)VCDemoVBDemo答疑讨论(20分钟),短消息平台系统结构,SP：业务提供商程序SMEIDLL：动态库接口ISMG：infoX短消息网关,SMEIDLL接口的优点：,Sp,CP,ICP,人工台、自动台、维测台等（统称为ESME扩展短消息实体）可以直接和ISMG按照CMPP或SMPP,SGIP,SMGP协议通讯，实现规范规定的有关服务。ESME和ISMG之间的通讯直接通过CMPP，SMPP等协议，是十分烦琐的，而且有许多工作是公共的，所以在M900INtess-SMAXII系统中提供了一些API函数，供ESME(SP,CP)直接使用，而不用ESME处理低层的TCPIP通信，及ISMG的握手等工作。通过这些API函数，将CMPP,SMPP等协议以API函数的形式提供给ESME使用。,SMEIDLL基本功能,1.低层链路出现故障时，重连链路，提示上层。2.和ISMG的定时握手。3.提供实现CMPP和SMPP协议的API函数。,API函数应用说明,培训大纲,基础知识培训（25分钟）infoX信息平台介绍（10分钟）CMPP2.0介绍（15分钟）API函数讲解(45分钟)smeidll函数接口介绍（25分钟）Unix函数接口介绍（10分钟）Java函数接口介绍（10分钟）开发应用举例(30)VCDemoVBDemo答疑讨论(20分钟),VC中如何调用动态链接库,Implict方式：必须包含三要素：1.在一个.h文件中，声明要调用的dll函数。示例为export.h(该.h文件是生成dll时创建的)。2.连接一个.lib文件(SMEIDLL.lib)，该文件包含dll的入口地址，用于程序运行时，操作系统来访问该dll。示例为SMEIDLL.lib(该.lib文件是生成dll时创建的)。3.在系统目录下安装.dll文件(SMEIDLL.dll)。,初始化接口：/事件：点击主界面的“初始化”按钮voidCDemoDlg:OnInit()/TODO:Addyourcontrolnotificationhandlercodehere/初始化接口：编码协议、通讯协议、通讯协议参数intiRet;iRet=IFInitInterface(3,1,850165000);if(iRet!=0)MessageBox(初始化套接字成功!,MB_OK,0);elseMessageBox(初始化套接字失败!,MB_OK,0);,登陆：/事件：点击主界面的“初始化”按钮voidCDemoDlg:OnLogin()/TODO:Addyourcontrolnotificationhandlercodehere/登录短讯中心：接口名、接口密码intiRet;iRet=Login_R(vp,);if(iRet!=0)MessageBox(登录成功!,MB_OK,0);elseMessageBox(登录失败!,MB_OK,0);,发送消息：/事件：点击主界面的“发送短讯”按钮voidCDemoDlg:OnSendSM()/TODO:Addyourcontrolnotificationhandlercodehere/向短讯中心提交短消息，返回失败原因intiRet;unsignedlong*SM_ID;/返回：短消息unsignedchar*FCS;unsignedlongUDLen;LPCTSTRUserData;UserData=dfdgf;UDLen=strlen(UserData);iRet=SubmitAExEx(2,12,1,968,0,0,0,0,0,0,0,5000,5000,100,0,UDLen,UserData,SM_ID,FCS);if(iRet=0)MessageBox(发送成功!,MB_OK,0);elseMessageBox(发送失败!,MB_OK,0);,获取消息：/事件：点击主界面的“获取消息”按钮voidCDemoDlg:OnGetSM()/TODO:Addyourcontrolnotificationhandlercodehere/获取短消息的内容intiRet;ULONG*sm_ID=newULONG;unsignedchar*DestTON=newunsignedchar;unsignedchar*DestNPI=newunsignedchar;char*DestAddr=newchar;unsignedchar*OrgTON=newunsignedchar;unsignedchar*OrgNPI=newunsignedchar;char*OrgAddr=newchar;unsignedchar*PRI=newunsignedchar;unsignedchar*RP=newunsignedchar;unsignedchar*UDHI=newunsignedchar;unsignedchar*PID=newunsignedchar;unsignedchar*DCS=newunsignedchar;char*TimeStamp=newchar;unsignedlong*UDLen=newunsignedlong;char*UserData=newchar;,iRet=GetDeliverSMExEx(sm_ID,DestTON,DestNPI,DestAddr,OrgTON,OrgNPI,OrgAddr,PRI,RP,UDHI,PID,DCS,TimeStamp,UDLen,UserData);if(iRet=0)MessageBox(接收成功！,MB_OK,0);CGetSMDlgdlg;/在此添加代码，在listbox框中显示该新短讯的各种状态。dlg.DoModal();elseMessageBox(接收失败！,MB_OK,0);,演示一个DEMO程序。,VB中如何调用动态链接库,利用事件驱动，设计一个主界面：,IFInitInterface调用方法：事件：点击主界面的“初始化”按钮功能:初始化套接字,准备连接PrivateSubcmdInitSocket_Click()DimbRetAsBooleanDimulRetAsLongDimiCountAsIntegerStatusBar1.Panels(1).Text=ulRet=IFInitInterface(CodeProtocol+1,DriverProtocol+1,_Trim(DriverParam)fStatusform.ProgressBar1.Value=100UnloadfStatusformIfulRet0ThenMsgBox初始化套接字成功!StatusBar1.Panels(1).Text=初始化连接成功ElseMsgBox初始化失败!StatusBar1.Panels(1).Text=初始化连接失败EndIfEndSub,Login_R调用方法：事件：点击主界面的“登录服务器”按钮功能:登录服务器PrivateSubcmdLogin_Click()DimbRetAsBooleanDimulRetAsLongStatusBar1.Panels(1).Text=ulRet=Login_R(Trim(SystemID),Trim(Password)IfulRet0ThenMsgBox登录成功!StatusBar1.Panels(1).Text=登录成功ElseMsgBox登录失败!StatusBar1.Panels(1).Text=登录失败EndIfEndSub,SubmitAExEx调用方法：事件：点击主界面的“发送短讯”按钮功能:向服务器提交短讯信息PrivateSubcmdSubmit_Click()DimresultAsIntegerDimUDLenAsLongStatusBar1.Panels(1).Text=DimUserDataAsStringUserData=testinfoUDLen=Len(UserData)result=SubmitAExEx(OrgTON,OrgNPI,Trim(OrgAddr),DestTON,DestNPI,_DestAddr,PRI,RD,RP,SRR,MR,DCS*4,PID,_Trim(Schedule),Trim(Expire),Default_ID,UDHI,UDLen,UserData,SM_ID,FCS)Ifresult=0ThenMsgBox发送成功!StatusBar1.Panels(1).Text=发送成功ElseMsgBox发送失败!StatusBar1.Panels(1).Text=发送失败EndIfEndSub,取Deliver消息的调用方法：事件：点击主界面的“获取消息”按钮功能:判断是否有新短讯发来,如果有,则获取该短讯的信息PrivateSubcmdGetMsg_Click()StatusBar1.Panels(1).Text=GetMsgEndSub功能:公共函数。判断是否有新短讯发来；如果有,则获取该短讯的信息SubGetMsg()DimresultAsIntegerHDM_TimeOut=2000result=HasDeliverMessage(HDM_TimeOut)Ifresult=0ThenMsgBox你有新短讯!StatusBar1.Panels(1).Text=有新短讯ElseStatusBar1.Panels(1).Text=无新短讯EndIfIfresult=0Thenresult=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),Ifresult=0ThenMsgBox接收短讯成功!StatusBar1.Panels(1).Text=接受短讯成功SetfNewSMForm=NewfrmNewSMfNewSMForm.List1.AddItem短消息的ID：+CStr(SM_ID_R)fNewSMForm.List1.AddItem目标地址号码类型：+CStr(DestTON_R)fNewSMForm.List1.AddItem目标地址编码方案：+CStr(DestNPI_R)fNewSMForm.List1.AddItem目标地址：+DestAddr_RfNewSMForm.List1.AddItem源地址号码类型：+CStr(OrgTON_R)fNewSMForm.List1.AddItem源地址编码方案：+CStr(OrgNPI_R)fNewSMForm.List1.AddItem源地址：+OrgAddr_RfNewSMForm.List1.AddItem回应路径：+CStr(RP_R)fNewSMForm.List1.AddItem头结构指示：+CStr(UDHI_R)fNew