gSOAP开发两部曲

一、导入和解析wsdl强大利器---wsdl2h

wsdl2h 根据webservice生成 .h文件, 从WSDL中产生头文件, 是C/c++语言的WSDL/schema 导入和解析工具。

只负责生成头文件，且此头文件不能直接使用，必须在经过soapcpp2转换后才能使用。

输入为一个或多个wsdl或xsd文件，或URL；

如果输入为wsld或xsd文件，默认输出为第一个文件名，后缀为.h。

如果输入为URL，则默认输出为标准输出。

 

用法：

wsdl2h -o 头文件名 WSDL文件名或URL 

wsdl2h常用选项

• Option	Description
  -a	generate indexed struct names for local elements with anonymous types
  -b	bi-directional operations to serve one-way response messages (duplex)
  -c	generate C source code
  -d	use DOM to populate xs:any and xsd:anyType elements
  -e	don't qualify enum names
  	This option is for backward compatibility with gSOAP 2.4.1 and earlier.
  	The option does not produce code that conforms to WS-I Basic Profile 1.0a.
  -f	generate flat C++ class hierarchy for schema extensions
  -g	generate global top-level element declarations
  -h	print help information
  -I path	use path to locate source files for #import
  -i	don't import (advanced option)
  -j	don't generate SOAP_ENV__Header and SOAP_ENV__Detail definitions
  -k	don't generate SOAP_ENV__Header mustUnderstand qualifiers
  -l	include license information in output
  -m	use xsd.h module to import primitive types
  -N name	use name for service prefixes to produce a service for each binding
  -n name	use name as the base namespace prefix name instead of ns
  -o file	output to file
  -P	don't create polymorphic types inherited from xsd__anyType
  -p	create polymorphic types inherited from base xsd__anyType
  	This is automatically performed when WSDL contains polymorphic definitions
  -q name	use name for the C++ namespace of all declarations
  -r host[:port[:uid:pwd]]	connect via proxy host, port, and proxy credentials
  -R	generate REST operations for REST bindings in the WSDL
  -s	don't generate STL code (no std::string and no std::vector)
  -t file	use type map file instead of the default file typemap.dat
  -u	don't generate unions
  -v	verbose output
  -W	suppress warnings
  -w	always wrap response parameters in a response struct
  -x	don't generate _XML any/anyAttribute extensibility elements
  -y	generate typedef synonyms for structs and enums
  -z1	compatibility with 2.7.6e: generate pointer-based arrays
  -z2	compatibility with 2.7.15: qualify element/attribute referenced members
  -z3	compatibility with 2.7.16 to 2.8.7: qualify element/attribute references
  -z4	compatibility up to 2.8.11: don't generate union structs in std::vector
  -z5	compatibility up to 2.8.15
  -_	don't generate _USCORE (replace with UNICODE _x005f)

typemap文件用于指定SOAP/XML中的类型与C/C++之间的转换规则。我将在后续的文章里专门分析它。现在而言，你只需记住，它是很重要的。

二 C/C++代码自动产生的利器----soapcpp2

用法

soapcpp2 头文件 

soapcpp2常用选项

   
   
   
   

    
    
    
    
 
     
 
      
Option
 
      
Description
 
     
 
     
 
      
-1
 
      
Generate SOAP 1.1 bindings
 
     
 
     
 
      
-2
 
      
Generate SOAP 1.2 bindings
 
     
 
     
 
      
-0
 
      
Remove SOAP bindings, use plain REST
 
     
 
     
 
      
-C
 
      
Generate client-side code only
 
     
 
     
 
      
-S
 
      
Generate server-side code only
 
     
 
     
 
      
-T
 
      
Generate server auto-test code
 
     
 
     
 
      
-L
 
      
Do not generate soapClientLib/soapServerLib
 
     
 
     
 
      
-a
 
      
Use SOAPAction with WS-Addressing to invoke server-side operations
 
     
 
     
 
      
-A
 
      
Require SOAPAction to invoke server-side operations
 
     
 
     
 
      
-b
 
      
serialize byte arrays char[N] as string
 
     
 
     
 
      
-c
 
      
Generate pure C code
 
     
 
     
 
      
-d < path > 
 
      
Save sources in directory specified by < path > 
 
     
 
     
 
      
-e
 
      
Generate SOAP RPC encoding style bindings
 
     
 
     
 
      
-f N
 
      
File split of N XML serializer implementations per file
 
     
 
     
 
      
-h
 
      
Print a brief usage message
 
     
 
     
 
      
-i
 
      
Generate service proxies and objects inherited from soap struct
 
     
 
     
 
      
-j
 
      
Generate C++ service proxies and objects that can share a soap struct
 
     
 
     
 
      
-I < path > 
 
      
Use < path > for #import (paths separated with ':' or ';' for windows)
 
     
 
     
 
      
-k
 
      
generate data structure walkers (experimental)
 
     
 
     
 
      
-l
 
      
Generate linkable modules (experimental)
 
     
 
     
 
      
-m
 
      
Generate Matlabtm code for MEX compiler
 
     
 
     
 
      
-n
 
      
When used with -p, enables multi-client and multi-server builds:
 
     
 
     
 
      
 
 
      
Sets compiler option WITH_NONAMESPACES, see Section 9.11
 
     
 
     
 
      
 
 
      
Saves the namespace mapping table with name < name > _namespaces instead of namespaces
 
     
 
     
 
      
 
 
      
Renames soap_serve() into < name > _serve() and soap_destroy() into < name > _destroy()
 
     
 
     
 
      
-p < name > 
 
      
Save sources with file name prefix < name > instead of "soap"
 
     
 
     
 
      
-q < name > 
 
      
Use name for the C++ namespace of all declarations
 
     
 
     
 
      
-s
 
      
Generates deserialization code with strict XML validation checks
 
     
 
     
 
      
-t
 
      
Generates code to send typed messages (with the xsi:type attribute)
 
     
 
     
 
      
-u
 
      
uncomment comments in WSDL/schema output by suppressing XML comments
 
     
 
     
 
      
-v
 
      
Display version info
 
     
 
     
 
      
-w
 
      
Do not generate WSDL and schema files
 
     
 
     
 
      
-x
 
      
Do not generate sample XML message files
 
     
 
     
 
      
-y
 
      
include C/C++ type access information in sample XML messages
 
     
 
     
 
      
-z1
 
      
generate deprecated old-style C++ service proxies and objects
 
     
 
    
   
   
   
   

例:

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