Web Services--gSOAP 2.7.6 第七章(7.1)

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

官方网站：http://genivia.com/Products/gsoap/index.html

本文翻译只是出于学习的目的，中文部分仅代表个人观点，有错误还望指正，英文部分来自gsoap-win32-2.7\doc\soapdoc2.pdf。其中复制可能有误，可以看懂英文的还请到官网下载。如有版权争议，请联系QQ：643166601，本人会及处理。翻译新手，有错是必然的，求高人指点。欢迎同为新手的你共同学习。

 

7.1 How to Use the gSOAP Stub and Skeleton Compiler to Build SOAP Clients

7.1 如何使用gSOAP Stub和Skeleton编译器去构建SOAP客户端

In general, the implementation of a SOAP client application requires a stub routine for each remote method that the client application needs to invoke. 

一般而言，一个SOAP的客户端程序的实例需要一个stub程序为每个远程方法，客户端应用需要调用的。

The primary stub’s responsibility is to marshall the parameter data, send the request with the parameters to the designated SOAP service over the wire, to wait for the response, and to demarshall the parameter data of the response when it arrives. 

这个主要的stub的责任是去序列化这个参数数据，发送这个请求用参数去指定SOAP服务在这个线路上，去等待这个响应，和反序列化这个参数数据的请求当他到达。

The client application invokes the stub routine for a remote method as if it would invoke a local method. 

这个客户端应用调用这个stub程序为远程方法，如果他会调用一个本地方法。

To write a stub routine in C or C++ by hand is a tedious task, especially if the input and/or output parameters of a remote method contain elaborate data structures such as records, arrays, and graphs. 

去写一个stub程序用C或C++用手是乏味的任务，特别是如果这个输入 或 输出参数的远程方法包含详细制定的树结构，像records, arrays, 和 graphs.

Fortunately, the gSOAP ’wsdl2h’ WSDL parser and ’soapcpp2’ stub and skeleton compiler automate the development of Web service client and server applications. 

幸运地，这个gSOAP的’wsdl2h’ WSDL 解析器和 ’soapcpp2’ stub 和 skeleton编译器自动的开发Web service客户端和服务端程序。

The gSOAP stub and skeleton compiler is a preprocessor that generates the necessary C++ sources to build SOAP C++ clients. 

这个gSOAP stub 和 skeleton 编译器是一个预处理程序，生成必要的C++源代码去构建C++ 客户端。

The input to the gSOAP stub and skeleton compiler consists of a standard C/C++ header file. 

这个输入到gSOAP stub 和 skeleton 编译器 由 一个标准的 C/C++ 头文件组成。

The header file can be generated from a WSDL (Web Service Description Language) documentation of a service with the gSOAP WSDL parser. 

这个头文件可以被生成来自一个WSDL(Web Service描述语言)文档的一个服务用gSOAP WSDL解析器。

Consider the following command (entered at the command prompt): 

考虑以下命令(在命令提示符下输入)

$ wsdl2h -o quote.h http://services.xmethods.net/soap/urn:xmethods-delayed-quotes.wsdl

 

 

This generates the file quote.h in C++ format from the WSDL at the specified URL.

这个生成文件quote.h是C++格式是WSDL指定的URL。

To generate a header file to develop a pure C client application, issue the command: Consider the following command (entered at the command prompt):

要生成一个头文件去开发一个纯C客户端程序，运行这个命令：思考以下命令(在命令提示符下输入)

 

$ wsdl2h -c -o quote.h http://services.xmethods.net/soap/urn:xmethods-delayed-quotes.wsdl

 

For more details on the WSDL parser and its options, see 7.2.10.

更多信息在WSDL解析器和它的选项，请看 7.2.10。

The quote.h header file is then processed by the gSOAP compiler to generate the stubs to develop client applications (and skeletons to develop a service).

quote.h头文件是在gSOAP编译器生成这个stubs客户端程序之前的(和skeletons 去开发服务端)。

The SOAP service methods are specified in the header file as function prototypes. 

SOAP服务方法是被指定的在头文件中作为函数原型。

Stub routines in C/C++ source form are automatically generated by the gSOAP compiler for these function prototypes of remote methods. 

stub程序在C/C++源代码中是自动生成的通过gSOAP编译器为这些远程方法的函数原型。

The resulting stub routines allow C and C++ client applications to seamlessly interact with existing SOAP Web services.

作为结果stub程序允许C和C++客户端城区去无缝隙地相互作用和已经存在的SOAP Web services。

 

 

The gSOAP stub and skeleton compiler also generates skeleton routines for each of the remote methods specified in the header file. 

这个gSOAP stub 和 skeleton编译器也生成skeleton程序在每个远程方法指定的头文件中。

The skeleton routines can be readily used to implement one or more of the remote methods in a new SOAP Web service.

这个skeleton程序可以容易地被使用去实行一个或多个远程方法咋一个新的SOAP Web service中。

These skeleton routines are not used for building SOAP clients in C++, although they can be used to build mixed SOAP client/server applications (peer applications).

这些skeleton程序是不被使用构建SOAP客户端在C++中，虽然他们可以被用来构建混合SOAP客户端/服务端程序(对等应用)。

The input and output parameters of a SOAP service method may be simple data types or compound data types, either generated by the WSDL parser or specified by hand. 

SOAP服务方法的输入和输出参数可以是简单数据类型或复合数据类型，要么是WSDL解析生成的，要么是手工指定的。

The gSOAP stub and skeleton compiler automatically generates serializers and deserializers for the data types to enable the generated stub routines to encode and decode the contents of the parameters of the remote methods in XML.

这个gSOAP stub和 skeleton编译器自动生成序列化和反序列化的数据类型使能够被生成stub程序去编码和解码这个在XML中的远程方法的参数内容。