Gsoap使用心得

           最近用到vc mfc 调用c#写的wcf 发布的webservice 上传文件.服务器端接收object 类型的byte[]数组。

           我本来还以为vs2010中vc能象c#一样方便的使用web service（记得vs2005,vs2008的vc clr 可以直接增加引用），可是找了半天头大了！！

           网上找了下，大家都是用的gsoap，但是能查到的资料，都是接收简单数据的，于是效仿，对gsoap生成的代理类，和数据类型研读，问题解决了。

    1、 先了解一下Gsoap

          gSOAP一种跨平台的C和 C++软件开发工具包。生成C/C++的RPC代码，XML数据绑定，对SOAP Web服务和其他应用形成高效的具体架构解析器，它们都受益于一个XML接口。

     这个工具包提供了一个全面和透明的XML数据绑定解决方案，Autocoding节省大量开发时间来执行SOAP/XML Web服务中的C/C++。此外，使用XML数据绑定大大简化了XML自动映

     射。应用开发人员不再需要调整应用程序逻辑的具体库和XML为中心的数据，如 交涉DOM。

          我们可以使用gSOAP提供的工具直接根据wsdl文档，生成所需要的数据类型，并将底层实现完全封装，我们只需要简单的操作代理类，就可以很轻松的实现调用。

     2、  Gsoap优点

           夸平台。支持linux386（MAC OS X universal binaries），macosx（Linux i386 compatible），win32（Windows 386 compatible）等。

           稳定性：该软件已经成熟。自2001年以来经过几年的发展和试验。许多工业项目和产品都在使用该软件。

           开源：可选择自由和商业许可。

           C和C++的支持：支持纯粹的ANSI C和混合的C/C++应用开发。

           行业标准协议： SOAP 1.1/1.2 WSDL 1.1，v2和UDDI 。支持XML架构原始XSD结构类型等等。

 

      3、 不废话了直接按地址下载：

           下载地址：http://sourceforge.net/projects/gsoap2

           解压gsoap_2.8.14.zip

           在目录gsoap-2.8\gsoap\win32下,存在2个exe 文件:

           soapcpp2.exe  该工具转换WSDL和XSD文件到带有注释的C/C++定义文件。

            Wsdl2h.exe  该工具从带有注释的C/C/++定义文件生成RPC代码和XML序列化

 

           在目录gsoap-2.8\gsoap\doc下帮助文裆。

           首先用C# wcf写个测试用的服务端代码（wcf 3.5）：

           发布的方法如下：

          

public int testAdd(int intA, int intB)
{ 
      Return  intA+intB;
}

public string upDateFile(string  ilename, object objfile)
{ 
      Byte[] mt=(byte) objfile;
      …………………
}

 

           然后启动，发布成web service .地址为http://127.0.0.1:2002/myBehavior?wsdl。

          其次：用Vc进行调用完成客户端功能，实现步骤如下：

          开始-运行-cmd进入dos模式，进入gsoap-2.8\gsoap\win32目录。

          1、  根据wsdl文档生成头文件.

          Wsdl2h  -1 –t  ..\..\typemap.dat  -s -0  test.h   http://127.0.0.1:2002/myBehavior?wsdl

          参数只写了几个常用的，其他的可以查询帮助。

-t file	use type map file instead of the default file typemap.dat
-s	don’t generate STL code (no std::string and no std::vector)
-o file	output to file

 

 

 

 

 

 

         2、 soapcpp2.exe -C -L -j -d "C:\test" -w -x "test.h" 

         注意：1、 如果不使用–t参数的话，默认soapcpp2相同的目录。

                  2、我所使用的服务端使用的是basehttpbinding 支持soap 1.0 （ws（*）HttpBinding 支持soap 2.0）所以使用参数 -1， 如果不设置此参数，将默认soap 1.2版本。

-C	Generate client-side code only
-L	Do not generate soapClientLib/soapServerLib
-j	Generate C++ service proxies and objects that can share a soap struct
-d <path>	Save sources in directory specified by <path>
-w	Do not generate WSDL and schema files
-x	Do not generate sample XML message files
-1	Generate SOAP 1.1 bindings
-2	Generate SOAP 1.2 bindings

 

 

 

 

 

 

 

 

 

 

 

 

将如下文件列表

 

 

 

 

 

 

 

 

 

 

 

 

        BasicHttpBinding_USCOREIDataService.nsmap

        soapBasicHttpBinding_USCOREIDataServiceProxy.cpp

        soapBasicHttpBinding_USCOREIDataServiceProxy.h

        soapC.cpp

        soapH.h

        soapStub.h

        将生成文件及stdsoap2.c，soap12.h，stdsoap2.cpp，加入到工程，

       1、右键选择soapC.cpp、soapBasicHttpBinding_USCOREIDataServiceProxy.cpp、stdsoap2.cpp，点击"属性"，如下图所

 

 

         2、选择 预编译-》预编译头设置为 不使用预编译头文件。

 

 

       在使用代码中加入头文件：

      #include "soap\ soapBasicHttpBinding_USCOREIDataServiceProxy.cpp "
      #include "soap\ BasicHttpBinding_USCOREIDataService.nsmap"

      代码实现部分如下:

struct soap clientSOAP;
soap_init(&clientSOAP);


//简单的传值没有什么疑问
struct _ns1__ testAdd testAdd;
struct _ns1__ testAdd Response testAddResponse;

xsd__int intA;
intA. __item=5;
xsd__int intB;
intB. __item=3;

testAdd. intA = intA;
testAdd. intB = intB;
BasicHttpBinding_USCOREIDataServiceProxy test;

 

test.soap_endpoint=”http://127.0.0.1:2002/myBehavior?wsdl”;

int soapResult= test. testAdd (&testAdd,& testAddResponse);
if(soapResult==SOAP_OK)
{
       Int result= testAddResponse. testAddResult;
}
else
{
       int m=GetLastError();
        ………
}
/*
web service 定义的object类型数据，在wsdl xml 中被定义为xsd:anyType，
而对应代理类中的xsd__anyType,要确认参数实际内容，需要获得接口的帮助，确定传值。本实例测试传输的是byte数组，二进制。
*/

struct _ns1__ upDateFile upDateFile;
struct _ns1__ upDateFileResponse upDateFileResponse;

   

//先将数据传给基础byte类型
// vobjFile

xsd__base64Binary  v ;
v.__ptr=new BYTE[vobjFileSize];
v.__size=vobjFileSize;
memcpy(v.__ptr,vobjFile, vobjFileSize);
v.soap=&clientSOAP;

//将基础类型传给从，xsd__anytype派生来的byte

xsd__base64Binary_ *v1 =new xsd__base64Binary_() ;
v1->__item=v;
upDateFile.objName=vFileName;

//生成代理类的时候，xsd:anytype,对应生成 xsd__anytype
upDateFile.objPgc=v1;
BasicHttpBinding_USCOREIDataServiceProxy test;

test.soap_endpoint=”http://127.0.0.1:2002/myBehavior?wsdl”;

int soapResult= test.upDateFile(&upDateFile,& upDateFileResponse);
if(soapResult==SOAP_OK)
{

     char *result;
     result=new char[10];
     result= upDateFileResponse. 
     upDateFileResponseResult;

     delete result;
     if (atoi(result)==0)
     {
           ………

     }
}
else
{
      int m=GetLastError();
       ………
}
    
delete v1;
upfile.destroy();

 

问题解决！！