anna::dbos::AutoObject< T > Class Template Reference

#include <AutoObject.hpp>

Public Member Functions
	AutoObject (T *t)
	AutoObject ()
	~AutoObject ()
T *	operator-> () const
T *	operator= (T *t)
T *	operator= (const AutoObject< T > &other) noexcept(false)
	operator T* () const

Detailed Description

template<typename T>
class anna::dbos::AutoObject< T >

Facilita el uso de los punteros a objectos obtenidos a partir de los datos guardados en un medio fisico.

La idea de esta clase es que el constructor y el destructor de esta clase cooperan para reservar y/o liberar correctamente la instancia de T asociada a esta instancia.

Parameters

T	Clase que vamos a gestionar.

En el siguiente ejemplo podemos ver la forma habitual de trabajar con un objeto persistente tiene el incoveniente de que tenemos que tener en cuenta cada una de las situaciones en las que la referencia obtenida mediante el metodo instantiate debe ser liberada.

void Application::getServerSocketsData (vector <SocketData>& serverSocketsData) const
   noexcept(false)
{
   LOGMETHOD (TraceMethod ("anna::Application", "getServerSocketsData", ANNA_FILE_LOCATION));

   Facility* facility (NULL);
   FacilityLoader facilityLoader;

   try {
      facility = Facility::instantiate (facilityLoader.setKey (a_thisFacility));   // (1)
      LOGDEBUG (Logger::write (Logger::Debug, facility->asString (), ANNA_FILE_LOCATION));

      getSocketsData (getThisHostName (), facility->getName (), a_thisCell, a_thisInstance, serverSocketsData);

      Facility::release (facility);
   }
   catch (dbos::DatabaseException& edbos) {
      Facility::release (facility);
      throw RuntimeException (edbos.getText (), ANNA_FILE_LOCATION);
   }
   catch (RuntimeException&) {   // Tenemos que capturar esta excepcion para liberar el recurso.
      Facility::release (facility);
      throw;
   }
}

Como podemos ver a continuacion el siguiente metodo es mucho mas sencillo y aporta la gran ventaja de que el sistema trabaja por nosotros para liberar correctamente los recursos.

void Application::getServerSocketsData (vector <SocketData>& serverSocketsData) const
   noexcept(false)
{
   LOGMETHOD (TraceMethod ("anna::Application", "getServerSocketsData", ANNA_FILE_LOCATION));

   AutoObject <Facility> facility;
   FacilityLoader facilityLoader;

   try {
      facility = Facility::instantiate (facilityLoader.setKey (a_thisFacility));   // (1)

      LOGDEBUG (Logger::write (Logger::Debug, facility->asString (), ANNA_FILE_LOCATION));

      getSocketsData (getThisHostName (), facility->getName (), a_thisCell, a_thisInstance, serverSocketsData);
   }
   catch (dbos::DatabaseException& edbos) {
      throw RuntimeException (edbos.getText (), ANNA_FILE_LOCATION);
   }
}

Constructor & Destructor Documentation

AutoObject() [1/2]

template<typename T>

anna::dbos::AutoObject< T >::AutoObject ( T *  t )

inlineexplicit

Constructor.

Parameters

t	Instancia del objeto asociado a esta instancia.

Warning

La instancia deberia haber sido obtenida mediate la invocacion a T::instantiate de la clase persistente.

: a_t(t) {;}

AutoObject() [2/2]

template<typename T>

anna::dbos::AutoObject< T >::AutoObject ( )

inline

Constructor.

: a_t(NULL) {;}

~AutoObject()

template<typename T>

anna::dbos::AutoObject< T >::~AutoObject ( )

inline

Destructor. Invoca al metodo T::release

{ if(a_t != NULL) T::release(a_t); }

Member Function Documentation

operator T*()

template<typename T>

anna::dbos::AutoObject< T >::operator T* ( ) const

inline

Operador de conversion.

Returns

La instancia de la clase T asociada a esta instancia.

{ return a_t; }

operator->()

template<typename T>

T* anna::dbos::AutoObject< T >::operator-> ( ) const

inline

Operador -> Permite invocar a metodos de la clase T.

Returns

La instancia de la clase T asociada a esta instancia.

{ return a_t; }

operator=() [1/2]

template<typename T>

T* anna::dbos::AutoObject< T >::operator= ( T *  t )

inline

Operador copia.

Parameters

t	Referencia al objeto que vamos a tratar.

Returns

La instancia de la clase T asociada a esta instancia.

                       {
    if(a_t != t) {
      T::release(a_t);
      a_t = t;
    }

    return a_t;
  }

operator=() [2/2]

template<typename T>

T* anna::dbos::AutoObject< T >::operator= ( const AutoObject< T > &  other )

inlinenoexcept

Operador copia.

Parameters

other

Referencia al objeto que vamos a tratar.

Returns

La instancia de la clase T asociada a esta instancia.

                                                              {
    return (this != &other)  ? (*this = T::duplicate(other.a_t)) : a_t;
  }

---

The documentation for this class was generated from the following file:

• /tmp/anna/include/anna/dbos/AutoObject.hpp