Mercurial > hg > orthanc
annotate OrthancServer/DatabaseWrapper.h @ 1641:4e56b5a206b7
Support of binary tags encoded using data URI scheme
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Wed, 23 Sep 2015 12:43:05 +0200 |
parents | c40fe92a68e7 |
children | 0c58f189782d |
rev | line source |
---|---|
183 | 1 /** |
2 * Orthanc - A Lightweight, RESTful DICOM Store | |
1288
6e7e5ed91c2d
upgrade to year 2015
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1286
diff
changeset
|
3 * Copyright (C) 2012-2015 Sebastien Jodogne, Medical Physics |
6e7e5ed91c2d
upgrade to year 2015
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1286
diff
changeset
|
4 * Department, University Hospital of Liege, Belgium |
183 | 5 * |
6 * This program is free software: you can redistribute it and/or | |
7 * modify it under the terms of the GNU General Public License as | |
8 * published by the Free Software Foundation, either version 3 of the | |
9 * License, or (at your option) any later version. | |
10 * | |
11 * In addition, as a special exception, the copyright holders of this | |
12 * program give permission to link the code of its release with the | |
13 * OpenSSL project's "OpenSSL" library (or with modified versions of it | |
14 * that use the same license as the "OpenSSL" library), and distribute | |
15 * the linked executables. You must obey the GNU General Public License | |
16 * in all respects for all of the code used other than "OpenSSL". If you | |
17 * modify file(s) with this exception, you may extend this exception to | |
18 * your version of the file(s), but you are not obligated to do so. If | |
19 * you do not wish to do so, delete this exception statement from your | |
20 * version. If you delete this exception statement from all source files | |
21 * in the program, then also delete it here. | |
22 * | |
23 * This program is distributed in the hope that it will be useful, but | |
24 * WITHOUT ANY WARRANTY; without even the implied warranty of | |
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
26 * General Public License for more details. | |
27 * | |
28 * You should have received a copy of the GNU General Public License | |
29 * along with this program. If not, see <http://www.gnu.org/licenses/>. | |
30 **/ | |
31 | |
32 | |
33 #pragma once | |
34 | |
1247 | 35 #include "IDatabaseWrapper.h" |
36 | |
183 | 37 #include "../Core/SQLite/Connection.h" |
187
8e673a65564d
refactoring of storing new instances
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
183
diff
changeset
|
38 #include "../Core/SQLite/Transaction.h" |
1242 | 39 |
183 | 40 namespace Orthanc |
41 { | |
42 namespace Internals | |
43 { | |
44 class SignalRemainingAncestor; | |
45 } | |
46 | |
47 /** | |
48 * This class manages an instance of the Orthanc SQLite database. It | |
49 * translates low-level requests into SQL statements. Mutual | |
50 * exclusion MUST be implemented at a higher level. | |
51 **/ | |
1247 | 52 class DatabaseWrapper : public IDatabaseWrapper |
183 | 53 { |
54 private: | |
1432
0ac74fa21db8
rename IServerIndexListener as IDatabaseListener
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1306
diff
changeset
|
55 IDatabaseListener* listener_; |
183 | 56 SQLite::Connection db_; |
57 Internals::SignalRemainingAncestor* signalRemainingAncestor_; | |
1615
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
58 unsigned int version_; |
183 | 59 |
60 void Open(); | |
61 | |
1240 | 62 void GetChangesInternal(std::list<ServerIndexChange>& target, |
63 bool& done, | |
237
16a4ac70bd8a
last change and export
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
233
diff
changeset
|
64 SQLite::Statement& s, |
1302 | 65 uint32_t maxResults); |
237
16a4ac70bd8a
last change and export
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
233
diff
changeset
|
66 |
1244 | 67 void GetExportedResourcesInternal(std::list<ExportedResource>& target, |
68 bool& done, | |
742 | 69 SQLite::Statement& s, |
1302 | 70 uint32_t maxResults); |
237
16a4ac70bd8a
last change and export
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
233
diff
changeset
|
71 |
1286 | 72 void ClearTable(const std::string& tableName); |
73 | |
183 | 74 public: |
1247 | 75 DatabaseWrapper(const std::string& path); |
76 | |
77 DatabaseWrapper(); | |
78 | |
1432
0ac74fa21db8
rename IServerIndexListener as IDatabaseListener
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1306
diff
changeset
|
79 virtual void SetListener(IDatabaseListener& listener); |
183 | 80 |
1247 | 81 virtual void SetGlobalProperty(GlobalProperty property, |
82 const std::string& value); | |
183 | 83 |
1247 | 84 virtual bool LookupGlobalProperty(std::string& target, |
85 GlobalProperty property); | |
86 | |
87 virtual int64_t CreateResource(const std::string& publicId, | |
88 ResourceType type); | |
183 | 89 |
1294 | 90 virtual bool LookupResource(int64_t& id, |
91 ResourceType& type, | |
92 const std::string& publicId); | |
183 | 93 |
1247 | 94 virtual bool LookupParent(int64_t& parentId, |
95 int64_t resourceId); | |
198
663cc6c46d0a
before refactoring of ServerIndex::GetXXX
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
197
diff
changeset
|
96 |
1247 | 97 virtual std::string GetPublicId(int64_t resourceId); |
98 | |
99 virtual ResourceType GetResourceType(int64_t resourceId); | |
198
663cc6c46d0a
before refactoring of ServerIndex::GetXXX
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
197
diff
changeset
|
100 |
1247 | 101 virtual void AttachChild(int64_t parent, |
102 int64_t child); | |
304 | 103 |
1247 | 104 virtual void DeleteResource(int64_t id); |
183 | 105 |
1247 | 106 virtual void SetMetadata(int64_t id, |
107 MetadataType type, | |
108 const std::string& value); | |
109 | |
110 virtual void DeleteMetadata(int64_t id, | |
111 MetadataType type); | |
183 | 112 |
1247 | 113 virtual bool LookupMetadata(std::string& target, |
114 int64_t id, | |
115 MetadataType type); | |
183 | 116 |
1247 | 117 virtual void ListAvailableMetadata(std::list<MetadataType>& target, |
118 int64_t id); | |
438 | 119 |
1247 | 120 virtual void AddAttachment(int64_t id, |
121 const FileInfo& attachment); | |
183 | 122 |
1247 | 123 virtual void DeleteAttachment(int64_t id, |
124 FileContentType attachment); | |
125 | |
1301 | 126 virtual void ListAvailableAttachments(std::list<FileContentType>& target, |
1247 | 127 int64_t id); |
436
d51186bf7602
read access to metadata
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
413
diff
changeset
|
128 |
1247 | 129 virtual bool LookupAttachment(FileInfo& attachment, |
130 int64_t id, | |
131 FileContentType contentType); | |
183 | 132 |
1286 | 133 virtual void SetMainDicomTag(int64_t id, |
134 const DicomTag& tag, | |
135 const std::string& value); | |
699
2929e17f8447
add attachments to resources
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
689
diff
changeset
|
136 |
1247 | 137 virtual void GetMainDicomTags(DicomMap& map, |
440
23e5b35e3c5c
statistics for patient/studies/series/instances
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
438
diff
changeset
|
138 int64_t id); |
23e5b35e3c5c
statistics for patient/studies/series/instances
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
438
diff
changeset
|
139 |
1301 | 140 virtual void GetChildrenPublicId(std::list<std::string>& target, |
1247 | 141 int64_t id); |
200
9c58b2b03cf0
refactoring of read operations
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
199
diff
changeset
|
142 |
1301 | 143 virtual void GetChildrenInternalId(std::list<int64_t>& target, |
1247 | 144 int64_t id); |
183 | 145 |
1247 | 146 virtual void LogChange(int64_t internalId, |
147 const ServerIndexChange& change); | |
183 | 148 |
1247 | 149 virtual void GetChanges(std::list<ServerIndexChange>& target /*out*/, |
150 bool& done /*out*/, | |
151 int64_t since, | |
1302 | 152 uint32_t maxResults); |
183 | 153 |
1247 | 154 virtual void GetLastChange(std::list<ServerIndexChange>& target /*out*/); |
204 | 155 |
1247 | 156 virtual void LogExportedResource(const ExportedResource& resource); |
183 | 157 |
1247 | 158 virtual void GetExportedResources(std::list<ExportedResource>& target /*out*/, |
159 bool& done /*out*/, | |
160 int64_t since, | |
1302 | 161 uint32_t maxResults); |
237
16a4ac70bd8a
last change and export
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
233
diff
changeset
|
162 |
1247 | 163 virtual void GetLastExportedResource(std::list<ExportedResource>& target /*out*/); |
183 | 164 |
1247 | 165 virtual uint64_t GetTotalCompressedSize(); |
166 | |
167 virtual uint64_t GetTotalUncompressedSize(); | |
238 | 168 |
1247 | 169 virtual uint64_t GetResourceCount(ResourceType resourceType); |
190 | 170 |
1247 | 171 virtual void GetAllPublicIds(std::list<std::string>& target, |
172 ResourceType resourceType); | |
262
2354560daf2f
primitives for recycling patients
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
238
diff
changeset
|
173 |
1509
0586ed8897f1
limit and since arguments while retrieving DICOM resources in the REST API
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1432
diff
changeset
|
174 virtual void GetAllPublicIds(std::list<std::string>& target, |
0586ed8897f1
limit and since arguments while retrieving DICOM resources in the REST API
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1432
diff
changeset
|
175 ResourceType resourceType, |
0586ed8897f1
limit and since arguments while retrieving DICOM resources in the REST API
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1432
diff
changeset
|
176 size_t since, |
0586ed8897f1
limit and since arguments while retrieving DICOM resources in the REST API
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1432
diff
changeset
|
177 size_t limit); |
0586ed8897f1
limit and since arguments while retrieving DICOM resources in the REST API
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1432
diff
changeset
|
178 |
1247 | 179 virtual bool SelectPatientToRecycle(int64_t& internalId); |
262
2354560daf2f
primitives for recycling patients
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
238
diff
changeset
|
180 |
1247 | 181 virtual bool SelectPatientToRecycle(int64_t& internalId, |
182 int64_t patientIdToAvoid); | |
183 | |
184 virtual bool IsProtectedPatient(int64_t internalId); | |
262
2354560daf2f
primitives for recycling patients
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
238
diff
changeset
|
185 |
1247 | 186 virtual void SetProtectedPatient(int64_t internalId, |
187 bool isProtected); | |
183 | 188 |
1247 | 189 virtual SQLite::ITransaction* StartTransaction() |
187
8e673a65564d
refactoring of storing new instances
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
183
diff
changeset
|
190 { |
8e673a65564d
refactoring of storing new instances
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
183
diff
changeset
|
191 return new SQLite::Transaction(db_); |
8e673a65564d
refactoring of storing new instances
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
183
diff
changeset
|
192 } |
202 | 193 |
1247 | 194 virtual void FlushToDisk() |
206
4453a010d0db
flush to disk thread
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
204
diff
changeset
|
195 { |
4453a010d0db
flush to disk thread
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
204
diff
changeset
|
196 db_.FlushToDisk(); |
4453a010d0db
flush to disk thread
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
204
diff
changeset
|
197 } |
310 | 198 |
1306
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
199 virtual bool HasFlushToDisk() const |
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
200 { |
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
201 return true; |
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
202 } |
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
203 |
1286 | 204 virtual void ClearChanges() |
205 { | |
206 ClearTable("Changes"); | |
207 } | |
208 | |
209 virtual void ClearExportedResources() | |
210 { | |
211 ClearTable("ExportedResources"); | |
212 } | |
513 | 213 |
1247 | 214 virtual bool IsExistingResource(int64_t internalId); |
521 | 215 |
1301 | 216 virtual void LookupIdentifier(std::list<int64_t>& target, |
1247 | 217 const DicomTag& tag, |
218 const std::string& value); | |
521 | 219 |
1301 | 220 virtual void LookupIdentifier(std::list<int64_t>& target, |
1247 | 221 const std::string& value); |
1006
649d47854314
proper handling of metadata in Store
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
742
diff
changeset
|
222 |
1301 | 223 virtual void GetAllMetadata(std::map<MetadataType, std::string>& target, |
1247 | 224 int64_t id); |
1241 | 225 |
1615
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
226 virtual unsigned int GetDatabaseVersion() |
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
227 { |
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
228 return version_; |
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
229 } |
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
230 |
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
231 virtual void Upgrade(unsigned int targetVersion, |
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
232 IStorageArea& storageArea); |
1241 | 233 |
234 | |
235 | |
236 /** | |
237 * The methods declared below are for unit testing only! | |
238 **/ | |
239 | |
1247 | 240 const char* GetErrorMessage() const |
241 { | |
242 return db_.GetErrorMessage(); | |
243 } | |
244 | |
1286 | 245 void GetChildren(std::list<std::string>& childrenPublicIds, |
246 int64_t id); | |
1241 | 247 |
1286 | 248 int64_t GetTableRecordCount(const std::string& table); |
1241 | 249 |
1301 | 250 bool GetParentPublicId(std::string& target, |
1286 | 251 int64_t id); |
1241 | 252 |
183 | 253 }; |
254 } |