comparison Core/DicomNetworking/DicomAssociation.h @ 3825:4570c57668a8

refactoring DicomUserConnection as Dicom[Control|Store]UserConnection
author Sebastien Jodogne <s.jodogne@gmail.com>
date Fri, 10 Apr 2020 16:04:54 +0200
parents
children
comparison
equal deleted inserted replaced
3817:37e20bbf25f5 3825:4570c57668a8
1 /**
2 * Orthanc - A Lightweight, RESTful DICOM Store
3 * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics
4 * Department, University Hospital of Liege, Belgium
5 * Copyright (C) 2017-2020 Osimis S.A., Belgium
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 #if ORTHANC_ENABLE_DCMTK_NETWORKING != 1
37 # error The macro ORTHANC_ENABLE_DCMTK_NETWORKING must be set to 1
38 #endif
39
40 #include "DicomAssociationParameters.h"
41
42 #include <dcmtk/dcmnet/dimse.h>
43
44 #include <stdint.h> // For uint8_t
45 #include <boost/noncopyable.hpp>
46 #include <set>
47
48 namespace Orthanc
49 {
50 class DicomAssociation : public boost::noncopyable
51 {
52 private:
53 // This is the maximum number of presentation context IDs (the
54 // number of odd integers between 1 and 255)
55 // http://dicom.nema.org/medical/dicom/2019e/output/chtml/part08/sect_9.3.2.2.html
56 static const size_t MAX_PROPOSED_PRESENTATIONS = 128;
57
58 struct ProposedPresentationContext
59 {
60 std::string abstractSyntax_;
61 std::set<DicomTransferSyntax> transferSyntaxes_;
62 };
63
64 typedef std::map<std::string, std::map<DicomTransferSyntax, uint8_t> >
65 AcceptedPresentationContexts;
66
67 DicomAssociationRole role_;
68 bool isOpen_;
69 std::vector<ProposedPresentationContext> proposed_;
70 AcceptedPresentationContexts accepted_;
71 T_ASC_Network* net_;
72 T_ASC_Parameters* params_;
73 T_ASC_Association* assoc_;
74
75 void Initialize();
76
77 void CheckConnecting(const DicomAssociationParameters& parameters,
78 const OFCondition& cond);
79
80 void CloseInternal();
81
82 void AddAccepted(const std::string& abstractSyntax,
83 DicomTransferSyntax syntax,
84 uint8_t presentationContextId);
85
86 public:
87 DicomAssociation()
88 {
89 Initialize();
90 }
91
92 ~DicomAssociation();
93
94 bool IsOpen() const
95 {
96 return isOpen_;
97 }
98
99 void SetRole(DicomAssociationRole role);
100
101 void ClearPresentationContexts();
102
103 void Open(const DicomAssociationParameters& parameters);
104
105 void Close();
106
107 bool LookupAcceptedPresentationContext(
108 std::map<DicomTransferSyntax, uint8_t>& target,
109 const std::string& abstractSyntax) const;
110
111 void ProposeGenericPresentationContext(const std::string& abstractSyntax);
112
113 void ProposePresentationContext(const std::string& abstractSyntax,
114 DicomTransferSyntax transferSyntax);
115
116 size_t GetRemainingPropositions() const;
117
118 void ProposePresentationContext(
119 const std::string& abstractSyntax,
120 const std::set<DicomTransferSyntax>& transferSyntaxes);
121
122 T_ASC_Association& GetDcmtkAssociation() const;
123
124 T_ASC_Network& GetDcmtkNetwork() const;
125
126 static void CheckCondition(const OFCondition& cond,
127 const DicomAssociationParameters& parameters,
128 const std::string& command);
129
130 static void ReportStorageCommitment(
131 const DicomAssociationParameters& parameters,
132 const std::string& transactionUid,
133 const std::vector<std::string>& sopClassUids,
134 const std::vector<std::string>& sopInstanceUids,
135 const std::vector<StorageCommitmentFailureReason>& failureReasons);
136
137 static void RequestStorageCommitment(
138 const DicomAssociationParameters& parameters,
139 const std::string& transactionUid,
140 const std::vector<std::string>& sopClassUids,
141 const std::vector<std::string>& sopInstanceUids);
142 };
143 }