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
|
|
37 #include <list>
|
|
38
|
|
39 namespace Orthanc
|
|
40 {
|
|
41 class RestApiHierarchy
|
|
42 {
|
|
43 private:
|
|
44 struct Handlers
|
|
45 {
|
|
46 typedef std::list<RestApi::GetHandler> GetHandlers;
|
|
47 typedef std::list<RestApi::PostHandler> PostHandlers;
|
|
48 typedef std::list<RestApi::PutHandler> PutHandlers;
|
|
49 typedef std::list<RestApi::DeleteHandler> DeleteHandlers;
|
|
50
|
|
51 GetHandlers getHandlers_;
|
|
52 PostHandlers postHandlers_;
|
|
53 PutHandlers putHandlers_;
|
|
54 DeleteHandlers deleteHandlers_;
|
|
55
|
|
56 bool HasGet() const
|
|
57 {
|
|
58 return getHandlers_.size() > 0;
|
|
59 }
|
|
60
|
|
61 void Register(RestApi::GetHandler handler)
|
|
62 {
|
|
63 getHandlers_.push_back(handler);
|
|
64 }
|
|
65
|
|
66 void Register(RestApi::PutHandler handler)
|
|
67 {
|
|
68 putHandlers_.push_back(handler);
|
|
69 }
|
|
70
|
|
71 void Register(RestApi::PostHandler handler)
|
|
72 {
|
|
73 postHandlers_.push_back(handler);
|
|
74 }
|
|
75
|
|
76 void Register(RestApi::DeleteHandler handler)
|
|
77 {
|
|
78 deleteHandlers_.push_back(handler);
|
|
79 }
|
|
80
|
|
81 bool IsEmpty() const;
|
|
82 };
|
|
83
|
|
84
|
|
85 typedef std::map<std::string, RestApiHierarchy*> Children;
|
|
86 typedef bool (*ResourceCallback) (Handlers& handlers,
|
|
87 const UriComponents& uri,
|
|
88 const RestApiPath::Components& components,
|
|
89 const UriComponents& trailing,
|
|
90 void* call);
|
|
91
|
|
92 Handlers handlers_;
|
|
93 Children children_;
|
|
94 Children wildcardChildren_;
|
|
95 Handlers universalHandlers_;
|
|
96
|
|
97
|
|
98 static RestApiHierarchy& AddChild(Children& children,
|
|
99 const std::string& name);
|
|
100
|
|
101 static void DeleteChildren(Children& children);
|
|
102
|
|
103 template <typename Handler>
|
|
104 void RegisterInternal(const RestApiPath& path,
|
|
105 Handler handler,
|
|
106 size_t level);
|
|
107
|
|
108 bool LookupHandler(RestApiPath::Components& components,
|
|
109 const UriComponents& uri,
|
|
110 ResourceCallback callback,
|
|
111 size_t level,
|
|
112 void* call);
|
|
113
|
|
114 bool GetDirectory(Json::Value& result,
|
|
115 const UriComponents& uri,
|
|
116 size_t level);
|
|
117
|
|
118 static bool GetCallback(Handlers& handlers,
|
|
119 const UriComponents& uri,
|
|
120 const RestApiPath::Components& components,
|
|
121 const UriComponents& trailing,
|
|
122 void* call);
|
|
123
|
|
124 static bool PostCallback(Handlers& handlers,
|
|
125 const UriComponents& uri,
|
|
126 const RestApiPath::Components& components,
|
|
127 const UriComponents& trailing,
|
|
128 void* call);
|
|
129
|
|
130 static bool PutCallback(Handlers& handlers,
|
|
131 const UriComponents& uri,
|
|
132 const RestApiPath::Components& components,
|
|
133 const UriComponents& trailing,
|
|
134 void* call);
|
|
135
|
|
136 static bool DeleteCallback(Handlers& handlers,
|
|
137 const UriComponents& uri,
|
|
138 const RestApiPath::Components& components,
|
|
139 const UriComponents& trailing,
|
|
140 void* call);
|
|
141
|
|
142
|
|
143 public:
|
|
144 ~RestApiHierarchy();
|
|
145
|
970
|
146 void Register(const std::string& uri,
|
969
|
147 RestApi::GetHandler handler);
|
|
148
|
970
|
149 void Register(const std::string& uri,
|
969
|
150 RestApi::PutHandler handler);
|
|
151
|
970
|
152 void Register(const std::string& uri,
|
969
|
153 RestApi::PostHandler handler);
|
|
154
|
970
|
155 void Register(const std::string& uri,
|
969
|
156 RestApi::DeleteHandler handler);
|
|
157
|
|
158 void CreateSiteMap(Json::Value& target) const;
|
|
159
|
|
160 bool GetDirectory(Json::Value& result,
|
|
161 const UriComponents& uri)
|
|
162 {
|
|
163 return GetDirectory(result, uri, 0);
|
|
164 }
|
|
165
|
|
166 bool Handle(RestApi::GetCall& call,
|
|
167 const UriComponents& uri);
|
|
168
|
|
169 bool Handle(RestApi::PutCall& call,
|
|
170 const UriComponents& uri);
|
|
171
|
|
172 bool Handle(RestApi::PostCall& call,
|
|
173 const UriComponents& uri);
|
|
174
|
|
175 bool Handle(RestApi::DeleteCall& call,
|
|
176 const UriComponents& uri);
|
|
177 };
|
|
178 }
|