gsoap入门:gsoap的plugin机制说明塈使用plugin实现调试soap函数时显示request/response xml文本

昨天调用gsoap函数时出错了，通过输出错误信息，知道了是服务器端的错误(参见前一篇博客《gsoap入门:获取gsoap的错误信息》)。
但仍然是一头雾水，不知道服务器端为什么报错，还需要更详细的信息，所以想到了能不能获取ressponse xml。
于是满世界找如何能获取gsop发送和接收的xml文本的办法，在google上找到了线索:gsoap的插件(plugin)机制：
gsoap 的插件是对gsoap进行功能扩展的一种便利机制，类似callback回调函数(或者类似java或c++的接口)。通过对soap对象添加用户自定义的插件，可以让插件中的callbacks函数重载soap原来的函数，让callbacks函数获取对gsoap的完全访问。在向soap对象注册了指定插件后，用户自定义的callbacks函数就接管了gosp中的核心调用(比如fsend,frecv),在此基础上用户可以对gsoap的进行功能扩展。
下面是注册和搜索插件的函数:

int soap_register_plugin_arg(struct soap *soap,int (*fcreate)(struct soap *soap,struct soap_plugin *p,void *arg),void *arg)
void* soap_lookup_plugin(struct soap*,const char*);

关于plugin机制更的官方说明参见《gSOAP Plug-ins》

gsoap的plugin文件夹下提供了不少成熟的插件代码，这些可以直接拿来使用，关于这些插件的说明也请参见《gSOAP Plug-ins》。

显示requese/response xml

这些插件中的一个基本的例子:plugin.c，plugin.h,就实现了显示requese/response xml的功能。
首先将plugin.c，plugin.h两个文件复制到自己项目代码路径下，并将plugin.c加入项目代码。

然后在用到plugin.c中函数的代码文件中加入#include "plugin.h"

并在soap_init之后加入下面的代码，将plugin注册到soap对象中。

soap_register_plugin(&soap,plugin);

test_gsoap.cp代码示例：

#include <sstream>
#include "FaceDbServiceSoap11Binding.nsmap"
#include "file_utilits.h"
#include "stdlib.h"
#include "plugin.h"
using namespace facedbservice;
int main(int argc,char * argv[]) {
    struct soap soap;
    soap_init(&soap);
    // 注册plugin插件显示request/response xml文本
    soap_register_plugin(&soap,plugin);
    _ns1__sdk_USCOREdetectFace param;
    _ns1__sdk_USCOREdetectFaceResponse ret;
    auto img_file= gdface::load_binary_file("d:\\tmp\\he049.jpg");
    xsd__base64Binary b;
    b.soap = &soap;
    b.__ptr = img_file.data();
    b.__size = img_file.size();
    param.imgData = &b;
    // soap调用
    soap_call___ns1__sdk_USCOREdetectFace(&soap,"http://192.168.1.18:8080/axis2/services/FaceDbService.FaceDbServiceHttpSoap12Endpoint/",nullptr,&param,ret);
    if (soap.error!= SOAP_OK) {
        soap_stream_fault(&soap,std::cerr);
    }else {
        for (auto code : ret.return_) {
            std::printf("soap err,errcode = (%d,%d,%d)\n",*(code->pos->left),*(code->pos->top),*(code->pos->width),*(code->pos->height));
        }
    }
    soap_done(&soap);
}

这样在调用soap函数的时候，就会自动显示request/response的xml文本。