GObject参考手册(4)－－GLib的一些规范

本文引用自http://imtx.cn，原文作者：TualatriX 

 

译者TualatriX注：在一些面向对象的程序语言中，有一些内置方法，是用来取得类的所属关系或者类型。比如Python中，用type来取得实例的类型。

GLib中规定了一些规范来实现这个。 这是在学用GObject定义自己的类型前需要注意的。

—–

原文：http://library.gnome.org/devel/gobject/2.14/gtype-conventions.html

当用户在头文件中创建新类型时，有一些规范用户需要注意：

• 使用object_method的形式来定义函数名称：例如在一个bar类中定义一个名为foo的函数，则用bar_foo。
• 使用前缀来避免与其他工程的命名空间冲突。如果你的库（或应用程序）名为Marman，那么所有的函数名称前缀为maman_。举例：maman_object_method。
• 创建一个宏命为PREFIX_OBJECT_TYPE用来返回GType关联的对象类型。比如，Bar这个类在一个以maman前缀的库中，则使用MANMAN_BAR_TYPE。另有一个不成文的规定是，定义一个使用全局静态变或一个名为prefix_object_get_type的函数来实现这个宏。我们将在后面的章节中讨论这个函数。
• 创建一个宏命名为PREFIX_OBJECT(obj)来返回一个指向PrefixObject类型的指针。这个宏用于必要时安全地强制转换一个静态类型。运行环境检查时，同样也是安全地执行动态类型。在处理过程中禁用动态类型检查是可行的。例如，我们可以创建MAMAN_BAR(obj)来保持先前的例子。
• 如果类型是类化的，那么创建一个命令为PREFIX_OBJECT_CLASS（klass）的宏。这个宏与前面那个是非常相似的：它以类结构的动态类型检查来进行静态转换，并返回一个指向PrefixObjectClass这个类型的类结构的指针。同样，例子为：MAMAN_BAR_CLASS。
• 创建一个宏命名为PREFIX_IS_BAR (obj)：这个宏用于判断输入的对象实例是否是BAR类型的。
• 如果类型是类化的，创建一个名为PREFIX_IS_OBJECT_CLASS (klass)的宏，与上面的类似，返回输入的类型指针是否是OBJECT类型。
• 如果类型是类化的，创建一个名为PREFIX_OBJECT_GET_CLASS，返回一个实例所属的类的类型指针。这个宏因为安全的原因，被静态和动态类型所使用，就像上面的转换宏一样。

至于这些宏的实现是非常直观的：一些数量的简单使用的宏由gtype.h提供。针对上面我们兴趣的例子，我们写了下面的代码来声明这些宏：

#define MAMAN_BAR_TYPE                  (maman_bar_get_type ())
#define MAMAN_BAR(obj)                  (G_TYPE_CHECK_INSTANCE_CAST ((obj), MAMAN_BAR_TYPE, MamanBar))
#define MAMAN_BAR_CLASS(klass)          (G_TYPE_CHECK_CLASS_CAST ((klass), MAMAN_BAR_TYPE, MamanBarClass))
#define MAMAN_IS_BAR(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MAMAN_BAR_TYPE))
#define MAMAN_IS_BAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), MAMAN_BAR_TYPE))
#define MAMAN_BAR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), MAMAN_BAR_TYPE, MamanBarClass))

下面的代码实现了maman_bar_get_type这个函数：

GType maman_bar_get_type (void)
{
  static GType type = 0;
  if (type == 0) {
    static const GTypeInfo info = {
      /* You fill this structure. */
    };
    type = g_type_register_static (G_TYPE_OBJECT,
                                   "MamanBarType",
                                   &info, 0);
  }
  return type;
}