协议开发 中移动CMPP2.0协议API（二）

云网(jimzj@21cn.om)

接上篇：

其实说到API的开发，也只是包装了一个通讯协议。让上层用户可以不用去知道详细的协议解释，而专注于自己的业务模块。

对于CMPP2.0协议，要用的指令也就8个，相对来说并不是很复杂

CMPP_CONNECT          =0x00000001; //       请求连接

CMPP_CONNECT_RESP     =0x80000001; //       请求连接应答

CMPP_TERMINATE        =0x00000002; //       终止连接

CMPP_TERMINATE_RESP   =0x80000002; //       终止连接应答

CMPP_SUBMIT           =0x00000004; //       提交短信

CMPP_SUBMIT_RESP      =0x80000004; //       提交短信应答

CMPP_DELIVER          =0x00000005; //       短信下发

CMPP_DELIVER_RESP     =0x80000005; //       下发短信应答

CMPP_QUERY            =0x00000006; //       短信状态查询

CMPP_QUERY_RESP       =0x80000006; //       短信状态查询应答

CMPP_CANCEL           =0x00000007; //       删除短信

CMPP_CANCEL_RESP      =0x80000007; //       删除短信应答

CMPP_ACTIVE_TEST      =0x00000008; //       激活测试

CMPP_ACTIVE_TEST_RESP =0x80000008;       //     激活测试应答

实现CMPP协议模块也就是实现上面的8个指令就可以了。按照上面说的设计模式，同进结合API开发来说一下协议的实现。

对于API对外的接口，一般的定义格式如下：

extern "C" __declspec( dllexport ) int WINAPI ActiveTest()

接下来就是实现接口的功能：

一、建立SOCKET连接

struct sockaddr_in _socaddr ;

    _socaddr.sin_family      = AF_INET;

    _socaddr.sin_port        = htons( _port );

    _socaddr.sin_addr.s_addr = inet_addr( _ismg );

        return connect( _soc, (struct sockaddr *)&_socaddr, sizeof( _socaddr ));

致于设置发送超时，接收超时还有阻塞或非阻塞的接收模式，可以自己根据需要去设置不同的目标值。

二、登录短信网关服务器

按CMPP协议，主要的部分是就是AuthenticatorSource = MD5（Source_Addr+9 字节的0 +shared secret+timestamp），MD5算法在网上可以直接找到源程序，不必要自己重新去写这个内容。这部分内容相对比较简单就不在这里再写出来了。

//计算单向HASH函数的值

    strcpy( authsrc, _spid ) ;

       char * pos = authsrc + strlen( _spid ) + 9 ;  //9 字节的0

    strcpy( pos, _passwd ) ;

       pos += strlen( _passwd );

       strcpy( pos, _timestamp( timestr ));    //时间戳

       pos += strlen( timestr );

    ctx.update(( unsigned char * )authsrc, (int)( pos - authsrc ));

       ctx.finalize();

    ctx.raw_digest( msg->digest );              //复制转换成MD5的字符串到发送数据中

三、提交短信息

相对于登录来说，提交短信也不会很复杂。只是简单的把客户端程序提交过来的数据复制到发送窗口，发送并等待网关回应的状态就可以了，当然也可以在接收到用户的数据前作一些适当的如：手机号码是否全数字，定时发送或存活时间是否正确等的判断。

//要注意的就是可变的用户数据与保留字段的内容：

memcpy( _pkg->data, &msg, sizeof( CMPP_SUBMIT ));

               //将最后8个字节的保留数据拷贝到适当的位置

              memcpy(

               ( _pkg->data + nsize - sizeof( msg.reserve ) - sizeof( CMPP_HEAD )),

               msg.reserve,

               sizeof( msg.reserve ));

四、接收短信息和状态

        接收短信后有两种处理方式，

1、  采用回调函数的方式：

这种方式相对于API来说比较简单，只要定义一下接口函数就可以了，客户端程序在初始化时，传入回调函数的函数指针，当API接收到短信网关下发（DELIVER）的短信时，调用函数指针把相关参数据传递给客户端。不必要考虑队列或其它细节的问题。

如下我在API中定义的回调函数：

typedef int ( WINAPI * TProcGetDeliver )(

            char * msgid,

            unsigned char * destnumber,

            unsigned char * serviceid,

            unsigned char tppid,

            unsigned char tpudhi,

            unsigned char msgfmt,

            unsigned char * srcnumber,

            unsigned char delivery,

            unsigned char msglen,

            unsigned char * msgcontent,

            unsigned char * reserve,

            unsigned char * stat,

            unsigned char * submittime,

unsigned char * donetime ) ;

              而在API对外接口中只要定义一个参数作为传送函数指针就可以了：如下：

              extern "C" __declspec( dllexport ) int WINAPI IFInitInterface( char *ismg, unsigned short port, TProcGetDeliver fCltGetDeliver );

              fCltGetDeliver 就是用户传递过来的回调函数指针，在调用时，直接采用参数开式用调用就可以了。如下所示：

              err = _fCltGetDeliver ( (char * )&_msgid,

                                _msg->destnumber,

                                _msg->serviceid,

                                _msg->tppid,

                                _msg->tpudhi,

                                _msg->msgfmt,

                                _msg->srcnumber,

                                _msg->delivery,

                                _msg->msglen,

                                _msg->msgcontent,

                                _msg->reserve,

                                _stat,

                                _submittime,

                                _donetime

                                 ) ;

              这样所接收到的所有参数就顺利传递到客户端了。

2、  调用API的客户端程序定时检测并从缓冲队列中拾取方式：

对于队列的方式，API内部必需自己建立一个缓冲队列。这个队列对于安全来说，必须是线程安全的（可以用临界区来保护），接收到一个下发信息时，数据暂时保存入队列中：

       int nl = sizeof( CMPP_HEAD ) + sizeof( CMPP_DELIVER ) ;

        _pushrecqueue( _recpkg, nl ) ;

下面是_pushrecqueue函数；

void WINAPI _pushrecqueue( void * inval, int nl )

{

    char * _queval = new char[ nl + 1 ] ;

    memset( _queval, 0, sizeof( nl + 1 )) ;

    memcpy( _queval, inval, nl ) ;

    _queue._push( _queval ) ;

}

为了保证数据最大安全性，不要接收到过多的数据进入队列。放入队列的数据就等待用户用API接口过来取走就可以了，其相关接口与回调函的参数相差不多，在这里就不多作说明，只要说明一下可以提供一个接口，可以让客户端可以检测队列中是否有可以接收的数据：

       extern "C" __declspec( dllexport ) int WINAPI HasDeliver() ;

        这检是否取数据就由客户端去作判断了。待续......