31e15c22180fadb1325fc3823e627748654cdcb7
[asterisk/asterisk.git] / res / stasis / app.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 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 /*! \file
20  *
21  * \brief Stasis application support.
22  *
23  * \author David M. Lee, II <dlee@digium.com>
24  */
25
26 #include "asterisk.h"
27
28 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
29
30 #include "app.h"
31
32 #include "asterisk/stasis_app.h"
33 #include "asterisk/stasis_channels.h"
34
35 /*!
36  * \brief Number of buckets for the channels container for app instances.  Remember
37  * to keep it a prime number!
38  */
39 #define APP_CHANNELS_BUCKETS 7
40
41 /*!
42  * \brief Number of buckets for the bridges container for app instances.  Remember
43  * to keep it a prime number!
44  */
45 #define APP_BRIDGES_BUCKETS 7
46
47 struct app {
48         /*! Callback function for this application. */
49         stasis_app_cb handler;
50         /*! Opaque data to hand to callback function. */
51         void *data;
52         /*! List of channel identifiers this app instance is interested in */
53         struct ao2_container *channels;
54         /*! List of bridge identifiers this app instance owns */
55         struct ao2_container *bridges;
56         /*! Name of the Stasis application */
57         char name[];
58 };
59
60 static void app_dtor(void *obj)
61 {
62         struct app *app = obj;
63
64         ao2_cleanup(app->data);
65         app->data = NULL;
66         ao2_cleanup(app->channels);
67         app->channels = NULL;
68         ao2_cleanup(app->bridges);
69         app->bridges = NULL;
70 }
71
72 struct app *app_create(const char *name, stasis_app_cb handler, void *data)
73 {
74         RAII_VAR(struct app *, app, NULL, ao2_cleanup);
75         size_t size;
76
77         ast_assert(name != NULL);
78         ast_assert(handler != NULL);
79
80         size = sizeof(*app) + strlen(name) + 1;
81         app = ao2_alloc_options(size, app_dtor, AO2_ALLOC_OPT_LOCK_MUTEX);
82
83         if (!app) {
84                 return NULL;
85         }
86
87         strncpy(app->name, name, size - sizeof(*app));
88         app->handler = handler;
89         ao2_ref(data, +1);
90         app->data = data;
91
92         app->channels = ast_str_container_alloc(APP_CHANNELS_BUCKETS);
93         if (!app->channels) {
94                 return NULL;
95         }
96
97         app->bridges = ast_str_container_alloc(APP_BRIDGES_BUCKETS);
98         if (!app->bridges) {
99                 return NULL;
100         }
101
102         ao2_ref(app, +1);
103         return app;
104 }
105
106 int app_add_channel(struct app *app, const struct ast_channel *chan)
107 {
108         const char *uniqueid;
109         ast_assert(chan != NULL);
110         ast_assert(app != NULL);
111
112         uniqueid = ast_channel_uniqueid(chan);
113         return ast_str_container_add(app->channels, uniqueid) ? -1 : 0;
114 }
115
116 void app_remove_channel(struct app* app, const struct ast_channel *chan)
117 {
118         ast_assert(chan != NULL);
119         ast_assert(app != NULL);
120
121         ao2_find(app->channels, ast_channel_uniqueid(chan), OBJ_KEY | OBJ_NODATA | OBJ_UNLINK);
122 }
123
124 int app_add_bridge(struct app *app, const char *uniqueid)
125 {
126         ast_assert(uniqueid != NULL);
127         ast_assert(app != NULL);
128
129         return ast_str_container_add(app->bridges, uniqueid) ? -1 : 0;
130 }
131
132 void app_remove_bridge(struct app* app, const char *uniqueid)
133 {
134         ast_assert(uniqueid != NULL);
135         ast_assert(app != NULL);
136
137         ao2_find(app->bridges, uniqueid, OBJ_KEY | OBJ_NODATA | OBJ_UNLINK | OBJ_MULTIPLE);
138 }
139
140 /*!
141  * \brief Send a message to the given application.
142  * \param app App to send the message to.
143  * \param message Message to send.
144  */
145 void app_send(struct app *app, struct ast_json *message)
146 {
147         app->handler(app->data, app->name, message);
148 }
149
150 void app_update(struct app *app, stasis_app_cb handler, void *data)
151 {
152         SCOPED_AO2LOCK(lock, app);
153
154         app->handler = handler;
155         ao2_cleanup(app->data);
156         ao2_ref(data, +1);
157         app->data = data;
158 }
159
160 const char *app_name(const struct app *app)
161 {
162         return app->name;
163 }
164
165 int app_is_watching_channel(struct app *app, const char *uniqueid)
166 {
167         RAII_VAR(char *, found, NULL, ao2_cleanup);
168         found = ao2_find(app->channels, uniqueid, OBJ_KEY);
169         return found != NULL;
170 }
171
172 int app_is_watching_bridge(struct app *app, const char *uniqueid)
173 {
174         RAII_VAR(char *, found, NULL, ao2_cleanup);
175         found = ao2_find(app->bridges, uniqueid, OBJ_KEY);
176         return found != NULL;
177 }