XSD/Schema compilation checklist
From Code Synthesis Wiki
(Difference between revisions)
Revision as of 10:05, 17 February 2008 Boris (Talk | contribs) (→C++/Tree Mapping Options) ← Previous diff |
Revision as of 10:27, 17 February 2008 Boris (Talk | contribs) Next diff → |
||
Line 36: | Line 36: | ||
The following options are specific to the [[Tree|C++/Parser mapping]]: | The following options are specific to the [[Tree|C++/Parser mapping]]: | ||
+ | |||
+ | * If your XML vocabulary uses XML Schema polymorphism (<code>xsi:type</code> or substitution groups), then you will need to compile your schemas with the <code>--generate-polymorphic</code> option. See [http://www.codesynthesis.com/projects/xsd/documentation/cxx/parser/guide/#5.4 Section 5.4, "Support for Polymorphism"] in the [http://www.codesynthesis.com/projects/xsd/documentation/cxx/parser/guide/ C++/Parser Mapping Getting Started Guide] for details. |
Revision as of 10:27, 17 February 2008
This page provides a checklist-like run through the most commonly used XSD options. For more details on each option as well as for the complete list of options refer to the XSD command line interface documentation (man pages).
Contents |
Common Options
The following options are available for all mappings:
- You can map any XML Schema namespace (including the no-namespace case and built-in XML Schema namespace) to a custom C++ namespace with the
--namespace-map
option, for example,--namespace-map http://www.example.com/xmlns/my=ExampleInc::My
. To place the generated code for a schema without a target namespace into a C++ namespace, use the empty string as XML Schema namespace:--namespace-map =My
. To map a set of namespaces at once the--namespace-regex
option is available.
- To place the generated code into a specific directory, use the
--output-dir
options, for example,--output-dir src
.
- You can select the character type that should be used in the generated code with the
--char-type
option. Available choices arechar
(default), andwchar_t
.
- If you have several schema files and some of them are not self-sufficient (that is, you get XML Schema errors when trying to compile them with XSD) or have cyclic dependecies that involve inheritance (that is, you get C++ errors when compiling the generated code with the message saying that the base type is undefined) then you will need to use the file-per-type compilation mode which is turned on with the
--file-per-type
option. For more information about the file-per-type mode see this blog post.
C++/Tree Mapping Options
The following options are specific to the C++/Tree mapping:
- If you are planning to serialize the object model back to XML, then use the
--generate-serialization
option. See Chapter 6, "Serialization" in the C++/Tree Mapping Getting Started Guide for details.
- If your schema defines several global elements while only some of them can be used as document root elements, then use the
--root-element
option to reduce the amount of the generated code, for example,--root-element library
.
- If you would like to change the identifier naming convention used in the generate code, then you can use the
--type-naming
and--function-naming
options. See the Naming Convention section in the XSD command line interface documentation (man pages).
- If your XML vocabulary uses XML Schema polymorphism (
xsi:type
or substitution groups), then you will need to compile your schemas with the--generate-polymorphic
option. See Section 2.11, "Mapping forxsi:type
and Substitution Groups" in the C++/Tree Mapping User Manual for details.
- If your XML vocabulary uses XML Schema wildcards (
xsd:any
andxsd:anyAttribute
) then you may want to use the--generate-wildcard
option. See Section 2.12, "Mapping for any and anyAttribute" in the C++/Tree Mapping User Manual for details.
- If you are using Visual Studio 2005 and rely on IntelliSense, then you may want to compile your schemas with the
--generate-intellisense
option.
- If your schema is large and the resulting C++ source file is too big for the C++ compiler to handle (for example, the C++ compiler runs out of memory), then you can use the
--parts
option to split this file into several smaller files, for example,--parts 4
. The file-per-type compilation mode discussed above can also be used to address this issue.
C++/Parser Mapping Options
The following options are specific to the C++/Parser mapping:
- If your XML vocabulary uses XML Schema polymorphism (
xsi:type
or substitution groups), then you will need to compile your schemas with the--generate-polymorphic
option. See Section 5.4, "Support for Polymorphism" in the C++/Parser Mapping Getting Started Guide for details.