gSOAP使用

Kagula

环境

 [1]VS2008+SP1

 [2]WinSP+SP3

 [3] gsoap_2.8.8.zip

正文

以实例形式描述，如何用gSOAP Toolkit实现Web Service功能，本文还捎带了如何用C#访问用gSoap with c++写的Web Service服务。

我习惯上把所有的SDK放在自己计算机的E:\SDK路径下，你可以指定其它路径。

 

准备工作

[1]从参考资料中下载gsoap_2.8.8.zip并解压到“E:\SDK\gsoap-2.8”

[2]“E:\SDK\gsoap-2.8\gsoap\bin\win32”下有wsdl2.h.exe、soapcpp2.exe，你也可以自己编译出这两个工具。下面的步骤[3]、[4]可选。

[3]打开“E:\SDK\gsoap-2.8\gsoap\VisualStudio2005\wsdl2h\wsdl2h.sln”编译出

“E:\SDK\gsoap-2.8\gsoap\VisualStudio2005\wsdl2h\release\wsdl2h.exe”

[4]打开“E:\SDK\gsoap-2.8\gsoap\VisualStudio2005\soapcpp2\soapcpp2.sln”文件无法编译通过，参考资料[2]编译通过。

[5] 在VS2008中加入头文件搜索路径“E:\SDK\gsoap-2.8\gsoap”

 

第一个Web Service服务端(C++)

[1]新建Win32控制台项目“MyFirstWS”。定义头文件“MyInterface.h”，输入你要暴露给WS客户端的方法声明，内容如下

int   ns__sqrt(double a, double &result);

[2]转到源文件所在的目录，运行命令“soapcpp2  -S  MyInterface.h”生成存根文件

将新生成的C++的源码文件加入到你的工程项目中，soapServerLib.cpp文件不用加。你需要修改自动生成的ns.wsdl文件，因为里面的Web Service侦听端口默认为80，但是我们一般不使用默认侦听端口。

[3]加入“E:\SDK\gsoap-2.8\gsoap”下的“stdsoap2.h、stdsoap2.cpp、dom.cpp”三个源文件到当前项目中。

[4]修改“MyFirstWS.cpp”，源文件内容如下

 

// MyFirstWS.cpp : Defines the entry point for the console application.//#include "stdafx.h"#include "MyInterface.h"#include "ns.nsmap"//我的接口实现int ns__sqrt(struct soap *soap, double a, double &result)  {     if (a >= 0)     {        result = sqrt(a);        return SOAP_OK;     }     return soap_sender_fault(soap,    "Square root of negative value",    "I can only compute the square root of a non-negative value"); } //返回接口描述，否则在为C#代码添加服务引用时，找不到这个接口int http_get(struct soap   *soap) { std::string fileName = "ns.wsdl";        if(strstr(soap->msgbuf,"clientaccesspolicy.xml")!=NULL){fileName = "clientaccesspolicy.xml";}//红色乃添加的代码FILE*fd = NULL;fd = fopen(fileName.c_str(), "rb"); //open WSDL file to copyif (!fd)    {        return 404; //return HTTP not found error    }    soap->http_content = "text/xml";  //HTTP header with text /xml content    soap_response(soap,SOAP_FILE);    for(;;)    {        size_t r = fread(soap->tmpbuf,1, sizeof(soap->tmpbuf), fd);        if (!r)        {                break;        }        if (soap_send_raw(soap, soap->tmpbuf, r))        {                break; //cannot send, but little we can do about that        }    }    fclose(fd);    soap_end_send(soap);    return SOAP_OK; }int _tmain(int argc, _TCHAR* argv[]){int m, s; /* master and slave sockets */    struct soap sqrt_soap;    soap_init(&sqrt_soap);//添加，返回接口描述(WSDL)的功能，//否则其它语言在建立Web Service客户端的时候，无法自动生成代码sqrt_soap.fget = http_get;    //服务端侦听端口设为8080，注意ns.wsdl文件内容要做相应修改    m = soap_bind(&sqrt_soap, NULL, 8080, 100);    if (m < 0)    {        soap_print_fault(&sqrt_soap, stderr);        exit(-1);    }        fprintf(stderr, "Socket connection successful: master socket = %d\n", m);    for ( ; ; )    {         s = soap_accept(&sqrt_soap);         if (s < 0)        {             soap_print_fault(&sqrt_soap, stderr);            exit(-1);        }        fprintf(stderr, "Socket connection successful: slave socket = %d\n", s);                soap_serve(&sqrt_soap);        soap_end(&sqrt_soap);    }    return 0;}

[5]如果链接的时候找不到soap的析构函数，你需要手动编译stdsoap2.cpp文件（即右键单击文件名，在弹出菜单上选择编译即可）

现在服务端程序可以跑起来了！

 

第一个WebService客户端(C++语言)

[1]新建C++的Console工程

[2]在命令行控制台中转到当前C++项目目录下

根据http://localhost:8080/网址打印出的WSDL信息产生MyInterface.h头文件

“wsdl2h  -o  MyInterface.h  http://localhost:8080/”

[3]根据“MyInterface.h”头文件生成存根文件

“soapcpp2  -C  -IE:\SDK\gsoap-2.8\gsoap\import  MyInterface.h”，“-C”参数指定只生成客户端存根文件，默认服务端和客户端存根文件都生成。“-I”参数指定stlvector.h文件的搜索路径。“E:\SDK\gsoap-2.8”是我gsoap  Toolkit的存放路径。在项目中添加新生成的源文件，soapClientLib.cpp文件不用添加。

[4]在项目中添加E:\SDK\gsoap-2.8\gsoap目录下的stdsoap2.h、stdsoap2.cpp、dom.cpp等三个文件。

[5]修改项目默认的cpp文件，源码清单如下

 

// MyFirstWSClient.cpp : Defines the entry point for the console application.//#include "stdafx.h"//服务端提供的功能可以查看下面的头文件内容//如果服务端的URL地址或侦听端口改变，需要修改下面这个头文件#include "soapServiceProxy.h"//下面这个头文件是必须的，否则stdsoap2.obj连接的时候会出错#include "Service.nsmap"int _tmain(int argc, _TCHAR* argv[]){Service srv;    double dR;{_ns2__sqrt         call;      //形参表_ns2__sqrtResponse response;  //返回调用结果call.a = 4.0;int nR = srv.__ns1__sqrt(&call,&response);//调用sqrt函数if( nR == SOAP_OK){dR = response.result;printf("成功返回，sqrt(4)=%f\n",response.result);} else{printf("请检查网络连接！");}}return 0;}

现在你的程序可以跑起来了

 

第一个Web Service客户端(C#语言)

[1]新建C#的Console工程

[2]在新的工程里添加”Service Reference”，在出现的窗口里把你Web Service服务端的URL地址复制过去，Visual  Studio 2008会自动发现Web Service接口，并为这个服务的接口建立相应的代码

[3]你可能需要修改app.config文件，修改Web Service服务的地址及侦听端口。

[4]修改Program.cs源文件，源码如下

 

using System;using System.Collections.Generic;using System.Linq;using System.Text;using WSClient.ServiceReference1;namespace WSClient{    class Program    {        static void Main(string[] args)        {            try            {                ServicePortTypeClient proxy = new ServicePortTypeClient();                double dR = proxy.sqrt(4);                Console.WriteLine("sqrt(..)=" + dR);            }            catch (Exception e)            {                Console.WriteLine(e.Message);            }        }    }}

现在可以跑了！

参考资料（网站）

[1]《gSOAP Toolkit》官网

http://www.cs.fsu.edu/~engelen/soap.html

[2]《gSoap入门之一__下载及编译gsoap两大法宝》

http://blog.csdn.net/hslinux/article/details/5888352

[3]《Silverlight跨域调用gSoap/Java web service以及wsdl文件的修改》http://www.cnblogs.com/MonkChen/archive/2012/01/11/2318672.html