libamxd  6.4.1
Data Model Manager
test_amxd_action_object_destroy.c
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** SPDX-License-Identifier: BSD-2-Clause-Patent
4 **
5 ** SPDX-FileCopyrightText: Copyright (c) 2023 SoftAtHome
6 **
7 ** Redistribution and use in source and binary forms, with or without modification,
8 ** are permitted provided that the following conditions are met:
9 **
10 ** 1. Redistributions of source code must retain the above copyright notice,
11 ** this list of conditions and the following disclaimer.
12 **
13 ** 2. Redistributions in binary form must reproduce the above copyright notice,
14 ** this list of conditions and the following disclaimer in the documentation
15 ** and/or other materials provided with the distribution.
16 **
17 ** Subject to the terms and conditions of this license, each copyright holder
18 ** and contributor hereby grants to those receiving rights under this license
19 ** a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
20 ** (except for failure to satisfy the conditions of this license) patent license
21 ** to make, have made, use, offer to sell, sell, import, and otherwise transfer
22 ** this software, where such license applies only to those patent claims, already
23 ** acquired or hereafter acquired, licensable by such copyright holder or contributor
24 ** that are necessarily infringed by:
25 **
26 ** (a) their Contribution(s) (the licensed copyrights of copyright holders and
27 ** non-copyrightable additions of contributors, in source or binary form) alone;
28 ** or
29 **
30 ** (b) combination of their Contribution(s) with the work of authorship to which
31 ** such Contribution(s) was added by such copyright holder or contributor, if,
32 ** at the time the Contribution is added, such addition causes such combination
33 ** to be necessarily infringed. The patent license shall not apply to any other
34 ** combinations which include the Contribution.
35 **
36 ** Except as expressly stated above, no rights or licenses from any copyright
37 ** holder or contributor is granted under this license, whether expressly, by
38 ** implication, estoppel or otherwise.
39 **
40 ** DISCLAIMER
41 **
42 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
43 ** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44 ** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45 ** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
46 ** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
47 ** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
48 ** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
49 ** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
51 ** USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
52 **
53 ****************************************************************************/
54 
55 #include <stdlib.h>
56 #include <stdio.h>
57 #include <stdarg.h>
58 #include <stddef.h>
59 #include <setjmp.h>
60 #include <fcntl.h>
61 #include <unistd.h>
62 #include <signal.h>
63 #include <cmocka.h>
64 
65 #include <amxc/amxc.h>
66 #include <amxp/amxp_signal.h>
67 #include <amxp/amxp_slot.h>
68 
69 #include <amxd/amxd_common.h>
70 #include <amxd/amxd_dm.h>
71 #include <amxd/amxd_object.h>
72 #include <amxd/amxd_parameter.h>
73 #include <amxd/amxd_function.h>
74 #include <amxd/amxd_action.h>
75 #include <amxd/amxd_transaction.h>
76 
78 
79 #include <amxc/amxc_macros.h>
80 static amxd_dm_t dm;
81 static int counter = 0;
82 
83 static amxd_status_t amxd_action_dummy_cb(UNUSED amxd_object_t* const object,
84  UNUSED amxd_param_t* const param,
85  UNUSED amxd_action_t reason,
86  UNUSED const amxc_var_t* const args,
87  UNUSED amxc_var_t* const retval,
88  UNUSED void* priv) {
89  counter++;
90  assert_true(counter < 100);
91 
93 }
94 
96  amxd_object_t* object = NULL;
97  amxd_object_t* template = NULL;
98  amxd_object_t* child_templ = NULL;
99 
100  amxd_param_t* param = NULL;
101 
102  assert_int_equal(amxd_dm_init(&dm), 0);
103 
104  assert_int_equal(amxd_object_new(&template, amxd_object_template, "parent"), 0);
105  assert_int_equal(amxd_object_add_action_cb(template, action_object_destroy, amxd_action_dummy_cb, NULL), 0);
106  assert_int_equal(amxd_dm_add_root_object(&dm, template), 0);
107  assert_int_equal(amxd_object_new(&object, amxd_object_singleton, "child"), 0);
108  assert_int_equal(amxd_object_add_object(template, object), 0);
109  assert_int_equal(amxd_object_new(&child_templ, amxd_object_template, "child_template"), 0);
110  assert_int_equal(amxd_object_add_object(object, child_templ), 0);
111 
112 
113  assert_int_equal(amxd_param_new(&param, "templ_param", AMXC_VAR_ID_CSTRING), 0);
115  assert_int_equal(amxd_object_add_param(template, param), 0);
116  assert_int_equal(amxd_param_new(&param, "inst_param", AMXC_VAR_ID_BOOL), 0);
117  assert_int_equal(amxd_object_add_param(template, param), 0);
118  assert_int_equal(amxd_param_new(&param, "param", AMXC_VAR_ID_UINT32), 0);
121  assert_int_equal(amxd_object_add_param(template, param), 0);
122 
123  assert_int_equal(amxd_param_new(&param, "child_param", AMXC_VAR_ID_CSTRING), 0);
125  assert_int_equal(amxd_object_add_param(object, param), 0);
126  assert_int_equal(amxd_param_new(&param, "child_param2", AMXC_VAR_ID_BOOL), 0);
127  assert_int_equal(amxd_object_add_param(object, param), 0);
128  assert_int_equal(amxd_param_new(&param, "child_param3", AMXC_VAR_ID_UINT64), 0);
129  assert_int_equal(amxd_object_add_param(object, param), 0);
130  counter = 0;
131 
132  return template;
133 }
134 
136  amxd_object_t* template = NULL;
137 
138  template = test_build_dm();
139  assert_int_equal(amxd_dm_invoke_action(template, NULL, action_object_destroy, NULL, NULL), 0);
140  amxd_dm_clean(&dm);
141 }
142 
143 void test_amxd_object_delete(UNUSED void** state) {
144  amxd_object_t* template = NULL;
145  amxd_object_t* instance = NULL;
146 
147  template = test_build_dm();
148 
149  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 1, NULL), 0);
150  assert_ptr_not_equal(instance, NULL);
151 
152  assert_int_equal(amxd_action_object_destroy(instance, NULL, action_object_destroy, NULL, NULL, NULL), 0);
153  instance = amxd_object_get_instance(template, NULL, 1);
154  assert_ptr_not_equal(instance, NULL);
155  amxd_object_delete(&instance);
156 
157  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 1, NULL), 0);
158  assert_ptr_not_equal(instance, NULL);
159 
160  amxd_object_delete(&instance);
161  assert_ptr_equal(instance, NULL);
162 
163  amxd_object_delete(&instance);
164  amxd_object_delete(NULL);
165 
166  assert_int_equal(amxd_action_object_destroy(NULL, NULL, action_object_destroy, NULL, NULL, NULL), 0);
167  assert_int_not_equal(amxd_action_object_destroy(template, NULL, action_object_read, NULL, NULL, NULL), 0);
168 
169  amxd_dm_clean(&dm);
170 }
171 
172 void test_amxd_object_delete_with_cb(UNUSED void** state) {
173  amxd_object_t* template = NULL;
174  amxd_object_t* instance = NULL;
175 
176  template = test_build_dm();
178  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 1, NULL), 0);
179  assert_ptr_not_equal(instance, NULL);
180 
181  amxd_object_delete(&instance);
182  assert_ptr_equal(instance, NULL);
183 
184  amxd_object_delete(&instance);
185  amxd_object_delete(NULL);
186 
187  amxd_dm_clean(&dm);
188 }
189 
191  UNUSED amxd_param_t* const param,
192  UNUSED amxd_action_t reason,
193  UNUSED const amxc_var_t* const args,
194  UNUSED amxc_var_t* const retval,
195  UNUSED void* priv) {
196  char* path = amxd_object_get_path(object, 0);
197  printf("Destroy object %s\n", path);
198  check_expected(path);
199  free(path);
200  return amxd_status_ok;
201 }
202 
203 void test_amxd_object_destroy_cb_order(UNUSED void** state) {
204  amxd_object_t* object = NULL;
205  amxd_trans_t transaction;
206 
207  object = test_build_dm();
208 
210  object = amxd_object_findf(object, "child");
212  object = amxd_object_findf(object, "child_template");
214 
215  amxd_trans_init(&transaction);
216  amxd_trans_select_pathf(&transaction, "parent");
217  amxd_trans_add_inst(&transaction, 0, NULL);
218  amxd_trans_select_pathf(&transaction, ".child.child_template");
219  amxd_trans_add_inst(&transaction, 0, NULL);
220  assert_int_equal(amxd_trans_apply(&transaction, &dm), 0);
221  amxd_trans_clean(&transaction);
222 
223  object = amxd_dm_findf(&dm, "parent.1.");
224  assert_non_null(object);
225  object = amxd_dm_findf(&dm, "parent.");
226 
227  expect_string(check_callback_order, path, "parent.1.child.child_template.1");
228  expect_string(check_callback_order, path, "parent.1.child.child_template");
229  expect_string(check_callback_order, path, "parent.1.child");
230  expect_string(check_callback_order, path, "parent.1");
231 
232  amxd_trans_init(&transaction);
233  amxd_trans_select_object(&transaction, object);
234  amxd_trans_del_inst(&transaction, 1, NULL);
235  assert_int_equal(amxd_trans_apply(&transaction, &dm), 0);
236  amxd_trans_clean(&transaction);
237 
238  expect_string(check_callback_order, path, "parent.child.child_template");
239  expect_string(check_callback_order, path, "parent.child");
240  expect_string(check_callback_order, path, "parent");
241 
242  amxd_dm_clean(&dm);
243 }
244 
245 void test_amxd_object_destroy_root(UNUSED void** state) {
246  static amxd_dm_t dm;
247  amxd_object_t* root = NULL;
248 
249  // GIVEN a datamodel with a destroy handler on the root object
250  assert_int_equal(amxd_dm_init(&dm), 0);
251  root = amxd_dm_get_root(&dm);
253 
254  // EXPECT the destroy callbacks will be called
255  expect_value(check_callback_order, path, NULL);
256 
257  // WHEN cleaning the datamodel
258  amxd_dm_clean(&dm);
259 }
Ambiorix Data Model Default actions header file.
Ambiorix Data Model API header file.
amxd_object_t * amxd_dm_findf(amxd_dm_t *const dm, const char *abs_path,...) __attribute__((format(printf
amxd_status_t amxd_dm_invoke_action(amxd_object_t *object, amxd_param_t *param, amxd_action_t reason, const amxc_var_t *const args, amxc_var_t *const retval)
Definition: amxd_dm.c:591
Ambiorix Data Model RPC methods API header file.
Ambiorix Data Model API header file.
amxd_status_t amxd_object_add_action_cb(amxd_object_t *const object, const amxd_action_t reason, amxd_action_fn_t fn, void *priv)
amxd_status_t amxd_param_new(amxd_param_t **param, const char *name, const uint32_t type)
amxd_status_t amxd_param_set_attr(amxd_param_t *param, const amxd_pattr_id_t attr, const bool enable)
Ambiorix Data Model API header file.
@ amxd_pattr_template
Definition: amxd_types.h:355
@ amxd_pattr_private
Definition: amxd_types.h:357
@ amxd_pattr_instance
Definition: amxd_types.h:356
@ action_object_read
Definition: amxd_types.h:117
@ action_object_destroy
Definition: amxd_types.h:125
enum _amxd_action amxd_action_t
enum _amxd_status amxd_status_t
@ amxd_status_ok
Definition: amxd_types.h:78
@ amxd_status_unknown_error
Definition: amxd_types.h:79
@ amxd_object_template
Definition: amxd_types.h:183
@ amxd_object_singleton
Definition: amxd_types.h:181
amxd_object_t * amxd_dm_get_root(amxd_dm_t *const dm)
Fetches the root object of the data model.
Definition: amxd_dm.c:456
amxd_status_t amxd_dm_add_root_object(amxd_dm_t *const dm, amxd_object_t *const object)
Adds an object to the root of the data model.
Definition: amxd_dm.c:418
amxd_status_t amxd_dm_init(amxd_dm_t *dm)
Initializes a data model structure.
Definition: amxd_dm.c:334
void amxd_dm_clean(amxd_dm_t *dm)
Cleans a data model structure.
Definition: amxd_dm.c:365
amxd_status_t amxd_action_object_destroy(amxd_object_t *object, amxd_param_t *const param, amxd_action_t reason, const amxc_var_t *const args, amxc_var_t *const retval, void *priv)
Default object destroy action implementation.
amxd_object_t amxd_status_t amxd_status_t char * amxd_object_get_path(const amxd_object_t *object, const uint32_t flags)
Get the full path of the object.
amxd_object_t * amxd_object_findf(amxd_object_t *object, const char *rel_path,...) __attribute__((format(printf
Find an object in the data model tree, starting from an object.
amxd_status_t amxd_object_add_object(amxd_object_t *const parent, amxd_object_t *const child)
Adds an object in the data model tree.
Definition: amxd_object.c:207
amxd_object_t * amxd_object_get_instance(const amxd_object_t *object, const char *name, uint32_t index)
Get an instance of the template object.
amxd_status_t amxd_object_add_param(amxd_object_t *const object, amxd_param_t *const param)
Adds a parameter definition to an object.
amxd_status_t amxd_object_new_instance(amxd_object_t **object, amxd_object_t *templ, const char *name, uint32_t index, amxc_var_t *values)
Data model object constructor function.
amxd_status_t amxd_object_new(amxd_object_t **object, const amxd_object_type_t type, const char *name)
Data model object constructor function.
Definition: amxd_object.c:185
void amxd_object_delete(amxd_object_t **object)
Invokes the destroy handler(s) of the object.
void amxd_trans_clean(amxd_trans_t *const trans)
Cleans the transaction object.
amxd_status_t amxd_trans_apply(amxd_trans_t *const trans, amxd_dm_t *const dm)
Applies all previously added actions.
amxd_status_t amxd_trans_add_inst(amxd_trans_t *const trans, const uint32_t index, const char *name)
Adds an instance add action to a transaction.
amxd_status_t amxd_trans_del_inst(amxd_trans_t *const trans, const uint32_t index, const char *name)
Adds an instance delete action to a transaction.
amxd_status_t amxd_trans_select_pathf(amxd_trans_t *const trans, const char *path,...) __attribute__((format(printf
Selects an object using a absolute or relative path.
amxd_status_t amxd_status_t amxd_trans_select_object(amxd_trans_t *trans, const amxd_object_t *const object)
Selects an object using an object pointer.
amxd_status_t amxd_trans_init(amxd_trans_t *const trans)
Initializes a transaction object.
void test_amxd_object_destroy_root(UNUSED void **state)
void test_amxd_object_destroy_cb_order(UNUSED void **state)
static amxd_dm_t dm
static amxd_status_t amxd_action_dummy_cb(UNUSED amxd_object_t *const object, UNUSED amxd_param_t *const param, UNUSED amxd_action_t reason, UNUSED const amxc_var_t *const args, UNUSED amxc_var_t *const retval, UNUSED void *priv)
void test_amxd_object_delete(UNUSED void **state)
static int counter
void test_amxd_object_delete_with_cb(UNUSED void **state)
static amxd_status_t check_callback_order(amxd_object_t *const object, UNUSED amxd_param_t *const param, UNUSED amxd_action_t reason, UNUSED const amxc_var_t *const args, UNUSED amxc_var_t *const retval, UNUSED void *priv)
void test_amxd_object_destroy_action_can_not_fail(UNUSED void **state)
static amxd_object_t * test_build_dm(void)