LibreOffice Module unoxml (master) 1
document.hxx
Go to the documentation of this file.
1/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2/*
3 * This file is part of the LibreOffice project.
4 *
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8 *
9 * This file incorporates work covered by the following license notice:
10 *
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18 */
19
20#pragma once
21
22#include <memory>
23#include <unordered_map>
24
25#include <libxml/tree.h>
26
27#include <sal/types.h>
28
31
32#include <com/sun/star/uno/Reference.h>
33#include <com/sun/star/beans/StringPair.hpp>
34#include <com/sun/star/xml/dom/XNode.hpp>
35#include <com/sun/star/xml/dom/XAttr.hpp>
36#include <com/sun/star/xml/dom/XElement.hpp>
37#include <com/sun/star/xml/dom/XDOMImplementation.hpp>
38#include <com/sun/star/xml/dom/events/XDocumentEvent.hpp>
39#include <com/sun/star/xml/dom/events/XEvent.hpp>
40#include <com/sun/star/xml/sax/XSAXSerializable.hpp>
41#include <com/sun/star/xml/sax/XFastSAXSerializable.hpp>
42#include <com/sun/star/xml/sax/XDocumentHandler.hpp>
43#include <com/sun/star/xml/sax/XFastDocumentHandler.hpp>
44#include <com/sun/star/io/XActiveDataSource.hpp>
45#include <com/sun/star/io/XActiveDataControl.hpp>
46#include <com/sun/star/io/XOutputStream.hpp>
47#include <com/sun/star/io/XStreamListener.hpp>
49
50#include <node.hxx>
51
52namespace DOM
53{
54 namespace events {
55 class CEventDispatcher;
56 }
57
58 class CElement;
59
60 typedef ::cppu::ImplInheritanceHelper<
61 CNode, css::xml::dom::XDocument, css::xml::dom::events::XDocumentEvent,
62 css::io::XActiveDataControl, css::io::XActiveDataSource,
63 css::xml::sax::XSAXSerializable, css::xml::sax::XFastSAXSerializable>
65
67 : public CDocument_Base
68 {
69
70 private:
73 ::osl::Mutex m_Mutex;
76 xmlDocPtr const m_aDocPtr;
77
78 // datacontrol/source state
81 css::uno::Reference< css::io::XOutputStream > m_rOutputStream;
82
83 typedef std::unordered_map< xmlNodePtr,
84 ::std::pair< css::uno::WeakReference<css::xml::dom::XNode>, CNode* > > nodemap_t;
86
87 ::std::unique_ptr<events::CEventDispatcher> const m_pEventDispatcher;
88
89 explicit CDocument(xmlDocPtr const pDocPtr);
90
91
92 public:
94 static ::rtl::Reference<CDocument>
95 CreateCDocument(xmlDocPtr const pDoc);
96
97 virtual ~CDocument() override;
98
99 // needed by CXPathAPI
100 ::osl::Mutex & GetMutex() { return m_Mutex; }
101
104
107 xmlNodePtr const pNode, bool const bCreate = true);
109 void RemoveCNode(xmlNodePtr const pNode, CNode const*const pCNode);
110
111 virtual CDocument & GetOwnerDocument() override;
112
113 virtual void saxify(const css::uno::Reference< css::xml::sax::XDocumentHandler >& i_xHandler) override;
114
115 virtual void fastSaxify( Context& rContext ) override;
116
117 virtual bool IsChildTypeAllowed(css::xml::dom::NodeType const nodeType,
118 css::xml::dom::NodeType const* pReplacedNodeType) override;
119
123 virtual css::uno::Reference< css::xml::dom::XAttr > SAL_CALL createAttribute(const OUString& name) override;
124
128 virtual css::uno::Reference< css::xml::dom::XAttr > SAL_CALL createAttributeNS(const OUString& namespaceURI, const OUString& qualifiedName) override;
129
133 virtual css::uno::Reference< css::xml::dom::XCDATASection > SAL_CALL createCDATASection(const OUString& data) override;
134
138 virtual css::uno::Reference< css::xml::dom::XComment > SAL_CALL createComment(const OUString& data) override;
139
143 virtual css::uno::Reference< css::xml::dom::XDocumentFragment > SAL_CALL createDocumentFragment() override;
144
148 virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL createElement(const OUString& tagName) override;
149
153 virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL createElementNS(const OUString& namespaceURI, const OUString& qualifiedName) override;
154
158 virtual css::uno::Reference< css::xml::dom::XEntityReference > SAL_CALL createEntityReference(const OUString& name) override;
159
164 virtual css::uno::Reference< css::xml::dom::XProcessingInstruction > SAL_CALL createProcessingInstruction(
165 const OUString& target, const OUString& data) override;
166
170 virtual css::uno::Reference< css::xml::dom::XText > SAL_CALL createTextNode(const OUString& data) override;
171
176 virtual css::uno::Reference< css::xml::dom::XDocumentType > SAL_CALL getDoctype() override;
177
182 virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL getDocumentElement() override;
183
187 virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL getElementById(const OUString& elementId) override;
188
194 virtual css::uno::Reference< css::xml::dom::XNodeList > SAL_CALL getElementsByTagName(const OUString& tagname) override;
195
201 virtual css::uno::Reference< css::xml::dom::XNodeList > SAL_CALL getElementsByTagNameNS(const OUString& namespaceURI, const OUString& localName) override;
202
206 virtual css::uno::Reference< css::xml::dom::XDOMImplementation > SAL_CALL getImplementation() override;
207
211 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL importNode(const css::uno::Reference< css::xml::dom::XNode >& importedNode, sal_Bool deep) override;
212
213 // XDocumentEvent
214 virtual css::uno::Reference< css::xml::dom::events::XEvent > SAL_CALL createEvent(const OUString& eventType) override;
215
216 // XActiveDataControl,
217 // see https://api.libreoffice.org/docs/common/ref/com/sun/star/io/XActiveDataControl.html
218 virtual void SAL_CALL addListener(const css::uno::Reference< css::io::XStreamListener >& aListener ) override;
219 virtual void SAL_CALL removeListener(const css::uno::Reference< css::io::XStreamListener >& aListener ) override;
220 virtual void SAL_CALL start() override;
221 virtual void SAL_CALL terminate() override;
222
223 // XActiveDataSource
224 // see https://api.libreoffice.org/docs/common/ref/com/sun/star/io/XActiveDataSource.html
225 virtual void SAL_CALL setOutputStream( const css::uno::Reference< css::io::XOutputStream >& aStream ) override;
226 virtual css::uno::Reference< css::io::XOutputStream > SAL_CALL getOutputStream() override;
227
228 // ---- resolve uno inheritance problems...
229 // overrides for XNode base
230 virtual OUString SAL_CALL getNodeName() override;
231 virtual OUString SAL_CALL getNodeValue() override;
232 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL cloneNode(sal_Bool deep) override;
233 // --- delegation for XNode base.
234 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL appendChild(const css::uno::Reference< css::xml::dom::XNode >& newChild) override
235 {
236 return CNode::appendChild(newChild);
237 }
238 virtual css::uno::Reference< css::xml::dom::XNamedNodeMap > SAL_CALL getAttributes() override
239 {
240 return CNode::getAttributes();
241 }
242 virtual css::uno::Reference< css::xml::dom::XNodeList > SAL_CALL getChildNodes() override
243 {
244 return CNode::getChildNodes();
245 }
246 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getFirstChild() override
247 {
248 return CNode::getFirstChild();
249 }
250 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getLastChild() override
251 {
252 return CNode::getLastChild();
253 }
254 virtual OUString SAL_CALL getLocalName() override
255 {
256 return CNode::getLocalName();
257 }
258 virtual OUString SAL_CALL getNamespaceURI() override
259 {
260 return CNode::getNamespaceURI();
261 }
262 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getNextSibling() override
263 {
264 return CNode::getNextSibling();
265 }
266 virtual css::xml::dom::NodeType SAL_CALL getNodeType() override
267 {
268 return CNode::getNodeType();
269 }
270 virtual css::uno::Reference< css::xml::dom::XDocument > SAL_CALL getOwnerDocument() override
271 {
272 return CNode::getOwnerDocument();
273 }
274 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getParentNode() override
275 {
276 return CNode::getParentNode();
277 }
278 virtual OUString SAL_CALL getPrefix() override
279 {
280 return CNode::getPrefix();
281 }
282 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getPreviousSibling() override
283 {
284 return CNode::getPreviousSibling();
285 }
286 virtual sal_Bool SAL_CALL hasAttributes() override
287 {
288 return CNode::hasAttributes();
289 }
290 virtual sal_Bool SAL_CALL hasChildNodes() override
291 {
292 return CNode::hasChildNodes();
293 }
294 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL insertBefore(
295 const css::uno::Reference< css::xml::dom::XNode >& newChild, const css::uno::Reference< css::xml::dom::XNode >& refChild) override
296 {
297 return CNode::insertBefore(newChild, refChild);
298 }
299 virtual sal_Bool SAL_CALL isSupported(const OUString& feature, const OUString& ver) override
300 {
301 return CNode::isSupported(feature, ver);
302 }
303 virtual void SAL_CALL normalize() override
304 {
305 CNode::normalize();
306 }
307 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL removeChild(const css::uno::Reference< css::xml::dom::XNode >& oldChild) override
308 {
309 return CNode::removeChild(oldChild);
310 }
311 virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL replaceChild(
312 const css::uno::Reference< css::xml::dom::XNode >& newChild, const css::uno::Reference< css::xml::dom::XNode >& oldChild) override
313 {
314 return CNode::replaceChild(newChild, oldChild);
315 }
316 virtual void SAL_CALL setNodeValue(const OUString& nodeValue) override
317 {
318 return CNode::setNodeValue(nodeValue);
319 }
320 virtual void SAL_CALL setPrefix(const OUString& prefix) override
321 {
322 return CNode::setPrefix(prefix);
323 }
324
325 // css::xml::sax::XSAXSerializable
326 virtual void SAL_CALL serialize(
327 const css::uno::Reference< css::xml::sax::XDocumentHandler >& i_xHandler,
328 const css::uno::Sequence< css::beans::StringPair >& i_rNamespaces) override;
329
330 // css::xml::sax::XFastSAXSerializable
331 virtual void SAL_CALL fastSerialize( const css::uno::Reference< css::xml::sax::XFastDocumentHandler >& handler,
332 const css::uno::Reference< css::xml::sax::XFastTokenHandler >& tokenHandler,
333 const css::uno::Sequence< css::beans::StringPair >& i_rNamespaces,
334 const css::uno::Sequence< css::beans::Pair< OUString, sal_Int32 > >& namespaces ) override;
335 };
336}
337
338/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
xmlDocPtr const m_aDocPtr
the libxml document: freed in destructor => all UNO wrapper objects must keep the CDocument alive
Definition: document.hxx:76
::rtl::Reference< CNode > GetCNode(xmlNodePtr const pNode, bool const bCreate=true)
get UNO wrapper instance for a libxml node
Definition: document.cxx:161
virtual void SAL_CALL serialize(const css::uno::Reference< css::xml::sax::XDocumentHandler > &i_xHandler, const css::uno::Sequence< css::beans::StringPair > &i_rNamespaces) override
Definition: document.cxx:964
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getParentNode() override
Definition: document.hxx:274
virtual css::uno::Reference< css::xml::dom::XCDATASection > SAL_CALL createCDATASection(const OUString &data) override
Creates a CDATASection node whose value is the specified string.
Definition: document.cxx:466
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getLastChild() override
Definition: document.hxx:250
virtual void fastSaxify(Context &rContext) override
Definition: document.cxx:282
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getPreviousSibling() override
Definition: document.hxx:282
::osl::Mutex & GetMutex()
Definition: document.hxx:100
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL replaceChild(const css::uno::Reference< css::xml::dom::XNode > &newChild, const css::uno::Reference< css::xml::dom::XNode > &oldChild) override
Definition: document.hxx:311
virtual void SAL_CALL setPrefix(const OUString &prefix) override
Definition: document.hxx:320
virtual OUString SAL_CALL getLocalName() override
Definition: document.hxx:254
o3tl::sorted_vector< css::uno::Reference< css::io::XStreamListener > > listenerlist_t
Definition: document.hxx:79
::std::unique_ptr< events::CEventDispatcher > const m_pEventDispatcher
Definition: document.hxx:87
virtual css::uno::Reference< css::xml::dom::XNodeList > SAL_CALL getElementsByTagNameNS(const OUString &namespaceURI, const OUString &localName) override
Returns a NodeList of all the Elements with a given local name and namespace URI in the order in whic...
Definition: document.cxx:687
virtual void SAL_CALL setOutputStream(const css::uno::Reference< css::io::XOutputStream > &aStream) override
Definition: document.cxx:400
virtual void SAL_CALL terminate() override
Definition: document.cxx:395
nodemap_t m_NodeMap
Definition: document.hxx:85
virtual css::uno::Reference< css::xml::dom::XAttr > SAL_CALL createAttributeNS(const OUString &namespaceURI, const OUString &qualifiedName) override
Creates an attribute of the given qualified name and namespace URI.
Definition: document.cxx:431
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL appendChild(const css::uno::Reference< css::xml::dom::XNode > &newChild) override
Definition: document.hxx:234
virtual bool IsChildTypeAllowed(css::xml::dom::NodeType const nodeType, css::xml::dom::NodeType const *pReplacedNodeType) override
Definition: document.cxx:294
virtual css::uno::Reference< css::xml::dom::XEntityReference > SAL_CALL createEntityReference(const OUString &name) override
Creates an EntityReference object.
Definition: document.cxx:559
virtual CDocument & GetOwnerDocument() override
Definition: document.cxx:265
virtual ~CDocument() override
Definition: document.cxx:106
virtual void SAL_CALL normalize() override
Definition: document.hxx:303
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL insertBefore(const css::uno::Reference< css::xml::dom::XNode > &newChild, const css::uno::Reference< css::xml::dom::XNode > &refChild) override
Definition: document.hxx:294
virtual void SAL_CALL removeListener(const css::uno::Reference< css::io::XStreamListener > &aListener) override
Definition: document.cxx:321
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL importNode(const css::uno::Reference< css::xml::dom::XNode > &importedNode, sal_Bool deep) override
Imports a node from another document to this document.
Definition: document.cxx:881
virtual sal_Bool SAL_CALL hasChildNodes() override
Definition: document.hxx:290
virtual void SAL_CALL fastSerialize(const css::uno::Reference< css::xml::sax::XFastDocumentHandler > &handler, const css::uno::Reference< css::xml::sax::XFastTokenHandler > &tokenHandler, const css::uno::Sequence< css::beans::StringPair > &i_rNamespaces, const css::uno::Sequence< css::beans::Pair< OUString, sal_Int32 > > &namespaces) override
Definition: document.cxx:989
virtual css::uno::Reference< css::xml::dom::XText > SAL_CALL createTextNode(const OUString &data) override
Creates a Text node given the specified string.
Definition: document.cxx:592
listenerlist_t m_streamListeners
Definition: document.hxx:80
virtual css::uno::Reference< css::xml::dom::XNodeList > SAL_CALL getElementsByTagName(const OUString &tagname) override
Returns a NodeList of all the Elements with a given tag name in the order in which they are encounter...
Definition: document.cxx:678
virtual css::uno::Reference< css::xml::dom::XAttr > SAL_CALL createAttribute(const OUString &name) override
Creates an Attr of the given name.
Definition: document.cxx:415
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getNextSibling() override
Definition: document.hxx:262
virtual sal_Bool SAL_CALL hasAttributes() override
Definition: document.hxx:286
::osl::Mutex m_Mutex
this Mutex is used for synchronization of all UNO wrapper objects that belong to this document
Definition: document.hxx:73
virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL createElementNS(const OUString &namespaceURI, const OUString &qualifiedName) override
Creates an element of the given qualified name and namespace URI.
Definition: document.cxx:523
virtual OUString SAL_CALL getNodeValue() override
Definition: document.cxx:917
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL cloneNode(sal_Bool deep) override
Definition: document.cxx:923
void RemoveCNode(xmlNodePtr const pNode, CNode const *const pCNode)
remove a UNO wrapper instance
Definition: document.cxx:136
virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL getElementById(const OUString &elementId) override
Returns the Element whose ID is given by elementId.
Definition: document.cxx:660
virtual css::uno::Reference< css::xml::dom::events::XEvent > SAL_CALL createEvent(const OUString &eventType) override
Definition: document.cxx:938
virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL getDocumentElement() override
This is a convenience attribute that allows direct access to the child node that is the root element ...
Definition: document.cxx:620
virtual css::uno::Reference< css::xml::dom::XDocumentType > SAL_CALL getDoctype() override
The Document Type Declaration (see DocumentType) associated with this document.
Definition: document.cxx:607
virtual void SAL_CALL setNodeValue(const OUString &nodeValue) override
Definition: document.hxx:316
::rtl::Reference< CElement > GetDocumentElement()
Definition: document.cxx:127
virtual css::uno::Reference< css::xml::dom::XDocument > SAL_CALL getOwnerDocument() override
Definition: document.hxx:270
virtual void SAL_CALL addListener(const css::uno::Reference< css::io::XStreamListener > &aListener) override
Definition: document.cxx:314
virtual OUString SAL_CALL getPrefix() override
Definition: document.hxx:278
CDocument(xmlDocPtr const pDocPtr)
Definition: document.cxx:86
virtual OUString SAL_CALL getNamespaceURI() override
Definition: document.hxx:258
virtual css::uno::Reference< css::io::XOutputStream > SAL_CALL getOutputStream() override
Definition: document.cxx:407
virtual css::uno::Reference< css::xml::dom::XProcessingInstruction > SAL_CALL createProcessingInstruction(const OUString &target, const OUString &data) override
Creates a ProcessingInstruction node given the specified name and data strings.
Definition: document.cxx:574
css::uno::Reference< css::io::XOutputStream > m_rOutputStream
Definition: document.hxx:81
virtual css::uno::Reference< css::xml::dom::XComment > SAL_CALL createComment(const OUString &data) override
Creates a Comment node given the specified string.
Definition: document.cxx:483
virtual OUString SAL_CALL getNodeName() override
Definition: document.cxx:911
std::unordered_map< xmlNodePtr, ::std::pair< css::uno::WeakReference< css::xml::dom::XNode >, CNode * > > nodemap_t
Definition: document.hxx:84
virtual css::xml::dom::NodeType SAL_CALL getNodeType() override
Definition: document.hxx:266
virtual css::uno::Reference< css::xml::dom::XNodeList > SAL_CALL getChildNodes() override
Definition: document.hxx:242
virtual css::uno::Reference< css::xml::dom::XElement > SAL_CALL createElement(const OUString &tagName) override
Creates an element of the type specified.
Definition: document.cxx:509
virtual sal_Bool SAL_CALL isSupported(const OUString &feature, const OUString &ver) override
Definition: document.hxx:299
events::CEventDispatcher & GetEventDispatcher()
Definition: document.cxx:122
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL removeChild(const css::uno::Reference< css::xml::dom::XNode > &oldChild) override
Definition: document.hxx:307
virtual css::uno::Reference< css::xml::dom::XDocumentFragment > SAL_CALL createDocumentFragment() override
Creates an empty DocumentFragment object.
Definition: document.cxx:497
static ::rtl::Reference< CDocument > CreateCDocument(xmlDocPtr const pDoc)
factory: only way to create instance!
Definition: document.cxx:94
virtual void SAL_CALL start() override
Definition: document.cxx:361
virtual void saxify(const css::uno::Reference< css::xml::sax::XDocumentHandler > &i_xHandler) override
Definition: document.cxx:270
virtual css::uno::Reference< css::xml::dom::XNode > SAL_CALL getFirstChild() override
Definition: document.hxx:246
virtual css::uno::Reference< css::xml::dom::XNamedNodeMap > SAL_CALL getAttributes() override
Definition: document.hxx:238
virtual css::uno::Reference< css::xml::dom::XDOMImplementation > SAL_CALL getImplementation() override
The DOMImplementation object that handles this document.
Definition: document.cxx:698
Definition: attr.cxx:38
::cppu::ImplInheritanceHelper< CNode, css::xml::dom::XDocument, css::xml::dom::events::XDocumentEvent, css::io::XActiveDataControl, css::io::XActiveDataSource, css::xml::sax::XSAXSerializable, css::xml::sax::XFastSAXSerializable > CDocument_Base
Definition: document.hxx:58
unsigned char sal_Bool