qom: Change object property iterator API contract

Currently the ObjectProperty iterator API works as follows:

  ObjectPropertyIterator *iter;

  iter = object_property_iter_init(obj);
  while ((prop = object_property_iter_next(iter))) {
     ...
  }
  object_property_iter_free(iter);

This has the benefit that the ObjectPropertyIterator struct
can be opaque, but has the downside that callers need to
explicitly call a free function. It is also not in keeping
with iterator style used elsewhere in QEMU/GLib2.

This patch changes the API to use stack allocation instead:

  ObjectPropertyIterator iter;

  object_property_iter_init(&iter, obj);
  while ((prop = object_property_iter_next(&iter))) {
     ...
  }

Reviewed-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
[AF: Fused ObjectPropertyIterator struct with typedef]
Signed-off-by: Andreas Färber <afaerber@suse.de>
master
Daniel P. Berrange 2015-12-09 12:34:02 +00:00 committed by Andreas Färber
parent 16bf7f522a
commit 7746abd8e9
7 changed files with 36 additions and 58 deletions

View File

@ -684,7 +684,7 @@ int spapr_drc_populate_dt(void *fdt, int fdt_offset, Object *owner,
{ {
Object *root_container; Object *root_container;
ObjectProperty *prop; ObjectProperty *prop;
ObjectPropertyIterator *iter; ObjectPropertyIterator iter;
uint32_t drc_count = 0; uint32_t drc_count = 0;
GArray *drc_indexes, *drc_power_domains; GArray *drc_indexes, *drc_power_domains;
GString *drc_names, *drc_types; GString *drc_names, *drc_types;
@ -708,8 +708,8 @@ int spapr_drc_populate_dt(void *fdt, int fdt_offset, Object *owner,
*/ */
root_container = container_get(object_get_root(), DRC_CONTAINER_PATH); root_container = container_get(object_get_root(), DRC_CONTAINER_PATH);
iter = object_property_iter_init(root_container); object_property_iter_init(&iter, root_container);
while ((prop = object_property_iter_next(iter))) { while ((prop = object_property_iter_next(&iter))) {
Object *obj; Object *obj;
sPAPRDRConnector *drc; sPAPRDRConnector *drc;
sPAPRDRConnectorClass *drck; sPAPRDRConnectorClass *drck;
@ -750,7 +750,6 @@ int spapr_drc_populate_dt(void *fdt, int fdt_offset, Object *owner,
spapr_drc_get_type_str(drc->type)); spapr_drc_get_type_str(drc->type));
drc_types = g_string_insert_len(drc_types, -1, "\0", 1); drc_types = g_string_insert_len(drc_types, -1, "\0", 1);
} }
object_property_iter_free(iter);
/* now write the drc count into the space we reserved at the /* now write the drc count into the space we reserved at the
* beginning of the arrays previously * beginning of the arrays previously

View File

@ -966,7 +966,10 @@ ObjectProperty *object_property_find(Object *obj, const char *name,
ObjectProperty *object_class_property_find(ObjectClass *klass, const char *name, ObjectProperty *object_class_property_find(ObjectClass *klass, const char *name,
Error **errp); Error **errp);
typedef struct ObjectPropertyIterator ObjectPropertyIterator; typedef struct ObjectPropertyIterator {
ObjectClass *nextclass;
GHashTableIter iter;
} ObjectPropertyIterator;
/** /**
* object_property_iter_init: * object_property_iter_init:
@ -984,32 +987,27 @@ typedef struct ObjectPropertyIterator ObjectPropertyIterator;
* <title>Using object property iterators</title> * <title>Using object property iterators</title>
* <programlisting> * <programlisting>
* ObjectProperty *prop; * ObjectProperty *prop;
* ObjectPropertyIterator *iter; * ObjectPropertyIterator iter;
* *
* iter = object_property_iter_init(obj); * object_property_iter_init(&iter, obj);
* while ((prop = object_property_iter_next(iter))) { * while ((prop = object_property_iter_next(&iter))) {
* ... do something with prop ... * ... do something with prop ...
* } * }
* object_property_iter_free(iter);
* </programlisting> * </programlisting>
* </example> * </example>
*
* Returns: the new iterator
*/ */
ObjectPropertyIterator *object_property_iter_init(Object *obj); void object_property_iter_init(ObjectPropertyIterator *iter,
Object *obj);
/**
* object_property_iter_free:
* @iter: the iterator instance
*
* Releases any resources associated with the iterator.
*/
void object_property_iter_free(ObjectPropertyIterator *iter);
/** /**
* object_property_iter_next: * object_property_iter_next:
* @iter: the iterator instance * @iter: the iterator instance
* *
* Return the next available property. If no further properties
* are available, a %NULL value will be returned and the @iter
* pointer should not be used again after this point without
* re-initializing it.
*
* Returns: the next property, or %NULL when all properties * Returns: the next property, or %NULL when all properties
* have been traversed. * have been traversed.
*/ */

View File

@ -137,7 +137,7 @@ static void netfilter_complete(UserCreatable *uc, Error **errp)
Error *local_err = NULL; Error *local_err = NULL;
char *str, *info; char *str, *info;
ObjectProperty *prop; ObjectProperty *prop;
ObjectPropertyIterator *iter; ObjectPropertyIterator iter;
StringOutputVisitor *ov; StringOutputVisitor *ov;
if (!nf->netdev_id) { if (!nf->netdev_id) {
@ -174,8 +174,8 @@ static void netfilter_complete(UserCreatable *uc, Error **errp)
QTAILQ_INSERT_TAIL(&nf->netdev->filters, nf, next); QTAILQ_INSERT_TAIL(&nf->netdev->filters, nf, next);
/* generate info str */ /* generate info str */
iter = object_property_iter_init(OBJECT(nf)); object_property_iter_init(&iter, OBJECT(nf));
while ((prop = object_property_iter_next(iter))) { while ((prop = object_property_iter_next(&iter))) {
if (!strcmp(prop->name, "type")) { if (!strcmp(prop->name, "type")) {
continue; continue;
} }
@ -189,7 +189,6 @@ static void netfilter_complete(UserCreatable *uc, Error **errp)
g_free(str); g_free(str);
g_free(info); g_free(info);
} }
object_property_iter_free(iter);
} }
static void netfilter_finalize(Object *obj) static void netfilter_finalize(Object *obj)

14
qmp.c
View File

@ -210,7 +210,7 @@ ObjectPropertyInfoList *qmp_qom_list(const char *path, Error **errp)
bool ambiguous = false; bool ambiguous = false;
ObjectPropertyInfoList *props = NULL; ObjectPropertyInfoList *props = NULL;
ObjectProperty *prop; ObjectProperty *prop;
ObjectPropertyIterator *iter; ObjectPropertyIterator iter;
obj = object_resolve_path(path, &ambiguous); obj = object_resolve_path(path, &ambiguous);
if (obj == NULL) { if (obj == NULL) {
@ -223,8 +223,8 @@ ObjectPropertyInfoList *qmp_qom_list(const char *path, Error **errp)
return NULL; return NULL;
} }
iter = object_property_iter_init(obj); object_property_iter_init(&iter, obj);
while ((prop = object_property_iter_next(iter))) { while ((prop = object_property_iter_next(&iter))) {
ObjectPropertyInfoList *entry = g_malloc0(sizeof(*entry)); ObjectPropertyInfoList *entry = g_malloc0(sizeof(*entry));
entry->value = g_malloc0(sizeof(ObjectPropertyInfo)); entry->value = g_malloc0(sizeof(ObjectPropertyInfo));
@ -234,7 +234,6 @@ ObjectPropertyInfoList *qmp_qom_list(const char *path, Error **errp)
entry->value->name = g_strdup(prop->name); entry->value->name = g_strdup(prop->name);
entry->value->type = g_strdup(prop->type); entry->value->type = g_strdup(prop->type);
} }
object_property_iter_free(iter);
return props; return props;
} }
@ -506,7 +505,7 @@ DevicePropertyInfoList *qmp_device_list_properties(const char *typename,
ObjectClass *klass; ObjectClass *klass;
Object *obj; Object *obj;
ObjectProperty *prop; ObjectProperty *prop;
ObjectPropertyIterator *iter; ObjectPropertyIterator iter;
DevicePropertyInfoList *prop_list = NULL; DevicePropertyInfoList *prop_list = NULL;
klass = object_class_by_name(typename); klass = object_class_by_name(typename);
@ -535,8 +534,8 @@ DevicePropertyInfoList *qmp_device_list_properties(const char *typename,
obj = object_new(typename); obj = object_new(typename);
iter = object_property_iter_init(obj); object_property_iter_init(&iter, obj);
while ((prop = object_property_iter_next(iter))) { while ((prop = object_property_iter_next(&iter))) {
DevicePropertyInfo *info; DevicePropertyInfo *info;
DevicePropertyInfoList *entry; DevicePropertyInfoList *entry;
@ -567,7 +566,6 @@ DevicePropertyInfoList *qmp_device_list_properties(const char *typename,
entry->next = prop_list; entry->next = prop_list;
prop_list = entry; prop_list = entry;
} }
object_property_iter_free(iter);
object_unref(obj); object_unref(obj);

View File

@ -67,11 +67,6 @@ struct TypeImpl
InterfaceImpl interfaces[MAX_INTERFACES]; InterfaceImpl interfaces[MAX_INTERFACES];
}; };
struct ObjectPropertyIterator {
ObjectClass *nextclass;
GHashTableIter iter;
};
static Type type_interface; static Type type_interface;
static GHashTable *type_table_get(void) static GHashTable *type_table_get(void)
@ -999,20 +994,11 @@ ObjectProperty *object_property_find(Object *obj, const char *name,
return NULL; return NULL;
} }
ObjectPropertyIterator *object_property_iter_init(Object *obj) void object_property_iter_init(ObjectPropertyIterator *iter,
Object *obj)
{ {
ObjectPropertyIterator *ret = g_new0(ObjectPropertyIterator, 1); g_hash_table_iter_init(&iter->iter, obj->properties);
g_hash_table_iter_init(&ret->iter, obj->properties); iter->nextclass = object_get_class(obj);
ret->nextclass = object_get_class(obj);
return ret;
}
void object_property_iter_free(ObjectPropertyIterator *iter)
{
if (!iter) {
return;
}
g_free(iter);
} }
ObjectProperty *object_property_iter_next(ObjectPropertyIterator *iter) ObjectProperty *object_property_iter_next(ObjectPropertyIterator *iter)

View File

@ -455,11 +455,11 @@ static void test_dummy_iterator(void)
NULL)); NULL));
ObjectProperty *prop; ObjectProperty *prop;
ObjectPropertyIterator *iter; ObjectPropertyIterator iter;
bool seenbv = false, seensv = false, seenav = false, seentype; bool seenbv = false, seensv = false, seenav = false, seentype;
iter = object_property_iter_init(OBJECT(dobj)); object_property_iter_init(&iter, OBJECT(dobj));
while ((prop = object_property_iter_next(iter))) { while ((prop = object_property_iter_next(&iter))) {
if (g_str_equal(prop->name, "bv")) { if (g_str_equal(prop->name, "bv")) {
seenbv = true; seenbv = true;
} else if (g_str_equal(prop->name, "sv")) { } else if (g_str_equal(prop->name, "sv")) {
@ -474,7 +474,6 @@ static void test_dummy_iterator(void)
g_assert_not_reached(); g_assert_not_reached();
} }
} }
object_property_iter_free(iter);
g_assert(seenbv); g_assert(seenbv);
g_assert(seenav); g_assert(seenav);
g_assert(seensv); g_assert(seensv);

7
vl.c
View File

@ -1535,14 +1535,14 @@ MachineInfoList *qmp_query_machines(Error **errp)
static int machine_help_func(QemuOpts *opts, MachineState *machine) static int machine_help_func(QemuOpts *opts, MachineState *machine)
{ {
ObjectProperty *prop; ObjectProperty *prop;
ObjectPropertyIterator *iter; ObjectPropertyIterator iter;
if (!qemu_opt_has_help_opt(opts)) { if (!qemu_opt_has_help_opt(opts)) {
return 0; return 0;
} }
iter = object_property_iter_init(OBJECT(machine)); object_property_iter_init(&iter, OBJECT(machine));
while ((prop = object_property_iter_next(iter))) { while ((prop = object_property_iter_next(&iter))) {
if (!prop->set) { if (!prop->set) {
continue; continue;
} }
@ -1555,7 +1555,6 @@ static int machine_help_func(QemuOpts *opts, MachineState *machine)
error_printf("\n"); error_printf("\n");
} }
} }
object_property_iter_free(iter);
return 1; return 1;
} }