Mercurial > hg > orthanc
annotate OrthancServer/IDatabaseWrapper.h @ 3038:53d583d2c775 db-changes
removing IDatabaseWrapper::LookupIdentifier()
| author | Sebastien Jodogne <s.jodogne@gmail.com> |
|---|---|
| date | Wed, 19 Dec 2018 18:06:46 +0100 |
| parents | 8fd203510d8b |
| children | 6c5d4281da4a |
| rev | line source |
|---|---|
| 1247 | 1 /** |
| 2 * Orthanc - A Lightweight, RESTful DICOM Store | |
| 1900 | 3 * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics |
|
1288
6e7e5ed91c2d
upgrade to year 2015
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1286
diff
changeset
|
4 * Department, University Hospital of Liege, Belgium |
|
2447
878b59270859
upgrade to year 2018
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2244
diff
changeset
|
5 * Copyright (C) 2017-2018 Osimis S.A., Belgium |
| 1247 | 6 * |
| 7 * This program is free software: you can redistribute it and/or | |
| 8 * modify it under the terms of the GNU General Public License as | |
| 9 * published by the Free Software Foundation, either version 3 of the | |
| 10 * License, or (at your option) any later version. | |
| 11 * | |
| 12 * In addition, as a special exception, the copyright holders of this | |
| 13 * program give permission to link the code of its release with the | |
| 14 * OpenSSL project's "OpenSSL" library (or with modified versions of it | |
| 15 * that use the same license as the "OpenSSL" library), and distribute | |
| 16 * the linked executables. You must obey the GNU General Public License | |
| 17 * in all respects for all of the code used other than "OpenSSL". If you | |
| 18 * modify file(s) with this exception, you may extend this exception to | |
| 19 * your version of the file(s), but you are not obligated to do so. If | |
| 20 * you do not wish to do so, delete this exception statement from your | |
| 21 * version. If you delete this exception statement from all source files | |
| 22 * in the program, then also delete it here. | |
| 23 * | |
| 24 * This program is distributed in the hope that it will be useful, but | |
| 25 * WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| 27 * General Public License for more details. | |
| 28 * | |
| 29 * You should have received a copy of the GNU General Public License | |
| 30 * along with this program. If not, see <http://www.gnu.org/licenses/>. | |
| 31 **/ | |
| 32 | |
| 33 | |
| 34 #pragma once | |
| 35 | |
| 36 #include "../Core/DicomFormat/DicomMap.h" | |
|
3025
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
37 #include "../Core/FileStorage/FileInfo.h" |
|
1615
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
38 #include "../Core/FileStorage/IStorageArea.h" |
|
3025
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
39 #include "../Core/SQLite/ITransaction.h" |
|
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
40 |
|
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
41 #include "ExportedResource.h" |
|
1432
0ac74fa21db8
rename IServerIndexListener as IDatabaseListener
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1306
diff
changeset
|
42 #include "IDatabaseListener.h" |
|
3029
ea653ec47f31
new class: DatabaseConstraint
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3027
diff
changeset
|
43 #include "Search/DatabaseConstraint.h" |
|
3025
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
44 #include "Search/DatabaseLookup.h" |
| 1247 | 45 |
| 46 #include <list> | |
| 47 #include <boost/noncopyable.hpp> | |
| 48 | |
| 49 namespace Orthanc | |
| 50 { | |
| 51 class IDatabaseWrapper : public boost::noncopyable | |
| 52 { | |
| 53 public: | |
|
3019
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
54 class ITransaction : public boost::noncopyable |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
55 { |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
56 public: |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
57 virtual ~ITransaction() |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
58 { |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
59 } |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
60 |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
61 virtual void Begin() = 0; |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
62 |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
63 virtual void Rollback() = 0; |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
64 |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
65 virtual void Commit(int64_t fileSizeDelta) = 0; |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
66 }; |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
67 |
|
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
68 |
| 1247 | 69 virtual ~IDatabaseWrapper() |
| 70 { | |
| 71 } | |
| 72 | |
|
1672
4c5a85c3ff43
sample database plugin now working
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1668
diff
changeset
|
73 virtual void Open() = 0; |
|
4c5a85c3ff43
sample database plugin now working
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1668
diff
changeset
|
74 |
|
4c5a85c3ff43
sample database plugin now working
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1668
diff
changeset
|
75 virtual void Close() = 0; |
|
4c5a85c3ff43
sample database plugin now working
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1668
diff
changeset
|
76 |
| 1247 | 77 virtual void AddAttachment(int64_t id, |
| 78 const FileInfo& attachment) = 0; | |
| 79 | |
| 80 virtual void AttachChild(int64_t parent, | |
| 81 int64_t child) = 0; | |
| 82 | |
| 1286 | 83 virtual void ClearChanges() = 0; |
| 84 | |
| 85 virtual void ClearExportedResources() = 0; | |
| 1247 | 86 |
| 87 virtual int64_t CreateResource(const std::string& publicId, | |
| 88 ResourceType type) = 0; | |
| 89 | |
| 90 virtual void DeleteAttachment(int64_t id, | |
| 91 FileContentType attachment) = 0; | |
| 92 | |
| 93 virtual void DeleteMetadata(int64_t id, | |
| 94 MetadataType type) = 0; | |
| 95 | |
| 96 virtual void DeleteResource(int64_t id) = 0; | |
| 97 | |
| 98 virtual void FlushToDisk() = 0; | |
| 99 | |
|
1306
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
100 virtual bool HasFlushToDisk() const = 0; |
|
8cd5784a6d80
IDatabaseWrapper::HasFlushToDisk()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1302
diff
changeset
|
101 |
| 1301 | 102 virtual void GetAllMetadata(std::map<MetadataType, std::string>& target, |
| 1247 | 103 int64_t id) = 0; |
| 104 | |
|
3038
53d583d2c775
removing IDatabaseWrapper::LookupIdentifier()
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3036
diff
changeset
|
105 // TODO: REMOVE THIS |
|
1750
55d52567bebb
LookupResource implemented
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1746
diff
changeset
|
106 virtual void GetAllInternalIds(std::list<int64_t>& target, |
|
55d52567bebb
LookupResource implemented
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1746
diff
changeset
|
107 ResourceType resourceType) = 0; |
|
55d52567bebb
LookupResource implemented
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1746
diff
changeset
|
108 |
| 1247 | 109 virtual void GetAllPublicIds(std::list<std::string>& target, |
| 110 ResourceType resourceType) = 0; | |
| 111 | |
|
1509
0586ed8897f1
limit and since arguments while retrieving DICOM resources in the REST API
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1432
diff
changeset
|
112 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
|
113 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
|
114 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
|
115 size_t limit) = 0; |
| 1247 | 116 |
| 117 virtual void GetChanges(std::list<ServerIndexChange>& target /*out*/, | |
| 118 bool& done /*out*/, | |
| 119 int64_t since, | |
| 1302 | 120 uint32_t maxResults) = 0; |
| 1247 | 121 |
| 1301 | 122 virtual void GetChildrenInternalId(std::list<int64_t>& target, |
| 1247 | 123 int64_t id) = 0; |
| 124 | |
| 1301 | 125 virtual void GetChildrenPublicId(std::list<std::string>& target, |
| 1247 | 126 int64_t id) = 0; |
| 127 | |
| 128 virtual void GetExportedResources(std::list<ExportedResource>& target /*out*/, | |
| 129 bool& done /*out*/, | |
| 130 int64_t since, | |
| 1302 | 131 uint32_t maxResults) = 0; |
| 1247 | 132 |
| 133 virtual void GetLastChange(std::list<ServerIndexChange>& target /*out*/) = 0; | |
| 134 | |
| 135 virtual void GetLastExportedResource(std::list<ExportedResource>& target /*out*/) = 0; | |
| 136 | |
| 137 virtual void GetMainDicomTags(DicomMap& map, | |
| 138 int64_t id) = 0; | |
| 139 | |
| 140 virtual std::string GetPublicId(int64_t resourceId) = 0; | |
| 141 | |
| 142 virtual uint64_t GetResourceCount(ResourceType resourceType) = 0; | |
| 143 | |
| 144 virtual ResourceType GetResourceType(int64_t resourceId) = 0; | |
| 145 | |
| 146 virtual uint64_t GetTotalCompressedSize() = 0; | |
| 147 | |
| 148 virtual uint64_t GetTotalUncompressedSize() = 0; | |
| 149 | |
| 150 virtual bool IsExistingResource(int64_t internalId) = 0; | |
| 151 | |
| 152 virtual bool IsProtectedPatient(int64_t internalId) = 0; | |
| 153 | |
| 154 virtual void ListAvailableMetadata(std::list<MetadataType>& target, | |
| 155 int64_t id) = 0; | |
| 156 | |
| 1301 | 157 virtual void ListAvailableAttachments(std::list<FileContentType>& target, |
| 1247 | 158 int64_t id) = 0; |
| 159 | |
| 160 virtual void LogChange(int64_t internalId, | |
| 161 const ServerIndexChange& change) = 0; | |
| 162 | |
| 163 virtual void LogExportedResource(const ExportedResource& resource) = 0; | |
| 164 | |
| 165 virtual bool LookupAttachment(FileInfo& attachment, | |
| 166 int64_t id, | |
| 167 FileContentType contentType) = 0; | |
| 168 | |
| 169 virtual bool LookupGlobalProperty(std::string& target, | |
| 170 GlobalProperty property) = 0; | |
| 171 | |
| 172 virtual bool LookupMetadata(std::string& target, | |
| 173 int64_t id, | |
| 174 MetadataType type) = 0; | |
| 175 | |
| 176 virtual bool LookupParent(int64_t& parentId, | |
| 177 int64_t resourceId) = 0; | |
| 178 | |
| 1294 | 179 virtual bool LookupResource(int64_t& id, |
| 180 ResourceType& type, | |
| 181 const std::string& publicId) = 0; | |
| 1247 | 182 |
| 183 virtual bool SelectPatientToRecycle(int64_t& internalId) = 0; | |
| 184 | |
| 185 virtual bool SelectPatientToRecycle(int64_t& internalId, | |
| 186 int64_t patientIdToAvoid) = 0; | |
| 187 | |
| 188 virtual void SetGlobalProperty(GlobalProperty property, | |
| 189 const std::string& value) = 0; | |
| 190 | |
|
1668
de1413733c97
reconstructing main dicom tags
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1615
diff
changeset
|
191 virtual void ClearMainDicomTags(int64_t id) = 0; |
|
de1413733c97
reconstructing main dicom tags
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1615
diff
changeset
|
192 |
| 1286 | 193 virtual void SetMainDicomTag(int64_t id, |
| 194 const DicomTag& tag, | |
| 195 const std::string& value) = 0; | |
| 1247 | 196 |
| 1713 | 197 virtual void SetIdentifierTag(int64_t id, |
| 198 const DicomTag& tag, | |
| 199 const std::string& value) = 0; | |
| 200 | |
| 1247 | 201 virtual void SetMetadata(int64_t id, |
| 202 MetadataType type, | |
| 203 const std::string& value) = 0; | |
| 204 | |
| 205 virtual void SetProtectedPatient(int64_t internalId, | |
| 206 bool isProtected) = 0; | |
| 207 | |
|
3019
8336204d95dc
refactoring computation of disk size for recycling
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
2697
diff
changeset
|
208 virtual ITransaction* StartTransaction() = 0; |
| 1247 | 209 |
|
1432
0ac74fa21db8
rename IServerIndexListener as IDatabaseListener
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1306
diff
changeset
|
210 virtual void SetListener(IDatabaseListener& listener) = 0; |
|
1615
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
211 |
|
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
212 virtual unsigned int GetDatabaseVersion() = 0; |
|
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
213 |
|
c40fe92a68e7
Primitives to upgrade the database version in plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
1509
diff
changeset
|
214 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
|
215 IStorageArea& storageArea) = 0; |
|
3020
d207f6ac1f86
tracking disk size by the database engine to ensure consistency across transactions
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3019
diff
changeset
|
216 |
|
d207f6ac1f86
tracking disk size by the database engine to ensure consistency across transactions
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3019
diff
changeset
|
217 virtual bool IsDiskSizeAbove(uint64_t threshold) = 0; |
|
3025
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
218 |
|
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
219 virtual void ApplyLookupResources(std::vector<std::string>& resourcesId, |
|
3036
8fd203510d8b
moving LookupIdentifierQuery to the graveyard
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3031
diff
changeset
|
220 std::vector<std::string>* instancesId, // Can be NULL if not needed |
|
3029
ea653ec47f31
new class: DatabaseConstraint
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3027
diff
changeset
|
221 const std::vector<DatabaseConstraint>& lookup, |
|
3025
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
222 ResourceType queryLevel, |
|
039a9d262d64
preparing to speed up find in databases
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
3020
diff
changeset
|
223 size_t limit) = 0; |
| 1247 | 224 }; |
| 225 } |