X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=include%2Fanna%2Fcore%2FSingleton.hpp;fp=include%2Fanna%2Fcore%2FSingleton.hpp;h=cd92e2dd02361042418868db0f735add7b59db40;hb=e0bb4829b028a76f7c1c58e41208205d78720665;hp=00e16e99b0b3c2c79a01270e45a889a9ced3d710;hpb=f22da03057d956275470698ec38bf51da768b05c;p=anna.git diff --git a/include/anna/core/Singleton.hpp b/include/anna/core/Singleton.hpp index 00e16e9..cd92e2d 100644 --- a/include/anna/core/Singleton.hpp +++ b/include/anna/core/Singleton.hpp @@ -45,14 +45,13 @@ namespace anna { /** - Patrn Singleton. Limita la utilizacin de una determinada clase - para que slo pueda existir una nica instancia. + Singleton pattern. Limits the use to a unique class instance. - El contructor por defecto de la clase T debe ser privado, para evitar que - esta clase se pueda instanciar desde el exterior. - Vamos a ver un ejemplo de como se haria un Singleton sobre la clase A. + Default constructor for T must be private in order to avoid + external instantiation. Following, an example using class A: - En el archivo de cabecera de la clase A tendriamos: + + On A class header file, we will have: \code ... @@ -62,21 +61,21 @@ namespace anna { class A : public anna::Singleton { public: - // Accesores - int obtenerDato () const { return a_unDato; } + // getters + int getData () const { return a_data; } - // Modificadores - void establecerOtroDato (const ASD& otroDato) { a_otroDato = otroDato; } + // setters + void setOtherData (const ASD& otherData) { a_otherData = otherData; } - // Operadores + // operators .... - // Metodos + // methods ... private: - int a_unDato; - ASD a_otroDato; + int a_data; + ASD a_otherData; A (); @@ -85,7 +84,7 @@ namespace anna { \endcode - Para hacer uso de la clase A: + To use A class: \code #include @@ -93,11 +92,11 @@ namespace anna { ... ... - void CualquierClase::cualquierFuncion () throw (RuntimeException) + void anyClass::anyFunction () throw (RuntimeException) { A& a (A::instantiate ()); - cout << a.obtenerDato () << endl; + cout << a.getData () << endl; } \endcode @@ -105,14 +104,14 @@ namespace anna { template class Singleton { public: /** - @return La instancia de la clase indicada en la creacin de la template. + @return Class instance provided on template creation. */ static T& instantiate() { return *alloc(true); } /** - Libera la instancia de la clase indicada en la creacin de esta template. - Si no hay creada ninguna instancia simplemente se ignora. Este m�odo - slo deber� invocarse justo antes de la terminacin de nuestro programa. + Release the class instance provided in this template creation. + If no instance has been created, this will be ignored. + This method only have to be used during the program termination. */ static void release() { alloc(false); }