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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef _XMLOFF_XMLPROPERTYBACKPATCHER_HXX
#define _XMLOFF_XMLPROPERTYBACKPATCHER_HXX
#include <map>
#include <vector>
#include <comphelper/stl_types.hxx>
namespace rtl { class OUString; }
namespace com { namespace sun { namespace star {
namespace beans { class XPropertySet; }
namespace uno { template<class A> class Reference; }
} } }
/** This class maintains an OUString->sal_Int16 mapping for cases in
* which an XPropertySet needs to be filled with values that are not
* yet known.
*
* A good example for appropriate use are footnotes and references to
* footnoes. Internally, the StarOffice API numbers footnotes, and
* references to footnotes refer to that internal numbering. In the
* XML file format, these numbers are replaced with name strings. Now
* if during import of a document a reference to a footnote is
* encountered, two things can happen: 1) The footnote already
* appeared in the document. In this case the name is already known
* and the proper ID can be requested from the footnote. 2) The
* footnote will appear later in the document. In this case the ID is
* not yet known, and the reference-ID property of the reference
* cannot be determined. Hence, the reference has to be stored and the
* ID needs to bet set later, when the footnote is eventually found in
* the document.
*
* This class simplifies this process: If the footnote is found,
* ResolveId with the XML name and the ID is called. When a reference
* is encountered, SetProperty gets called with the reference's
* XPropertySet and the XML name. All remaining tasks are handled by
* the class.
*/
template <class A>
class XMLPropertyBackpatcher
{
/// name of property that gets set or backpatched
::rtl::OUString sPropertyName;
/// should a default value be set for unresolved properties
sal_Bool bDefaultHandling;
/// should the sPreservePropertyName be preserved
sal_Bool bPreserveProperty;
/// name of the property to preserve
::rtl::OUString sPreservePropertyName;
/// default value for unresolved properties (if bDefaultHandling)
A aDefault;
/// backpatch list type
typedef ::std::vector<
::com::sun::star::uno::Reference<
::com::sun::star::beans::XPropertySet> > BackpatchListType;
/* use void* instead of BackpatchListType to avoid linker problems
with long typenames. The real typename (commented out) contains
>1200 chars. */
/// backpatch list for unresolved IDs
//::std::map<const ::rtl::OUString, BackpatchListType*> aBackpatchListMap;
::std::map<const ::rtl::OUString, void*, ::comphelper::UStringLess> aBackpatchListMap;
/// mapping of names -> IDs
::std::map<const ::rtl::OUString, A, ::comphelper::UStringLess> aIDMap;
public:
XMLPropertyBackpatcher(
const ::rtl::OUString& sPropertyName);
~XMLPropertyBackpatcher();
/// resolve a known ID.
/// Call this as soon as the value for a particular name is known.
void ResolveId(
const ::rtl::OUString& sName,
A aValue);
/// Set property with the proper value for this name. If the value
/// is not yet known, store the XPropertySet in the backpatch list.
/// Use this whenever the value should be set, even if it is not yet known.
/// const version
void SetProperty(
const ::com::sun::star::uno::Reference<
::com::sun::star::beans::XPropertySet> & xPropSet,
const ::rtl::OUString& sName);
/// non-const version of SetProperty
void SetProperty(
::com::sun::star::uno::Reference<
::com::sun::star::beans::XPropertySet> & xPropSet,
const ::rtl::OUString& sName);
/// set default (if bDefaultHandling) for unresolved names
/// called by destructor
void SetDefault();
};
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
