QEMU源码全解析25 —— QOM介绍（14）

接前一篇文章：QEMU源码全解析24 —— QOM介绍（13）

本文内容参考：

《趣谈Linux操作系统》 —— 刘超，极客时间

《QEMU/KVM》源码解析与应用 —— 李强，机械工业出版社

特此致谢！

本文开始对于属性ObjectProperty进行深入讲解。

ObjectProperty结构在include/qom/object.h中定义，代码如下：

typedef struct ObjectProperty ObjectProperty;……struct ObjectProperty
{char *name;char *type;char *description;ObjectPropertyAccessor *get;ObjectPropertyAccessor *set;ObjectPropertyResolve *resolve;ObjectPropertyRelease *release;ObjectPropertyInit *init;void *opaque;QObject *defval;
};

其中：

• name：表示名字；
• type：表示属性的类型。如有的属性是字符串，有的是bool类型，有的是link等其它更复杂的类型；
• description：表示对于属性的描述；
• get：对属性进行获取；
• set：对属性进行设置；
• resolve：对属性进行操作；
• release：对属性进行释放；
• opaque：指向一个具体的属性，如BoolProperty等。

每一种具体的属性都会有一个结构体来描述它。例如：表示布尔类型的属性的BoolProperty、表示字符串类型的属性的StringProperty以及表示link类型的属性的LinkProperty。三者都在qom/object.c中定义（不挨着），定义分别如下：

typedef struct {union {Object **targetp;Object *target; /* if OBJ_PROP_LINK_DIRECT, when holding the pointer  */ptrdiff_t offset; /* if OBJ_PROP_LINK_CLASS */};void (*check)(const Object *, const char *, Object *, Error **);ObjectPropertyLinkFlags flags;
} LinkProperty;……typedef struct StringProperty
{char *(*get)(Object *, Error **);void (*set)(Object *, const char *, Error **);
} StringProperty;……typedef struct BoolProperty
{bool (*get)(Object *, Error **);void (*set)(Object *, bool, Error **);
} BoolProperty;

总结一下Object、ObjectProperty和各个具体属性的关系：

• Object（struct object）-> GHashTable *properties中存放着属性名到ObjectProperty（struct ObjectProperty）的映射。
• ObjectProperty -> void *opaque指向一个具体的属性。

下边介绍几个属性的操作接口。属性的添加分为类属性的添加和对象属性的添加。

对于对象属性来说，其属性添加是通过object_property_add接口完成的。object_property_add函数在qom/object.c中，代码如下：

ObjectProperty *
object_property_add(Object *obj, const char *name, const char *type,ObjectPropertyAccessor *get,ObjectPropertyAccessor *set,ObjectPropertyRelease *release,void *opaque)
{return object_property_try_add(obj, name, type, get, set, release,opaque, &error_abort);
}

该函数实际上是object_property_try_add函数的简单封装，object_property_try_add函数就在上边，代码如下：

ObjectProperty *
object_property_try_add(Object *obj, const char *name, const char *type,ObjectPropertyAccessor *get,ObjectPropertyAccessor *set,ObjectPropertyRelease *release,void *opaque, Error **errp)
{ObjectProperty *prop;size_t name_len = strlen(name);if (name_len >= 3 && !memcmp(name + name_len - 3, "[*]", 4)) {int i;ObjectProperty *ret = NULL;char *name_no_array = g_strdup(name);name_no_array[name_len - 3] = '\0';for (i = 0; i < INT16_MAX; ++i) {char *full_name = g_strdup_printf("%s[%d]", name_no_array, i);ret = object_property_try_add(obj, full_name, type, get, set,release, opaque, NULL);g_free(full_name);if (ret) {break;}}g_free(name_no_array);assert(ret);return ret;}if (object_property_find(obj, name) != NULL) {error_setg(errp, "attempt to add duplicate property '%s' to object (type '%s')",name, object_get_typename(obj));return NULL;}prop = g_malloc0(sizeof(*prop));prop->name = g_strdup(name);prop->type = g_strdup(type);prop->get = get;prop->set = set;prop->release = release;prop->opaque = opaque;g_hash_table_insert(obj->properties, prop->name, prop);return prop;
}

先不管通配符的情况，即if (name_len >= 3 && !memcmp(name + name_len - 3, "[*]", 4)) 条件判断中的内容，直接跳过往下看。首先调用object_property_find函数来确认所插入的属性是否已经存在。如果已存在，则报错返回，确保不会添加重复的属性。

随后分配一个ObjectProperty结构并使用函数参数进行初始化。代码片段如下：

    prop = g_malloc0(sizeof(*prop));prop->name = g_strdup(name);prop->type = g_strdup(type);prop->get = get;prop->set = set;prop->release = release;prop->opaque = opaque;

最后，调用以下代码将其插入到对象的properties域中，并返回此prop：

g_hash_table_insert(obj->properties, prop->name, prop);

返回头来，看一下object_property_find函数的具体实现。object_property_find函数在同文件（qom/object.c）中，代码如下：

ObjectProperty *object_property_find(Object *obj, const char *name)
{ObjectProperty *prop;ObjectClass *klass = object_get_class(obj);prop = object_class_property_find(klass, name);if (prop) {return prop;}return g_hash_table_lookup(obj->properties, name);
}​

此函数首先调用object_get_class函数由Object结构对象（的指针）obj得到ObjectClass对象（的指针）kclass。object_get_class函数在qom/object.c中，代码如下：

ObjectClass *object_get_class(Object *obj)
{return obj->class;
}

然后，调用object_class_property_find函数以确认自己所属的类以及所有父类都不存在这个属性。object_class_property_find函数同样在qom/object.c中，代码如下：

ObjectProperty *object_class_property_find(ObjectClass *klass, const char *name)
{ObjectClass *parent_klass;parent_klass = object_class_get_parent(klass);if (parent_klass) {ObjectProperty *prop =object_class_property_find(parent_klass, name);if (prop) {return prop;}}return g_hash_table_lookup(klass->properties, name);
}

最后，在遍历（递归）完所有父类之后，调用g_hash_table_lookup(obj->properties, name);在自己的域中查找。

欲知后事如何，且看下回分解。