Shuffle RESTful URL's around.
[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         <depend type="module">res_stasis</depend>
42         <support_level>core</support_level>
43  ***/
44
45 #include "asterisk.h"
46
47 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
48
49 #include "asterisk/module.h"
50 #include "asterisk/stasis_app.h"
51 #include "stasis_http/resource_{{name}}.h"
52
53 {{#apis}}
54 {{#operations}}
55 {{#is_req}}
56 /*!
57  * \brief Parameter parsing callback for {{path}}.
58  * \param get_params GET parameters in the HTTP request.
59  * \param path_vars Path variables extracted from the request.
60  * \param headers HTTP headers.
61  * \param[out] response Response to the HTTP request.
62  */
63 static void stasis_http_{{c_nickname}}_cb(
64     struct ast_variable *get_params, struct ast_variable *path_vars,
65     struct ast_variable *headers, struct stasis_http_response *response)
66 {
67 {{> param_parsing}}
68         stasis_http_{{c_nickname}}(headers, &args, response);
69 }
70 {{/is_req}}
71 {{#is_websocket}}
72 static void stasis_http_{{c_nickname}}_ws_cb(struct ast_websocket *ws_session,
73         struct ast_variable *get_params, struct ast_variable *headers)
74 {
75         RAII_VAR(struct ast_websocket *, s, ws_session, ast_websocket_unref);
76         RAII_VAR(struct ari_websocket_session *, session, NULL, ao2_cleanup);
77 {{#has_path_parameters}}
78         /* TODO: It's not immediately obvious how to pass path params through
79          * the websocket code to this callback. Not needed right now, so we'll
80          * just punt. */
81         struct ast_variable *path_vars = NULL;
82 {{/has_path_parameters}}
83 {{> param_parsing}}
84         session = ari_websocket_session_create(ws_session);
85         if (!session) {
86                 ast_log(LOG_ERROR, "Failed to create ARI session\n");
87                 return;
88         }
89         ari_websocket_{{c_nickname}}(session, headers, &args);
90 }
91 {{/is_websocket}}
92 {{/operations}}
93 {{/apis}}
94
95 {{! The rest_handler partial expands to the tree of stasis_rest_handlers }}
96 {{#root_path}}
97 {{> rest_handler}}
98 {{/root_path}}
99
100 static int load_module(void)
101 {
102         int res = 0;
103 {{#apis}}
104 {{#has_websocket}}
105         {{full_name}}.ws_server = ast_websocket_server_create();
106         if (!{{full_name}}.ws_server) {
107                 return AST_MODULE_LOAD_FAILURE;
108         }
109 {{/has_websocket}}
110 {{#operations}}
111 {{#is_websocket}}
112         res |= ast_websocket_server_add_protocol({{full_name}}.ws_server,
113                 "{{websocket_protocol}}", stasis_http_{{c_nickname}}_ws_cb);
114 {{/is_websocket}}
115 {{/operations}}
116 {{/apis}}
117         stasis_app_ref();
118         res |= stasis_http_add_handler(&{{root_full_name}});
119         return res;
120 }
121
122 static int unload_module(void)
123 {
124         stasis_http_remove_handler(&{{root_full_name}});
125 {{#apis}}
126 {{#has_websocket}}
127         ao2_cleanup({{full_name}}.ws_server);
128         {{full_name}}.ws_server = NULL;
129 {{/has_websocket}}
130 {{/apis}}
131         stasis_app_unref();
132         return 0;
133 }
134
135 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT, "RESTful API module - {{{description}}}",
136         .load = load_module,
137         .unload = unload_module,
138         .nonoptreq = "res_stasis_http,res_stasis",
139         );
140 {{/api_declaration}}