Feb 25, 2008
GObject既然是物件，肯定有屬性。既然有屬性，肯定有獲取和設置的辦法。GObject在這方面非常靈活，除具備一般物件導向程式的共性外，GObject的批量設置屬性的方法非常不錯。
-----
GObject的其中一個漂亮特性就是它那為物件屬性準備的通用get/set機制。當一個物件被產生實體以後，物件的類初始化處理將用g_object_class_install_property來註冊物件的屬性（由gobject.c中實現）。
理解物件屬性是如何工作的最好就是看下面的例子：
/************************************************/
/* Implementation */
/************************************************/
enum {
MAMAN_BAR_CONSTRUCT_NAME = 1,
MAMAN_BAR_PAPA_NUMBER,
};
static void
maman_bar_instance_init (GTypeInstance *instance,
gpointer
g_class)
{
MamanBar *self = (MamanBar *)instance;
}
static void
maman_bar_set_property (GObject *object,
guint
property_id,
const GValue *value,
GParamSpec
*pspec)
{
MamanBar *self = (MamanBar *) object;
switch (property_id) {
case MAMAN_BAR_CONSTRUCT_NAME: {
g_free (self->priv->name);
self->priv->name = g_value_dup_string
(value);
g_print ("maman:
%s\n",self->priv->name);
}
break;
case MAMAN_BAR_PAPA_NUMBER: {
self->priv->papa_number =
g_value_get_uchar (value);
g_print ("papa:
%u\n",self->priv->papa_number);
}
break;
default:
/* We don't have any other property... */
G_OBJECT_WARN_INVALID_PROPERTY_ID(object,property_id,pspec);
break;
}
}
static void
maman_bar_get_property (GObject *object,
guint property_id,
GValue
*value,
GParamSpec
*pspec)
{
MamanBar *self = (MamanBar *) object;
switch (property_id) {
case MAMAN_BAR_CONSTRUCT_NAME: {
g_value_set_string (value,
self->priv->name);
}
break;
case MAMAN_BAR_PAPA_NUMBER: {
g_value_set_uchar (value,
self->priv->papa_number);
}
break;
default:
/* We don't have any other property... */
G_OBJECT_WARN_INVALID_PROPERTY_ID(object,property_id,pspec);
break;
}
}
static void
maman_bar_class_init (gpointer g_class,
gpointer g_class_data)
{
GObjectClass *gobject_class = G_OBJECT_CLASS
(g_class);
MamanBarClass *klass = MAMAN_BAR_CLASS
(g_class);
GParamSpec *pspec;
gobject_class->set_property =
maman_bar_set_property;
gobject_class->get_property =
maman_bar_get_property;
pspec = g_param_spec_string
("maman-name",
"Maman construct prop",
"Set maman's name",
"no-name-set" /* default value */,
G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE);
g_object_class_install_property
(gobject_class,
MAMAN_BAR_CONSTRUCT_NAME,
pspec);
pspec = g_param_spec_uchar ("papa-number",
"Number of current Papa",
"Set/Get papa's number",
0 /*
minimum value */,
10 /* maximum value */,
2 /*
default value */,
G_PARAM_READWRITE);
g_object_class_install_property
(gobject_class,
MAMAN_BAR_PAPA_NUMBER,
pspec);
}
/************************************************/
/* Use */
/************************************************/
GObject *bar;
GValue val = {0,};
bar = g_object_new (MAMAN_TYPE_SUBBAR, NULL);
g_value_init (&val, G_TYPE_CHAR);
g_value_set_char (&val, 11);
g_object_set_property (G_OBJECT (bar),
"papa-number", &val);
上面的例子看起來應該是簡單的，但是很多事情發生了：
g_object_set_property先確保相應名稱的屬性已經在bar的class_init處理函數中被註冊。如果是的話，它依次調用類繼承關係中的object_set_property，從底至頂，基礎類型用來找到註冊了這個屬性的類。接著它嘗試轉換使用者提供的GValue到屬性所關聯的GValue。
如果使用者提供了一個有符號的字元GValue，就像這裡所示，如果物件的屬性被註冊為一個無符號的整型，g_value_transform將會試著轉換輸入的有符號的字元到一個無符號的整型。當然，轉換是否成功取取決於可用的轉換函數。實際上，如果需要的時候，總會有相關的轉換函數可以用。
在轉型以後，GValue將被g_param_value_validata來驗證，以確保使用者保存在GValue中的資料吻合由屬性的GParamSpea所描述的字元特性。在這裡，我們在class_init裡提供的GParamSpec有一個驗證函數來確保GValue包含了一個代表最小和最大邊界的GParamSpec。在上面的例子中，用戶端的GValue並沒有尊重規範（它設置為了11，而最大值是10）。因為這樣，所了g_object_set_property函數將返回一個錯誤。
如果用戶的GValue已經被設置成了一個可用的值，g_object_set_property將處理一下呼叫至物件的set_property的類方法。在這裡，因為我們在Foo的實現代碼中並沒有重載這個函數，代碼路徑將會跳到foo_set_property在收到g_object_class_install_property存儲了GParamSpec的param_id後。
一時已經用物件的set_property類方法來設置好屬性以後，代碼路徑將調用g_object_nofity_queue_thaw使返回到g_object_set_property 。這個函數確保“notify”信號”已經在物件實例完成改變屬性後被發出，除非通知台已經被g_object_free_notify所凍潔。
g_object_thaw_nofity可以被用來重新啟用通過“notify”信號的屬性修改的通知中心。這是非常重要的，記住當屬性被改變時通知中心是否被凍結，“notify”信號將會當在屬性改變的一睡意由通知中心所發出：沒有屬性改變會因“notify”所信號。只有通過通知中心的凍結機制才能使信號發身被延誤。
這聽起來像是一個無聊的任務每次設置GValues當我想需要一個屬性時。實際上我們僅僅很少這樣做。g_object_set_property和g_object_get_property一般是用來語言綁定的。對應用程式來說，有一個更簡單的方法，在下面描述。
同時修改多個屬性
我想這很有趣，我們可以通過g_object_set和g_object_set_valist函數來同時設置多個屬性值。用戶端代碼可以被重寫為：
MamanBar *foo;
foo = /* */;
g_object_set (G_OBJECT (foo),
"papa-number", 2,
"maman-name", "test",
NULL);
這個節省了我們管理用g_object_set_property來處理GValue的時間。在被修改時這個代碼同樣會觸發每個屬性。
當然，_get的版本同樣是存在的：g_object_get和g_object-get_valist可以用來一次性得到很多屬性。
這些高級的方法有一個缺點──它們不提供一個返回值。在使用它們時，你需要注意這些參數類型和範圍 。（暫時不會了）
These high
level functions have one drawback - they don't provide a return result. One
should pay attention to the argument types and ranges when using them. A know
source of errors is to e.g. pass a gfloat instead of a gdouble and thus
shifting all subsequent parameters by four bytes. Also forgetting the
terminating NULL will lead to unexpected behaviour.
如果你認真看這章的話，現在你應該已經知道了g_object_new，g_object_newv和g_object_new_valist是如何工作的：它們解析使用者提供的變數數目和參數並當物件成功的創建以後，用這些參數調用g_object_set。當然，“notify”信號同樣會在每個屬性改變後發射。
沒有留言:
張貼留言