浙江聯通行业应用短信平台二次开发接口使用手册(学生上课内容).docVIP

文件版本：V1.0.070201 发布时间：2007.02.01 浙江联通行业应用短信平台 二次开发接口使用手册 （V1.0） 中国联通浙江分公司增值业务部 2007.02 1．简介 1.1系统的结构和特点 浙江联通行业应用短信平台具备二次开发接口（后面简称接口或接口软件），接口软件在整个方案中的位置如下图中蓝色部分所示，在安装了接口软件以后，企业内部所有的短信应用系统只要对接口数据库进行数据存储，就能完成收发短信的工作，并且可以查询到所发送短信当前的状态，避免了企业内部软件开发人员在CMPP、SMPP等短信通讯协议上浪费大量的人力和物力。 和使用API接口在CMPP或SMPP协议层次上开发短信应用程序相比，企业直接使用本系统提供的数据库接口开发短信应用程序，可以至少节省一个开发小组几个月的工作量，在时间就是金钱的现代社会，本系统为企业带来的时间效益是惊人的。 图例：绿色箭头——采用SGIP或SMPP协议传输短信的链路 红色箭头——采用加密数据包传输短信的链路 本系统采用了各种方法保证企业短信收发的安全性和稳定性： 信息加密：和浙江联通行业短信平台接口服务器之间的通讯不采用CMPP、SMPP等非加密的协议，而是在短消息传送的过程中进行加密传输，保证了信息的安全性。 断线重连：软件具备断线自动重连的功能，当因为网络异常等各种原因造成链路中断时，软件能够自动重复尝试连接，以保证短信收发的及时性和可靠性。 免维护：接口服务软件采用系统服务的方式在后台运行，无须用户干预，即使遇到服务器断电等异常情况，只要按动电源按钮重新将计算机开机，软件即可自动运行。 接口软件和企业内部的短信应用系统之间采用容易编程的数据库接口，使开发人员能够以最简便的方式实现最强大的功能： 发送简单方便：软件自动对接口数据库进行扫描，企业内部的短信应用系统只要将短信发送号码和内容保存到接口数据库里面，就可以将短信发送到用户的手机上。 状态可查询：软件自动接收短信网关返回的短信状态报告，并将状态保存到接口数据库中，企业内部的短信应用程序只要查询数据库，就可以得知短信的当前状态。 信息双向交流：当用户向企业发送短信时，软件自动从服务器端接收短信并保存到接口数据库中，其他应用程序只要查询接口数据库，就可以获取该短信。 号码扩展：企业可以对短信号码进行多达8位的扩展，便于多个内部应用系统同时通过该接口收发短信，真正实现一点接入，多点使用。 支持广泛：现在最新版本的短信接口服务软件已经支持最常用的Oracle、SQLServer和Sybase数据库。 1.2运行环境 接口软件的运行环境为： 硬件要求：CPU PIII 700以上，内存128M 软件要求：Windows 2000/XP，如果接口数据库使用Oracle，则需安装Oracle客户端软件。 和软件配套使用的接口数据库可以使用Oracle、SQL Server或Sybase三种类型，接口数据库和接口服务软件既可以安装在不同的计算机上，也可以安装在同一台计算机上，如果两者安装在同一台服务器上，那么服务器的硬件配置应该相应提高。建议采用下列配置的专用服务器： ※ 双P4 1600 CPU，1G内存，36.4G x 2热插拔硬盘（Raid1） 2．数据库的安装和配置 在安装接口服务软件之前，需要首先安装数据库并初始化接口表，下面的内容将分Oracle、SQLServer和Sybase数据库三种类型分别说明如何创建接口表。 2.1使用Oracle数据库 在使用Oracle数据库的情况下，最好为短信接口表单独设置一个表空间，并为其单独分配一个用户，以便和其他短信应用系统使用的数据表隔离。 2.1.1数据字典 下面是短信接口表的初始化脚本，各字段的取值和含义已经包含在字段的注释中： -- -- 系统范围内唯一的ID，容量：10位整数 -- drop sequence sms_seq; create sequence sms_seq increment by 1 start with 1 maxvalue 9999999999 nocache; -- -- 数据库版本表 -- !!! 请不要增加、删除或者修改本表的记录 !!! -- drop table sms_ver cascade constraints; create table sms_ver ( ver number(2) -- 数据库结构版本号 ); insert into sms_ver values(1); commit; -- -- 短信接收表 -- drop table sms_recei