用WebService实现类XmlRpc远程调用

来源：互联网发布：下歌的软件编辑：程序博客网时间：2024/04/29 09:14

远程调用对一些不需要实时数据的地方可以考虑用WebService或者xmlrpc，而不采用socket,比如获取配置项信息等. 最近和我同事商讨，总结了一套可以应付各种需求的远程调用方法，并且实现了。好东西，大家共分享：

web service报文协议

描述

采用xml格式进行数据交互

协议

请求报文

<?xml version="1.0" encoding = "UTF-8"?>

<aot>

<method>tribe.gettribe</method>

<param>

<p>fantaotao</p>

</param>

</aot>

字段

含义

说明

aot

xml根节点

method

远过程名

callid

调用标识

1. 值可为空

2. web端必须原样返回该字段值

token

登录令牌

1. 值可为空（在TATA未登时可为空）

2. TATA登录后会取得该令牌

param

参数集

3. 没有参数，该结点可没有

4. 该节点下的子节点, 都用来描述具体的参数内容

5. 参数必须保证顺序

描述具体某个参数

1. 参数必须保证顺序

应答报文

<?xml version="1.0" encoding = "UTF-8"?>

<aot>

<token>登录令牌为GUID</token>

<pagesize>一页显示记录数</pagesize>

</record>

</record>

</recordset>

</aot>

字段

含义

说明

aot

xml根节点

ret

操作结果(数字)

1. =0: 操作成功

2. !=0: 失败, msg字段描述具体失败原因

msg

操作结果描述

可为空, 描述具体操作的结果信息

callid

调用标识

1. 原样返回请求报文中的callid字段

recordset

记录集

1. 返回的操作结果集

2. 可为空

recordcount

记录总数

可为空

recordsize

一页显示记录数

可为空

record

表示一个记录

C++ 接口设计：

class ipacket;

    class ievent_handler
    {
    public:
        virtual void on_recv(ipacket* _pack) = 0;
    };

    class ipacket : public aot::tt::interface_base
    {
    protected:
        virtual ~ipacket(){;}
    public:
        virtual bool query_interface(void** out, const char* key){return false;}
        virtual const char* interface_name(){return "ipacket";}

    public:
        virtual void set_event_handler(ievent_handler* pHandler) = 0;
        virtual ievent_handler* get_event_handler() = 0;
    public:
        //参数操作
        virtual void set_method(const char* method) = 0;
        virtual void set_call_id(const char* call_id) = 0;
        virtual void set_token(const char* token) = 0;
        virtual void push_back(const char* key, const char* value) = 0;

        virtual bool get_params(aot::tt::istr** out) = 0; // 获取发出去的参数报文

    public:
        // 结果操作
        virtual int get_ret_code() = 0;   //WebService调用结果,1 成功其他失败
        virtual void set_result(const char* result) = 0; // 设置原始的返回报文并且解析
        virtual bool get_result(aot::tt::istr** out) = 0; // 获取返回的原始的报文

        virtual bool is_valid() = 0; //返回的xml是否有效

virtual int get_ret_result_code() = 0; // 返回的报文中的ret 值
virtual bool get_ret_result_msg(aot::tt::istr** out) = 0; //返回的报文中的msg 值

        /************************ recordset op ******************/
        /************************ begin *************************/
        //必须先调用get_recordset_count,然后才可调用其它recordset操作函数
        virtual long get_recordset_count() = 0;
        virtual bool goto_first_recordset() = 0;
        virtual bool goto_next_recordset() = 0;
        virtual bool goto_recordset(int n=1) = 0;
        virtual int get_recordset_recordcount() = 0; // 获取recordset 报文中的 recordcount
        virtual int get_recordset_pagesize() = 0;    // 获取recordset 报文中的 pagesize

/************************ recordset op ******************/
/************************ end *************************/

        /************************ record op *********************/
        /************************ begin *************************/
        //必须先调用get_record_count,然后才可调用其它record操作函数
        virtual long get_record_count() = 0;
        virtual bool goto_first_record() = 0;
        virtual bool goto_next_record() = 0;
        virtual bool goto_record(int n=1) = 0;
        virtual bool get_record_raw_str(aot::tt::istr** out) = 0; //获取record的原始报文
        virtual bool get_value(const char* key, aot::tt::istr** out, const char* default="") = 0;
        virtual int get_value_int(const char* key, int default = 0) = 0;
        /************************ record op *********************/
        /************************ end ***************************/

    };

    class iwebRpc : public aot::tt::interface_base
    {
    protected:
        virtual ~iwebRpc(){;}
    public:
        virtual bool query_interface(void** out, const char* key){return false;}
        virtual const char* interface_name(){return "iwebRpc";}

    public:
        virtual bool set_root_url(const char* szUrl) = 0;

/************************ 通用WebService处理 *********************/

virtual bool sy_post_packet(ipacket* _pack) = 0;

        /*
            pPack 必须绑定一个 ievent_handler 的事件处理器，并且必须在事件处理中把pPack 释放掉
        */
        virtual bool asy_post_packet(ipacket* pPack) = 0;

        /************************ 通用WebService处理结束 *********************/
    };