Mercurial > hg > orthanc
view OrthancServer/Plugins/Engine/OrthancPluginDatabase.h @ 4754:00044831357a
fix doc
author | Alain Mazy <am@osimis.io> |
---|---|
date | Sat, 17 Jul 2021 13:04:54 +0200 |
parents | 5fabef29c4ff |
children | f0038043fb97 7053502fbf97 |
line wrap: on
line source
/** * Orthanc - A Lightweight, RESTful DICOM Store * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics * Department, University Hospital of Liege, Belgium * Copyright (C) 2017-2021 Osimis S.A., Belgium * * This program is free software: you can redistribute it and/or * modify it under the terms of the GNU General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * In addition, as a special exception, the copyright holders of this * program give permission to link the code of its release with the * OpenSSL project's "OpenSSL" library (or with modified versions of it * that use the same license as the "OpenSSL" library), and distribute * the linked executables. You must obey the GNU General Public License * in all respects for all of the code used other than "OpenSSL". If you * modify file(s) with this exception, you may extend this exception to * your version of the file(s), but you are not obligated to do so. If * you do not wish to do so, delete this exception statement from your * version. If you delete this exception statement from all source files * in the program, then also delete it here. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. **/ #pragma once #if ORTHANC_ENABLE_PLUGINS == 1 #include "../../../OrthancFramework/Sources/SharedLibrary.h" #include "../../Sources/Database/IDatabaseWrapper.h" #include "../Include/orthanc/OrthancCDatabasePlugin.h" #include "PluginsErrorDictionary.h" #include <boost/thread/recursive_mutex.hpp> namespace Orthanc { /** * This class is for backward compatibility with database plugins * that don't use the primitives introduced in Orthanc 1.9.2 to deal * with concurrent read-only transactions. * * In Orthanc <= 1.9.1, Orthanc assumed that at most 1 single thread * was accessing the database plugin at anytime, in order to match * the SQLite model. Read-write accesses assumed the plugin to run * the SQL statement "START TRANSACTION SERIALIZABLE" so as to be * able to rollback the modifications. Read-only accesses didn't * start a transaction, as they were protected by the global mutex. **/ class OrthancPluginDatabase : public IDatabaseWrapper { private: class Transaction; /** * We need a "recursive_mutex" because of "AnswerReceived()" that * is called by the "answer" primitives of the database SDK once a * transaction is running. **/ boost::recursive_mutex mutex_; SharedLibrary& library_; PluginsErrorDictionary& errorDictionary_; OrthancPluginDatabaseBackend backend_; OrthancPluginDatabaseExtensions extensions_; void* payload_; Transaction* activeTransaction_; bool fastGetTotalSize_; uint64_t currentDiskSize_; OrthancPluginDatabaseContext* GetContext() { return reinterpret_cast<OrthancPluginDatabaseContext*>(this); } void CheckSuccess(OrthancPluginErrorCode code); public: OrthancPluginDatabase(SharedLibrary& library, PluginsErrorDictionary& errorDictionary, const OrthancPluginDatabaseBackend& backend, const OrthancPluginDatabaseExtensions* extensions, size_t extensionsSize, void *payload); virtual void Open() ORTHANC_OVERRIDE; virtual void Close() ORTHANC_OVERRIDE; const SharedLibrary& GetSharedLibrary() const { return library_; } virtual void FlushToDisk() ORTHANC_OVERRIDE { } virtual bool HasFlushToDisk() const ORTHANC_OVERRIDE { return false; } virtual IDatabaseWrapper::ITransaction* StartTransaction(TransactionType type, IDatabaseListener& listener) ORTHANC_OVERRIDE; virtual unsigned int GetDatabaseVersion() ORTHANC_OVERRIDE; virtual void Upgrade(unsigned int targetVersion, IStorageArea& storageArea) ORTHANC_OVERRIDE; virtual bool HasRevisionsSupport() const ORTHANC_OVERRIDE { return false; // No support for revisions in old API } void AnswerReceived(const _OrthancPluginDatabaseAnswer& answer); }; } #endif