Mercurial > hg > orthanc

comparison Core/RestApi/RestApiHierarchy.h @ 969:3dce528b0cc2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
RestApiHierarchy
author Sebastien Jodogne <s.jodogne@gmail.com>
date Mon, 30 Jun 2014 13:17:49 +0200
parents
children 1a3817d84f39
comparison
equal deleted inserted replaced
968:8ed284e79850 969:3dce528b0cc2
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
146 void Register(const RestApiPath& path,
147 RestApi::GetHandler handler);
148
149 void Register(const RestApiPath& path,
150 RestApi::PutHandler handler);
151
152 void Register(const RestApiPath& path,
153 RestApi::PostHandler handler);
154
155 void Register(const RestApiPath& path,
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 }