summaryrefslogtreecommitdiff
path: root/xsd-examples/cxx/tree/embedded/README
blob: f1946bfcdadc712391be8d5501b0e1a1fa72798d (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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
This example shows how to embed the binary representation of the schema
grammar into an application and then use it with the C++/Tree mapping to
parse and validate XML documents. This example is similar to the 'caching'
example except that it loads the binary representation of the schemas
embedded into the application instead of pre-parsing external schema files.

The example consists of the following files:

xsdbin.cxx
  Tool for converting one or more XML Schema files to the compressed binary
  representation. The output is written as a pair of C++ source files
  containing the array with the binary data. Use the --help option to see
  the tool's usage information.

  To compile and link this tool we can use the following commands (replace
  'c++' with your C++ compiler name):

  c++ -c xsdbin.cxx
  c++ -o xsdbin xsdbin.o -lxerces-c

library.xsd
  XML Schema which describes a library of books.

library.xml
  Sample XML instance document.

library.hxx
library.cxx
  C++ types that represent the given vocabulary and a set of parsing
  functions that convert XML instance documents to a tree-like in-memory
  object model.

  These files are generated by the XSD compiler from library.xsd using
  the following command line:

  xsd cxx-tree library.xsd

library-schema.hxx
library-schema.cxx
  Binary representation of the library.xsd schema.

  These files are generated by the xsdbin tool from library.xsd using the
  following command line:

  ./xsdbin library.xsd

grammar-input-stream.hxx
grammar-input-stream.cxx
  Input stream implementation with the special-purpose schema grammar
  decompression algorithm. It is used to load the binary schema representation
  produced by the xsdbin tool.

driver.cxx
  Driver for the example. It first sets up the Xerces-C++ DOM parser and
  loads the embedded binary schema grammar for validation. It then performs
  ten iterations that parse the input file to a DOM document using the DOM
  parser and call one of the parsing functions that constructs the object
  model from this DOM document. On each iteration the driver prints a number
  of books in the object model to STDERR.

To compile and link the example manually from the command line we can use
the following commands (replace 'c++' with your C++ compiler name):

c++ -DXSD_CXX11 -c library.cxx
c++ -DXSD_CXX11 -c library-schema.cxx
c++ -DXSD_CXX11 -c grammar-input-stream.cxx
c++ -DXSD_CXX11 -c driver.cxx
c++ -o driver driver.o library.o library-schema.o grammar-input-stream.o \
    -lxerces-c

Note that we need to define the XSD_CXX11 preprocessor macro since the
source code includes libxsd headers directly.

To run the example on the sample XML instance document execute:

./driver library.xml