2. gobject中G_DEFINE_TYPE和g_object_new流程简介

C语言如何实现gobject面向对象支持呢？很简单，我们只需要建立自己的头文件，并在 .c 文件中添加一个宏定义G_DEFINE_TYPE即可。

 

G_DEFINE_TYPE 的流程（G_DEFINE_TYPE在 GLIB 的gobject/gtype.h 中定义）：

#define G_DEFINE_TYPE(TN, t_n, T_P) G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, 0, {})

#define G_DEFINE_TYPE_EXTENDED(TN, t_n, T_P, _f_, _C_)      _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, _f_) {_C_;} _G_DEFINE_TYPE_EXTENDED_END()

#define _G_DEFINE_TYPE_EXTENDED_BEGIN(TypeName, type_name, TYPE_PARENT, flags) \
\
static void     type_name##_init              (TypeName        *self); \
static void     type_name##_class_init        (TypeName##Class *klass); \
static gpointer type_name##_parent_class = NULL; \
static void     type_name##_class_intern_init (gpointer klass) \
{ \
  type_name##_parent_class = g_type_class_peek_parent (klass); \
  type_name##_class_init ((TypeName##Class*) klass); \
} \
\
gulong\
type_name##_get_type (void) \
{ \
  static volatile gsize g_define_type_id__volatile = 0; \
  if (g_once_init_enter (&g_define_type_id__volatile))  \
    { \
      gulongg_define_type_id = \
        g_type_register_static_simple (TYPE_PARENT, \
                                       g_intern_static_string (#TypeName), \
                                       sizeof (TypeName##Class), \
                                       (GClassInitFunc) type_name##_class_intern_init, \
                                       sizeof (TypeName), \
                                       (GInstanceInitFunc) type_name##_init, \
                                       (GTypeFlags) flags); \
      { /* custom code follows */
	      #define _G_DEFINE_TYPE_EXTENDED_END()   \
        /* following custom code */ \
      }                 \
      g_once_init_leave (&g_define_type_id__volatile, g_define_type_id); \
    }                   \
  return g_define_type_id__volatile;    \
} /* closes type_name##_get_type() */

下面以gtk_gadget为例, 一般来说 gtk_表示命名空间,gadget表示对象名字.

/******** 首先在.h头文件中，会看到这样的语句 ***********/

GType gtk_gadget_get_type(void);

/******** 在对应的.c文件中就会有G_DEFINE_TYPE这个宏的声明 ***********/

G_DEFINE_TYPE(GtkGadget, gtk_gadget, G_TYPE_OBJECT)

G_DEFINE_TYPE 宏会声明一些函数, 并且实现了gtk_gadget_get_type(void)，所以才需要在对应的.h头文件中声明gtk_gadget_get_type这个函数。下面这个例子来自于 gobject 的参考手册:

static void     gtk_gadget_init       (GtkGadget      *self);
static void     gtk_gadget_class_init (GtkGadgetClass *klass);
static gpointer gtk_gadget_parent_class = NULL;
static void     gtk_gadget_class_intern_init (gpointer klass)
{
  gtk_gadget_parent_class = g_type_class_peek_parent (klass);
  gtk_gadget_class_init ((GtkGadgetClass*) klass);
}

GType
gtk_gadget_get_type (void)
{
  static volatile gsize g_define_type_id__volatile = 0;
  if (g_once_init_enter (&g_define_type_id__volatile))
    {
      GType g_define_type_id =
        g_type_register_static_simple (GTK_TYPE_WIDGET,
                                       g_intern_static_string ("GtkGadget"),
                                       sizeof (GtkGadgetClass),
                                       (GClassInitFunc) gtk_gadget_class_intern_init,
                                       sizeof (GtkGadget),
                                       (GInstanceInitFunc) gtk_gadget_init,
                                       0);
      {
        const GInterfaceInfo g_implement_interface_info = {
          (GInterfaceInitFunc) gtk_gadget_gizmo_init
        };
        g_type_add_interface_static (g_define_type_id, TYPE_GIZMO, &g_implement_interface_info);
      }
      g_once_init_leave (&g_define_type_id__volatile, g_define_type_id);
    }
  return g_define_type_id__volatile;
}

从上面的代码中可以看出来，如果在.c文件中声明一个G_DEFINE_TYPE宏的话，就会自动生成一个gtk_gadget_get_type(void)函数，而这也就是需要在.h头文件中声明的原因，代码中, 最关键的部分是:

g_type_register_static_simple(GTK_TYPE_WIDGET,
                              g_intern_static_string ("GtkGadget"),
                              sizeof (GtkGadgetClass),
                              (GClassInitFunc) gtk_gadget_class_intern_init,
                              sizeof (GtkGadget),
                              (GInstanceInitFunc) gtk_gadget_init,
                              (GTypeFlags) flags);

g_type_register_static_simple 这个函数的作用, 就是将用户自己定义的类型注册到系统中, 从上面的代码我们还可以看出, G_DEFINE_TYPE 声明了两个函数, 但是并没有实现, 需要定义对象的用户自己去实现, 这两个函数是:

static void    gtk_gadget_init      (GtkGadget      *self);

static void     gtk_gadget_class_init (GtkGadgetClass*klass);

这两个函数是对象的初始化函数, 相当于C++中的构造函数, 第一个函数在每个对象创建的时候都会被调用, 第二个函数只有在第一次创建对象的时候才会被调用. 确切的说, 是调用 g_type_class_ref 时, 如果 class 没有初始化, 就会调用 gtk_gadget_class_init.

 

再来看看g_object_new函数的原型：

这个函数是个可变参数的函数, 第一个参数是需要创建的对象的类型, 当使用 g_object_new 来创建对象的时候, 这个参数是必须的,同时它还要求这个函数所创建的对象必须是GObject的子对象. 在我们定义自己的对象时, 必须要在系统中注册自己的类型, 这里的系统指的是 glib 的系统,即 glib 自己维护的一套数据结构. 先说一下第二个参数, 从第二个参数开始, 表示的是object 的属性, 它们都是成对出现的,如果没有属性需要在创建对象的时候设置, 则第二个参数设置成 NULL. 如果有属性要设置, 那么最后一个参数也要设置成 NULL. 一个来自于 gtk 的例子(gtk 中的对象, 都是继承自gobject):

/* 没有属性 */

g_object_new (GTK_TYPE_TOOL_ITEM, NULL);

/* 有一个属性 */

g_object_new (GTK_TYPE_TOOL_ITEM_GROUP, "label", label, NULL);

下面来看整个的调用过程, 一般调用的方式为:

g_object_new(gtk_gadget_get_type(), NULL);

这里我们假设没有属性需要设置. 在真实的代码中, 我们一般会定义一个宏来使用gtk_gadget_get_type():

#define GTK_TYPE_GADGET   (gtk_gadget_get_type())

所以一般的我们会写成:

g_object_new (GTK_TYPE_GADGET, NULL);

这样看上去更加的清晰.

GTK_TYPE_GADGET宏会取得这个对象的类型, 在 glib 中, 这个类型是一个唯一标示符. g_object_new 首先会确认 object_type (g_object_new 的第一个参数)是否是一个 gobject 对象.然后检查是否有属性值需要设置, 如果属性值为 NULL, 那么直接调用 g_object_newv. 如果需要设置属性值, 则调用 g_object_new_valist.

g_object_newv 的原型是:

gpointer
g_object_newv (GType       object_type,
               guint       n_parameters,
               GParameter *parameters)

这个函数的具体功能可以参考手册, g_object_new 是这样调用这个函数的:

g_object_newv(object_type,0, NULL);

g_object_newv 会调用 g_type_class_peek_static(object_type) 来取得 object_type的 class, 如果取回来的 class 为空, 那么就会调用g_type_class_ref(object_type), g_type_class_ref 会查找node, node 中会记录 class 相关信息, 如果 class 没有初始化,那么会调用type_class_init_Wm. type_class_init_Wm 会初始化 class, 如果在注册类型的时候指定了 class_init, 那么会调用 class_init. 接下来, 由于传递给 g_object_newv 的 n_parameters 和 parameters 都为空, 所以会直接调用 gobject class 的constructor 来构造对象. constructor 是 gobject class 的一个函数. 一般是 g_object_constructor, 用户可以创建自己的 constructor函数, 在自定义对象的 class_init 中将 GObject 中的 constructor, 改成自己需要的 constructor. 这样的行为类似于 C++ 中的虚函数. g_object_constructor 会调用g_type_create_instance 来创建对象实例(分配内存), g_type_create_instance 会调依次调用祖先对象的初始化函数,调用完成后再调用自己对象的初始化函数, 在这里就是 gtk_gadget_init.