🧼 cpp-soaplib

This is a toolkit for C++ to create SOAP client applications.

It includes a generator (soapgen) that will turn a service defintion (WSDL) into C++ code. Currently it only supports single file definitions.

The library itself uses cpp-httplib for the basic HTTP handling. LibXml2 is used for the XML processing.

WARNING: This project was written to access some custom WCF SOAP services. I have never read any spec, nor have I tested this against other services. Do not expect this to work! ¯\(ツ)/¯

[[TOC]]

Dependencies

• argparse (soapgen, included)
• cpp-httplib (soaplib, included)
• Catch2 (unit tests, included)
• LibXml2 (soapgen, soaplib)
• OpenSSL (soaplib)

TODO

• all types (int, string, etc.) should be derived from SoapLibBaseType
• [~] add operators for direct value access on simple types (single member and value types)
• implement missing data types
• abort if unknown type is detected
• use templates for code generation (inja)
• use command line parameters for configuration (argparse)
• use libxml2 directly, remove xmlwrp dependency
• replace shared_ptr with unique_ptr where possible (soaplib and generated code)
• add unit tests
• support for split definition files
• support file download in generator
• auto detect and resolve cyclic references
• c++ 11 support (currently built with c++ 17 enabled)
• cleanup cmake scripts
• generate doxygen files

---

soapgen

Configuration

<config>
  <wsdl path="wsdl/FooService.wsdl" />
  <cpp>
    <output path="_output/foo" append-ns="false" types-subfolder="types" />
    <namespaces>
      <namespace>admin</namespace>
      <namespace>authentication</namespace>
    </namespaces>
    <cmake namespace="foo" export="foolib" />
    <pointer-types>
      <param>Replacements</param>
    </pointer-types>
  </cpp>
</config>

Parameter	Description	Usage	Default	Command line
wsdl/@path	Path to the input wsdl file.	mandatory		--input
cpp/output/@path	Output path for generated files.	optional	_output	--output
cpp/output/@append-ns	Create subdirectories for namespaces.	optional	true	--namespace-folders
cpp/output/@types-subfolder	If set, will create a subfolder for types with the given name.	optional	types	--types-folder
cpp/namespaces	List of namespace elements. Namespaces are applied in order.	optional
cpp/namespaces/namespace	Namespace value.	multiple		--namespace
cpp/cmake/@namespace	Namespace for generated CMake targets.	optional		--cmake-namespace
cpp/cmake/@export	Name for CMake export.	optional		--cmake-export
cpp/pointer-types	List of types that should be generated as pointer.	optional
cpp/pointer-types/@param	Name of type that should be generated as a pointer.	optional		--pointer-type

Usage

Create configuration file (see configuration section).

Run with:

# soapgen config.xml