git migration: Refactor the ASTERISK_FILE_VERSION macro
[asterisk/asterisk.git] / res / res_ari_sounds.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2012 - 2013, Digium, Inc.
5  *
6  * David M. Lee, II <dlee@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*
20  * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
21  * !!!!!                               DO NOT EDIT                        !!!!!
22  * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
23  * This file is generated by a mustache template. Please see the original
24  * template in rest-api-templates/res_ari_resource.c.mustache
25  */
26
27 /*! \file
28  *
29  * \brief Sound resources
30  *
31  * \author David M. Lee, II <dlee@digium.com>
32  */
33
34 /*** MODULEINFO
35         <depend type="module">res_ari</depend>
36         <depend type="module">res_stasis</depend>
37         <support_level>core</support_level>
38  ***/
39
40 #include "asterisk.h"
41
42 ASTERISK_REGISTER_FILE()
43
44 #include "asterisk/app.h"
45 #include "asterisk/module.h"
46 #include "asterisk/stasis_app.h"
47 #include "ari/resource_sounds.h"
48 #if defined(AST_DEVMODE)
49 #include "ari/ari_model_validators.h"
50 #endif
51
52 #define MAX_VALS 128
53
54 int ast_ari_sounds_list_parse_body(
55         struct ast_json *body,
56         struct ast_ari_sounds_list_args *args)
57 {
58         struct ast_json *field;
59         /* Parse query parameters out of it */
60         field = ast_json_object_get(body, "lang");
61         if (field) {
62                 args->lang = ast_json_string_get(field);
63         }
64         field = ast_json_object_get(body, "format");
65         if (field) {
66                 args->format = ast_json_string_get(field);
67         }
68         return 0;
69 }
70
71 /*!
72  * \brief Parameter parsing callback for /sounds.
73  * \param get_params GET parameters in the HTTP request.
74  * \param path_vars Path variables extracted from the request.
75  * \param headers HTTP headers.
76  * \param[out] response Response to the HTTP request.
77  */
78 static void ast_ari_sounds_list_cb(
79         struct ast_tcptls_session_instance *ser,
80         struct ast_variable *get_params, struct ast_variable *path_vars,
81         struct ast_variable *headers, struct ast_ari_response *response)
82 {
83         struct ast_ari_sounds_list_args args = {};
84         struct ast_variable *i;
85         RAII_VAR(struct ast_json *, body, NULL, ast_json_unref);
86 #if defined(AST_DEVMODE)
87         int is_valid;
88         int code;
89 #endif /* AST_DEVMODE */
90
91         for (i = get_params; i; i = i->next) {
92                 if (strcmp(i->name, "lang") == 0) {
93                         args.lang = (i->value);
94                 } else
95                 if (strcmp(i->name, "format") == 0) {
96                         args.format = (i->value);
97                 } else
98                 {}
99         }
100         /* Look for a JSON request entity */
101         body = ast_http_get_json(ser, headers);
102         if (!body) {
103                 switch (errno) {
104                 case EFBIG:
105                         ast_ari_response_error(response, 413, "Request Entity Too Large", "Request body too large");
106                         goto fin;
107                 case ENOMEM:
108                         ast_ari_response_error(response, 500, "Internal Server Error", "Error processing request");
109                         goto fin;
110                 case EIO:
111                         ast_ari_response_error(response, 400, "Bad Request", "Error parsing request body");
112                         goto fin;
113                 }
114         }
115         if (ast_ari_sounds_list_parse_body(body, &args)) {
116                 ast_ari_response_alloc_failed(response);
117                 goto fin;
118         }
119         ast_ari_sounds_list(headers, &args, response);
120 #if defined(AST_DEVMODE)
121         code = response->response_code;
122
123         switch (code) {
124         case 0: /* Implementation is still a stub, or the code wasn't set */
125                 is_valid = response->message == NULL;
126                 break;
127         case 500: /* Internal Server Error */
128         case 501: /* Not Implemented */
129                 is_valid = 1;
130                 break;
131         default:
132                 if (200 <= code && code <= 299) {
133                         is_valid = ast_ari_validate_list(response->message,
134                                 ast_ari_validate_sound_fn());
135                 } else {
136                         ast_log(LOG_ERROR, "Invalid error response %d for /sounds\n", code);
137                         is_valid = 0;
138                 }
139         }
140
141         if (!is_valid) {
142                 ast_log(LOG_ERROR, "Response validation failed for /sounds\n");
143                 ast_ari_response_error(response, 500,
144                         "Internal Server Error", "Response validation failed");
145         }
146 #endif /* AST_DEVMODE */
147
148 fin: __attribute__((unused))
149         return;
150 }
151 /*!
152  * \brief Parameter parsing callback for /sounds/{soundId}.
153  * \param get_params GET parameters in the HTTP request.
154  * \param path_vars Path variables extracted from the request.
155  * \param headers HTTP headers.
156  * \param[out] response Response to the HTTP request.
157  */
158 static void ast_ari_sounds_get_cb(
159         struct ast_tcptls_session_instance *ser,
160         struct ast_variable *get_params, struct ast_variable *path_vars,
161         struct ast_variable *headers, struct ast_ari_response *response)
162 {
163         struct ast_ari_sounds_get_args args = {};
164         struct ast_variable *i;
165         RAII_VAR(struct ast_json *, body, NULL, ast_json_unref);
166 #if defined(AST_DEVMODE)
167         int is_valid;
168         int code;
169 #endif /* AST_DEVMODE */
170
171         for (i = path_vars; i; i = i->next) {
172                 if (strcmp(i->name, "soundId") == 0) {
173                         args.sound_id = (i->value);
174                 } else
175                 {}
176         }
177         ast_ari_sounds_get(headers, &args, response);
178 #if defined(AST_DEVMODE)
179         code = response->response_code;
180
181         switch (code) {
182         case 0: /* Implementation is still a stub, or the code wasn't set */
183                 is_valid = response->message == NULL;
184                 break;
185         case 500: /* Internal Server Error */
186         case 501: /* Not Implemented */
187                 is_valid = 1;
188                 break;
189         default:
190                 if (200 <= code && code <= 299) {
191                         is_valid = ast_ari_validate_sound(
192                                 response->message);
193                 } else {
194                         ast_log(LOG_ERROR, "Invalid error response %d for /sounds/{soundId}\n", code);
195                         is_valid = 0;
196                 }
197         }
198
199         if (!is_valid) {
200                 ast_log(LOG_ERROR, "Response validation failed for /sounds/{soundId}\n");
201                 ast_ari_response_error(response, 500,
202                         "Internal Server Error", "Response validation failed");
203         }
204 #endif /* AST_DEVMODE */
205
206 fin: __attribute__((unused))
207         return;
208 }
209
210 /*! \brief REST handler for /api-docs/sounds.{format} */
211 static struct stasis_rest_handlers sounds_soundId = {
212         .path_segment = "soundId",
213         .is_wildcard = 1,
214         .callbacks = {
215                 [AST_HTTP_GET] = ast_ari_sounds_get_cb,
216         },
217         .num_children = 0,
218         .children = {  }
219 };
220 /*! \brief REST handler for /api-docs/sounds.{format} */
221 static struct stasis_rest_handlers sounds = {
222         .path_segment = "sounds",
223         .callbacks = {
224                 [AST_HTTP_GET] = ast_ari_sounds_list_cb,
225         },
226         .num_children = 1,
227         .children = { &sounds_soundId, }
228 };
229
230 static int load_module(void)
231 {
232         int res = 0;
233         stasis_app_ref();
234         res |= ast_ari_add_handler(&sounds);
235         return res;
236 }
237
238 static int unload_module(void)
239 {
240         ast_ari_remove_handler(&sounds);
241         stasis_app_unref();
242         return 0;
243 }
244
245 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT, "RESTful API module - Sound resources",
246         .support_level = AST_MODULE_SUPPORT_CORE,
247         .load = load_module,
248         .unload = unload_module,
249         .nonoptreq = "res_ari,res_stasis",
250         );