[xsd-announcements] XSD 3.3.0 released
boris at codesynthesis.com
Wed Apr 28 06:01:59 EDT 2010
We have released XSD 3.3.0. The NEWS file entries for this release
are as follows:
* New option, --char-encoding, allows you to specify the character encoding
that should be used in the generated code. Valid values for the 'char'
character type are 'utf8' (default), 'iso8859-1' (new), 'lcp' (Xerces-C++
local code page), and 'custom' (provides support for custom encodings).
Note that if you use a non-default character encoding and include some
libxsd headers (e.g., xsd/cxx/xml/string.hxx) directly, then you will
need to first include the correct xsd/cxx/xml/char-<enc>.hxx header,
where <enc> is iso8859-1, lcp, etc. This mechanism replaces the
For the wchar_t character type the only valid value for this option is
'auto' and the encoding is automatically selected between UTF-16 and
UTF-32, depending on the wchar_t type size.
* When the XSD compiler is built with Xerces-C++ 3.1.0 or later, the
handling of multiple imports for the same namespace is enabled. Before,
all subsequent imports for a namespace were ignored which caused errors
in some schemas. Note that if your application has XML Schema validation
enabled, then you will also need to build it with Xerces-C++ 3.1.0 or
later to take advantage of this feature.
* 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).
* Warning id's have changed to start with a letter identifying the
component issuing the warning. F - compiler frontend, D - compiler
driver, P - C++/Parser mapping, T - C++/Tree mapping.
* Strings used to match regular expressions supplied with the
--namespace-regex and --anonymous-regex options now include the file
component for the schema being compiled.
* The XSD_NO_EXPORT macro can be used to omit code generated with the
--export/import-maps and, for C++/Tree, --generate-xml-schema options
during C++ compilation. This may be useful if you would like to use
the same generated code across multiple platforms.
* New option, --generate-element-type, triggers the generation of types
instead of parsing/serialization functions for root elements. This
is primarily useful to distinguish object models with the same root
type but with different root elements. For more information, refer
to the messaging example and Section 2.9.1, "Element Types" in the
C++/Tree Mapping User Manual. To support the customization of the
element type naming the --element-type-regex option has been added.
See the NAMING CONVENTION section in the compiler command line manual
(man pages) for details.
* New option, --generate-element-map, triggers the generation of a root
element map. The element map allows uniform parsing and serialization
of multiple root elements. This option can only be used together with
--generate-element-type. For more information, refer to the messaging
example and Section 2.9.2, "Element Map" in the C++/Tree Mapping
* Prior to this version, if the --generate-polymorphic option is
specified, the compiler treats all types as potentially polymorphic.
Now by default only type hierarchies used in substitution groups and
those explicitly declared polymorphic with the new --polymorphic-type
option are treated as polymorphic. This results in smaller and faster
generated code. If you would like to continue using the old behavior,
you will need to specify --polymorphic-type-all. For more information,
on this change see Section 2.11, "Mapping for xsi:type and Substitution
Groups" in the C++/Tree Mapping User Manual.
* New option, --generate-detach, triggers the generation of detach
functions for required elements and attributes. For optional and
sequence cardinalities the detach functions are now provided by the
respective containers even without this option. These functions, for
example, allow one to move sub-trees in the object model either within
the same tree or between different trees without copying. For more
information, refer to Section 2.8 "Mapping for Local Elements and
Attributes" in the C++/Tree Mapping User Manual.
* New option, --export-xml-schema, causes the compiler to export/import
types in the XML Schema namespace using the export symbol provided
with the --export-symbol option.
* New example, embedded, shows how to embed the binary representation of
the schema grammar into an application and then use it to parse and
validate XML documents.
* New example, compression, shows how to compress an XML document during
serialization and decompress it during parsing using the zlib library.
* New example, custom/mixed, shows how to use type customization to parse
and serialize mixed content.
* The streaming example has been extended to show how to perform stream-
oriented, partially in-memory XML processing using the C++/Tree mapping.
With the partially in-memory parsing and serialization only a part of
the object model is in memory at any given time. With this approach one
can process parts of the document as they become available as well as
handle documents that are too large to fit into memory.
* New default/fixed value initialization code. Now the default/fixed values
are parsed by the XSD compiler at compile time instead of the standard
parsing code at runtime. This will allow the compilation of schemas that
use the default/fixed values without support for XML parsing
* Empty XML Schema enumeration values are now mapped to the 'empty' C++
enumerator name instead of 'cxx'.
* XML Schema union types with members that are enumeration types are
automatically converted to equivalent enumeration types with a union
of all the members' enumerators.
This release also includes a large number of bug fixes and performance
improvements which should be especially apparent when compiling large and
The release also adds support for a range of new operating system and C++
compiler versions, including:
* AIX 6.x
* Mac OS X 10.6 "Snow Leopard"
* Windows 7,
* Windows Server 2008
* Visual Studio 2010 (10.0)
* GNU g++ 4.5.0
* Intel C++ 11
* Sun Studio 12.1
* IBM XL C++ 11
In particular, Visual Studio 2010 (10.0) project and solution files are
provided for all the examples.
The XSD source code is now tracked with git and the public, read-only
repository (including the web interface) is available at:
In particular, the repository allows you to view a more detailed change
history between XSD 3.2.0 and this version.
Precompiled binary distributions are available from the product's
Source code for this release is available from the project's web page:
SHA1 checksums for the files:
Last but not least, thanks to all the individuals who reported bugs, sent
suggestions, and tested the alpha and beta releases. Unfortunately, the
list of all who helped would be too long to include in this announcement.
More information about the xsd-announcements