下载gSoap
http://sourceforge.net/projects/gsoap2
1.下载完成后直接解压缩,在目录gsoap-2.8\gsoap\bin下面有编译工具,支持多个平台,我们使用的是win32平台的工具
wsdl2h.exe 解析WebService的wsdl文件
soapcpp2.exe 编译WebService代码
2.接下来需要先获得WebService的wsdl文件,访问WebService时,http://XXXX/XXXX.asmx?wsdl这个地址就是需要的wsdl文件,选择查看源文件,然后另存为的方式,获取到wsdl文件,例如:另存为webs.wsdl文件。
3.解析wsdl文件
执行wsdl2h.exe -o webs.wsdl命令,就会生成一个webs.h的头文件 wsdl2h -s –o x:\xxx\TestWebService.h
用法:
wsdl2h -o 头文件名 WSDL文件名或URL
wsdl2h常用选项
- -o 文件名,指定输出头文件
- -n 名空间前缀 代替默认的ns
- -c 产生纯C代码,否则是C++代码
- -s 不要使用STL代码
- -t 文件名,指定type map文件,默认为typemap.dat
- -e 禁止为enum成员加上名空间前缀
type map文件用于指定SOAP/XML中的类型与C/C++之间的转换规则,比如在wsmap.dat里写
4.编译
soapcpp2 头文件
例:
soapcpp2 ayandy.h
将生成下面这些文件
- soapStub.h
// soap的存根文件,定义了ayandy.h里对应的远程调用模型 - soapC.c soapH.h
// soap的序列和反序列代码,它已经包含了soapStub.h,服务器端与客户端都要包含它 - soapClient.c soapClientLib.c // 客户端代码,soapClientLib.c文件则只是简单地包含soapClient.c和soapC.c
- soapServer.c soapServerLib.c // 服务器端代码,soapServerLib.c文件则只是简单地包含soapServer.c和soapC.c
- ServiceSoap.nsmap ServiceSoap12.nsmap // 名空间定义,服务器端与客户端都要包含它
- soapServiceSoapProxy.h soapServiceSoap12Proxy.h // 客户端的C++简单包装(如果头文件是纯C代码,这两个文件就不会生成)
综上所述
- 如果编写服务器端,项目里应该加入soapServerLib.c,代码里包含头文件soapH.h
- 如果编写客户端,项目里应该加入soapClientLib.c,代码里包含头文件SoapH.h(或xxxxProxy.h)
- 当然,还要加入gsoap库里的stdsoap2.cpp文件(如果是写C代码,则加入stdsoap2.c)
如果看到soapcpp2提示:”Critical error: #import: Cannot open file "stlvector.h" for reading.“, 那是因为我们的头文件使用了STL(wsdl2h 没用-s选项),这时要使用-I选项指定gSOAP的 import文件路径,这个路径是"$gsoap\gsoap\import":
soapcpp2 ayandy.h -I D:\gsoap-2.7\gsoap\import
执行soapcpp2.exe webs.h,会生成很多个文件,这里同样可以加一些参数,具体不解释了,可以通过soapcpp2.exe /?命令来查看。
我们找出需要的以下几个文件:
soapC.cpp
soapClient.cpp
soapH.h
soapStub.h
WebsSoap.nsmap
再加上另外两个文件(不在bin目录下,在gsoap-2.8\gsoap目录下):
stdsoap2.h
stdsoap2.cpp
一共7个文件,就是我们最终访问WebService所需要的soap访问调用文件。这里是C++的代码,根据需要,也可以生成C的代码,stdsoap2.cpp更换为stdsoap2.h文件。
把上述7个文件,加入到自己的工程中编译即可,接下来就是如何调用的问题了。
soapcpp2常用选项
- -C 仅生成客户端代码
- -S 仅生成服务器端代码
- -L 不要产生soapClientLib.c和soapServerLib.c文件
- -c 产生纯C代码,否则是C++代码(与头文件有关)
- -I 指定import路径(见上文)
- -x 不要产生XML示例文件
- -i 生成C++包装,客户端为xxxxProxy.h(.cpp),服务器端为xxxxService.h(.cpp)。
------------------------------------------
这些文件没把我给弄崩溃了,简要说一下吧:
工程中所要包含的文件(不是include的)有:
soapStub.h
这个要搞清楚。
程序中include的头文件有
#include "soap/ServiceSoap.nsmap"//命名空间,这个必不可少
#include "soap/soapH.h
#include "soap/soapServiceSoapProxy.h" //如果使用代理类
调用哪些方法 可以去 soapStub.h 去找
ps:
很重要的是 如果在vc中开发的话,引入的3个cpp文件要进行设置
方法:工程 -》设置 -》选择cpp文件 -》预编译头 -》选择不使用
另一方面 ,soap也是使用socket通信的 所以链接的时候还要加上wsock32.lib
方法: