Pocos cambios a la vista del "usuario":

[z.facultad/75.42/plaqui.git] / Server / include / plaqui / server / runnable.h

diff --git a/Server/include/plaqui/server/runnable.h b/Server/include/plaqui/server/runnable.h
index 39a221f26a684bc1569c6930a9529b42d6f92f11..7896090370af01d016ff3da2bd31b84326a80db3 100644 (file)
--- a/Server/include/plaqui/server/runnable.h
+++ b/Server/include/plaqui/server/runnable.h
@@ -29,16 +29,52 @@
 #define PLAQUI_RUNNABLE_H
 
 #include <glibmm/thread.h>
+#include <sigc++/signal.h>
 
-namespace Plaqui {
+namespace PlaQui {
+
+namespace Server {
 
        /// ealizauna tarea (generalmente en un thread).
        class Runnable {
 
+               // Tipos.
+
+               public:
+
+                       /// Tipo de señal para indicar que se finalizó la tarea.
+                       typedef SigC::Signal0<void> SignalFinished;
+
+               // Atributos.
+
                private:
-                       // Thread en el cual correr la tarea.
+
+                       /// Thread en el cual correr la tarea.
                        Glib::Thread* thread;
 
+                       /// Señal que indica que se finalizó la tarea.
+                       SignalFinished finished;
+
+               protected:
+
+                       /**
+                        * Indica si se debe frinalizar la tarea.
+                        *
+                        * \todo Poner como privado y poner get() set() con locks.
+                        */
+                       bool stop;
+
+               // Métodos.
+
+               private:
+
+                       /**
+                        * Corre la tarea controlando cuando termina.
+                        *
+                        * \param runner Objeto con la tarea a realizar.
+                        */
+                       static void static_run(Runnable* runner);
+
                protected:
 
                        /// Realiza la terea.
@@ -49,7 +85,7 @@ namespace Plaqui {
                        /**
                         * Destructor.
                         */
-                       virtual ~Runnable(void) {}
+                       virtual ~Runnable(void);
 
                        /**
                         * Constructor.
@@ -57,15 +93,35 @@ namespace Plaqui {
                        Runnable(void);
 
                        /**
-                        * Comienza la tares.
+                        * Comienza la tarea.
                         *
                         * \param detach Si es true se corre en un thread propio. Si no no
                         *                               retorna hasta que finaliza.
                         */
                        virtual void run(bool detach = true);
 
+                       /**
+                        * Finaliza la tarea.
+                        *
+                        * \param attach Si es true, la función no retorna hasta que no
+                        *               finalice la tearea (no recomendable).
+                        *
+                        * \note Para saber cuando la tarea fue finalizada puede utilizar
+                        *       la señal signal_finished().
+                        */
+                       virtual void finish(bool attach = false);
+
+                       /**
+                        * Obtiene la señal que avisa cuando la tarea es finalizada.
+                        *
+                        * \see finish().
+                        */
+                       SignalFinished& signal_finished(void);
+
        };
 
 }
 
+}
+
 #endif // PLAQUI_RUNNABLE_H