This patch adds a RESTful HTTP interface to Asterisk.
[asterisk/asterisk.git] / rest-api-templates / res_stasis_http_resource.c.mustache
1 {{#api_declaration}}
2 /*
3  * Asterisk -- An open source telephony toolkit.
4  *
5  * {{{copyright}}}
6  *
7  * {{{author}}}
8 {{! Template Copyright
9  * Copyright (C) 2013, Digium, Inc.
10  *
11  * David M. Lee, II <dlee@digium.com>
12 }}
13  *
14  * See http://www.asterisk.org for more information about
15  * the Asterisk project. Please do not directly contact
16  * any of the maintainers of this project for assistance;
17  * the project provides a web site, mailing lists and IRC
18  * channels for your use.
19  *
20  * This program is free software, distributed under the terms of
21  * the GNU General Public License Version 2. See the LICENSE file
22  * at the top of the source tree.
23  */
24
25 {{! Template for rendering the res_ module for an HTTP resource. }}
26 /*
27 {{> do-not-edit}}
28  * This file is generated by a mustache template. Please see the original
29  * template in rest-api-templates/res_stasis_http_resource.c.mustache
30  */
31
32 /*! \file
33  *
34  * \brief {{{description}}}
35  *
36  * \author {{{author}}}
37  */
38
39 /*** MODULEINFO
40         <depend type="module">res_stasis_http</depend>
41         <support_level>core</support_level>
42  ***/
43
44 #include "asterisk.h"
45
46 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
47
48 #include "asterisk/module.h"
49 #include "stasis_http/resource_{{name}}.h"
50
51 {{#apis}}
52 {{#operations}}
53 /*!
54  * \brief Parameter parsing callback for {{path}}.
55  * \param get_params GET parameters in the HTTP request.
56  * \param path_vars Path variables extracted from the request.
57  * \param headers HTTP headers.
58  * \param[out] response Response to the HTTP request.
59  */
60 static void stasis_http_{{c_nickname}}_cb(
61     struct ast_variable *get_params, struct ast_variable *path_vars,
62     struct ast_variable *headers, struct stasis_http_response *response)
63 {
64         struct ast_{{c_nickname}}_args args = {};
65 {{#has_parameters}}
66         struct ast_variable *i;
67
68 {{#has_query_parameters}}
69         for (i = get_params; i; i = i->next) {
70 {{#query_parameters}}
71                 if (strcmp(i->name, "{{name}}") == 0) {
72                         args.{{c_name}} = {{c_convert}}(i->value);
73                 } else
74 {{/query_parameters}}
75                 {}
76         }
77 {{/has_query_parameters}}
78 {{#has_path_parameters}}
79         for (i = path_vars; i; i = i->next) {
80 {{#path_parameters}}
81                 if (strcmp(i->name, "{{name}}") == 0) {
82                         args.{{c_name}} = {{c_convert}}(i->value);
83                 } else
84 {{/path_parameters}}
85                 {}
86         }
87 {{/has_path_parameters}}
88 {{/has_parameters}}
89         stasis_http_{{c_nickname}}(headers, &args, response);
90 }
91 {{/operations}}
92 {{/apis}}
93
94 {{! The rest_handler partial expands to the tree of stasis_rest_handlers }}
95 {{#root_path}}
96 {{> rest_handler}}
97 {{/root_path}}
98
99 static int load_module(void)
100 {
101         return stasis_http_add_handler(&{{root_full_name}});
102 }
103
104 static int unload_module(void)
105 {
106         stasis_http_remove_handler(&{{root_full_name}});
107         return 0;
108 }
109
110 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT,
111         "RESTful API module - {{{description}}}",
112         .load = load_module,
113         .unload = unload_module,
114         .nonoptreq = "res_stasis_http",
115         );
116 {{/api_declaration}}