LibreOffice Module desktop (master)  1
dp_backenddb.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 #ifndef INCLUDED_DESKTOP_SOURCE_DEPLOYMENT_REGISTRY_INC_DP_BACKENDDB_HXX
21 #define INCLUDED_DESKTOP_SOURCE_DEPLOYMENT_REGISTRY_INC_DP_BACKENDDB_HXX
22 
23 #include <rtl/ustring.hxx>
24 #include <deque>
25 #include <vector>
26 
27 namespace com { namespace sun { namespace star {
28  namespace uno {
29  class XComponentContext;
30  }
31  namespace xml { namespace dom {
32  class XDocument;
33  class XNode;
34  }}
35  namespace xml { namespace xpath {
36  class XXPathAPI;
37  }}
38 }}}
39 
40 namespace dp_registry {
41 namespace backend {
42 
43 class BackendDb
44 {
45 private:
46 
47  css::uno::Reference<css::xml::dom::XDocument> m_doc;
48  css::uno::Reference<css::xml::xpath::XXPathAPI> m_xpathApi;
49 
50  BackendDb(BackendDb const &) = delete;
51  BackendDb & operator = (BackendDb const &) = delete;
52 
53 protected:
54  const css::uno::Reference<css::uno::XComponentContext> m_xContext;
55  OUString m_urlDb;
56 
57 protected:
58 
59  /* caller must make sure that only one thread accesses the function
60  */
61  css::uno::Reference<css::xml::dom::XDocument> const & getDocument();
62 
63  /* the namespace prefix is "reg" (without quotes)
64  */
65  css::uno::Reference<css::xml::xpath::XXPathAPI> const & getXPathAPI();
66  void save();
67  void removeElement(OUString const & sXPathExpression);
68 
69  css::uno::Reference<css::xml::dom::XNode> getKeyElement(
70  OUString const & url);
71 
72  void writeSimpleList(
73  std::deque< OUString> const & list,
74  OUString const & sListTagName,
75  OUString const & sMemberTagName,
76  css::uno::Reference<css::xml::dom::XNode> const & xParent);
77 
78  void writeVectorOfPair(
79  std::vector< std::pair< OUString, OUString > > const & vecPairs,
80  OUString const & sVectorTagName,
81  OUString const & sPairTagName,
82  OUString const & sFirstTagName,
83  OUString const & sSecondTagName,
84  css::uno::Reference<css::xml::dom::XNode> const & xParent);
85 
86  void writeSimpleElement(
87  OUString const & sElementName, OUString const & value,
88  css::uno::Reference<css::xml::dom::XNode> const & xParent);
89 
90  css::uno::Reference<css::xml::dom::XNode> writeKeyElement(
91  OUString const & url);
92 
93  OUString readSimpleElement(
94  OUString const & sElementName,
95  css::uno::Reference<css::xml::dom::XNode> const & xParent);
96 
97  std::vector< std::pair< OUString, OUString > >
99  css::uno::Reference<css::xml::dom::XNode> const & parent,
100  OUString const & sListTagName,
101  OUString const & sPairTagName,
102  OUString const & sFirstTagName,
103  OUString const & sSecondTagName);
104 
105  std::deque< OUString> readList(
106  css::uno::Reference<css::xml::dom::XNode> const & parent,
107  OUString const & sListTagName,
108  OUString const & sMemberTagName);
109 
110  /* returns the values of one particularly child element of all key elements.
111  */
112  std::vector< OUString> getOneChildFromAllEntries(
113  OUString const & sElementName);
114 
115 
116  /* returns the namespace which is to be written as xmlns attribute
117  into the root element.
118  */
119  virtual OUString getDbNSName()=0;
120  /* return the namespace prefix which is to be registered with the XPath API.
121 
122  The prefix can then be used in XPath expressions.
123  */
124  virtual OUString getNSPrefix()=0;
125  /* returns the name of the root element without any namespace prefix.
126  */
127  virtual OUString getRootElementName()=0;
128  /* returns the name of xml element for each entry
129  */
130  virtual OUString getKeyElementName()=0;
131 
132 public:
133  BackendDb(css::uno::Reference<css::uno::XComponentContext> const & xContext,
134  OUString const & url);
135  virtual ~BackendDb() {};
136 
137  void removeEntry(OUString const & url);
138 
139  /* This is called to write the "revoked" attribute to the entry.
140  This is done when XPackage::revokePackage is called.
141  */
142  void revokeEntry(OUString const & url);
143 
144  /* returns false if the entry does not exist yet.
145  */
146  bool activateEntry(OUString const & url);
147 
148  bool hasActiveEntry(OUString const & url);
149 
150 };
151 
152 class RegisteredDb: public BackendDb
153 {
154 
155 public:
156  RegisteredDb( css::uno::Reference<css::uno::XComponentContext> const & xContext,
157  OUString const & url);
158 
159 
160  void addEntry(OUString const & url);
161 };
162 
163 }
164 }
165 #endif
166 
167 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
void writeVectorOfPair(std::vector< std::pair< OUString, OUString > > const &vecPairs, OUString const &sVectorTagName, OUString const &sPairTagName, OUString const &sFirstTagName, OUString const &sSecondTagName, css::uno::Reference< css::xml::dom::XNode > const &xParent)
css::uno::Reference< css::xml::dom::XDocument > const & getDocument()
void removeEntry(OUString const &url)
std::deque< OUString > readList(css::uno::Reference< css::xml::dom::XNode > const &parent, OUString const &sListTagName, OUString const &sMemberTagName)
css::uno::Reference< css::xml::dom::XDocument > m_doc
css::uno::Reference< css::xml::dom::XNode > writeKeyElement(OUString const &url)
The key elements have a url attribute and are always children of the root element.
css::uno::Reference< css::xml::dom::XNode > getKeyElement(OUString const &url)
css::uno::Reference< css::xml::xpath::XXPathAPI > m_xpathApi
virtual OUString getKeyElementName()=0
std::vector< std::pair< OUString, OUString > > readVectorOfPair(css::uno::Reference< css::xml::dom::XNode > const &parent, OUString const &sListTagName, OUString const &sPairTagName, OUString const &sFirstTagName, OUString const &sSecondTagName)
BackendDb(BackendDb const &)=delete
void removeElement(OUString const &sXPathExpression)
virtual OUString getDbNSName()=0
bool hasActiveEntry(OUString const &url)
void writeSimpleElement(OUString const &sElementName, OUString const &value, css::uno::Reference< css::xml::dom::XNode > const &xParent)
void addEntry(OUString const &url)
static uno::Reference< css::uno::XComponentContext > xContext
Definition: init.cxx:1882
const css::uno::Reference< css::uno::XComponentContext > m_xContext
std::vector< OUString > getOneChildFromAllEntries(OUString const &sElementName)
void revokeEntry(OUString const &url)
RegisteredDb(css::uno::Reference< css::uno::XComponentContext > const &xContext, OUString const &url)
virtual OUString getNSPrefix()=0
css::uno::Reference< css::xml::xpath::XXPathAPI > const & getXPathAPI()
OUString readSimpleElement(OUString const &sElementName, css::uno::Reference< css::xml::dom::XNode > const &xParent)
virtual OUString getRootElementName()=0
BackendDb & operator=(BackendDb const &)=delete
bool activateEntry(OUString const &url)
void writeSimpleList(std::deque< OUString > const &list, OUString const &sListTagName, OUString const &sMemberTagName, css::uno::Reference< css::xml::dom::XNode > const &xParent)