aboutsummaryrefslogtreecommitdiff
path: root/examples/cxx/parser/multiroot/README
blob: 817e5227e89ac7bb59be50e459b68f8d78bfaa87 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
This example shows how to handle XML vocabularies with multiple
root elements using the Embedded C++/Parser mapping.

The example consists of the following files:

protocol.xsd
  XML Schema which defines a simple bank account protocol with
  requests such as withdraw and deposit.

balance.xml
withdraw.xml
deposit.xml
  Sample XML instances for the protocol requests.

protocol.hxx
  C++ types that describe the protocol requests. These are
  hand-written.

protocol.map
  Type map. It maps XML Schema types defined in protocol.xsd
  to the C++ types defined in protocol.hxx.

protocol-pskel.hxx
protocol-pskel.cxx
  Parser skeletons generated by XSD/e from protocol.xsd and
  protocol.map.

protocol-pimpl-mixin.hxx
protocol-pimpl-mixin.cxx

protocol-pimpl-tiein.hxx
protocol-pimpl-tiein.cxx
  Parser implementations (using either mixin or tiein parser
  reuse style) that construct the custom object model from an
  XML instance using the types from protocol.hxx. These are
  hand-written implementations of the parser skeletons defined
  in protocol-pskel.hxx.

driver.cxx
  Driver for the example. It implements a custom document parser
  that determines which request is being parsed and uses the
  corresponding parser implementation. The document parser
  intentionally does not support the deposit request to show
  how to handle unknown documents. The driver first constructs
  a parser instance from all the individual parsers found in one
  of protocol-pimpl-*.hxx. In then invokes this parser instance
  to parse the input file and produce the in-memory object model.
  Finally, it prints the contents of the object model to STDERR.

To run the example on the sample XML request documents simply
execute:

$ ./driver balance.xml
$ ./driver withdraw.xml
$ ./driver deposit.xml

The example reads from STDIN if input file is not specified:

$ ./driver <balance.xml
$ ./driver <withdraw.xml
$ ./driver <deposit.xml