qom: allow properties to be registered against classes
PATCH v2 1/1 qom: allow properties to be registered against classes
When there are many instances of a given class, registering properties against the instance is wasteful of resources. The majority of objects have a statically defined list of possible properties, so most of the properties are easily registerable against the class. Only those properties which are conditionally registered at runtime need be recorded against the klass.
Registering properties against classes also makes it possible to provide static introspection of QOM - currently introspection is only possible after creating an instance of a class, which severely limits its usefulness.
This impl only supports simple scalar properties. It does not attempt to allow child object / link object properties against the class. There are ways to support those too, but it would make this patch more complicated, so it is left as an exercise for the future.
There is no equivalent to object_property_del provided, since classes must be immutable once they are defined.
---
Changed in v2:
- Clarify in commit message that prop deletion is intentionally not provided against classes
- Remove automatic expansion of "[*]" property names, leaving it to the caller todo this if desired.
include/qom/object.h | 44 +++++++++++ qom/object.c | 212 +++++++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 249 insertions(+), 7 deletions(-)
include/qom/object.h +44 -0
@@ -383,6 +383,8 @@ struct ObjectClassconst char *class_cast_cache[OBJECT_CLASS_CAST_CACHE ];ObjectUnparent *unparent; + + QTAILQ_HEAD(, ObjectProperty) properties; };/**
@@ -949,6 +951,13 @@ ObjectProperty *object_property_add(Object *obj, const char *name,void object_property_del (Object *obj,const char *name,Error **errp); +ObjectProperty *object_class_property_add (ObjectClass *klass,const char *name, +const char *type, +ObjectPropertyAccessor *get, +ObjectPropertyAccessor *set, +ObjectPropertyRelease *release, +void *opaque,Error **errp); +/** * object_property_find: * @obj: the object
@@ -959,6 +968,8 @@ void object_property_del(Object *obj, const char *name, Error **errp);*/ ObjectProperty *object_property_find (Object *obj,const char *name,Error **errp); +ObjectProperty *object_class_property_find (ObjectClass *klass,const char *name, +Error **errp);void object_unparent (Object *obj);
@@ -1327,6 +1338,12 @@ void object_property_add_str(Object *obj, const char *name,void (*set)(Object *,const char *,Error **), Error **errp); +void object_class_property_add_str (ObjectClass *klass,const char *name, +char *(*get)(Object *,Error **), +void (*set)(Object *,const char *, +Error **), +Error **errp); +/** * object_property_add_bool: * @obj: the object to add a property to
@@ -1343,6 +1360,11 @@ void object_property_add_bool(Object *obj, const char *name,void (*set)(Object *,bool ,Error **), Error **errp); +void object_class_property_add_bool (ObjectClass *klass,const char *name, +bool (*get)(Object *,Error **), +void (*set)(Object *,bool ,Error **), +Error **errp); +/** * object_property_add_enum: * @obj: the object to add a property to
@@ -1362,6 +1384,13 @@ void object_property_add_enum(Object *obj, const char *name,void (*set)(Object *,int ,Error **), Error **errp); +void object_class_property_add_enum (ObjectClass *klass,const char *name, +const char *typename, +const char *const *strings, +int (*get)(Object *,Error **), +void (*set)(Object *,int ,Error **), +Error **errp); +/** * object_property_add_tm: * @obj: the object to add a property to
@@ -1376,6 +1405,10 @@ void object_property_add_tm(Object *obj, const char *name,void (*get)(Object *,struct tm *,Error **), Error **errp); +void object_class_property_add_tm (ObjectClass *klass,const char *name, +void (*get)(Object *,struct tm *,Error **), +Error **errp); +/** * object_property_add_uint8_ptr: * @obj: the object to add a property to
@@ -1388,6 +1421,8 @@ void object_property_add_tm(Object *obj, const char *name,*/ void object_property_add_uint8_ptr (Object *obj,const char *name,const uint8_t *v,Error **errp); +void object_class_property_add_uint8_ptr (ObjectClass *klass,const char *name, +const uint8_t *v,Error **errp);/** * object_property_add_uint16_ptr:
@@ -1401,6 +1436,8 @@ void object_property_add_uint8_ptr(Object *obj, const char *name,*/ void object_property_add_uint16_ptr (Object *obj,const char *name,const uint16_t *v,Error **errp); +void object_class_property_add_uint16_ptr (ObjectClass *klass,const char *name, +const uint16_t *v,Error **errp);/** * object_property_add_uint32_ptr:
@@ -1414,6 +1451,8 @@ void object_property_add_uint16_ptr(Object *obj, const char *name,*/ void object_property_add_uint32_ptr (Object *obj,const char *name,const uint32_t *v,Error **errp); +void object_class_property_add_uint32_ptr (ObjectClass *klass,const char *name, +const uint32_t *v,Error **errp);/** * object_property_add_uint64_ptr:
@@ -1427,6 +1466,8 @@ void object_property_add_uint32_ptr(Object *obj, const char *name,*/ void object_property_add_uint64_ptr (Object *obj,const char *name,const uint64_t *v,Error **Errp); +void object_class_property_add_uint64_ptr (ObjectClass *klass,const char *name, +const uint64_t *v,Error **Errp);/** * object_property_add_alias:
@@ -1478,6 +1519,9 @@ void object_property_add_const_link(Object *obj, const char *name,*/ void object_property_set_description (Object *obj,const char *name,const char *description,Error **errp); +void object_class_property_set_description (ObjectClass *klass,const char *name, +const char *description, +Error **errp);/** * object_child_foreach:
qom/object.c +205 -7
300 lines not on this page · raw message
Signature · 1 line
2.4.3