gsoap工具的使用与soap通信

gsoap工具下载地址：

https://sourceforge.net/projects/gsoap2/files/

wsdl example地址：

http://schemas.xmlsoap.org/wsdl/soap12/soap12wsdl.htm

soap参考网址：

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

https://www.genivia.com/dev.html

https://www.genivia.com/examples/calc/index.html

soap 用户手册：

https://www.genivia.com/doc/soapdoc2.pdf

MarkdownPad2下载：

http://markdownpad.com/

MarkdownPad2破解：

Email address :

[email protected]

License key：

GBPduHjWfJU1mZqcPM3BikjYKF6xKhlKIys3i1MU2eJHqWGImDHzWdD6xhMNLGVpbP2M5SN6bnxn2kSE8qHqNY5QaaRxmO3YSMHxlv2EYpjdwLcPwfeTG7kUdnhKE0vVy4RidP6Y2wZ0q74f47fzsZo45JE2hfQBFi2O9Jldjp1mW8HUpTtLA2a5/sQytXJUQl/QKO0jUQY4pa5CCx20sV1ClOTZtAGngSOJtIOFXK599sBr5aIEFyH0K7H4BoNMiiDMnxt1rD8Vb/ikJdhGMMQr0R4B+L3nWU97eaVPTRKfWGDE8/eAgKzpGwrQQoDh+nzX1xoVQ8NAuH+s4UcSeQ==
 

wsdl2h.exe

该工具是可以根据输入的wsdl或XSD或URL，产生相应的C/C++形式的.h（不能直接引用），供soapcpp2使用。

 

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
-c++	generate C++ source code
-c++11	generate C++11 source code
-d	use DOM to populate xs:any and xsd:anyType elements
-D	make attribute members with default values optional with pointers
-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
-O1	optimize by omitting duplicate choice/sequence members
-O2	optimize -O1 and omit unused schema types (unreachable from roots)
-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	generate REST operations for REST bindings in the WSDL
-r host[:port[:uid:pwd]]	connect via proxy host, port, and proxy credentials
-r:uid:pwd	connect with authentication credentials (digest auth requires SSL)
-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	map Unicode XML names to UTF8-encoded Unicode C/C++ identifiers
-u	don’t generate unions
-V	display the current version and exit
-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 include minor improvements
-z6	compatibility up to 2.8.17: don’t include minor improvements
-z7	compatibility up to 2.8.59: don’t generate std::vector of class of union
-	don’t generate USCORE (replace with Unicode x005f)

 

soapcpp2.exe

Soapcpp2是一个根据.h文件生成若干支持webservice的代码生成工具，生成的代码文件包括webservice客户端和服务器的实现框架，XML数据绑定等，具体说明如下：

 

Option	Description
-1	generate SOAP 1.1 bindings
-2	generate SOAP 1.2 bindings
-0	no SOAP bindings, use REST
-C	generate client-side code only
-S	generate server-side code only
-T	generate server auto-test code
-Ec	generate extra routines for deep data copying
-Ed	generate extra routines for deep data deletion
-Et	generate extra routines for data traversals with walker functions
-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	multiple soapC files, with N serializer definitions per file (N ≥ 10)
-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)
-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
-r	generate soapReadme.md report
-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 the current version and exit
-v	verbose output
-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	compatibility: generate old-style C++ service proxies and objects
-z2	compatibility with 2.7.x: omit XML output for NULL pointers
-z3	compatibility with <= 2.8.30: _param_N indexing; nillable pointers

生成文件的描述

File Name	Description
soapStub.h	A modified and annotated header file produced from the input header file
soapH.h	Main header file to be included by all client and service sources
soapC.cpp	Serializers and deserializers for the specified data structures
soapClient.cpp	Client stub routines for remote operations
soapServer.cpp	Service skeleton routines
soapClientLib.cpp	Client stubs combined with local static (de)serializers
soapServerLib.cpp	Service skeletons combined with local static (de)serializers
soapXYZProxy.h	A C++ proxy object (link with soapC.cpp soapClient.cpp)
soapXYZProxy.h	With option -i: proxy object (link with soapC.cpp and soapXYZProxy.cpp)
soapXYZProxy.cpp	With option -i: proxy code
soapXYZObject.h	A C++ server object (link with soapC.cpp and soapServer.cpp)
soapXYZService.h	With option -i: server object (link with soapC.cpp and soapXYZService.cpp)
soapXYZService.cpp	With option -i: server code
.xsd	An ns.xsd file is generated with an XML Schema for each namespace prefix ns used by a data structure in the header file input to the compiler, see Section 7.2.9
.wsdl	A ns.wsdl file is generated with an WSDL description for each namespace prefix ns used by a service operation in the header file input to the compiler, see Section 7.2.9
.xml	Several SOAP/XML request and response files are generated. These are example message files are valid provided that sufficient schema namespace directives are added to the header file or the generated .nsmap namespace table for the client/service is not modified by hand
.nsmap	A ns.nsmap file is generated for each namespace prefix ns used by a service operation in the header file input to the compiler, see Section 7.2.9. The file contains a namespace mapping table that can be used in the client/service sources

 

File Name	Description
stdsoap2.h	Header file of stdsoap2.cpp runtime library
stdsoap2.c	Runtime C library with XML parser and run-time support routines
stdsoap2.cpp	Runtime C++ library identical to stdsoap2.c

calc.wsdl

wsdl2h.exe -c

soapcpp2.exe -c -r -L calc.h

客户端代码：

#include 
#include 
#include "../SoapSource/calcServiceHttpBinding.nsmap"
#include "../SoapSource/soapStub.h"
#include "../SoapSource/soapH.h"

/* the Web service endpoint URL */
const char server[] = "http://localhost:8080/";

struct requestData {
        int in0;
        int in1;
};
struct responseData {
        int out;
};

int main(int argc, char ** argv)
{
	printf("hello soap I'm soap client!\n");

	struct requestData request;
	struct responseData response;

	if (argc < 4)
	{
		fprintf(stderr, "Usage: [add|sub|mul|div] num num\n");
		exit(0);
	}
	request.in0 = atoi(argv[2]);
	request.in1 = atoi(argv[3]);

	struct soap *soap = soap_new1(SOAP_XML_INDENT); /* new context */
	switch (*argv[1])
	{
	case 'a':
		soap_call___ns1__add(soap, server, "add", (struct _ns2__addRequest *)&request, (struct _ns2__addResponse *)&response);
		break;
	case 's':
		soap_call___ns1__minus(soap, server, "sub", (struct _ns2__minusRequest *)&request, (struct _ns2__minusResponse *)&response);
		break;
	case 'm':
		soap_call___ns1__multi(soap, server, "mul", (struct _ns2__multiRequest *)&request, (struct _ns2__multiResponse *)&response);
		break;
	case 'd':
		soap_call___ns1__div(soap, server, "div", (struct _ns2__divRequest *)&request, (struct _ns2__divResponse *)&response);
		break;
	default:
		fprintf(stderr, "Unknown command\n");
		exit(0);
	}
	if (soap->error)
		soap_print_fault(soap, stderr);
	else
		printf("result = %d\n", response.out);

	soap_destroy(soap); /* delete deserialized objects */
	soap_end(soap);     /* delete heap and temp data */
	soap_free(soap);    /* we're done with the context */

	return 0;
}

服务端代码：

#include 
#include 
#include "../SoapSource/calcServiceHttpBinding.nsmap"
#include "../SoapSource/soapStub.h"
#include "../SoapSource/soapH.h"

int port = 8080;

int main(int argc, char ** argv)
{
	SOAP_SOCKET m;                               /* master socket */
	struct soap *soap = soap_new();               /* new context */

	printf("hello soap I'm soap server!\n");
	soap->send_timeout = soap->recv_timeout = 5; /* 5 sec socket idle timeout */
	soap->transfer_timeout = 30;                 /* 30 sec message transfer timeout */
	m = soap_bind(soap, NULL, port, 100);
	if (soap_valid_socket(m))
	{
		while (soap_valid_socket(soap_accept(soap)))
		{
			fprintf(stderr, "Socket connection successful.\n");
			soap_serve(soap);   /* serve request */
			soap_destroy(soap); /* delete deserialized objects */
			soap_end(soap);     /* delete heap and temp data */
		}
	}
	soap_print_fault(soap, stderr);
	soap_destroy(soap); /* delete deserialized objects */
	soap_end(soap);     /* delete heap and temp data */
	soap_free(soap);    /* we're done with the context */
	return 0;
}
/** Web service operation '__ns1__add' (returns SOAP_OK or error code) */
SOAP_FMAC5 int SOAP_FMAC6 __ns1__add(struct soap *soap, struct _ns2__addRequest *ns2__addRequest, struct _ns2__addResponse *ns2__addResponse)
{
	ns2__addResponse->out = ns2__addRequest->in0 + ns2__addRequest->in1;
	return SOAP_OK;
}
/** Web service operation '__ns1__minus' (returns SOAP_OK or error code) */
SOAP_FMAC5 int SOAP_FMAC6 __ns1__minus(struct soap *soap, struct _ns2__minusRequest *ns2__minusRequest, struct _ns2__minusResponse *ns2__minusResponse)
{
	ns2__minusResponse->out = ns2__minusRequest->in0 - ns2__minusRequest->in1;
	return SOAP_OK;
}
/** Web service operation '__ns1__multi' (returns SOAP_OK or error code) */
SOAP_FMAC5 int SOAP_FMAC6 __ns1__multi(struct soap *soap, struct _ns2__multiRequest *ns2__multiRequest, struct _ns2__multiResponse *ns2__multiResponse)
{
	ns2__multiResponse->out = ns2__multiRequest->in0 * ns2__multiRequest->in1;
	return SOAP_OK;
}
/** Web service operation '__ns1__div' (returns SOAP_OK or error code) */
SOAP_FMAC5 int SOAP_FMAC6 __ns1__div(struct soap *soap, struct _ns2__divRequest *ns2__divRequest, struct _ns2__divResponse *ns2__divResponse)
{
	ns2__divResponse->out = ns2__divRequest->in0 / ns2__divRequest->in1;
	return SOAP_OK;
}