sorcery: Add additional observer capabilities.

Add new global, instance and wizard observers.
instance_created
wizard_registered
wizard_unregistered
instance_destroying
instance_loading
instance_loaded
wizard_mapped
object_type_registered
object_type_loading
object_type_loaded
wizard_loading
wizard_loaded

Tested-by: George Joseph

Review: https://reviewboard.asterisk.org/r/4215/
........

Merged revisions 428999 from http://svn.asterisk.org/svn/asterisk/branches/12
........

Merged revisions 429000 from http://svn.asterisk.org/svn/asterisk/branches/13


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@429001 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
George Joseph 2014-12-05 17:08:27 +00:00
parent 19992844be
commit d04445c24a
4 changed files with 749 additions and 58 deletions

View File

@ -141,8 +141,9 @@ enum ast_sorcery_field_handler_flags {
};
/*! \brief Forward declaration for the sorcery main structure */
/*! \brief Forward declaration for the sorcery main structure and wizard structure */
struct ast_sorcery;
struct ast_sorcery_wizard;
/*!
* \brief A callback function for translating a value into a string
@ -215,6 +216,62 @@ typedef int (*sorcery_copy_handler)(const void *src, void *dst);
*/
typedef int (*sorcery_diff_handler)(const void *original, const void *modified, struct ast_variable **changes);
/*! \brief Interface for the global sorcery observer */
struct ast_sorcery_global_observer {
/*! \brief Callback after an instance is created */
void (*instance_created)(const char *name, struct ast_sorcery *sorcery);
/*! \brief Callback after an wizard is registered */
void (*wizard_registered)(const char *name,
const struct ast_sorcery_wizard *wizard);
/*! \brief Callback before an instance is destroyed */
void (*instance_destroying)(const char *name, struct ast_sorcery *sorcery);
/*! \brief Callback before a wizard is unregistered */
void (*wizard_unregistering)(const char *name,
const struct ast_sorcery_wizard *wizard);
};
/*! \brief Interface for the sorcery instance observer */
struct ast_sorcery_instance_observer {
/*! \brief Callback before instance is loaded/reloaded */
void (*instance_loading)(const char *name, const struct ast_sorcery *sorcery,
int reloaded);
/*! \brief Callback after instance is loaded/reloaded */
void (*instance_loaded)(const char *name, const struct ast_sorcery *sorcery,
int reloaded);
/*! \brief Callback after a wizard is mapped to an object_type */
void (*wizard_mapped)(const char *name, struct ast_sorcery *sorcery,
const char *object_type, struct ast_sorcery_wizard *wizard,
const char *wizard_args, void *wizard_data);
/*! \brief Callback after any object_type is registered */
void (*object_type_registered)(const char *name, struct ast_sorcery *sorcery,
const char *object_type);
/*! \brief Callback before any object_type is loaded/reloaded */
void (*object_type_loading)(const char *name, const struct ast_sorcery *sorcery,
const char *object_type, int reloaded);
/*! \brief Callback after any object_type is loaded/reloaded */
void (*object_type_loaded)(const char *name, const struct ast_sorcery *sorcery,
const char *object_type, int reloaded);
};
/*! \brief Interface for the sorcery wizard observer */
struct ast_sorcery_wizard_observer {
/*! \brief Callback before a wizard is loaded/reloaded for any type */
void (*wizard_loading)(const char *name, const struct ast_sorcery_wizard *wizard,
const char *object_type, int reloaded);
/*! \brief Callback after a wizard is loaded/reloaded for any type */
void (*wizard_loaded)(const char *name, const struct ast_sorcery_wizard *wizard,
const char *object_type, int reloaded);
};
/*! \brief Interface for a sorcery wizard */
struct ast_sorcery_wizard {
/*! \brief Name of the wizard */
@ -406,6 +463,40 @@ enum ast_sorcery_apply_result __ast_sorcery_apply_default(struct ast_sorcery *so
#define ast_sorcery_apply_default(sorcery, type, name, data) \
__ast_sorcery_apply_default((sorcery), (type), AST_MODULE, (name), (data))
/*!
* \brief Apply additional object wizard mappings
*
* \param sorcery Pointer to a sorcery structure
* \param type Type of object to apply to
* \param module The name of the module, typically AST_MODULE
* \param name Name of the wizard to use
* \param data Data to be passed to wizard
* \param caching Wizard should cache
*
* \return What occurred when applying the mapping
*
* \note This should be called *after* applying default mappings
*/
enum ast_sorcery_apply_result __ast_sorcery_apply_wizard_mapping(struct ast_sorcery *sorcery,
const char *type, const char *module, const char *name, const char *data, unsigned int caching);
/*!
* \brief Apply additional object wizard mappings
*
* \param sorcery Pointer to a sorcery structure
* \param type Type of object to apply to
* \param module The name of the module, typically AST_MODULE
* \param name Name of the wizard to use
* \param data Data to be passed to wizard
*
* \return What occurred when applying the mapping
*
* \note This should be called *after* applying default mappings
*/
#define ast_sorcery_apply_wizard_mapping(sorcery, type, name, data, caching) \
__ast_sorcery_apply_wizard_mapping((sorcery), (type), AST_MODULE, (name), (data), (caching));
/*!
* \brief Register an object type
*
@ -793,6 +884,89 @@ void *ast_sorcery_copy(const struct ast_sorcery *sorcery, const void *object);
*/
int ast_sorcery_diff(const struct ast_sorcery *sorcery, const void *original, const void *modified, struct ast_variable **changes);
/*!
* \brief Add a global observer to sorcery
*
* \param callbacks Implementation of the global observer interface
*
* \retval 0 success
* \retval -1 failure
*
* \note You must be ready to accept observer invocations before this function is called
*/
int ast_sorcery_global_observer_add(const struct ast_sorcery_global_observer *callbacks);
/*!
* \brief Remove a global observer from sorcery.
*
* A global observer is notified...
* After a new wizard is registered.
* After a new sorcery instance is opened.
* Before an instance is destroyed.
* Before a wizard is unregistered.
*
* \param callbacks Implementation of the global observer interface
*/
void ast_sorcery_global_observer_remove(const struct ast_sorcery_global_observer *callbacks);
/*!
* \brief Add an observer to a sorcery instance
*
* \param sorcery Pointer to a sorcery structure
* \param callbacks Implementation of the instance observer interface
*
* An instance observer is notified...
* Before an instance is loaded or reloaded.
* After an instance is loaded or reloaded.
* After a wizard is mapped to an object type.
* After an object type is registered.
* Before an object type is loaded or reloaded.
* After an object type is loaded or reloaded.
*
* \retval 0 success
* \retval -1 failure
*
* \note You must be ready to accept observer invocations before this function is called
*/
int ast_sorcery_instance_observer_add(struct ast_sorcery *sorcery,
const struct ast_sorcery_instance_observer *callbacks);
/*!
* \brief Remove an observer from a sorcery instance
*
* \param sorcery Pointer to a sorcery structure
* \param callbacks Implementation of the instance observer interface
*/
void ast_sorcery_instance_observer_remove(struct ast_sorcery *sorcery,
const struct ast_sorcery_instance_observer *callbacks);
/*!
* \brief Add an observer to a sorcery wizard
*
* \param sorcery Pointer to a previously registered wizard structure
* \param callbacks Implementation of the wizard observer interface
*
* A wizard observer is notified...
* Before a wizard is loaded or reloaded.
* After a wizard is loaded or reloaded.
*
* \retval 0 success
* \retval -1 failure
*
* \note You must be ready to accept observer invocations before this function is called
*/
int ast_sorcery_wizard_observer_add(struct ast_sorcery_wizard *wizard,
const struct ast_sorcery_wizard_observer *callbacks);
/*!
* \brief Remove an observer from a sorcery wizard.
*
* \param sorcery Pointer to a sorcery structure
* \param callbacks Implementation of the wizard observer interface
*/
void ast_sorcery_wizard_observer_remove(struct ast_sorcery_wizard *wizard,
const struct ast_sorcery_wizard_observer *callbacks);
/*!
* \brief Add an observer to a specific object type
*

View File

@ -381,10 +381,10 @@ int __ast_test_status_update(const char *file, const char *func, int line, struc
* \param test Currently executing test
* \param condition Boolean condition to check.
*/
#define ast_test_validate(test, condition) \
#define ast_test_validate(test, condition, ...) \
do { \
if (!(condition)) { \
__ast_test_status_update(__FILE__, __PRETTY_FUNCTION__, __LINE__, (test), "Condition failed: %s\n", #condition); \
__ast_test_status_update(__FILE__, __PRETTY_FUNCTION__, __LINE__, (test), "%s: %s\n", strlen(#__VA_ARGS__) ? #__VA_ARGS__ : "Condition failed", #condition); \
return AST_TEST_FAIL; \
} \
} while(0)

View File

@ -60,6 +60,29 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
/*! \brief Number of buckets for object fields (should be prime for performance reasons) */
#define OBJECT_FIELD_BUCKETS 29
#define NOTIFY_GENERIC_OBSERVERS(container, type, callback, ...) ({ \
struct ao2_iterator i = ao2_iterator_init(container, 0); \
struct type *observer; \
ao2_rdlock(container); \
while ((observer = ao2_iterator_next(&i))) { \
if (observer->callbacks->callback) { \
observer->callbacks->callback(__VA_ARGS__); \
} \
ao2_cleanup(observer); \
} \
ao2_unlock(container); \
ao2_iterator_cleanup(&i); \
})
#define NOTIFY_GLOBAL_OBSERVERS(container, callback, ...) \
NOTIFY_GENERIC_OBSERVERS(container, sorcery_global_observer, callback, __VA_ARGS__)
#define NOTIFY_INSTANCE_OBSERVERS(container, callback, ...) \
NOTIFY_GENERIC_OBSERVERS(container, sorcery_instance_observer, callback, __VA_ARGS__)
#define NOTIFY_WIZARD_OBSERVERS(container, callback, ...) \
NOTIFY_GENERIC_OBSERVERS(container, sorcery_wizard_observer, callback, __VA_ARGS__)
/*! \brief Thread pool for observers */
static struct ast_threadpool *threadpool;
@ -153,10 +176,19 @@ struct ast_sorcery_object_field {
intptr_t args[];
};
/*! \brief Structure for an internal wizard instance */
struct ast_sorcery_internal_wizard {
/*! \brief Wizard interface itself */
struct ast_sorcery_wizard callbacks;
/*! \brief Observers */
struct ao2_container *observers;
};
/*! \brief Structure for a wizard instance which operates on objects */
struct ast_sorcery_object_wizard {
/*! \brief Wizard interface itself */
struct ast_sorcery_wizard *wizard;
struct ast_sorcery_internal_wizard *wizard;
/*! \brief Unique data for the wizard */
void *data;
@ -169,6 +201,10 @@ struct ast_sorcery_object_wizard {
struct ast_sorcery {
/*! \brief Container for known object types */
struct ao2_container *types;
/*! \brief Observers */
struct ao2_container *observers;
/*! \brief The name of the module owning this sorcery instance */
char module_name[0];
};
@ -188,6 +224,30 @@ struct sorcery_load_details {
/*! \brief Registered sorcery wizards */
static struct ao2_container *wizards;
/* The following 3 observer wrappers must name their
* external observer 'callbacks' and it must be
* the first member of the structure. Common macros
* and container callbacks depend on it.
*/
/*! \brief A global observer wrapper */
struct sorcery_global_observer {
const struct ast_sorcery_global_observer *callbacks;
};
/*! \brief An instance observer wrapper */
struct sorcery_instance_observer {
const struct ast_sorcery_instance_observer *callbacks;
};
/*! \brief A wizard observer wrapper */
struct sorcery_wizard_observer {
const struct ast_sorcery_wizard_observer *callbacks;
};
/*! \brief Registered global observers */
struct ao2_container *observers;
/*! \brief Registered sorcery instances */
static struct ao2_container *instances;
@ -262,7 +322,7 @@ static sorcery_field_handler sorcery_field_default_handler(enum aco_option_type
/*! \brief Hashing function for sorcery wizards */
static int sorcery_wizard_hash(const void *obj, const int flags)
{
const struct ast_sorcery_wizard *object;
const struct ast_sorcery_internal_wizard *object;
const char *key;
switch (flags & OBJ_SEARCH_MASK) {
@ -271,7 +331,7 @@ static int sorcery_wizard_hash(const void *obj, const int flags)
break;
case OBJ_SEARCH_OBJECT:
object = obj;
key = object->name;
key = object->callbacks.name;
break;
default:
ast_assert(0);
@ -283,20 +343,20 @@ static int sorcery_wizard_hash(const void *obj, const int flags)
/*! \brief Comparator function for sorcery wizards */
static int sorcery_wizard_cmp(void *obj, void *arg, int flags)
{
const struct ast_sorcery_wizard *object_left = obj;
const struct ast_sorcery_wizard *object_right = arg;
const struct ast_sorcery_internal_wizard *object_left = obj;
const struct ast_sorcery_internal_wizard *object_right = arg;
const char *right_key = arg;
int cmp;
switch (flags & OBJ_SEARCH_MASK) {
case OBJ_SEARCH_OBJECT:
right_key = object_right->name;
right_key = object_right->callbacks.name;
/* Fall through */
case OBJ_SEARCH_KEY:
cmp = strcmp(object_left->name, right_key);
cmp = strcmp(object_left->callbacks.name, right_key);
break;
case OBJ_SEARCH_PARTIAL_KEY:
cmp = strncmp(object_left->name, right_key, strlen(right_key));
cmp = strncmp(object_left->callbacks.name, right_key, strlen(right_key));
break;
default:
cmp = 0;
@ -368,6 +428,8 @@ static void sorcery_cleanup(void)
{
ao2_cleanup(wizards);
wizards = NULL;
ao2_cleanup(observers);
observers = NULL;
ao2_cleanup(instances);
instances = NULL;
}
@ -442,6 +504,13 @@ int ast_sorcery_init(void)
return -1;
}
observers = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_RWLOCK, 0, NULL, NULL);
if (!observers) {
sorcery_cleanup();
sorcery_exit();
return -1;
}
instances = ao2_container_alloc_options(AO2_ALLOC_OPT_LOCK_RWLOCK, INSTANCE_BUCKETS,
sorcery_instance_hash, sorcery_instance_cmp);
if (!instances) {
@ -456,9 +525,16 @@ int ast_sorcery_init(void)
return 0;
}
static void sorcery_internal_wizard_destructor(void *obj)
{
struct ast_sorcery_internal_wizard *wizard = obj;
ao2_cleanup(wizard->observers);
}
int __ast_sorcery_wizard_register(const struct ast_sorcery_wizard *interface, struct ast_module *module)
{
struct ast_sorcery_wizard *wizard;
struct ast_sorcery_internal_wizard *wizard;
int res = -1;
ast_assert(!ast_strlen_zero(interface->name));
@ -471,18 +547,26 @@ int __ast_sorcery_wizard_register(const struct ast_sorcery_wizard *interface, st
goto done;
}
if (!(wizard = ao2_alloc(sizeof(*wizard), NULL))) {
if (!(wizard = ao2_alloc(sizeof(*wizard), sorcery_internal_wizard_destructor))) {
goto done;
}
*wizard = *interface;
wizard->module = module;
wizard->callbacks = *interface;
wizard->callbacks.module = module;
wizard->observers = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_RWLOCK, 0, NULL, NULL);
if (!wizard->observers) {
goto done;
}
ao2_link_flags(wizards, wizard, OBJ_NOLOCK);
res = 0;
ast_verb(2, "Sorcery registered wizard '%s'\n", interface->name);
NOTIFY_GLOBAL_OBSERVERS(observers, wizard_registered,
interface->name, interface);
done:
ao2_cleanup(wizard);
ao2_unlock(wizards);
@ -492,9 +576,13 @@ done:
int ast_sorcery_wizard_unregister(const struct ast_sorcery_wizard *interface)
{
RAII_VAR(struct ast_sorcery_wizard *, wizard, ao2_find(wizards, interface->name, OBJ_KEY | OBJ_UNLINK), ao2_cleanup);
struct ast_sorcery_internal_wizard *wizard =
interface ? ao2_find(wizards, interface->name, OBJ_SEARCH_KEY) : NULL;
if (wizard) {
NOTIFY_GLOBAL_OBSERVERS(observers, wizard_unregistering, wizard->callbacks.name, &wizard->callbacks);
ao2_unlink(wizards, wizard);
ao2_ref(wizard, -1);
ast_verb(2, "Sorcery unregistered wizard '%s'\n", interface->name);
return 0;
} else {
@ -502,11 +590,105 @@ int ast_sorcery_wizard_unregister(const struct ast_sorcery_wizard *interface)
}
}
/*! \brief Internal callback function for removing a generic observer */
static int sorcery_generic_observer_remove(void *obj, void *arg, int flags)
{
const struct sorcery_global_observer *observer = obj;
return (observer->callbacks == arg) ? CMP_MATCH | CMP_STOP : 0;
}
int ast_sorcery_global_observer_add(const struct ast_sorcery_global_observer *callbacks)
{
struct sorcery_global_observer *cb;
cb = ao2_alloc(sizeof(*cb), NULL);
if (!cb) {
return -1;
}
cb->callbacks = callbacks;
ao2_link(observers, cb);
ao2_ref(cb, -1);
return 0;
}
void ast_sorcery_global_observer_remove(
const struct ast_sorcery_global_observer *callbacks)
{
ao2_callback(observers, OBJ_NODATA | OBJ_UNLINK, sorcery_generic_observer_remove, (void *)callbacks);
}
int ast_sorcery_instance_observer_add(struct ast_sorcery *sorcery,
const struct ast_sorcery_instance_observer *callbacks)
{
struct sorcery_instance_observer *cb;
cb = ao2_alloc(sizeof(*cb), NULL);
if (!cb) {
return -1;
}
cb->callbacks = callbacks;
ao2_link(sorcery->observers, cb);
ao2_ref(cb, -1);
return 0;
}
void ast_sorcery_instance_observer_remove(struct ast_sorcery *sorcery,
const struct ast_sorcery_instance_observer *callbacks)
{
ao2_callback(sorcery->observers, OBJ_NODATA | OBJ_UNLINK, sorcery_generic_observer_remove, (void *)callbacks);
}
int ast_sorcery_wizard_observer_add(struct ast_sorcery_wizard *interface,
const struct ast_sorcery_wizard_observer *callbacks)
{
RAII_VAR(struct ast_sorcery_internal_wizard *, wizard,
interface ? ao2_find(wizards, interface->name, OBJ_SEARCH_KEY) : NULL,
ao2_cleanup);
if (wizard) {
struct sorcery_wizard_observer *cb;
cb = ao2_alloc(sizeof(*cb), NULL);
if (!cb) {
return -1;
}
cb->callbacks = callbacks;
ao2_link(wizard->observers, cb);
ao2_ref(cb, -1);
return 0;
}
return -1;
}
void ast_sorcery_wizard_observer_remove(struct ast_sorcery_wizard *interface,
const struct ast_sorcery_wizard_observer *callbacks)
{
RAII_VAR(struct ast_sorcery_internal_wizard *, wizard,
interface ? ao2_find(wizards, interface->name, OBJ_SEARCH_KEY) : NULL,
ao2_cleanup);
if (wizard) {
ao2_callback(wizard->observers, OBJ_NODATA | OBJ_UNLINK, sorcery_generic_observer_remove, (void *)callbacks);
}
}
/*! \brief Destructor called when sorcery structure is destroyed */
static void sorcery_destructor(void *obj)
{
struct ast_sorcery *sorcery = obj;
if (sorcery->observers) {
NOTIFY_GLOBAL_OBSERVERS(observers, instance_destroying, sorcery->module_name, sorcery);
}
ao2_cleanup(sorcery->observers);
ao2_cleanup(sorcery->types);
}
@ -580,6 +762,12 @@ struct ast_sorcery *__ast_sorcery_open(const char *module_name)
goto done;
}
if (!(sorcery->observers = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_RWLOCK, 0, NULL, NULL))) {
ao2_ref(sorcery, -1);
sorcery = NULL;
goto done;
}
strcpy(sorcery->module_name, module_name); /* Safe */
if (__ast_sorcery_apply_config(sorcery, module_name, module_name) == AST_SORCERY_APPLY_FAIL) {
@ -591,6 +779,8 @@ struct ast_sorcery *__ast_sorcery_open(const char *module_name)
ao2_link_flags(instances, sorcery, OBJ_NOLOCK);
NOTIFY_GLOBAL_OBSERVERS(observers, instance_created, module_name, sorcery);
done:
ao2_unlock(instances);
return sorcery;
@ -683,22 +873,22 @@ static void sorcery_object_wizard_destructor(void *obj)
struct ast_sorcery_object_wizard *object_wizard = obj;
if (object_wizard->data) {
object_wizard->wizard->close(object_wizard->data);
object_wizard->wizard->callbacks.close(object_wizard->data);
}
if (object_wizard->wizard) {
ast_module_unref(object_wizard->wizard->module);
ast_module_unref(object_wizard->wizard->callbacks.module);
}
ao2_cleanup(object_wizard->wizard);
}
/*! \brief Internal function which creates an object type and adds a wizard mapping */
static enum ast_sorcery_apply_result sorcery_apply_wizard_mapping(struct ast_sorcery *sorcery,
enum ast_sorcery_apply_result __ast_sorcery_apply_wizard_mapping(struct ast_sorcery *sorcery,
const char *type, const char *module, const char *name, const char *data, unsigned int caching)
{
RAII_VAR(struct ast_sorcery_object_type *, object_type, ao2_find(sorcery->types, type, OBJ_KEY), ao2_cleanup);
RAII_VAR(struct ast_sorcery_wizard *, wizard, ao2_find(wizards, name, OBJ_KEY), ao2_cleanup);
RAII_VAR(struct ast_sorcery_internal_wizard *, wizard, ao2_find(wizards, name, OBJ_KEY), ao2_cleanup);
RAII_VAR(struct ast_sorcery_object_wizard *, object_wizard, ao2_alloc(sizeof(*object_wizard), sorcery_object_wizard_destructor), ao2_cleanup);
int created = 0;
@ -719,17 +909,17 @@ static enum ast_sorcery_apply_result sorcery_apply_wizard_mapping(struct ast_sor
found = ao2_find(object_type->wizards, wizard, OBJ_SEARCH_OBJECT);
if (found) {
ast_debug(1, "Wizard %s already applied to object type %s\n",
wizard->name, object_type->name);
wizard->callbacks.name, object_type->name);
ao2_cleanup(found);
return AST_SORCERY_APPLY_DUPLICATE;
}
}
if (wizard->open && !(object_wizard->data = wizard->open(data))) {
if (wizard->callbacks.open && !(object_wizard->data = wizard->callbacks.open(data))) {
return AST_SORCERY_APPLY_FAIL;
}
ast_module_ref(wizard->module);
ast_module_ref(wizard->callbacks.module);
object_wizard->wizard = ao2_bump(wizard);
object_wizard->caching = caching;
@ -740,6 +930,9 @@ static enum ast_sorcery_apply_result sorcery_apply_wizard_mapping(struct ast_sor
ao2_link(sorcery->types, object_type);
}
NOTIFY_INSTANCE_OBSERVERS(sorcery->observers, wizard_mapped,
sorcery->module_name, sorcery, type, &wizard->callbacks, data, object_wizard->data);
return AST_SORCERY_APPLY_SUCCESS;
}
@ -778,7 +971,7 @@ enum ast_sorcery_apply_result __ast_sorcery_apply_config(struct ast_sorcery *so
}
/* Any error immediately causes us to stop */
if (sorcery_apply_wizard_mapping(sorcery, type, module, wizard, data, caching) == AST_SORCERY_APPLY_FAIL) {
if (__ast_sorcery_apply_wizard_mapping(sorcery, type, module, wizard, data, caching) == AST_SORCERY_APPLY_FAIL) {
res = AST_SORCERY_APPLY_FAIL;
break;
}
@ -798,7 +991,7 @@ enum ast_sorcery_apply_result __ast_sorcery_apply_default(struct ast_sorcery *so
return AST_SORCERY_APPLY_DEFAULT_UNNECESSARY;
}
return sorcery_apply_wizard_mapping(sorcery, type, module, name, data, 0);
return __ast_sorcery_apply_wizard_mapping(sorcery, type, module, name, data, 0);
}
static int sorcery_extended_config_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)
@ -847,6 +1040,9 @@ int __ast_sorcery_object_register(struct ast_sorcery *sorcery, const char *type,
return -1;
}
NOTIFY_INSTANCE_OBSERVERS(sorcery->observers, object_type_registered,
sorcery->module_name, sorcery, type);
return 0;
}
@ -986,10 +1182,16 @@ static int sorcery_wizard_load(void *obj, void *arg, int flags)
return 0;
}
load = !details->reload ? wizard->wizard->load : wizard->wizard->reload;
load = !details->reload ? wizard->wizard->callbacks.load : wizard->wizard->callbacks.reload;
if (load) {
NOTIFY_WIZARD_OBSERVERS(wizard->wizard->observers, wizard_loading,
wizard->wizard->callbacks.name, &wizard->wizard->callbacks, details->type, details->reload);
load(wizard->data, details->sorcery, details->type);
NOTIFY_WIZARD_OBSERVERS(wizard->wizard->observers, wizard_loaded,
wizard->wizard->callbacks.name, &wizard->wizard->callbacks, details->type, details->reload);
}
return 0;
@ -1053,6 +1255,10 @@ static int sorcery_object_load(void *obj, void *arg, int flags)
struct sorcery_load_details *details = arg;
details->type = type->name;
NOTIFY_INSTANCE_OBSERVERS(details->sorcery->observers, object_type_loading,
details->sorcery->module_name, details->sorcery, type->name, details->reload);
ao2_callback(type->wizards, OBJ_NODATA, sorcery_wizard_load, details);
if (ao2_container_count(type->observers)) {
@ -1063,6 +1269,9 @@ static int sorcery_object_load(void *obj, void *arg, int flags)
}
}
NOTIFY_INSTANCE_OBSERVERS(details->sorcery->observers, object_type_loaded,
details->sorcery->module_name, details->sorcery, type->name, details->reload);
return 0;
}
@ -1073,7 +1282,13 @@ void ast_sorcery_load(const struct ast_sorcery *sorcery)
.reload = 0,
};
NOTIFY_INSTANCE_OBSERVERS(sorcery->observers, instance_loading,
sorcery->module_name, sorcery, 0);
ao2_callback(sorcery->types, OBJ_NODATA, sorcery_object_load, &details);
NOTIFY_INSTANCE_OBSERVERS(sorcery->observers, instance_loaded,
sorcery->module_name, sorcery, 0);
}
void ast_sorcery_load_object(const struct ast_sorcery *sorcery, const char *type)
@ -1098,7 +1313,14 @@ void ast_sorcery_reload(const struct ast_sorcery *sorcery)
.reload = 1,
};
NOTIFY_INSTANCE_OBSERVERS(sorcery->observers, instance_loading,
sorcery->module_name, sorcery, 1);
ao2_callback(sorcery->types, OBJ_NODATA, sorcery_object_load, &details);
NOTIFY_INSTANCE_OBSERVERS(sorcery->observers, instance_loaded,
sorcery->module_name, sorcery, 1);
}
void ast_sorcery_reload_object(const struct ast_sorcery *sorcery, const char *type)
@ -1302,20 +1524,6 @@ int ast_sorcery_objectset_apply(const struct ast_sorcery *sorcery, void *object,
return res;
}
static const struct ast_variable *sorcery_find_field(const struct ast_variable *fields, const char *name)
{
const struct ast_variable *field;
/* Search the linked list of fields to find the correct one */
for (field = fields; field; field = field->next) {
if (!strcmp(field->name, name)) {
return field;
}
}
return NULL;
}
int ast_sorcery_changeset_create(const struct ast_variable *original, const struct ast_variable *modified, struct ast_variable **changes)
{
const struct ast_variable *field;
@ -1329,9 +1537,9 @@ int ast_sorcery_changeset_create(const struct ast_variable *original, const stru
}
for (field = modified; field; field = field->next) {
const struct ast_variable *old = sorcery_find_field(original, field->name);
const char *old_value = ast_variable_find_in_list(original, field->name);
if (!old || strcmp(old->value, field->value)) {
if (!old_value || strcmp(old_value, field->value)) {
struct ast_variable *tmp;
if (!(tmp = ast_variable_new(field->name, field->value, ""))) {
@ -1475,11 +1683,11 @@ static int sorcery_cache_create(void *obj, void *arg, int flags)
const struct ast_sorcery_object_wizard *object_wizard = obj;
const struct sorcery_details *details = arg;
if (!object_wizard->caching || !object_wizard->wizard->create) {
if (!object_wizard->caching || !object_wizard->wizard->callbacks.create) {
return 0;
}
object_wizard->wizard->create(details->sorcery, object_wizard->data, details->obj);
object_wizard->wizard->callbacks.create(details->sorcery, object_wizard->data, details->obj);
return 0;
}
@ -1498,8 +1706,8 @@ void *ast_sorcery_retrieve_by_id(const struct ast_sorcery *sorcery, const char *
i = ao2_iterator_init(object_type->wizards, 0);
for (; (wizard = ao2_iterator_next(&i)); ao2_ref(wizard, -1)) {
if (wizard->wizard->retrieve_id &&
!(object = wizard->wizard->retrieve_id(sorcery, wizard->data, object_type->name, id))) {
if (wizard->wizard->callbacks.retrieve_id &&
!(object = wizard->wizard->callbacks.retrieve_id(sorcery, wizard->data, object_type->name, id))) {
continue;
}
@ -1540,12 +1748,12 @@ void *ast_sorcery_retrieve_by_fields(const struct ast_sorcery *sorcery, const ch
i = ao2_iterator_init(object_type->wizards, 0);
for (; (wizard = ao2_iterator_next(&i)); ao2_ref(wizard, -1)) {
if ((flags & AST_RETRIEVE_FLAG_MULTIPLE)) {
if (wizard->wizard->retrieve_multiple) {
wizard->wizard->retrieve_multiple(sorcery, wizard->data, object_type->name, object, fields);
if (wizard->wizard->callbacks.retrieve_multiple) {
wizard->wizard->callbacks.retrieve_multiple(sorcery, wizard->data, object_type->name, object, fields);
}
} else if (fields && wizard->wizard->retrieve_fields) {
if (wizard->wizard->retrieve_fields) {
object = wizard->wizard->retrieve_fields(sorcery, wizard->data, object_type->name, fields);
} else if (fields && wizard->wizard->callbacks.retrieve_fields) {
if (wizard->wizard->callbacks.retrieve_fields) {
object = wizard->wizard->callbacks.retrieve_fields(sorcery, wizard->data, object_type->name, fields);
}
}
@ -1581,11 +1789,11 @@ struct ao2_container *ast_sorcery_retrieve_by_regex(const struct ast_sorcery *so
i = ao2_iterator_init(object_type->wizards, 0);
for (; (wizard = ao2_iterator_next(&i)); ao2_ref(wizard, -1)) {
if (!wizard->wizard->retrieve_regex) {
if (!wizard->wizard->callbacks.retrieve_regex) {
continue;
}
wizard->wizard->retrieve_regex(sorcery, wizard->data, object_type->name, objects, regex);
wizard->wizard->callbacks.retrieve_regex(sorcery, wizard->data, object_type->name, objects, regex);
}
ao2_iterator_destroy(&i);
@ -1598,13 +1806,13 @@ static int sorcery_wizard_create(void *obj, void *arg, int flags)
const struct ast_sorcery_object_wizard *object_wizard = obj;
const struct sorcery_details *details = arg;
if (!object_wizard->wizard->create) {
if (!object_wizard->wizard->callbacks.create) {
ast_assert(0);
ast_log(LOG_ERROR, "Sorcery wizard '%s' doesn't contain a 'create' virtual function.\n",
object_wizard->wizard->name);
object_wizard->wizard->callbacks.name);
return 0;
}
return (!object_wizard->caching && !object_wizard->wizard->create(details->sorcery, object_wizard->data, details->obj)) ? CMP_MATCH | CMP_STOP : 0;
return (!object_wizard->caching && !object_wizard->wizard->callbacks.create(details->sorcery, object_wizard->data, details->obj)) ? CMP_MATCH | CMP_STOP : 0;
}
/*! \brief Internal callback function which notifies an individual observer that an object has been created */
@ -1685,7 +1893,7 @@ static int sorcery_wizard_update(void *obj, void *arg, int flags)
const struct ast_sorcery_object_wizard *object_wizard = obj;
const struct sorcery_details *details = arg;
return (object_wizard->wizard->update && !object_wizard->wizard->update(details->sorcery, object_wizard->data, details->obj) &&
return (object_wizard->wizard->callbacks.update && !object_wizard->wizard->callbacks.update(details->sorcery, object_wizard->data, details->obj) &&
!object_wizard->caching) ? CMP_MATCH | CMP_STOP : 0;
}
@ -1744,7 +1952,7 @@ static int sorcery_wizard_delete(void *obj, void *arg, int flags)
const struct ast_sorcery_object_wizard *object_wizard = obj;
const struct sorcery_details *details = arg;
return (object_wizard->wizard->delete && !object_wizard->wizard->delete(details->sorcery, object_wizard->data, details->obj) &&
return (object_wizard->wizard->callbacks.delete && !object_wizard->wizard->callbacks.delete(details->sorcery, object_wizard->data, details->obj) &&
!object_wizard->caching) ? CMP_MATCH | CMP_STOP : 0;
}

View File

@ -3037,6 +3037,309 @@ AST_TEST_DEFINE(object_field_registered)
return AST_TEST_PASS;
}
static int event_observed;
static void wizard_observer(const char *name, const struct ast_sorcery_wizard *wizard)
{
if (!strcmp(wizard->name, "test")) {
event_observed = 1;
}
}
static void instance_observer(const char *name, struct ast_sorcery *sorcery)
{
if (!strcmp(name, "test_sorcery")) {
event_observed = 1;
}
}
AST_TEST_DEFINE(global_observation)
{
RAII_VAR(struct ast_sorcery_wizard *, wizard, &test_wizard, ast_sorcery_wizard_unregister);
RAII_VAR(struct ast_sorcery *, sorcery, NULL, ast_sorcery_unref);
const struct ast_sorcery_global_observer observer = {
.wizard_registered = wizard_observer,
.instance_created = instance_observer,
.wizard_unregistering = wizard_observer,
.instance_destroying = instance_observer,
};
switch (cmd) {
case TEST_INIT:
info->name = "global_observation";
info->category = "/main/sorcery/";
info->summary = "global sorcery observation test";
info->description =
"Test observation of sorcery (global)";
return AST_TEST_NOT_RUN;
case TEST_EXECUTE:
break;
}
ast_sorcery_global_observer_add(&observer);
event_observed = 0;
ast_sorcery_wizard_register(wizard);
ast_test_validate(test, (event_observed == 1), "Wizard registered failed");
event_observed = 0;
ast_sorcery_wizard_unregister(wizard);
ast_test_validate(test, (event_observed == 1), "Wizard unregistered failed");
event_observed = 0;
sorcery = ast_sorcery_open();
ast_test_validate(test, (event_observed == 1), "Instance created failed");
event_observed = 0;
ast_sorcery_unref(sorcery);
sorcery = NULL;
ast_test_validate(test, (event_observed == 1), "Instance destroyed failed");
ast_sorcery_global_observer_remove(&observer);
event_observed = 0;
ast_sorcery_wizard_register(&test_wizard);
ast_test_validate(test, (event_observed == 0), "Observer removed failed");
return AST_TEST_PASS;
}
static void instance_loaded_observer(const char *name, const struct ast_sorcery *sorcery,
int reloaded)
{
if (!strcmp(name, "test_sorcery") && !reloaded) {
event_observed++;
}
}
static void instance_reloaded_observer(const char *name,
const struct ast_sorcery *sorcery, int reloaded)
{
if (!strcmp(name, "test_sorcery") && reloaded) {
event_observed++;
}
}
static void wizard_mapped_observer(const char *name, struct ast_sorcery *sorcery,
const char *object_type, struct ast_sorcery_wizard *wizard,
const char *wizard_args, void *wizard_data)
{
if (!strcmp(name, "test_sorcery") && !strcmp(object_type, "test_object_type")
&& !strcmp(wizard->name, "memory") && !strcmp(wizard_args, "memwiz")) {
event_observed++;
}
}
static void object_type_registered_observer(const char *name,
struct ast_sorcery *sorcery, const char *object_type)
{
if (!strcmp(name, "test_sorcery") && !strcmp(object_type, "test_object_type")) {
event_observed++;
}
}
static void object_type_loaded_observer(const char *name,
const struct ast_sorcery *sorcery, const char *object_type, int reloaded)
{
if (!strcmp(name, "test_sorcery") && !strcmp(object_type, "test_object_type")
&& !reloaded) {
event_observed++;
}
}
static void object_type_reloaded_observer(const char *name,
const struct ast_sorcery *sorcery, const char *object_type, int reloaded)
{
if (!strcmp(name, "test_sorcery") && !strcmp(object_type, "test_object_type")
&& reloaded) {
event_observed++;
}
}
AST_TEST_DEFINE(instance_observation)
{
RAII_VAR(struct ast_sorcery *, sorcery, NULL, ast_sorcery_unref);
struct ast_sorcery_instance_observer observer = {
.wizard_mapped = wizard_mapped_observer,
.object_type_registered = object_type_registered_observer,
};
switch (cmd) {
case TEST_INIT:
info->name = "instance_observation";
info->category = "/main/sorcery/";
info->summary = "sorcery instance observation test";
info->description =
"Test observation of sorcery (instance)";
return AST_TEST_NOT_RUN;
case TEST_EXECUTE:
break;
}
/* Test instance load */
if (!(sorcery = ast_sorcery_open())) {
ast_test_status_update(test, "Failed to open a sorcery instance\n");
return AST_TEST_FAIL;
}
observer.instance_loading = instance_loaded_observer;
observer.instance_loaded = instance_loaded_observer;
ast_sorcery_instance_observer_add(sorcery, &observer);
event_observed = 0;
ast_sorcery_load(sorcery);
ast_test_validate(test, (event_observed == 2), "Instance loaded failed");
event_observed = 0;
ast_sorcery_reload(sorcery);
ast_test_validate(test, (event_observed == 0), "Instance reloaded failed");
/* Test instance reload */
ast_sorcery_instance_observer_remove(sorcery, &observer);
observer.instance_loading = instance_reloaded_observer;
observer.instance_loaded = instance_reloaded_observer;
ast_sorcery_instance_observer_add(sorcery, &observer);
event_observed = 0;
ast_sorcery_load(sorcery);
ast_test_validate(test, (event_observed == 0), "Instance loaded failed");
event_observed = 0;
ast_sorcery_reload(sorcery);
ast_test_validate(test, (event_observed == 2), "Instance reloaded failed");
/* Test wizard mapping */
event_observed = 0;
ast_sorcery_apply_default(sorcery, "test_object_type", "memory", "memwiz");
ast_test_validate(test, (event_observed == 1), "Wizard mapping failed");
/* Test object type register */
event_observed = 0;
ast_sorcery_internal_object_register(sorcery, "test_object_type",
test_sorcery_object_alloc, NULL, NULL);
ast_test_validate(test, (event_observed == 1), "Object type registered failed");
/* Test object type load */
ast_sorcery_instance_observer_remove(sorcery, &observer);
observer.object_type_loading = object_type_loaded_observer;
observer.object_type_loaded = object_type_loaded_observer;
ast_sorcery_instance_observer_add(sorcery, &observer);
event_observed = 0;
ast_sorcery_load_object(sorcery, "test_object_type");
ast_test_validate(test, (event_observed == 2), "Object type loaded failed");
event_observed = 0;
ast_sorcery_reload_object(sorcery, "test_object_type");
ast_test_validate(test, (event_observed == 0), "Object type reloaded failed");
/* Test object type reload */
ast_sorcery_instance_observer_remove(sorcery, &observer);
observer.object_type_loading = object_type_reloaded_observer;
observer.object_type_loaded = object_type_reloaded_observer;
ast_sorcery_instance_observer_add(sorcery, &observer);
event_observed = 0;
ast_sorcery_load_object(sorcery, "test_object_type");
ast_test_validate(test, (event_observed == 0), "Object type loaded failed");
event_observed = 0;
ast_sorcery_reload_object(sorcery, "test_object_type");
ast_test_validate(test, (event_observed == 2), "Object type reloaded failed");
ast_sorcery_instance_observer_remove(sorcery, &observer);
event_observed = 0;
ast_sorcery_apply_default(sorcery, "test_object_type", "memory", "memwiz");
ast_test_validate(test, (event_observed == 0), "Observer remove failed");
return AST_TEST_PASS;
}
static void wizard_loaded_observer(const char *name,
const struct ast_sorcery_wizard *wizard, const char *object_type, int reloaded)
{
if (!strcmp(name, "test") && !strcmp(object_type, "test_object_type")
&& !reloaded) {
event_observed++;
}
}
static void sorcery_test_load(void *data, const struct ast_sorcery *sorcery, const char *type)
{
return;
}
static void wizard_reloaded_observer(const char *name,
const struct ast_sorcery_wizard *wizard, const char *object_type, int reloaded)
{
if (!strcmp(name, "test") && !strcmp(object_type, "test_object_type")
&& reloaded) {
event_observed++;
}
}
AST_TEST_DEFINE(wizard_observation)
{
RAII_VAR(struct ast_sorcery *, sorcery, NULL, ast_sorcery_unref);
RAII_VAR(struct ast_sorcery_wizard *, wizard, &test_wizard, ast_sorcery_wizard_unregister);
struct ast_sorcery_wizard_observer observer = {
.wizard_loading = wizard_loaded_observer,
.wizard_loaded = wizard_loaded_observer,
};
switch (cmd) {
case TEST_INIT:
info->name = "wizard_observation";
info->category = "/main/sorcery/";
info->summary = "sorcery wizard observation test";
info->description =
"Test observation of sorcery (wizard)";
return AST_TEST_NOT_RUN;
case TEST_EXECUTE:
break;
}
wizard->load = sorcery_test_load;
wizard->reload = sorcery_test_load;
/* Test wizard observer remove and wizard unregister */
ast_sorcery_wizard_register(wizard);
ast_sorcery_wizard_observer_add(wizard, &observer);
ast_sorcery_wizard_observer_remove(wizard, &observer);
event_observed = 0;
ast_sorcery_wizard_unregister(wizard);
ast_test_validate(test, (event_observed == 0), "Wizard observer removed failed");
/* Setup for test loaded and reloaded */
if (!(sorcery = ast_sorcery_open())) {
ast_test_status_update(test, "Failed to open a sorcery instance\n");
return AST_TEST_FAIL;
}
ast_sorcery_wizard_register(wizard);
ast_sorcery_apply_default(sorcery, "test_object_type", "test", NULL);
ast_sorcery_internal_object_register(sorcery, "test_object_type",
test_sorcery_object_alloc, NULL, NULL);
/* Test wizard loading and loaded */
ast_sorcery_wizard_observer_add(wizard, &observer);
event_observed = 0;
ast_sorcery_load_object(sorcery, "test_object_type");
ast_test_validate(test, (event_observed == 2), "Wizard loaded failed");
event_observed = 0;
ast_sorcery_reload_object(sorcery, "test_object_type");
ast_sorcery_wizard_observer_remove(wizard, &observer);
ast_test_validate(test, (event_observed == 0), "Wizard reloaded failed");
/* Test wizard reloading and reloaded */
observer.wizard_loading = wizard_reloaded_observer;
observer.wizard_loaded = wizard_reloaded_observer;
ast_sorcery_wizard_observer_add(wizard, &observer);
event_observed = 0;
ast_sorcery_load_object(sorcery, "test_object_type");
ast_test_validate(test, (event_observed == 0), "Wizard loaded failed");
event_observed = 0;
ast_sorcery_reload_object(sorcery, "test_object_type");
ast_sorcery_wizard_observer_remove(wizard, &observer);
ast_test_validate(test, (event_observed == 2), "Wizard reloaded failed");
return AST_TEST_PASS;
}
static int unload_module(void)
{
AST_TEST_UNREGISTER(wizard_registration);
@ -3084,6 +3387,9 @@ static int unload_module(void)
AST_TEST_UNREGISTER(configuration_file_wizard_retrieve_multiple_all);
AST_TEST_UNREGISTER(dialplan_function);
AST_TEST_UNREGISTER(object_field_registered);
AST_TEST_UNREGISTER(global_observation);
AST_TEST_UNREGISTER(instance_observation);
AST_TEST_UNREGISTER(wizard_observation);
return 0;
}
@ -3135,6 +3441,9 @@ static int load_module(void)
AST_TEST_REGISTER(configuration_file_wizard_retrieve_multiple_all);
AST_TEST_REGISTER(dialplan_function);
AST_TEST_REGISTER(object_field_registered);
AST_TEST_REGISTER(global_observation);
AST_TEST_REGISTER(instance_observation);
AST_TEST_REGISTER(wizard_observation);
return AST_MODULE_LOAD_SUCCESS;
}