8

GObject 库的文档非常详细。很难弄清楚创建实体的目的。也就是说,我没有得到GValueGTypeValueTableGTypeInfoGParamSpec的角色TypeData

简而言之,类型注册的过程如下。每种类型都由一个TypeNode结构表示。有两种TypeNode结构存储:static_fundamental_type_nodes array用于存储TypeNodes静态基本类型和static_type_nodes_ht用于静态非基本类型的哈希表。在非基本类型的情况下,每个GType只是对应的内存地址或在基本类型的情况下的索引。动态类型会发生什么 - 我不知道,如果可以请解释一下。对应的代码位于 gtype_init 函数中,负责类型系统的初始化:http ://git.gnome.org/browse/glib/tree/gobject/gtype.c#n4323 。 TypeNodeTypeNodestatic_fundamental_type_nodes

在此处输入图像描述

GValue,GParamSpec并且GObjectGTypes它们自己,所以它们被注册为类型。

GValue意味着用于通过它注册新的类型值,但是如何呢?

GParameters并且GParamSpec似乎需要注册GObject类型(不确定)。它究竟是如何完成的?各自的作用是什么?

最重要的是: 和 的作用GTypeValueTableGTypeInfo什么TypeDataTypeData由BoxedData、ClassData、IFaceData、InstanceData 引用TypeNode并包含子结构(为什么是 Instance,我们不是在注册类型吗?)。GTypeValueTable此外,它们似乎相互重复,因为它们都包含对 base_init/finalize 的引用,class_init/finalize 具有对GTypeValueTable.

所以,GObject 爸爸,如果你正在阅读这篇文章,请解释一下自己!描述你使用的那些结构的目的。

4

1 回答 1

18

除非您尝试处理一些非常低级的代码,否则您真正需要关心的仅有两个是 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 类型:strings、bools、ints 等,而 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 对象上有两个属性,我想要一个称为“详细信息”的属性。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 的信息可以在这里找到 -通用值

为了struct _PersonDetails向 GLib 类型系统注册我们的自定义,我们将创建一个自定义 Boxed 类型,它告诉系统如何复制和释放它。详细信息在这里:盒装类型

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);
于 2013-02-13T07:48:04.493 回答