# Changelog

- Version 1.1

- Added typedef conventions
- Added enumerations
- Added hexBinary encoding
- Added base64 encoding
- Enable pass by reference operator (&) for output parameter
- Enable specification of methods in classes

- Version 1.2 (9/9/2001)

- Added WSDL generator

- Version 1.2w (9/14/2001)

- Win32 port
- Fixed a socket communication problem in win32 version
- Added namespace name pattern matching to ease validation

- Version 1.2.1 (10/24/2001)

- Chunked HTTP 1.1 transfer support
- Improved buffering
- Fixed a problem with nested vector allocation

- Version 1.2.2 (11/2/2001)

- Support for special XML element names with dots, underscores, and center dots (see documentation section 5.3)
- Fixed a decoding problem with dynamic array of pointers to polymorphic objects
- Fixed an encoding problem with enumerations
- Added a "safe-mode" flag to disable serialization of multi-referenced objects:

      soap_disable_href = 1;

  You can set this global flag anywere in the code, but at least before serialization is performed. It will disable the use of href attributes when sending multi-reference data. Instead, the data is copied in the payload. When set, this flag will hang the serializer when sending cyclic data structures.

- Version 1.2.3 (12/5/2001)

- Added bool type encoding/decoding.
- Added dynamic multi-dimensional arrays.
- Added support for primitive polymorphic types.
- Added full support for CDATA content decoding.
- More convenient customization of SOAP Headers and Faults. No separate `soapheader.h` and `soapfault.h` files required (and therefore no `.cpp` files have to be created for these). Instead, the compiler generates customized SOAP Header and SOAP Fault marshalling routines when struct/class `SOAP_ENV__Fault` and/or `SOAP_ENV__Header` are specified in the header file input to the compiler.
- On-demand generation of the marshalling routines for the primitive types, which reduces the size of the executables.
- Fixed a WSDL incompatibility problem in the WSDL generator.
- Improved decoding of multi-reference elements (no `xsi:type` required anymore in receiving message so gSOAP does not break).
- Improved support for encoding/decoding indirect data (e.g. pointers to pointers to data).
- Improved encoding of data with the same pointers to shared data but with the shared data declared with different XML schema types (formerly encoded as multi-reference data which could cause type incmpatibilities at the receiving side). For example, in the declarations `typedef char *xsd__NCName; xsd__NCName *s="SOAP"; char *t = s;` the pointers `s` and `t` point to the same data, but will not be encoded as multi-reference data since the types are different.
- Added flag:

      soap_enable_null = 1;

  When set, all NULL pointers will be explicitly encoded. By default, NULL pointers are omitted from the SOAP payload. For example, with this flag set all NULL strings and other NULL pointer data will appear as nil values in the SOAP payload.
- Added flag:

      soap_enable_embedding = 1;

  When set, multi-reference data will be encoded inline which will guarantee the exact preservation of the structure of the data transmitted. However, some SOAP implementations do not support embedding inline multi-reference data although this encoding style is likely to be included in future verions of the SOAP protocol. The flag is useful when creating C++ applications that need to communicate data to eachother and the data structures need to be preserved. Setting this flag may cause a duplication of multi-reference data by the receiver created with the SOAP stub compiler when the data is part of a struct/class or array. The data is not copied by the receiver when the struct/class or arrays use pointers to the data type.
- Added the ability to declare virtual destructors.
- Fixed a compilation error with fixed-size array of pointers.
- Fixed a problem with padding in Base64 (en/de)coding.
- Fixed XML entity decoding (hexadecimal).
- Added encoding of sparse arrays. A sparse array MUST be declared as a (fixed-size of dynamic) array of pointers. NULL pointer values are omitted from the output and SOAP-ENC:position attributes are used for non-NULL elements.
- Changed soap_put and soap_get functions to include explicit schema type parameters. This fixed a problem with Web services that need to return typedef-ed XML schema types The new stdsoap.cpp and stdsoap.h files are incompatible with the previous version(s).
- Added the ability to ignore the names of accessors when decoding fields through the use of a leading `_` in a field name. For example:

      ns__mymethod(xsd__string in, xsd__string &_return);

  When used to invoke a remote method, the actual element name of the remote return parameter used by the service is insignificant.
- Improved memory management. Added new function: `soap_destroy()` to remove all class instances.
- Improved documentation.
- Added time_t type support, but still need to add encoding/decoding routines to the runtime (next version).
- Added wchar_t type support, but still need to add encoding/decoding routines to the runtime (next version).

- Version 1.2.4 (12/17/2001)

- Added support for wide character strings (wchar_t*).
- Added support for time_t type.
- Added support for SOAP literal encoding.
- Fixed an obscure bug in the deserialization of data from the SOAP4R toolkit that caused the deserializer to hang.
- Fixed a problem with the soap_disable_href flag.
- Fixed a problem with the position attributes in sparse multi-dimensional arrays.
- Fixed a problem with the generation of .nsmap files.
- Fixed a problem with mixed content decoding in strings.

- Version 1.2.5 (12/27/2001)

- Fixed a memory leak in the block allocation scheme used for strings, hexBinary, and base64 types.
- Fixed a bug in the WSDL generator for fixed-size arrays.
- Fixed a problem with the use of trailing underscores in field names in struct/class declarations.

- Version 1.2.6 (1/25/2002)

- Improved portability.
- Improved id/href hash table efficiency and storage.
- Improved namespace URI matching with wildcards.
- Improved stand-alone deployment.
- Added `soap_disable_response_count` flag.
- Fixed operator declaration parsing (cast operators).
- Fixed a WSDL generator bug for output parameters and enumeration types.
- Renamed function `soap_return_fault()` into `soap_send_fault()`.

- Version 2.0 (2/2/2002)

- Rewrote the compiler and the run-time to create a thread safe implementation.

- Versions 1.2.7 and 2.0.1 (2/11/2002)

- Added compiler options (-h -c -d -p).
- Added optional specification of service name, location, and namespace URI in header file.
- Improved interoperability.

- Versions 1.2.8 and 2.0.2 (2/24/2002)

- Added function callbacks to support customized I/O and HTTP operations. This allows for plug-in HTTP code, NSAPI interface code, reading/writing from/to files or string buffers, etc.
- Added HTTP 1.0/1.1 keep-alive support.
- Added HTTP 1.1 chunked transfer support.
- Added `soap_disable_request_count` flag.
- Added `soap_enable_array_overflow` flag.
- Added type naming conventions to serialize elements without generating `xsi:type` attributes.
- Fixed a fixed-size array decoding problem (type mismatch).
- Fixed </sequence/> bug in the WSDL generators.

- Versions 1.3 and 2.1 (3/10/2002)

- Added client-side SSL (HTTPS) support (thanks to Massimo Cafaro for his suggestions).
- Added a naming convention for dynamic array `__ptr` fields which enables the naming of the XML tags of array elements.
- Added WSDL Header and Fault schema generation.
- Improved doc/literal encoding style.
- Improved WSDL service/schema namespace generation.
- Fixed SOAP-ENV:Headers to be self contained.
- Fixed WSDL generation of xsd schema types declared as string.
- Fixed a method overriding type clash for derived classes.
- Fixed spurious occurrence of id="-1" with soap_enable_null flag enabled.
- Fixed a front-end gSOAP compiler problem with forward and cyclic struct declarations.

- Versions 1.3.1 and 2.1.1 (3/25/2002)

- Added header file source constructs to support transient data types and transient struct/class fields to control gSOAP's code generatiion window for (de)serialization routines.
- Added callback for handling XML elements that are ignored on the receiving side (e.g. because of schema type problems). This feature is intended to enhance the reliability of services/clients.
- Added server-side SSL support and included an example multi-threaded stand-alone SSL secure SOAP server example.
- Added proxy server support.
- Improved message logging in gSOAP 2.1.1 (thanks to Jessie Ragsdale for his suggestions).
- Fixed WSDL generation for dynamic arrays.
- Fixed deserialization of empty multi-ref derived class instances.

- Versions 1.3.2 and 2.1.2 (4/15/2002)

- Added socket timeout management.
- Added optional client and server cookie support.
- Added support for maxOccurs="unbounded" for arbitrary elements in complexTypes (not just limited to SOAP arrays).
- Improved generation of schema <extension> definitions to allow XML validation in the presence of class overriding.
- Fixed ULONG64 type handling.
- Fixed light validation problem (now rejects invalid XML schema URIs).
- Fixed a deserialization type mismatch with typedef-ed pointer primitives.
- Fixed WSDL and schema interoperability problems.

- Versions 1.3.3 and 2.1.3 (4/27/2002)

- Added 'mustUnderstand' declaration qualifier for SOAP Header processing.
- Added soap.actor attribute for SOAP Header processing.
- Added method-header-part directive to identify methods with header message associations (WSDL requirement).
- Added bitmask (de)serialization.
- Added FastCGI support.
- Improved DLL build support (gSOAP 2.1.3 only).
- Improved WinCE support (gSOAP 2.1.3 only, thanks to Sean Ryan for his suggestions).
- Improved Mac OS X support.
- WSDL generator improvements and fixes.
- Workaround a bug in .NET SOAP Headers (non-unique id name values in .NET).
- Fixed disable_href=1 bug.
- Fixed `XML in string parsing' code generation problem.

- Versions 1.3.4 and 2.1.4 (6/9/2002)

- Added non-blocking soap_accept() with timeout management.
- Added support for SOAP Header and Fault declared as classes.
- Added syntax for 'extern' declarations for transient types and fields.
- Added support for SOAP Headers in SOAP Fault messages.
- Added one-way SOAP messages (2.1.4 only).
- Added support for user-defined (de)serializers (2.1.4 only).
- Improved object memory management.
- Improved support for AIX and HP platforms.
- Fixed proxy server connect bug.
- Fixed an OpenSSL bug.
- Fixed soap_instantiate_ClassX() derived class allocation problem.
- Fixed generation of spurious .xsd files when lots of trailing underscores are used by identifiers in the header file.
- Fixed syntax error that occured with header files containing cyclic class declarations.
- Fixed 'class in struct' and 'vector of classes' VMT initialization bugs.

- Version 2.1.5 (6/22/2002)

- Added non-blocking remote method calls (not supported in win32 version).
- Added specification of default values for struct/class fields.
- Added specification of minOccurs and maxOccurs for struct/class fields.
- Added resolution operator '::' parsing.
- Added abstract method declaration support.
- Fixed WSDL generation of SOAP doc/lit.
- Fixed WITH_FASTCGI option.

- Version 2.1.6 (7/10/2002)

- Added DIME attachment support.
- Added win32 non-blocking sockets.
- Changed "%lld"/"%llu" format strings into "%I64d"/"%I64u" format string for win32.
- Improved I/O.
- Fixed multi-dimensional dynamic array (de)serialization.
- Fixed WSDL enum and header namespace generation.

- Version 2.1.7 (8/6/2002)

- Added generation of example SOAP/XML request and response messages by the compiler.
- Added RSA to SSL stack.
- Added two callbacks to the HTTP stack for efficient handling of HTTP headers in Apache-mod and IIS.
- Added compiler option -m (malloc() memory control) and updated doc on memory allocation policies.
- Added compiler option -i to support #include and #define directives.
- Improved HTTP cookie support to handle new and old cookie protocols.
- Improved external class (de)serialization support (std::string example is included).
- Fixed a SSL+proxy connect problem.
- Fixed uninitialized '//gsoap..executable:' string which caused sporadic exits.
- Fixed XML literal string encoding problem introduced with DIME.
- Fixed and removed WSDL duplicate response elements.
- Fixed LONG64 and ULONG64 types for WinCE.

- Version 2.1.8 (8/28/2002)

- Added client-side proxy class source code generation.
- Added soap.enable_strict flag to enable very strict validation of messages (unknown namespace URIs and XML elements are not allowed).
- Added soap.socket_flags to control socket send() and recv() flags, e.g. to disable broken pipe signals (soap.socket_flags=MSG_NOSIGNAL).
- Added '//gsoap ns service method-action' header file directive.
- Added server-side soap_receiver_fault() and soap_sender_fault() functions to return SOAP 1.1 and SOAP 1.2 faults.
- Added seeding of the PRNG for SSL.
- Added soapcpp2 compiler option '-2' to automate SOAP 1.2 support (SOAP 1.2 features are Beta-release).
- Changed keep-alive support (see docs).
- Improved WSDL output.
- Workaround Bison 1.6 for win32 bug in gSOAP win32 version.
- Fixed a wild-card matching bug in soap_tag_cmp()
- Fixed a string deserialization problem.
- Fixed a deserialization bug that can occur in a client-server combination with gSOAP and Apache Axis.

- Version 2.1.9 (9/08/2002)

- Added HTTP proxy authentication.
- Added plug-in registry (Beta).
- Changed compiler exit status for compilation errors.
- Fixed stdin/stdout binary mode for DIME transfer with gSOAP for win32.
- Fixed win32 soapcpp2.exe bug in .res.xml file generation.

- Version 2.1.10 (10/14/2002)

- Added '//gsoap ns service method-documentation:' directive.
- Added provision for additional documentation text with '//gsoap ns service name:' directive.
- Added #import directive to (recursively) import gSOAP header files.
- Added plugin features and included a plugin example in 'extras' directory.
- Added automake/autoconf to generic gSOAP package (thanks to Christian Aberger).
- Added -DWITH_LOCALTIME compilation option to control time_t (de)serialization.
- Changed time_t (de)serialization (now uses timegm() and gmtime() to handle UTC). Found that mktime() library call is buggy on some systems.
- Improved and reorganized package directory structure.
- Fixed DDL linkage problem with instantiate/delete routines dealing with class instance memory management.
- Fixed compilation problem with Sun Workshop CC compiler and other compilers that adopt a specfic class VMT structure that could break object (de)serializers.
- Fixed bug in WSDL generator with multiple service namespaces.

- Version 2.1.11 (11/10/2002)

- Added a multi-functional SOAP router application (message forwarding and message relay server).
- Added keep-alive support for asynchronous one-way messages.
- Improved parsing and handling of function prototypes and class methods.
- Improved modular design to enable the compilation and linkage of multiple client and service modules.
- Improved user-defined SOAP Fault detail handling.
- Fixed SSL_accept bug.
- Fixed serialization of pointers to dynamic arrays with multi-references.

- Version 2.2 (12/12/2002)

- Added XML attribute (de)serialization support.
- Added XSD QName parsing and conversion support (typedef char *xsd__QName).
- Added compression support (-DWITH_ZLIB requires Zlib).
- Changed and improved transport and encoding settings by splitting up sending and receiving side flags into separate sets. Depricated soap.enable_X and soap.disable_X flags.
- Improved keep-alive support (automatic client and server sides).
- Fixed a bug in mustUnderstand handling.
- Fixed a sporadic crash of the gSOAP compiler under win32.
- Fixed user-defined SOAP Fault output in WSDL generator.

- Version 2.2.1 (12/18/2002)

- Added callbacks to enable custom streaming of DIME attachments.
- Fixed broken serialization of pointers to dynamic arrays with NULL __ptr
- Fixed some WSDL issues.

- Version 2.2.2 (1/25/2003)

- Added gzip support (-DWITH_GZIP requires Zlib).
- Added faccept() callback.
- Improved HTTP chunking.
- Fixed OpenSSL and accept_timeout (OpenSSL requires blocking sockets).
- Fixed HTTP header buffering.
- Fixed UTF8 decoding of a subset of characters (2-octet UTF).
- Fixed 'operator==' parsing.
- Fixed a couple of WSDL issues.

- Version 2.2.3 (3/2/2003)

- Added server-side HTTP basic authentication.
- Improved speed.
- Improved Tru64 portability.
- Changed fpost() function callback signature: added 'int port' argument and added port number to the Host: HTTP header.
- Fixed memory leak in SSL connect when using OpenSSL DH.
- Fixed custom (de)serializer definitions parsing.
- Fixed a gzip/deflate bug with large transfers.
- Fixed use of ftime() for time_t (de)serialization with timezones.
- Fixed a problem with concurrent access to global namespace table by multiple threads.
- Fixed crash with //gsoap name directive.
- Fixed deserialization bug with multi-ref object encoding by Apache Axis.

- Version 2.3.1-8 (9/24/2003)

- Updated SOAP 1.2 support (implements the SOAP 1.2 recommendation).
- Added STL container support and built-in std::string encoding.
- Added stand-alone Web server example to serve static and dynamic pages with a new HTTP GET plugin.
- Added void* (de)serialization, e.g. useful to support polymorphism with C applications and as an alternative to union types.
- Added XML DOM parser to support SOAP document encoding and for mixing of application data (de)serialization within an XML DOM.
- Added WITH_LEAN and WITH_LEANER compilation flags to improve support for small-memory devices such as WinCE and Palm.
- Added SOAP_XML_CANONICAL flag for canonical XML output (XML-C14N support and SOAP 1.2 normalization support).
- Added '//gsoap ns method-encoding:' directive.
- Added '//gsoap ns schema import:' directive.
- Added optional class getter and setter methods for object (de)serialization.
- Added 'volatile' qualifier to indicate that certain type declarations should be treated 'as-is' when types are declared externally (e.g. part of a library).
- Added a new string notation for declarations to specify simpleType restriction patterns.
- Added soapcpp2 -I option to indicate #import path.
- Added support for (de)serialization of application data to C++ iostreams.
- Added fsslauth() callback.
- Added HTTP code error values.
- Added SOAP_MALLOC and SOAP_FREE macros to replace malloc() and free().
- Added soap_strdup(soap, string) to copy strings in gSOAP's memory space.
- Added chunked streaming DIME output (thanks to J. Li for his suggestions).
- Added SOAP_SOCKET for win32 support (thanks to B. Gille for his suggestions).
- Added SO_LINGER support (soap.connect_flags).
- Added support for iso-8859-1 encoded XML parsing (default is utf8).
- Added #module directive to build shared libraries.
- Added C++ namespaces support to enable the compilation and linkage of multiple client and service codes.
- Added WITH_CASEINSENSITIVETAGS compilation flag to enable case insensitive XML parsing.
- Improved WSDL types schema output.
- Improved custom (de)serialization (note: extras/stringtest example has been changed).
- Improved SOAP literal encoding.
- Improved speed.
- Improved HTTP1.0/1.1 support.
- Removed soap.defaultNamespace in favor of automatic SOAP literal output based on soap.encodingStyle value.
- Fixed GMT to DST localtime conversion, but still issues with Sun Solaris.
- Fixed dynamic array __offset handling.
- Fixed class definition order.
- Fixed sporadic memory leak in HTTP cookie reader.
- Fixed multi-threaded server-side OpenSSL initialization.
- Fixed enumeration-based XML attribute deserialiation.
- Fixed SOAP-ENC:position attribute placement when arrays of pointers are mixed with nillable data.
- Fixed crash when parsing incorrect SOAP/XML attribute content.

- Version 2.4 (12/20/2003)

- New WSDL parser and importer with improved support for SOAP document style and literal encoding.
- Added optional full schema validation (partial by default). Use SOAP_XML_STRICT flag.
- Added SSL session caching.
- Added soap_set_namespaces() to switch namespace tables.
- Fixed plugin memory leak. REQUIRED CHANGE to plugin allocation and copying.
- Fixed server-side blocking SSL accept.

- Version 2.4.1 (01/07/2004)

- Changed _USCORE_ and _DOT_ naming conventions into _USCORE and _DOT to improve name mapping.
- Updated DOM parser (integrated into core gSOAP library).
- Improved WSDL parser and included several new features.
- Fixed WSDL schema import and WSDL literal output.

- Version 2.5 (01/28/2004)

- Changed default encoding to SOAP RPC literal, as mandated by WS-I Basic Profile 1.0a and best practices.
- Added soapcpp2 compiler option -e for backward compatibility to gSOAP 2.4.1 and earlier that use SOAP RPC encoding defaults (helpful when migrating gSOAP projects to 2.5).
- Added automatic compiler-side WS-I Basic Profile 1.0a compliance warnings (warns before deployment).
- Added fget() callback for HTTP GET responses.
- Added IPv6 support contributed by Wind River Systems.
- Added VxWorks support contributed by Wind River Systems.
- Improved SOAP Fault handling.
- Improved interop with Axis RPC encoded response messages.
- Fixed std::string xsi:type attribute value.
- Fixed gSOAP 2.4 problems with serialization of enumeration values outside enumeration range.
- Fixed gSOAP 2.4 Pocket PC build problem.
- Fixed wsdl2h SOAP Fault and Header output.

- Version 2.5.1 (02/12/2004)

- Improved WSDL output and WS-I BP1.0a compliance.
- Improved WSDL parser stability.
- Fixed problem parsing empty xsd:base64Binary elements.
- Fixed VxWorks and TRU64 portability issues.
- Fixed HTTP 400 error problem.
- Fixed soapcpp2 2.5 stability problem with one-way messages.