gSOAP 2.8.15 用户指南(目录)

Robert van Engelen
GENIVIA INC

May 12, 2013
 
[This document is also available in PDF format (black and white only)]

Contents 1  soap 简介     1.1  入门指南     1.2  快速入门：开发Web服务客户端应用程序     1.3  快速入门：开发Web服务     1.4  快速入门：XML数据绑定1.5     1.5  功能概述 2  符号约定 3  GSOAP2.5版本（或更早）和2.4之间的差异 4  GSOAP2.1版本（或更早）和2.2之间的差异 5  GSOAP2.X 和 GSOAP2.x之间的差异 6  互通性 7  快速使用指南     7.1  如何创建 SOAP/XML 客户端         7.1.1  例子         7.1.2  XML Namespace 注意事项         7.1.3  例子         7.1.4  如何生成C + +客户端代理类（Proxy Classes）         7.1.5  XSD类型编码（Type Encoding ）注意事项         7.1.6  例子         7.1.7  如何更改响应元素（Response Element）名称         7.1.8  例子         7.1.9  如何指定多个输出参数         7.1.10  例子         7.1.11  如何指定输出参数为 struct/class 复合数据类型         7.1.12  例子         7.1.13  如何指定匿名参数名称         7.1.14  如何指定没有输入参数的方法         7.1.15  如何指定没有输出参数方法     7.2  如何构建 SOAP/ XML Web服务         7.2.1  例子         7.2.2  使用 MSVC++ 创建（Builds）         7.2.3  如何创建一个独立的服务器（Stand-Alone Server）         7.2.4  如何创建一个多线程（ Multi-Threaded ）独立的服务器（Stand-Alone Service）         7.2.5  如何访问应用程序的数据服务方法         7.2.6  Web Service 实施方面（Implementation Aspects）         7.2.7  如何生成C + +服务器对象类         7.2.8  如何串连C + +服务器类在同一端口上接收消息         7.2.9  如何生成WSDL服务的描述         7.2.10  例子         7.2.11  如何让客户端使用服务上的功能     7.3  异步单向（Asynchronous One-Way）消息传递     7.4  通过HTTP实现的同步单向（Synchronous One-Way）消息传递     7.5  如何使用 SOAP XML数据绑定序列化和反序列化来保存和加载应用程序的数据         7.5.1  使用wsdl2h 创建XSD（XML Schema）与C + +映射         7.5.2  使用soapcpp2创建C/C++ 与 XSD（XML Schema）映射         7.5.3          7.5.4  从XML反序列换 C/C++ 数据         7.5.5  例子         7.5.6  序列化和反序列化类的实例流         7.5.7  如何给省略的数据指定默认值 8  wsdl2h WSDL和XML Schema import 元素     8.1  wsdl2h工具选项     8.2  使用typemap.dat文件定制数据绑定 9  soapcpp2编译器和代码生成器     9.1  soapcpp2 工具选项     9.2  SOAP1.1与SOAP1.2和动态切换     9.3  soapdefs.h 头文件     9.4  如何使用#module模块指令创建模块和类库     9.5  如何使用#import指令     9.6  如何使用#include和#define 指令     9.7  使用soapcpp2工具编译一个SOAP/ XML的客户端应用程序     9.8  使用soapcpp2工具编译 SOAP/XML Web Service     9.9  ANSI C编译Web服务和客户端     9.10  GSOAP的限制     9.11  类库构建标志     9.12  运行时（Run Time） 标示     9.13  内存管理         9.13.1  内存分配和管理策略         9.13.2  内部类（Intra-Class）内存管理     9.14  调试     9.15  生成服务器和客户端自动测试     9.16  所需的类库 10  GSOAP服务操作规范格式     10.1  参数传递服务的操作     10.2  错误码     10.3  C/C++ 标示符 与 XML标签名之间的映射     10.4  命名空间映射表 11  GSOAP序列化和反序列化规则     11.1  SOAP RPC编码对战 Document/Literal和xsi:type 信息     11.2  原始类型编码     11.3  为XSD类型表示原始的C/C++类型         11.3.1  一个单独的XSDl类型如何表示多个 C/C++ 类型         11.3.2  如何使用C++ Wrapper 类来指导多态类型         11.3.3  XSD Schema 编码规则         11.3.4  Multi-Reference Strings         11.3.5  "Smart String" 混合内容解码         11.3.6  C++ Strings         11.3.7  更改float和double类型的编码精度         11.3.8  float 和 double 类型的值INF, -INF和NaN     11.4  枚举的序列化         11.4.1  枚举常量的序列化         11.4.2  枚举常量的编码         11.4.3  初始化枚举常量         11.4.4  重利用枚举常量         11.4.5  C枚举内bool类型的序列化         11.4.6  Bitmask 枚举序列化     11.5  结构类型序列化     11.6  类的实例序列化         11.6.1  例子         11.6.2  初始化 静态常量（static const） 字段         11.6.3  初始化类的方法         11.6.4  Getter 和 Setter 方法         11.6.5  Streaming XML with Getter and Setter Methods         11.6.6  Polymorphism, Derived Classes, and Dynamic Binding         11.6.7  XML Attributes         11.6.8  QName Attributes and Elements     11.7  Union Serialization     11.8  Serializing Pointer Types         11.8.1  Multi-Referenced Data         11.8.2  NULL Pointers and Nil Elements     11.9  Void Pointers     11.10  Fixed-Size Arrays     11.11  Dynamic Arrays         11.11.1  SOAP Array Bounds Limits         11.11.2  One-Dimensional Dynamic SOAP Arrays         11.11.3  Example         11.11.4  One-Dimensional Dynamic SOAP Arrays With Non-Zero Offset         11.11.5  Nested One-Dimensional Dynamic SOAP Arrays         11.11.6  Multi-Dimensional Dynamic SOAP Arrays         11.11.7  Encoding XML Generics Containing Dynamic Arrays         11.11.8  STL Containers         11.11.9  Polymorphic Dynamic Arrays and Lists         11.11.10  How to Change the Tag Names of the Elements of a SOAP Array or List     11.12  Base64Binary XML Schema Type Encoding     11.13  hexBinary XML Schema Type Encoding     11.14  Literal XML Encoding Style         11.14.1  Serializing and Deserializing Mixed Content XML With Strings 12  SOAP Fault Processing 13  SOAP Header Processing 14  MIME Attachments     14.1  Sending a Collection of MIME Attachments (SwA)     14.2  Retrieving a Collection of MIME Attachments (SwA) 15  DIME Attachments     15.1  Sending a Collection of DIME Attachments     15.2  Retrieving a Collection of DIME Attachments     15.3  Serializing Binary Data in DIME     15.4  Streaming DIME     15.5  Streaming Chunked DIME     15.6  WSDL Bindings for DIME Attachments 16  MTOM Attachments     16.1  Generating MultipartRelated MIME Attachment Bindings in WSDL     16.2  Sending and Receiving MTOM Attachments     16.3  Streaming MTOM/MIME     16.4  Redirecting Inbound MTOM/MIME Streams Based on SOAP Body Content     16.5  Streaming Chunked MTOM/MIME 17  XML Validation     17.1  Occurrence Constraints         17.1.1  Default Values         17.1.2  Elements with minOccurs and maxOccurs Restrictions         17.1.3  Required and Prohibited Attributes     17.2  Value Constraints         17.2.1  Data Length Restrictions         17.2.2  Value Range Restrictions         17.2.3  Pattern Restrictions     17.3  Element and Attribute Qualified/Unqualified Forms 18  SOAP/XML Over UDP     18.1  Using WS-Addressing with SOAP-over-UDP     18.2  Client-side One-way Unicast     18.3  Client-side One-way Multicast     18.4  Client-side Request-Response Unicast     18.5  Client-side Request-Response Multicast     18.6  SOAP-over-UDP Server     18.7  SOAP-over-UDP Multicast Receiving Server 19  Advanced Features     19.1  Internationalization     19.2  Customizing the WSDL and Namespace Mapping Table File Contents With gSOAP Directives         19.2.1  Example     19.3  Transient Data Types     19.4  Serialization "as is" with Volatile Data Types     19.5  How to Declare User-Defined Serializers and Deserializers     19.6  How to Serialize Data Without Generating XSD Type Attributes     19.7  Function Callbacks for Customized I/O and HTTP Handling     19.8  HTTP 1.0 and 1.1     19.9  HTTP 307 Temporary Redirect Support     19.10  HTTP GET Support     19.11  TCP and HTTP Keep-Alive     19.12  HTTP Chunked Transfer Encoding     19.13  HTTP Buffered Sends     19.14  HTTP Authentication     19.15  HTTP NTLM Authentication     19.16  HTTP Proxy NTLM Authentication     19.17  HTTP Proxy Basic Authentication     19.18  Speed Improvement Tips     19.19  Timeout Management for Non-Blocking Operations     19.20  Socket Options and Flags     19.21  Secure SOAP Web Services with HTTPS/SSL     19.22  Secure SOAP Clients with HTTPS/SSL     19.23  SSL Authentication Callback     19.24  SSL Certificates and Key Files     19.25  SSL Hardware Acceleration     19.26  SSL on Windows     19.27  Zlib Compression     19.28  Client-Side Cookie Support     19.29  Server-Side Cookie Support     19.30  Connecting Clients Through Proxy Servers     19.31  FastCGI Support     19.32  How to Create gSOAP Applications With a Small Memory Footprint     19.33  How to Eliminate BSD Socket Library Linkage     19.34  How to Combine Multiple Client and Server Implementations into one Executable     19.35  How to Build a Client or Server in a C++ Code Namespace     19.36  How to Create Client/Server Libraries         19.36.1  C++ Clients Example         19.36.2  C Clients Example         19.36.3  C Services Chaining Example     19.37  How to Create DLLs         19.37.1  Create the Base stdsoap2.dll         19.37.2  Creating Client and Server DLLs     19.38  gSOAP Plug-ins         19.38.1  The Message Logging and Statistics Plug-in         19.38.2  RESTful Interface: The HTTP GET Plug-in         19.38.3  RESTful Interface: The HTTP POST Plug-in         19.38.4  The HTTP MD5 Checksum Plug-in         19.38.5  The HTTP Digest Authentication Plug-in         19.38.6  The WS-Addressing Plug-in         19.38.7  The WS-ReliableMessaging Plug-in         19.38.8  The WS-Security Plug-in         19.38.9  WS-Discovery

Copyright (C) 2000-2012 Robert A. van Engelen, GENIVIA INC, All Rights Reserved.