969
|
1 /**
|
|
2 * Orthanc - A Lightweight, RESTful DICOM Store
|
|
3 * Copyright (C) 2012-2014 Medical Physics Department, CHU of Liege,
|
|
4 * Belgium
|
|
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
|
|
35 #include "RestApi.h"
|
|
36
|
972
|
37 #include "../OrthancException.h"
|
|
38
|
969
|
39 #include <list>
|
972
|
40 #include <set>
|
969
|
41
|
|
42 namespace Orthanc
|
|
43 {
|
|
44 class RestApiHierarchy
|
|
45 {
|
|
46 private:
|
972
|
47 class Handlers
|
969
|
48 {
|
972
|
49 private:
|
|
50 RestApi::GetHandler getHandler_;
|
|
51 RestApi::PostHandler postHandler_;
|
|
52 RestApi::PutHandler putHandler_;
|
|
53 RestApi::DeleteHandler deleteHandler_;
|
969
|
54
|
972
|
55 public:
|
|
56 Handlers();
|
|
57
|
|
58 bool HasHandler(HttpMethod method) const;
|
969
|
59
|
972
|
60 RestApi::GetHandler GetGetHandler() const;
|
|
61
|
|
62 RestApi::PutHandler GetPutHandler() const;
|
|
63
|
|
64 RestApi::PostHandler GetPostHandler() const;
|
|
65
|
|
66 RestApi::DeleteHandler GetDeleteHandler() const;
|
969
|
67
|
|
68 void Register(RestApi::GetHandler handler)
|
|
69 {
|
972
|
70 getHandler_ = handler;
|
969
|
71 }
|
|
72
|
|
73 void Register(RestApi::PutHandler handler)
|
|
74 {
|
972
|
75 putHandler_ = handler;
|
969
|
76 }
|
|
77
|
|
78 void Register(RestApi::PostHandler handler)
|
|
79 {
|
972
|
80 postHandler_ = handler;
|
969
|
81 }
|
|
82
|
|
83 void Register(RestApi::DeleteHandler handler)
|
|
84 {
|
972
|
85 deleteHandler_ = handler;
|
969
|
86 }
|
|
87
|
|
88 bool IsEmpty() const;
|
|
89 };
|
|
90
|
|
91
|
|
92 typedef std::map<std::string, RestApiHierarchy*> Children;
|
|
93 typedef bool (*ResourceCallback) (Handlers& handlers,
|
|
94 const UriComponents& uri,
|
|
95 const RestApiPath::Components& components,
|
|
96 const UriComponents& trailing,
|
|
97 void* call);
|
|
98
|
|
99 Handlers handlers_;
|
|
100 Children children_;
|
|
101 Children wildcardChildren_;
|
|
102 Handlers universalHandlers_;
|
|
103
|
|
104
|
|
105 static RestApiHierarchy& AddChild(Children& children,
|
|
106 const std::string& name);
|
|
107
|
|
108 static void DeleteChildren(Children& children);
|
|
109
|
|
110 template <typename Handler>
|
|
111 void RegisterInternal(const RestApiPath& path,
|
|
112 Handler handler,
|
|
113 size_t level);
|
|
114
|
|
115 bool LookupHandler(RestApiPath::Components& components,
|
|
116 const UriComponents& uri,
|
|
117 ResourceCallback callback,
|
|
118 size_t level,
|
|
119 void* call);
|
|
120
|
|
121 bool GetDirectory(Json::Value& result,
|
|
122 const UriComponents& uri,
|
|
123 size_t level);
|
|
124
|
|
125 static bool GetCallback(Handlers& handlers,
|
|
126 const UriComponents& uri,
|
|
127 const RestApiPath::Components& components,
|
|
128 const UriComponents& trailing,
|
|
129 void* call);
|
|
130
|
|
131 static bool PostCallback(Handlers& handlers,
|
|
132 const UriComponents& uri,
|
|
133 const RestApiPath::Components& components,
|
|
134 const UriComponents& trailing,
|
|
135 void* call);
|
|
136
|
|
137 static bool PutCallback(Handlers& handlers,
|
|
138 const UriComponents& uri,
|
|
139 const RestApiPath::Components& components,
|
|
140 const UriComponents& trailing,
|
|
141 void* call);
|
|
142
|
|
143 static bool DeleteCallback(Handlers& handlers,
|
|
144 const UriComponents& uri,
|
|
145 const RestApiPath::Components& components,
|
|
146 const UriComponents& trailing,
|
|
147 void* call);
|
|
148
|
|
149
|
|
150 public:
|
|
151 ~RestApiHierarchy();
|
|
152
|
970
|
153 void Register(const std::string& uri,
|
969
|
154 RestApi::GetHandler handler);
|
|
155
|
970
|
156 void Register(const std::string& uri,
|
969
|
157 RestApi::PutHandler handler);
|
|
158
|
970
|
159 void Register(const std::string& uri,
|
969
|
160 RestApi::PostHandler handler);
|
|
161
|
970
|
162 void Register(const std::string& uri,
|
969
|
163 RestApi::DeleteHandler handler);
|
|
164
|
|
165 void CreateSiteMap(Json::Value& target) const;
|
|
166
|
|
167 bool GetDirectory(Json::Value& result,
|
|
168 const UriComponents& uri)
|
|
169 {
|
|
170 return GetDirectory(result, uri, 0);
|
|
171 }
|
|
172
|
|
173 bool Handle(RestApi::GetCall& call,
|
|
174 const UriComponents& uri);
|
|
175
|
|
176 bool Handle(RestApi::PutCall& call,
|
|
177 const UriComponents& uri);
|
|
178
|
|
179 bool Handle(RestApi::PostCall& call,
|
|
180 const UriComponents& uri);
|
|
181
|
|
182 bool Handle(RestApi::DeleteCall& call,
|
|
183 const UriComponents& uri);
|
|
184 };
|
|
185 }
|