Refined the whole share system for operands.

5 files changed, 154 insertions, 26 deletions

diff --git a/src/arch/sharing/instance-int.h b/src/arch/sharing/instance-int.h
index f9a91ba..cf5a56d 100644
--- a/src/arch/sharing/instance-int.h
+++ b/src/arch/sharing/instance-int.h
@@ -26,14 +26,21 @@
 
 
 #include "instance.h"
+#include "manager.h"
 
 
 
+/* Fournit le gestionnaire de partages attribué à un type. */
+typedef GShareManager * (* get_share_manager_fc) (const GSharedInstance *);
+
 /* Initialise un nouvel objet partagé avec des informations. */
-typedef bool (* init_shared_fc) (GSharedInstance *, const GSharedInstance *);
+typedef bool (* apply_shared_template_fc) (GSharedInstance *, const GSharedInstance *);
 
 /* Procède à l'initialisation de l'interface de partage. */
-typedef void (* qck_copy_shared_fc) (const GSharedInstance *, GSharedInstance *);
+typedef void (* define_shared_template_fc) (const GSharedInstance *, GSharedInstance *);
+
+/* Initialise un nouvel objet partagé avec des informations. */
+typedef bool (* free_shared_template_fc) (const GSharedInstance *, GSharedInstance *);
 
 /* Fournit la valeur du compteur de partage. */
 typedef unsigned int (* get_shared_ref_fc) (const GSharedInstance *);
@@ -45,7 +52,7 @@ typedef void (* inc_shared_ref_fc) (GSharedInstance *);
 typedef void (* dec_shared_ref_fc) (GSharedInstance *);
 
 /* Procède à l'initialisation de l'interface de partage. */
-typedef int (* qck_compare_shared_fc) (const GSharedInstance **, const GSharedInstance **);
+typedef int (* compare_shared_fc) (const GSharedInstance * const *, const GSharedInstance * const *);
 
 
 /* Règles de partage d'une instance GObject (interface) */
@@ -53,14 +60,17 @@ struct _GSharedInstanceIface
 {
     GTypeInterface base_iface;              /* A laisser en premier        */
 
-    init_shared_fc init;                    /* Initialisation de l'objet   */
-    qck_copy_shared_fc qck_copy;            /* Copie minimale des détails  */
+    get_share_manager_fc get_manager;       /* Accès au gestionnaire       */
+
+    apply_shared_template_fc apply_template;/* Intialisation d'instance    */
+    define_shared_template_fc define_template; /* Copie minimale de détails*/
+    free_shared_template_fc free_template;  /* Libération d'un patron      */
 
     get_shared_ref_fc get_ref;              /* Obtention du compteur       */
     inc_shared_ref_fc inc_ref;              /* Incrémentation du compteur  */
     dec_shared_ref_fc dec_ref;              /* Décrémentation du compteur  */
 
-    qck_compare_shared_fc qck_cmp;          /* Comparaison des détails     */
+    compare_shared_fc compare;              /* Comparaison des détails     */
 
 };
 
diff --git a/src/arch/sharing/instance.c b/src/arch/sharing/instance.c
index 39dacec..05081bb 100644
--- a/src/arch/sharing/instance.c
+++ b/src/arch/sharing/instance.c
@@ -71,7 +71,7 @@ static void g_shared_instance_default_init(GSharedInstanceInterface *iface)
 *                                                                             *
 ******************************************************************************/
 
-bool g_shared_instance_init(GSharedInstance *instance, const GSharedInstance *template)
+bool g_shared_instance_apply_template(GSharedInstance *instance, const GSharedInstance *template)
 {
     bool result;                            /* Bilan à retourner           */
     GSharedInstanceIface *iface;            /* Interface utilisée          */
@@ -83,7 +83,7 @@ bool g_shared_instance_init(GSharedInstance *instance, const GSharedInstance *te
      * à la différence d'une opération de copie minimaliste.
      */
 
-    result = iface->init(instance, template);
+    result = iface->apply_template(instance, template);
 
     return result;
 
@@ -103,7 +103,7 @@ bool g_shared_instance_init(GSharedInstance *instance, const GSharedInstance *te
 *                                                                             *
 ******************************************************************************/
 
-void g_shared_instance_quickly_copy(const GSharedInstance *instance, GSharedInstance *template)
+void g_shared_instance_define_template(const GSharedInstance *instance, GSharedInstance *template)
 {
     GSharedInstanceIface *iface;            /* Interface utilisée          */
 
@@ -114,7 +114,59 @@ void g_shared_instance_quickly_copy(const GSharedInstance *instance, GSharedInst
      * Ce genre de traitement est réservé à la phase d'initialisation.
      */
 
-    iface->qck_copy(instance, template);
+    iface->define_template(instance, template);
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : instance = objet partagé à modifier.                         *
+*                                                                             *
+*  Description : Incrémente le compteur de références d'un élément partagé.   *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+void g_shared_instance_ref(GSharedInstance *instance)
+{
+    GSharedInstanceIface *iface;            /* Interface utilisée          */
+    GShareManager *manager;                 /* Gestionnaire associé        */
+
+    iface = G_SHARED_INSTANCE_GET_IFACE(instance);
+
+    manager = iface->get_manager(instance);
+
+    g_share_manager_get(manager, instance);
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : instance = objet partagé à modifier.                         *
+*                                                                             *
+*  Description : Décrémente le compteur de références d'un élément partagé.   *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+void g_shared_instance_unref(GSharedInstance *instance)
+{
+    GSharedInstanceIface *iface;            /* Interface utilisée          */
+    GShareManager *manager;                 /* Gestionnaire associé        */
+
+    iface = G_SHARED_INSTANCE_GET_IFACE(instance);
+
+    manager = iface->get_manager(instance);
+
+    g_share_manager_put(manager, instance);
 
 }
 
@@ -201,7 +253,7 @@ void g_shared_instance_dec_references(GSharedInstance *instance)
 *                                                                             *
 ******************************************************************************/
 
-int g_shared_instance_quickly_compare(const GSharedInstance **a, const GSharedInstance **b)
+int g_shared_instance_compare(const GSharedInstance * const *a, const GSharedInstance * const *b)
 {
     int result;                             /* Bilan à faire remonter      */
     GSharedInstanceIface *iface;            /* Interface utilisée          */
@@ -214,7 +266,7 @@ int g_shared_instance_quickly_compare(const GSharedInstance **a, const GSharedIn
 
     iface = G_SHARED_INSTANCE_GET_IFACE(*b);
 
-    result = iface->qck_cmp(b, a) * -1;
+    result = iface->compare(b, a) * -1;
 
     return result;
 
diff --git a/src/arch/sharing/instance.h b/src/arch/sharing/instance.h
index fdc94d7..d9653ff 100644
--- a/src/arch/sharing/instance.h
+++ b/src/arch/sharing/instance.h
@@ -49,10 +49,16 @@ typedef struct _GSharedInstanceIface GSharedInstanceIface;
 GType g_shared_instance_get_type(void) G_GNUC_CONST;
 
 /* Initialise un nouvel objet partagé avec des informations. */
-bool g_shared_instance_init(GSharedInstance *, const GSharedInstance *);
+bool g_shared_instance_apply_template(GSharedInstance *, const GSharedInstance *);
 
 /* Réalise une copie minimale d'un contenu partagé. */
-void g_shared_instance_quickly_copy(const GSharedInstance *, GSharedInstance *);
+void g_shared_instance_define_template(const GSharedInstance *, GSharedInstance *);
+
+/* Incrémente le compteur de références d'un élément partagé. */
+void g_shared_instance_ref(GSharedInstance *);
+
+/* Décrémente le compteur de références d'un élément partagé. */
+void g_shared_instance_unref(GSharedInstance *);
 
 /* Fournit la valeur du compteur de partage. */
 unsigned int g_shared_instance_get_references(const GSharedInstance *);
@@ -64,7 +70,7 @@ void g_shared_instance_inc_references(GSharedInstance *);
 void g_shared_instance_dec_references(GSharedInstance *);
 
 /* Compare de façon accélérée un object partagé avec un autre. */
-int g_shared_instance_quickly_compare(const GSharedInstance **, const GSharedInstance **);
+int g_shared_instance_compare(const GSharedInstance * const *, const GSharedInstance * const *);
 
 
 
diff --git a/src/arch/sharing/manager.c b/src/arch/sharing/manager.c
index 3b7cd01..379c342 100644
--- a/src/arch/sharing/manager.c
+++ b/src/arch/sharing/manager.c
@@ -69,6 +69,9 @@ static void g_share_manager_dispose(GShareManager *);
 /* Procède à la libération totale de la mémoire. */
 static void g_share_manager_finalize(GShareManager *);
 
+/* Note une augmentation des utilisations d'un élément partagé. */
+static void _g_share_manager_get(GShareManager *, GSharedInstance *);
+
 
 
 /* Détermine le type du gestionnaire d'instances partagées. */
@@ -207,7 +210,7 @@ GShareManager *g_share_manager_new(GType type)
 *                                                                             *
 ******************************************************************************/
 
-GSharedInstance *g_share_manager_get(GShareManager *manager, GSharedInstance *template)
+GSharedInstance *g_share_manager_build(GShareManager *manager, GSharedInstance *template)
 {
     GSharedInstance *result;                /* Trouvaille à retourner      */
     size_t index;                           /* Indice d'une instance idéale*/
@@ -217,13 +220,13 @@ GSharedInstance *g_share_manager_get(GShareManager *manager, GSharedInstance *te
     g_mutex_lock(&manager->access);
 
     found = bsearch_index(&template, manager->instances, manager->count, sizeof(GSharedInstance *),
-                          (__compar_fn_t)g_shared_instance_quickly_compare, &index);
+                          (__compar_fn_t)g_shared_instance_compare, &index);
 
     if (!found)
     {
         result = g_object_new(manager->managed, NULL);
 
-        status = g_shared_instance_init(result, template);
+        status = g_shared_instance_apply_template(result, template);
 
         if (!status)
         {
@@ -245,11 +248,7 @@ GSharedInstance *g_share_manager_get(GShareManager *manager, GSharedInstance *te
     else
         result = manager->instances[index];
 
-    if (result != NULL)
-    {
-        g_object_ref(G_OBJECT(result));
-        g_shared_instance_inc_references(result);
-    }
+    _g_share_manager_get(manager, result);
 
     g_mutex_unlock(&manager->access);
 
@@ -278,7 +277,7 @@ GSharedInstance *g_share_manager_update(GShareManager *manager, GSharedInstance
     GSharedInstance *result;                /* Nouvelle instance à renvoyer*/
     bool replaced;                          /* Remplacement effectué ?     */
 
-    result = g_share_manager_get(manager, template);
+    result = g_share_manager_build(manager, template);
 
     if (container != NULL)
         replaced = g_share_container_replace(container, old, result);
@@ -301,6 +300,64 @@ GSharedInstance *g_share_manager_update(GShareManager *manager, GSharedInstance
 
 /******************************************************************************
 *                                                                             *
+*  Paramètres  : manager  = gestionnaire d'instance à consulter.              *
+*                instance = élément partagé à manipuler.                      *
+*                                                                             *
+*  Description : Note une augmentation des utilisations d'un élément partagé. *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static void _g_share_manager_get(GShareManager *manager, GSharedInstance *instance)
+{
+#ifndef NDEBUG
+    bool found;                             /* Existence de cette instance */
+#endif
+
+#ifndef NDEBUG
+
+    found = bsearch_index(&instance, manager->instances, manager->count, sizeof(GSharedInstance *),
+                          (__compar_fn_t)g_shared_instance_compare, (size_t []) { 0 });
+
+    assert(found);
+
+#endif
+
+    g_object_ref(G_OBJECT(instance));
+    g_shared_instance_inc_references(instance);
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : manager  = gestionnaire d'instance à consulter.              *
+*                instance = élément partagé à manipuler.                      *
+*                                                                             *
+*  Description : Note une augmentation des utilisations d'un élément partagé. *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+void g_share_manager_get(GShareManager *manager, GSharedInstance *instance)
+{
+    g_mutex_lock(&manager->access);
+
+    _g_share_manager_get(manager, instance);
+
+    g_mutex_unlock(&manager->access);
+
+}
+
+
+/******************************************************************************
+*                                                                             *
 *  Paramètres  : manager = gestionnaire d'instance à consulter.               *
 *                shared  = instance partagée à libérer.                       *
 *                                                                             *
@@ -322,7 +379,7 @@ void g_share_manager_put(GShareManager *manager, GSharedInstance *shared)
     {
         manager->instances = qdelete(manager->instances, &manager->count,
                                      sizeof(GSharedInstance *),
-                                     (__compar_fn_t)g_shared_instance_quickly_compare,
+                                     (__compar_fn_t)g_shared_instance_compare,
                                      &shared);
 
         g_object_unref(G_OBJECT(shared));
diff --git a/src/arch/sharing/manager.h b/src/arch/sharing/manager.h
index 959087d..c24fcc6 100644
--- a/src/arch/sharing/manager.h
+++ b/src/arch/sharing/manager.h
@@ -60,11 +60,14 @@ GType g_share_manager_get_type(void);
 GShareManager *g_share_manager_new(GType);
 
 /* Retrouve ou crée une instance partagée. */
-GSharedInstance *g_share_manager_get(GShareManager *, GSharedInstance *);
+GSharedInstance *g_share_manager_build(GShareManager *, GSharedInstance *);
 
 /* Met à jour une instance partagée. */
 GSharedInstance *g_share_manager_update(GShareManager *, GSharedInstance *, GSharedInstance *, GShareContainer *);
 
+/* Note une augmentation des utilisations d'un élément partagé. */
+void g_share_manager_get(GShareManager *, GSharedInstance *);
+
 /* Abandonne un usage d'une instance partagée. */
 void g_share_manager_put(GShareManager *, GSharedInstance *);