中国联通SGIP1.2短消息网关开发接口库 V1.7

中国联通SGIP1.2短消息网关开发接口库 V1.7 Description:
一、 简介
SGIPAPI短消息网关开发接口库是由北京风起水流软件工作室（http://www.zealware.com）开发的SMAL开发库的一部分，支持中国联通的SGIP1.2协议（修订版）。
1. 什么是SMAL?
SMAL是short message abstract library的缩写,是一个主要用于短信网关平台的底层抽象接口库，通过对短信协议的抽象封装，可以在smal上面方便地实现CMPP，SGIP，SMPP，SMGP，CNGP，EMPP等短信协议，同时可以很方便地在上面扩展实现新的协议和自定义的内部协议等。
2. SMAL目前支持哪些协议？
SMAL目前支持的协议包括中国移动的CMPP2.0,CMPP3.0,中国联通的 SGIP1.2, SGIP1.2修订版，中国电信的SMGP2.0，SMGP3.0，中国网通的CNGP2.0，和国际标准SMPP3.3，SMPP3.4，以及企信通协议EMPP等。
 
二、 SGIPAPI目录说明和文件列表
1. ./include
接口库的包含文件目录，里面是接口库所需的头文件
./include/smal.h
包含windows和MFC的一些文件和定义，所有的SMAL库都需要用到该文件。
./include/common
SMAL库的各个协议的通用头文件所在目录
./include/common/const.h
接口库的所有常量定义，例如命令字，错误代码等。
./include/common/logqueue.h
日志队列类
./include/common/threadpool.h
线程池类
./include/common/util.h
一些功能函数和类定义
./include/sgip
SMAL库中SGIP协议需要的头文件所在目录
./include/sgip/sgip_message.h
定义了SGIP协议消息结构。
./include/sgip/sgip_const.h
定义了SGIP协议的错误码，命令字等常量。
./include/sgip/sgip_function.h
定义了SGIP底层socket操作以及SGIP协议的底层实现。
./include/sgip/sgipapi.h
定义了CSgip类,一个高度封装，简单易用的sgip实现。
2. ./lib
静态库文件目录
./lib/zealware_sgip.lib
Release版的sgiplib库文件
./lib/zealware_sgipd.lib
debug版的sgiplib库文件
3. ./doc
相关文档(使用手册，参考手册，FAQ)目录
4. ./sample
VC7.1示例工程目录，演示了如何用SGIPAPI很容易地开发一个完整的SP网关程序。包括一个对话框形式的和一个命令行形式的两个示例工程。开发环境是Visual studio .net 2003 + Winxp SP2。
 
三、 SGIPAPI的功能特点
运行稳定。经过五年在线运行，目前在全国有超过100家SP采用我们提供的短信网关开发接口库。
效率高，资源占用率低。接口库内建线程池和中间件系统，采用多连接，多线程的WINDOWS完成端口技术，采用智能路由和连接分配方法，能够处理大量的并发短信，最充分地利用系统资源。线程池能够根据当前的系统负荷，动态地进行线程数调节，动态地增减线程。
网关完全符合中国联通SGIP1.2(修订版)协议标准。支持各省和全网的所有短信网关，支持LinkID。
高度封装，开发效率高。二次开发人员只需要很少的开发工作就可以实现短信网关应用和业务开发。
支持自动重连，自动重发功能。参数定制性强，可以同时连接多个网关进行消息收发。
系统采用面向对象的方法，严格按照SGIP1.2协议实现，支持Bind, BindResp,Submit, SubmitResp, Deliver, DeliverResp, Report, ReportResp, Unbind, UnbindResp消息，符合联通网关的最新标准(SGIP 0120修订版)。
发送消息采用长连接的方式,并且允许用户自定义同网关建立的连接数；接收消息采用半长连接的方式，可以设置超时时间，在没有消息的情况下，主动断开网关连接。
接口库采用事件触发的方式，经过高度封装，模块化强，使用非常简单，屏蔽了网关通信，消息收发和处理的复杂性操作，SP用户只需要关注具体的业务处理过程，大大简化了短消息开发的难度！
以最为方便灵活的形式提供了短信群发功能(参见函数AddUserNumber()说明)。
由于采用了面向对象的方法，因此你只需要初始化多个实例，就可以很方便地连接多个网关。 
..........................