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
77
78
79
80
81
82
83
|
#ifndef _BUILDER_H
#define _BUILDER_H
#include "xml.h"
namespace ledger {
/**
* @class builder_t
*
* @brief Represents an interface for building a data hierarchy.
*
* This interface is much like .NET's XmlWriter facility. It
* abstracts the kind of hierarchy we're building, instead focusing
* only on the relationships.
*/
class builder_t
{
virtual void pushAttribute(const string& name,
const string& value) = 0;
virtual void pushAttribute(const nameid_t name_id,
const string& value) = 0;
virtual void beginNode(const string& name) = 0;
virtual void beginNode(const nameid_t name_id) = 0;
virtual void appendText(const string& text) = 0;
virtual node_t * endNode(const optional<string>& name =
optional<string>()) = 0;
virtual node_t * endNode(const nameid_t name_id) = 0;
};
/**
* @class xml_builder_t
*
* @brief Build a generic node_t hierarchy.
*
* This builder can be used to parse ordinary XML into a document
* object structure which can then be traversed in memory.
*/
class xml_builder_t : public builder_t
{
};
/**
* @class journal_builder_t
*
* @brief This custom builder creates an XML-mirrored Ledger journal.
*
* Rather than simply creating a node_t hierarchy, as xml_builder_t
* does, this code creates the associated journal elements referred to
* by those nodes, and then refers to those elements via minimalist
* "shadow nodes".
*
* Thus, after building a <transaction> element, the element itself
* will have no children, but instead will point to a transaction_t
* object. If later an XPath expression desires to traverse the
* <transaction> element, all of the appropriate child nodes will be
* constructed on the fly, as if they'd been created in the first
* place by a regular xml_builder_t.
*/
class journal_builder_t : public xml_builder_t
{
};
/**
* @class xml_writer_t
*
* @brief Create textual XML on the given output stream.
*
* This builder, rather than manipulating data structures in memory,
* simply streams its contents on the fly to the given output stream.
* It uses only enough memory to remember the currently push
* attributes and text.
*/
class xml_writer_t : public builder_t
{
};
} // namespace ledger
#endif // _BUILDER_H
|
