Mercurial > hg > orthanc
view OrthancServer/Sources/ServerContext.h @ 5077:6c0ed4a98bb0
fix
author | Alain Mazy <am@osimis.io> |
---|---|
date | Mon, 29 Aug 2022 17:13:45 +0200 |
parents | d4e5ca0c9307 |
children | d7274e43ea7c 7547c7dfd017 |
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-2022 Osimis S.A., Belgium * Copyright (C) 2021-2022 Sebastien Jodogne, ICTEAM UCLouvain, 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. * * 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 #include "IServerListener.h" #include "LuaScripting.h" #include "OrthancHttpHandler.h" #include "ServerIndex.h" #include "ServerJobs/IStorageCommitmentFactory.h" #include "../../OrthancFramework/Sources/DicomFormat/DicomElement.h" #include "../../OrthancFramework/Sources/DicomParsing/DicomModification.h" #include "../../OrthancFramework/Sources/DicomParsing/IDicomTranscoder.h" #include "../../OrthancFramework/Sources/DicomParsing/ParsedDicomCache.h" #include "../../OrthancFramework/Sources/FileStorage/StorageCache.h" #include "../../OrthancFramework/Sources/MultiThreading/Semaphore.h" namespace Orthanc { class DicomInstanceToStore; class IStorageArea; class JobsEngine; class MetricsRegistry; class OrthancPlugins; class ParsedDicomFile; class RestApiOutput; class SetOfInstancesJob; class SharedArchive; class SharedMessageQueue; class StorageCommitmentReports; /** * This class is responsible for maintaining the storage area on the * filesystem (including compression), as well as the index of the * DICOM store. It implements the required locking mechanisms. **/ class ServerContext : public IStorageCommitmentFactory, public IDicomTranscoder, private JobsRegistry::IObserver { friend class ServerIndex; // To access "RemoveFile()" public: class ILookupVisitor : public boost::noncopyable { public: virtual ~ILookupVisitor() { } virtual bool IsDicomAsJsonNeeded() const = 0; virtual void MarkAsComplete() = 0; // NB: "dicomAsJson" must *not* be deleted, and can be NULL if // "!IsDicomAsJsonNeeded()" virtual void Visit(const std::string& publicId, const std::string& instanceId, const DicomMap& mainDicomTags, const Json::Value* dicomAsJson) = 0; }; struct StoreResult { private: StoreStatus status_; uint16_t cstoreStatusCode_; // uint16_t httpStatusCode_; // for future use public: StoreResult(); void SetStatus(StoreStatus status) { status_ = status; } StoreStatus GetStatus() { return status_; } void SetCStoreStatusCode(uint16_t statusCode) { cstoreStatusCode_ = statusCode; } uint16_t GetCStoreStatusCode() { return cstoreStatusCode_; } }; private: class LuaServerListener : public IServerListener { private: ServerContext& context_; public: explicit LuaServerListener(ServerContext& context) : context_(context) { } virtual void SignalStoredInstance(const std::string& publicId, const DicomInstanceToStore& instance, const Json::Value& simplifiedTags) ORTHANC_OVERRIDE { context_.mainLua_.SignalStoredInstance(publicId, instance, simplifiedTags); } virtual void SignalChange(const ServerIndexChange& change) ORTHANC_OVERRIDE { context_.mainLua_.SignalChange(change); } virtual bool FilterIncomingInstance(const DicomInstanceToStore& instance, const Json::Value& simplified) ORTHANC_OVERRIDE { return context_.filterLua_.FilterIncomingInstance(instance, simplified); } virtual bool FilterIncomingCStoreInstance(uint16_t& dimseStatus, const DicomInstanceToStore& instance, const Json::Value& simplified) ORTHANC_OVERRIDE { return context_.filterLua_.FilterIncomingCStoreInstance(dimseStatus, instance, simplified); } }; class ServerListener { private: IServerListener *listener_; std::string description_; public: ServerListener(IServerListener& listener, const std::string& description) : listener_(&listener), description_(description) { } IServerListener& GetListener() { return *listener_; } const std::string& GetDescription() { return description_; } }; typedef std::list<ServerListener> ServerListeners; static void ChangeThread(ServerContext* that, unsigned int sleepDelay); static void SaveJobsThread(ServerContext* that, unsigned int sleepDelay); void SaveJobsEngine(); virtual void SignalJobSubmitted(const std::string& jobId) ORTHANC_OVERRIDE; virtual void SignalJobSuccess(const std::string& jobId) ORTHANC_OVERRIDE; virtual void SignalJobFailure(const std::string& jobId) ORTHANC_OVERRIDE; ServerIndex index_; IStorageArea& area_; StorageCache storageCache_; bool compressionEnabled_; bool storeMD5_; Semaphore largeDicomThrottler_; // New in Orthanc 1.9.0 (notably for very large DICOM files in WSI) ParsedDicomCache dicomCache_; LuaScripting mainLua_; LuaScripting filterLua_; LuaServerListener luaListener_; std::unique_ptr<SharedArchive> mediaArchive_; // The "JobsEngine" must be *after* "LuaScripting", as // "LuaScripting" embeds "LuaJobManager" that registers as an // observer to "SequenceOfOperationsJob", whose lifetime // corresponds to that of "JobsEngine". It must also be after // "mediaArchive_", as jobs might access this archive. JobsEngine jobsEngine_; #if ORTHANC_ENABLE_PLUGINS == 1 OrthancPlugins* plugins_; #endif ServerListeners listeners_; boost::shared_mutex listenersMutex_; bool done_; bool haveJobsChanged_; bool isJobsEngineUnserialized_; SharedMessageQueue pendingChanges_; boost::thread changeThread_; boost::thread saveJobsThread_; std::unique_ptr<SharedArchive> queryRetrieveArchive_; std::string defaultLocalAet_; OrthancHttpHandler httpHandler_; bool saveJobs_; FindStorageAccessMode findStorageAccessMode_; unsigned int limitFindInstances_; unsigned int limitFindResults_; std::unique_ptr<MetricsRegistry> metricsRegistry_; bool isHttpServerSecure_; bool isExecuteLuaEnabled_; bool overwriteInstances_; std::unique_ptr<StorageCommitmentReports> storageCommitmentReports_; bool transcodeDicomProtocol_; std::unique_ptr<IDicomTranscoder> dcmtkTranscoder_; BuiltinDecoderTranscoderOrder builtinDecoderTranscoderOrder_; bool isIngestTranscoding_; DicomTransferSyntax ingestTransferSyntax_; bool ingestTranscodingOfUncompressed_; bool ingestTranscodingOfCompressed_; // New in Orthanc 1.9.0 DicomTransferSyntax preferredTransferSyntax_; boost::mutex dynamicOptionsMutex_; bool isUnknownSopClassAccepted_; std::set<DicomTransferSyntax> acceptedTransferSyntaxes_; StoreResult StoreAfterTranscoding(std::string& resultPublicId, DicomInstanceToStore& dicom, StoreInstanceMode mode, bool isReconstruct); void PublishDicomCacheMetrics(); // This method must only be called from "ServerIndex"! void RemoveFile(const std::string& fileUuid, FileContentType type); // This DicomModification object is intended to be used as a // "rules engine" when de-identifying logs for C-Find, C-Get, and // C-Move queries (new in Orthanc 1.8.2) DicomModification logsDeidentifierRules_; bool deidentifyLogs_; public: class DicomCacheLocker : public boost::noncopyable { private: ServerContext& context_; std::string instancePublicId_; std::unique_ptr<ParsedDicomCache::Accessor> accessor_; std::unique_ptr<ParsedDicomFile> dicom_; size_t dicomSize_; std::unique_ptr<Semaphore::Locker> largeDicomLocker_; public: DicomCacheLocker(ServerContext& context, const std::string& instancePublicId); ~DicomCacheLocker(); ParsedDicomFile& GetDicom() const; }; ServerContext(IDatabaseWrapper& database, IStorageArea& area, bool unitTesting, size_t maxCompletedJobs); ~ServerContext(); void SetupJobsEngine(bool unitTesting, bool loadJobsFromDatabase); ServerIndex& GetIndex() { return index_; } void SetMaximumStorageCacheSize(size_t size) { return storageCache_.SetMaximumSize(size); } void SetCompressionEnabled(bool enabled); bool IsCompressionEnabled() const { return compressionEnabled_; } bool AddAttachment(int64_t& newRevision, const std::string& resourceId, FileContentType attachmentType, const void* data, size_t size, bool hasOldRevision, int64_t oldRevision, const std::string& oldMD5); StoreResult Store(std::string& resultPublicId, DicomInstanceToStore& dicom, StoreInstanceMode mode); StoreResult TranscodeAndStore(std::string& resultPublicId, DicomInstanceToStore* dicom, StoreInstanceMode mode, bool isReconstruct = false); void AnswerAttachment(RestApiOutput& output, const std::string& resourceId, FileContentType content); void ChangeAttachmentCompression(const std::string& resourceId, FileContentType attachmentType, CompressionType compression); void ReadDicomAsJson(Json::Value& result, const std::string& instancePublicId, const std::set<DicomTag>& ignoreTagLength); void ReadDicomAsJson(Json::Value& result, const std::string& instancePublicId); void ReadDicom(std::string& dicom, const std::string& instancePublicId); void ReadDicomForHeader(std::string& dicom, const std::string& instancePublicId); bool ReadDicomUntilPixelData(std::string& dicom, const std::string& instancePublicId); // This method is for low-level operations on "/instances/.../attachments/..." void ReadAttachment(std::string& result, int64_t& revision, const std::string& instancePublicId, FileContentType content, bool uncompressIfNeeded, bool skipCache = false); void SetStoreMD5ForAttachments(bool storeMD5); bool IsStoreMD5ForAttachments() const { return storeMD5_; } JobsEngine& GetJobsEngine() { return jobsEngine_; } bool DeleteResource(Json::Value& remainingAncestor, const std::string& uuid, ResourceType expectedType); void SignalChange(const ServerIndexChange& change); SharedArchive& GetQueryRetrieveArchive() { return *queryRetrieveArchive_; } SharedArchive& GetMediaArchive() { return *mediaArchive_; } const std::string& GetDefaultLocalApplicationEntityTitle() const { return defaultLocalAet_; } LuaScripting& GetLuaScripting() { return mainLua_; } OrthancHttpHandler& GetHttpHandler() { return httpHandler_; } void Stop(); void Apply(ILookupVisitor& visitor, const DatabaseLookup& lookup, ResourceType queryLevel, size_t since, size_t limit); bool LookupOrReconstructMetadata(std::string& target, const std::string& publicId, ResourceType level, MetadataType type); /** * Management of the plugins **/ #if ORTHANC_ENABLE_PLUGINS == 1 void SetPlugins(OrthancPlugins& plugins); void ResetPlugins(); const OrthancPlugins& GetPlugins() const; OrthancPlugins& GetPlugins(); #endif bool HasPlugins() const; void AddChildInstances(SetOfInstancesJob& job, const std::string& publicId); void SignalUpdatedModalities(); void SignalUpdatedPeers(); MetricsRegistry& GetMetricsRegistry() { return *metricsRegistry_; } void SetHttpServerSecure(bool isSecure) { isHttpServerSecure_ = isSecure; } bool IsHttpServerSecure() const { return isHttpServerSecure_; } void SetExecuteLuaEnabled(bool enabled) { isExecuteLuaEnabled_ = enabled; } bool IsExecuteLuaEnabled() const { return isExecuteLuaEnabled_; } void SetOverwriteInstances(bool overwrite) { overwriteInstances_ = overwrite; } bool IsOverwriteInstances() const { return overwriteInstances_; } virtual IStorageCommitmentFactory::ILookupHandler* CreateStorageCommitment(const std::string& jobId, const std::string& transactionUid, const std::vector<std::string>& sopClassUids, const std::vector<std::string>& sopInstanceUids, const std::string& remoteAet, const std::string& calledAet) ORTHANC_OVERRIDE; StorageCommitmentReports& GetStorageCommitmentReports() { return *storageCommitmentReports_; } ImageAccessor* DecodeDicomFrame(const std::string& publicId, unsigned int frameIndex); ImageAccessor* DecodeDicomFrame(const DicomInstanceToStore& dicom, unsigned int frameIndex); ImageAccessor* DecodeDicomFrame(const void* dicom, size_t size, unsigned int frameIndex); void StoreWithTranscoding(std::string& sopClassUid, std::string& sopInstanceUid, DicomStoreUserConnection& connection, const std::string& dicom, bool hasMoveOriginator, const std::string& moveOriginatorAet, uint16_t moveOriginatorId); // This method can be used even if the global option // "TranscodeDicomProtocol" is set to "false" virtual bool Transcode(DicomImage& target, DicomImage& source /* in, "GetParsed()" possibly modified */, const std::set<DicomTransferSyntax>& allowedSyntaxes, bool allowNewSopInstanceUid) ORTHANC_OVERRIDE; bool IsTranscodeDicomProtocol() const { return transcodeDicomProtocol_; } const std::string& GetDeidentifiedContent(const DicomElement& element) const; void GetAcceptedTransferSyntaxes(std::set<DicomTransferSyntax>& syntaxes); void SetAcceptedTransferSyntaxes(const std::set<DicomTransferSyntax>& syntaxes); bool IsUnknownSopClassAccepted(); void SetUnknownSopClassAccepted(bool accepted); bool ExpandResource(Json::Value& target, const std::string& publicId, ResourceType level, DicomToJsonFormat format, const std::set<DicomTag>& requestedTags, bool allowStorageAccess); bool ExpandResource(Json::Value& target, const std::string& publicId, const DicomMap& mainDicomTags, // optional: the main dicom tags for the resource (if already available) const std::string& instanceId, // optional: the id of an instance for the resource const Json::Value* dicomAsJson, // optional: the dicom-as-json for the resource ResourceType level, DicomToJsonFormat format, const std::set<DicomTag>& requestedTags, bool allowStorageAccess); bool ExpandResource(ExpandedResource& target, const std::string& publicId, const DicomMap& mainDicomTags, // optional: the main dicom tags for the resource (if already available) const std::string& instanceId, // optional: the id of an instance for the resource const Json::Value* dicomAsJson, // optional: the dicom-as-json for the resource ResourceType level, const std::set<DicomTag>& requestedTags, ExpandResourceDbFlags expandFlags, bool allowStorageAccess); FindStorageAccessMode GetFindStorageAccessMode() const { return findStorageAccessMode_; } }; }