Version 3.3.0
* New option, --fat-type-file, triggers the generation of code
corresponding to global elements into type files instead of schema
files in the file-per-type mode. This option is primarily useful
when trying to minimize the amount of object code that is linked
to an executable by packaging compiled generated code into a static
(archive) library.
C++/Serializer
* Elements with empty content are now closed immediately (for example,
) rather than with a separate closing tag (for example,
).
* To improve serialization performance, attributes are not longer
sorted but rather written in the order that they were specified.
* Support for the fractionDigits facet for the decimal data type.
* New functions, format() and precision(), allow changing of the
output notation and precision for the float, double, and decimal
type serializers.
Version 3.2.0
* Support for ISO-8859-1 in addition to UTF-8 as application encoding.
Note that this encoding is not the same as the XML document encoding
that is being parsed or serialized. Rather, it is the encoding that
is used inside the application. When an XML document is parsed, the
character data is automatically converted to the application encoding.
Similarly, when an XML document is serialized, the data in the
application encoding is automatically converted to the resulting
document encoding. To select a particular encoding, configure the
XSD/e runtime library accordingly and pass the --char-encoding option
to the XSD/e compiler when translating your schemas.
* Support for custom allocators. This feature allows you to configure
the XSD/e runtime and generated code to perform memory management
using custom allocator functions provided by your application instead
of the standard operator new/delete. For more information, see Section
3.8, "Custom Allocators" in the C++/Hybrid Mapping Getting Started
Guide (equivalent documentation is provided for other mappings) as
well as the 'allocator' example in the examples/cxx/hybrid/ directory.
* When built with Xerces-C++ 3-series, enable handling of multiple imports
for the same namespace. Before, all subsequent imports for a namespace
were ignored which caused errors in some schemas.
* Automatic mapping for the urn-style XML namespaces. The last component
in the urn name is used to derive the C++ namespace name.
* New option, --schema-file-regex, in combination with the existing
--type-file-regex, can be used to place the generated files into
subdirectories or to resolve file name conflicts in the file-per-
type mode (--file-per-type).
* Strings used to match regular expression supplied with the
--namespace-regex and --anonymous-regex options now include the file
component for the schema being compiled.
C++/Hybrid
* String-based types that use XML Schema restriction by enumeration are
now mapped to C++ classes with semantics similar to C++ enum. You can
suppress this new mapping and instead get the old behavior (plain
inheritance) by specifying the --suppress-enum compiler option. See
Section 4.3, "Enumerations" in the Getting Started Guide for more
information.
* New option, --generate-clone, triggers the generation of clone functions
for variable-length types. These functions allow you to make dynamically-
allocated copies of variable-length objects.
* Support for schema evolution using substitution groups. The 'ignore' and
'passthrough' examples in the examples/cxx/hybrid/evolution/ directory
show how the new mechanism works. The 'ignore' example shows how to
ignore unknown elements. The 'passthrough' example shows how to pass
the unknown content through parsing and serialization so that the output
XML contains all the unknown elements.
* The anySimpleType build-in type is now mapped to std::string or a C-string,
depending on whether STL is enabled or not.
* New mapping for anyType with support for polymorphism. For more
information, see Section 5.14, "Mapping for anyType" in the Embedded
C++/Hybrid Mapping Getting Started Guide.
* The object model interface for optional members of variable-length
types now omits the _present modifier function. This is done to help
detect programming errors that result from a type becoming variable-
length due to schema changes. To reset such optional members you can
call the member modifier function with NULL as its argument.
* New configuration parameter, XSDE_STL_ITERATOR, makes iterators
provided by the mapping conform to the STL requirements. This feature
requires working header and allows you to use the standard
algorithms such as find_if, etc.
* When the code is generated with the --generate-polymorphic or
--runtime-polymorphic option, the resulting parser and serializer
aggregate classes provide the static polymorphic() function which
returns true if the object model corresponding to the root element
or root type is polymorphic and false otherwise. This can be used
together with the XSDE_POLYMORPHIC macro to implement generic parsing
and serialization code that works with both polymorphic and non-
polymorphic object models.
* XML Schema union types with members that are enumeration types are
automatically converted to equivalent enumeration types with a union
of all the member's enumerators.
C++/Parser
* Support for the following XML Schema facets:
String-based types:
- length
- minLength
- maxLength
- pattern
- whiteSpace
- enumeration
Integer and floating-point types:
- minExclusive
- minInclusive
- maxExclusive
- maxInclusive
For more information on the pattern facet validation, see the XSDE_REGEXP
parameter in the configuration files.
* The anySimpleType build-in type is now mapped to std::string or a C-string,
depending on whether STL is enabled or not.
C++/Serializer
* Support for the following XML Schema facets:
String-based types:
- length
- minLength
- maxLength
- pattern
- enumeration
Integer and floating-point types:
- minExclusive
- minInclusive
- maxExclusive
- maxInclusive
For more information on the pattern facet validation, see the XSDE_REGEXP
parameter in the configuration files.
* The anySimpleType build-in type is now mapped to std::string or a C-string,
depending on whether STL is enabled or not.
Version 3.1.0
C++/Hybrid
* Support for XML Schema polymorphism. The new --generate-polymorphic
option triggers the generation of polymorphism-aware code. This option
should be used on XML vocabularies which use xsi:type and/or
substitution groups. For more information see Section 3.7, "Support
for Polymorphism" and Section 4.9, "Polymorphic Object Models" in
the Embedded C++/Parser Mapping Getting Started Guide as well as
the polymorphism and polyroot examples in the examples/cxx/hybrid/
directory.
* Support for saving the object model to and loading it from binary
representations. The new --generate--insertion and --generate-extraction
options trigger the generation of data representation stream insertion
and extraction operators, respectively. The XSD/e runtime provides
support for the ACE CDR streams and XDR API that is part of Sun RPC.
Custom representations can be supported by implementing insertion and
extraction operators for the built-in XML Schema types and sequence
templates. For more information, see Chapter 7, "Binary Representation"
in the Getting Started Guide as well as examples in the
examples/cxx/hybrid/binary/ directory.
* Support for attributes with default and fixed values. For details see
Section 4.3, "Attributes and Elements" in the Getting Started Guide.
Use the new --omit-default-attributes option to omit the attributes
with default and fixed values from serialized XML documents.
* New option, --custom-type, allows the customization of the object model
classes. You have the option of either basing your custom implementation
on the generated version or providing your own implementation from
scratch. For details see Section 4.8, "Customizing the Object Model"
in the Getting Started Guide as well as examples in the
examples/cxx/hybrid/custom/ directory.
* New option, --generate-detach, triggers the generation of detach
functions for elements and attributes of variable-length types. These
functions, for example, allow you to move sub-trees in the object model
either within the same tree or between different trees. The sequence
interfaces for variable-length types now also provide the detach()
function.
* The generated parser and serializer implementations are now capable
of parsing/serializing recursive types. The XSD/e compiler detects
recursive types and generates stack-based implementations with the
optimized non-recursive case (i.e., the first iteration still does
not result in any heap allocations for the state maintenance).
* Assignment function with signature assign(const T*, size_t) for
sequences of fixed-length types. With this function you can, for
example, initialize a sequence with a C array. Assignment of
sequences of fundamental types (e.g., int, float, etc.) is
implemented in terms of memcpy().
C++/Serializer
* Support for XML pretty-printing. The serialize() functions in the
xml_schema::document_simpl class now have the flags argument (defaults
to 0). You can pass the xml_schema::document_simpl::pretty_print flag
for this argument to turn on pretty-printing. See the examples and
documentation for details.
Version 3.0.0
* The new Embedded C++/Hybrid mapping provides a light-weight, tree-
like object model with precise reproduction of the XML vocabulary
structure and element order. C++/Hybrid supports fully in-memory
as well as hybrid, partially event-driven, partially in-memory
XML processing. For more information on the new mapping see the
Embedded C++/Hybrid Mapping Getting Started Guide and examples in
the examples/cxx/hybrid/ directory.
* New option, --disable-warning, disables printing of a warning with
the specified id. Specifying 'all' for the warning id disables all
warnings.
* The interfaces of the non-STL versions of the xml_schema::qname and
xml_schema::string_sequence classes have changed. Now by default
their modifier functions assume ownership of the passed strings.
The *_copy() versions of the modifier functions that make copies
of the passed strings are now provided. See the documentation for
details.
* The implementation of the STL version of the xml_schema::string_sequence
class has changed. Now a custom implementation of the sequence
container is used instead of std::vector. See the documentation for
details.
* When STL is enabled the xml_schema::string_sequence objects
corresponding to the NMTOKENS and IDREFS types are now returned and
passed by pointer rather than by value.
Version 2.1.0
* New delegation-based parser/serializer implementation reuse style in
addition to virtual inheritance-based. The new style results in a much
smaller object code size. The new reuse style is used by default and is
incompatible with the old style. Applications that require backwards
compatibility should use the --reuse-style-mixin option. The reuse
support code now can be completely omitted with the --reuse-style-none
option. A number of examples were converted to support both the new
and old reuse styles while others were converted to support the new
style only. For more information on the new reuse style see Section
5.6 in the Embedded C++/Parser Getting Started Guide and Section 6.6
in the Embedded C++/Serializer Getting Started Guide.
* New option, --file-per-type, triggers generation of a separate set
of C++ files for each type defined in XML Schema. This compilation
mode is primarily useful when some of your schemas cannot be compiled
separately or have cyclic dependencies which involve inheritance.
Other new options that are useful in this compilation mode are
--type-file-regex, --type-file-regex-trace, and --file-list. See the
compiler command line manual (man pages) for more information.
* New option, --options-file, allows additional command line options
to be provided in files, with one option per line.
* New option, --reserved-name, allows inserting additional names with
optional replacements to the list of names that should not be used
as identifiers. See the compiler command line manual (man pages)
for details.
* New options, --location-map, --location-regex, and
--location-regex-trace, allow re-mapping of schema locations
specified in the include and import elements without modifying the
schema files. See the compiler command line manual (man pages) for
more information.
* New option, --guard-prefix, allows specifying a prefix that will be
added to generated header inclusion guards.
* New option, --file-list, triggers creation of a file with a list of
generated C++ files. This option is primarily useful in the file-per-
type compilation mode (--file-per-type) to create a list of generated
C++ files, for example, as a makefile fragment. Other new options
that are useful with --file-list are --file-list-prologue,
--file-list-epilogue, and --file-list-delim. See the compiler command
line manual (man pages) for more information.
* In type map files the optional argument type now defaults to the
return type if the return type ends with * or & (that is, it is
a pointer or a reference) and 'const return type&' otherwise.
* Type map files can now include comments. A comment starts with #
and ends with a new line or end of file. To specify a name that
contains # enclose it in "".
C++/Parser
* New option, --generate-polymorphic, triggers generation of polymorphism-
aware code. This option should be used on XML vocabularies which use
xsi:type and/or substitution groups. For more information see Section
5.7, "Support for Polymorphism" in the Embedded C++/Parser Mapping
Getting Started Guide we well as the polymorphism and polyroot
examples in the examples/cxx/parser/ directory.
* New options, --generate-xml-schema and --extern-xml-schema, trigger
generation of the mapping for the XML Schema namespace to a separate
header file and inclusion of that header into other generated header
files instead of generating the necessary declarations inline,
respectively. See the the compiler command line manual (man pages)
for details.
* Support for parser reuse after an error. For more information refer
to Section 7.4, "Reusing Parsers after an Error" in the Embedded
C++/Parser Mapping Getting Started Guide. To suppress generation
of the reset code use the --suppress-reset option.
* New, context-based internal parsing architecture which provides
better performance, especially for deeply-nested documents. This
change should not affect user code except for wildcard parsing.
See the wildcard example for the required changes.
* The generated sample test driver file name was changed from
-driver.cxx to -pdriver.cxx.
C++/Serializer
* The mapping now supports automatic generation of sample serializer
implementations and a test driver. The --generate-empty-impl option
triggers generation of a sample implementation with empty function
bodies which can then be filled with application code. The
--generate-test-driver option trigger generation of a test driver.
For more information on this feature see the compiler command line
manual (man pages). Other relevant new options include:
--impl-file-suffix, --force-overwrite, --root-element-first,
--root-element-last, and --root-element.
* New option, --generate-polymorphic, triggers generation of polymorphism-
aware code. This option should be used on XML vocabularies which use
xsi:type and/or substitution groups. For more information see Section
6.7, "Support for Polymorphism" in the Embedded C++/Serializer Mapping
Getting Started Guide we well as the polymorphism and polyroot
examples in the examples/cxx/serializer/ directory.
* New options, --generate-xml-schema and --extern-xml-schema, trigger
generation of the mapping for the XML Schema namespace to a separate
header file and inclusion of that header into other generated header
files instead of generating the necessary declarations inline,
respectively. See the the compiler command line manual (man pages)
for details.
* Support for serializer reuse after an error. For more information
refer to Section 8.4, "Reusing Serializers after an Error" in the
Embedded C++/Serializer Mapping Getting Started Guide. To suppress
generation of the reset code use the --suppress-reset option.
Version 2.0.0
* The new Embedded C++/Serializer mapping supports event-driven,
stream oriented XML serialization with XML Schema validation
and C++ data binding. The new Embedded C++/Serializer Mapping
Getting Started Guide as well as the set of examples provide
an introduction to the mapping.
C++/Parser
* The argument order in the generated parsers() functions has
changed from elements then attributes to attributes then
elements.
* A number of types in the xml_schema namespaces have been
renamed in order to make the C++/Parser and C++/Serializer
mappings usable in the same translation unit. The old and
new names are listed below:
document document_pimpl
exception parser_exception
xml parser_xml
schema parser_schema
error parser_error
xml_error parser_xml_error
schema_error parser_schema_error
simple_content parser_simple_content
complex_content parser_complex_content
list_base parser_list_base
* The error accessor function has been renamed from error()
to _error(). The application error modifier function has
been renamed from error(int) to _app_error(int).
* For each subsequent element with the same name in the same
complex type, the mapping now produces a separate set of
callbacks and accessors. Note that in this case the
generated code will be able to perform correct dispatching
only with XML Schema validation enabled. When validation is
disabled all events will be delivered to the callback
corresponding to the first element with this name.
Version 1.1.0
* The runtime library now provides parser implementations for all
built-in XML Schema types. See Chapter 6, "Built-In XML Schema
Type Parsers" in the Embedded C++/Parser Mapping Getting Started
Guide for more information.
* The mapping now supports automatic generation of sample parser
implementations and a test driver. The --generate-noop-impl option
triggers generation of a sample implementation with empty function
bodies. The --generate-print-impl option triggers generation of a
sample implementation that prints the data stored in XML to STDOUT.
The --generate-test-driver option trigger generation of a test driver.
For more information on this feature see the compiler command line
manual (man pages) and the generated example in the examples/cxx/parser/
directory. Other relevant new options include: --force-overwrite,
--root-element-first, --root-element-last, and --root-element.
* New example, examples/cxx/parser/wildcard, shows how to parse the
XML data matched by XML Schema wildcards (any and anyAttribute).
* The xml_schema::document parser has been extended with overridable
virtual functions start_root_element and end_root_element to support
parsing of XML vocabularies with multiple document roots. See the
multiroot example in the examples/cxx/parser/ directory for more
information.
* Declaration for built-in parser implementations and the document
parser are now automatically included into generated header files.
As a result, you do not need to explicitly include the
xml-schema-impl.hxx or document.hxx header files.
* The default parser skeleton type and file suffixes have changed
from _skel to _pskel and from -skel to -pskel, respectively. The
--type-suffix and --file-suffix options were renamed to
--skel-type-suffix and --skel-file-suffix, respectively.
Version 1.0.0
* First public release.