feat(object): add realize lifecycle state

Author: chenglong

include/miniqom/object.h

@@ -9,13 +9,20 @@
 
 #define MINIQOM_MAX_CHILDREN 32
 
+typedef enum ObjectState
+{
+    OBJECT_STATE_NEW,
+    OBJECT_STATE_REALIZED,
+} ObjectState;
+
 struct Object
 {
     ObjectClass *klass;
     Object *parent;
     char *name;
     Object *children[MINIQOM_MAX_CHILDREN];
     size_t child_count;
+    ObjectState state;
 };
 
 Object *object_new(const char *type_name);
@@ -26,6 +33,10 @@ bool object_is_instance_of(const Object *obj, const char *type_name);
 const char *object_get_type_name(const Object *obj);
 bool object_is_a(const Object *obj, const char *type_name);
 
+bool object_realize(Object *obj, Error *err);
+void object_unrealize(Object *obj);
+bool object_is_realized(const Object *obj);
+
 bool object_add_child(Object *parent, const char *name,
                       Object *child, Error *err);
 

src/qom/object.c

@@ -55,6 +55,39 @@ Object *object_new(const char *type_name)
     return obj;
 }
 
+bool object_is_realized(const Object *obj)
+{
+    return obj && obj->state == OBJECT_STATE_REALIZED;
+}
+
+bool object_realize(Object *obj, Error *err)
+{
+    if (!obj)
+    {
+        error_set(err, "cannot realize null object");
+        return false;
+    }
+
+    if (obj->state == OBJECT_STATE_REALIZED)
+    {
+        error_set(err, "object is already realized");
+        return false;
+    }
+
+    obj->state = OBJECT_STATE_REALIZED;
+    return true;
+}
+
+void object_unrealize(Object *obj)
+{
+    if (!obj || obj->state != OBJECT_STATE_REALIZED)
+    {
+        return;
+    }
+
+    obj->state = OBJECT_STATE_NEW;
+}
+
 void object_free(Object *obj)
 {
     Type *type;

tests/test_qom.c

@@ -35,6 +35,29 @@ int main(void)
     assert(object_get_type_name(NULL) == NULL);
     assert(!object_is_a(NULL, "object"));
 
+    error_clear(&err);
+
+    assert(!object_is_realized(mem0));
+
+    assert(object_realize(mem0, &err));
+    assert(object_is_realized(mem0));
+
+    assert(!object_realize(mem0, &err));
+    assert(!strcmp(err.message, "object is already realized"));
+    assert(object_is_realized(mem0));
+
+    object_unrealize(mem0);
+    assert(!object_is_realized(mem0));
+
+    object_unrealize(mem0);
+    assert(!object_is_realized(mem0));
+
+    assert(object_realize(mem0, &err));
+    assert(object_is_realized(mem0));
+
+    object_unrealize(mem0);
+    assert(!object_is_realized(mem0));
+
     backend = (HostMemoryBackendMemfd *)mem0;
     assert(backend->seal);
     assert(backend->parent_obj.share);