GObject库真的很有文件记录。很难确定创建实体的目的。也就是说,我没有得到GValue
,GTypeValueTable
,GTypeInfo
,GParamSpec
和TypeData
的角色。
简而言之,类型注册的过程如下。每种类型都由TypeNode
结构表示。 TypeNode
个结构有两个存储:static_fundamental_type_nodes array
用于存储TypeNodes
个静态基本类型,static_type_nodes_ht
哈希表用于静态非基本类型。在基本类型的情况下,每个GType
只是TypeNode
的非基本类型或TypeNode
中的static_fundamental_type_nodes
索引的内存地址。动态类型会发生什么 - 我不知道,如果可以,请解释我。相应的代码驻留在gtype_init函数中,负责类型系统的初始化:http://git.gnome.org/browse/glib/tree/gobject/gtype.c#n4323。
GValue
,GParamSpec
和GObject
本身为GTypes
,因此会将其注册为类型。
GValue
用于通过它注册新的类型值,但是如何?。
GParameters
类型(不确定)似乎需要 GParamSpec
和GObject
。究竟是怎么做到的?每个人的角色是什么?
最重要的是:GTypeValueTable
,GTypeInfo
和TypeData
的角色是什么? TypeData
引用TypeNode
并包含GTypeValueTable
以及子结构BoxedData,ClassData,IFaceData,InstanceData(为什么Instance,我们不是注册类型?)。而且,它们似乎互相复制,因为它们都包含对base_init / finalize的引用,class_init / finalize引用了GTypeValueTable
。
所以,GObject爸爸,如果你正在读这篇文章,请自己解释一下!描述你使用的那些结构的目的。
答案 0 :(得分:14)
除非您尝试处理某些非常低级别的代码,否则您真正需要关注的其中仅有两个是GValue和GParamType
我将从GParamType
GParamType
用于向GObject注册属性。比方说,我有一个名为Person的GObject子类,我希望它有两个属性:Name和Age。在class_init
函数中,我会像这样注册这些
{
GParamSpec *pspec;
. . .
pspec = g_param_spec_string ("name", "Name", "The name of the person", "", G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (object_class, PROP_NAME, pspec);
pspec = g_param_spec_int ("age", "Age", "The age of the person", 0, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (object_class, PROP_AGE, spec);
. . .
}
现在您可以在这些属性上调用g_object_get
或g_object_set
,系统将知道如何处理它
char *name;
int age;
g_object_set (G_OBJECT (person), "name", "Steve", "age", 37, NULL);
g_object_get (G_OBJECT (person), "name", &name, "age", &age, NULL);
g_print ("%s is %d years old\n", name, age);
// And because the type system knows when a property is a string, it knows how to give
// you a copy of the string, so you need to free it once you've finished with it
g_free (name);
这里解释了各种参数:GParamSpec所有标准类型都有GValue类型:字符串,bool,int等,而其他一些库(如GStreamer)将注册自己的自定义类型。
在GObjectClass上安装属性之外,您很少需要处理GParamSpec。它们出现的两个主要场合是GObjectClass set / get_property方法和GObject通知信号。在最后一种情况下,通过调用g_param_spec_get_name
检测哪个属性已收到通知信号很有用,但实际上最好使用更具体的通知信号,如下所示:
g_signal_connect (person, "notify::name", G_CALLBACK (name_changed_cb), NULL);
g_signal_connect (person, "notify::age", G_CALLBACK (age_changed_cb), NULL);
而不是
g_signal_connect (person, "notify", G_CALLBACK (something_changed_cb), NULL);
有时您可能想要创建自己的结构并将其用于属性。例如,如果我有
struct _PersonDetails {
char *name;
int age;
}
而不是在Person对象上有两个属性,我想要一个名为“details”的属性。 GLib类型系统不知道如何处理我的自定义struct _PersonDetails
所以我需要为它创建一个盒装类型,以便它知道如何正确地复制/释放结构,因为它在Glib内部传递。这就是GValue
的用武之地。
GValue
用于包装不同类型的值,以便可以正确地复制和释放它们(如果需要),以便可以使用泛型函数。
例如,GObjectClass方法set_property具有
的原型void set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec)
这意味着可以传入任何可以由GValue表示的类型,并且不需要特定的函数,例如set_int_property,set_string_property,set_bool_property。
这也意味着函数g_object_set
和g_object_get
知道如何处理传入的参数,因为它知道属性“name”被注册为字符串类型,并且它具有复制/释放该字符串所需的功能。
有关GValue的更多信息,请访问此处 - Generic values
要使用GLib类型系统注册我们的自定义struct _PersonDetails
,我们将创建一个自定义Boxed类型,告诉系统如何复制和释放它。详细信息如下:Boxed Types
G_DEFINE_BOXED_TYPE (PersonDetails, person_details,
person_details_copy,
person_details_free)
. . .
static gpointer
person_details_copy (gpointer data)
{
struct _PersonDetails *details = (struct _PersonDetails *)data;
struct _PersonDetails *copy = g_new (struct _PersonDetails, 1);
// We need to copy the string
copy->name = g_strdup (details->name);
copy->age = details->age;
return (gpointer) copy;
}
static void
person_details_free (gpointer data)
{
struct _PersonDetails *details = (struct _PersonDetails *)data;
// name was allocated so it needs freed as well
g_free (details->name);
g_free (details);
}
现在我们可以使用
注册我们的类型pspec = g_param_spec_boxed ("details", "Details", "The person's details", person_details_get_type (), G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_property (object_class, PROP_DETAILS, pspec);