Gsoap 2.7.15 user guide

gSOAP 2.7.15 User Guide
Robert van Engelen Florida State University and Genivia, Inc. engelen@acm.org Updated November 7, 2009

Contents
1 Introduction 1.1 1.2 1.3 1.4 1.5 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Developing a Web Service Client Application . . . . . . . . . . . . . . . . . . . . Developing a Web Service in CGI . . . . . . . . .. . . . . . . . . . . . . . . . . . XML C/C++ Data Bindings: Mapping WSDL and XSD to C/C++ For Reading and Writing XML Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 8 9 11 12 14 16 16 16 17 19 20 21 22 26 27 28 30 31 32

2 Notational Conventions 3 Differences Between gSOAP Versions2.4 (and Earlier) and 2.5 4 Differences Between gSOAP Versions 2.1 (and Earlier) and 2.2 5 Differences Between gSOAP Versions 1.X and 2.X 6 Interoperability 7 Quick User Guide 7.1 How to Use the gSOAP Stub and Skeleton Compiler to Build SOAP Clients . . . 7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NamespaceConsiderations . . . . . . . . . . . . . . . . . . . . . . . . . . . Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to Generate C++ Client Proxy Classes . . . . . . . . . . . . . . . . . XSD Type Encoding Considerations . . . . . . . . . . . . . . . . . . . . . Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to Change the ResponseElement Name . . . . . . . . . . . . . . . .

1

7.1.8 7.1.9

Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to Specify Multiple Output Parameters . . . . . . . . . . . . . . . .

32 33 33 34 34 37 38 38 39 41 42 44 50 50 51 52 52 55 56 57 60 61 61 62 67 69 72 74 75 76 78 79 79 80

7.1.10 Example . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . 7.1.11 How to Specify Output Parameters With struct/class Compound Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1.12 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1.13 How to Specify Anonymous Parameter Names . . . . . . . . . . . . . . . 7.1.14 How to Specify a Method with No Input Parameters .. . . . . . . . . . . 7.1.15 How to Specify a Method with No Output Parameters . . . . . . . . . . . 7.2 7.2.1 7.2.2 7.2.3 7.2.4 7.2.5 7.2.6 7.2.7 7.2.8 7.2.9 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MSVC++ Builds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to Create a Stand-Alone gSOAP Service . . . . . . . . . . . . . . . . How toCreate a Multi-Threaded Stand-Alone Service . . . . . . . . . . . How to Pass Application Data to Service Methods . . . . . . . . . . . . . Some Web Service Implementation Issues . . . . . . . . . . . . . . . . . . How to Generate C++ Server Object Classes . . . . . . . . . . . . . . . . How to Generate WSDL Service Descriptions . . . . . . . . . . . . . . . . Example . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .

How to Use the gSOAP Stub and Skeleton Compiler to Build SOAP Web Services 39

7.2.10 How to Parse and Import WSDL Service Descriptions to Develop Clients and Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2.11 The typemap.dat File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2.12 How to Use ClientFunctionalities Within a Service . . . . . . . . . . . . . 7.3 7.4 7.5 How to Use gSOAP for Asynchronous One-Way Message Passing . . . . . . . . . One-Way Message Passing over HTTP . . . . . . . . . . . . . . . . . . . . . . . . How to Use the SOAP Serializers and Deserializers to Save and Load Application Data using XML Data Bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.5.1...