---

d_Ref_NoTx.h

Go to the documentation of this file.

//------------------------------------------------------------------------------
#ifndef d_Ref_NoTx_h
#define d_Ref_NoTx_h 1
//------------------------------------------------------------------------------

#include "d_Ref.h"
//------------------------------------------------------------------------------

/**
 * Expresses relationships to objects.
 * 
 * This class works such as d_Ref but manages no transactional objects.
 *
 * LOCATION:
 * d_Ref_NoTx.h
 *
 * Usage:
 * d_Ref_NoTx< <linked-class> >         <property-name>;
 * 
 * WHERE:
 * 
 * <linked-class>:      Name of class to link. Can be only a persistent class
 *                  (inherited from d_Object)
 * 
 * <property-name>:     name of property
 *
 * EXAMPLES:
 * 
 *  * Reference to Invoice object 
 * d_Ref_NoTx<Invoice>  myInvoice;              
 *
 * SEE ALSO:
 * d_Ref, d_Object
 *
 * ODMG:
 * Extension
 */
template <class T>
class _ODLL d_Ref_NoTx : public d_Ref_Any
{
  public:
    /**
     * Default constructor.
     *
     * Creates a null reference.
     */
    d_Ref_NoTx();

    /**
     * Creates a reference to <iObject> object.
     */
    d_Ref_NoTx( const T* iObject );

    /**
     * Copy constructor.
     *
     * Copy the reference of <iRef>.
     */
    d_Ref_NoTx( const d_Ref_NoTx<T>& iRef );

    /**
     * Creates a reference by the d_Ref object <iRef>.
     */
    d_Ref_NoTx( const d_Ref<T>& iRef );

    /**
     * Creates a reference by the d_Ref_Any object <iRef>.
     */
    d_Ref_NoTx( const d_Ref_Any& iRef );

    /**
     * Set the reference to <iSource> object.
     */
    d_Ref_NoTx<T>& operator =( const T* iSource );

    /**
     * Returns the persistent object in memory.
     *
     * If the object is not present in memory Orient ODBMS loads the object
     * from database to memory trasparently.
     *
     * If the reference is null then an exception d_Error_RefNull or
     * d_Error_RefInvalid is raised.
     *
     * This operator permits to handle d_Ref<> as common C++ pointer.
     *
     * SEE ALSO:  operator *(), ptr()
     */
    T* operator -> ();

    /**
     * Returns the persistent object in memory.
     *
     * If the object is not present in memory Orient ODBMS loads the object
     * from storage to memory trasparently.
     *
     * If the reference is null then an exception d_Error_RefNull or
     * d_Error_RefInvalid is raised.
     *
     * SEE ALSO:  operator ->(), ptr()
     */
    T & operator * ();

    /**
     * Returns the persistent object in memory.
     *
     * If the object is not present in memory Orient ODBMS loads the object
     * from storage to memory trasparently.
     *
     * If the reference is null then an exception d_Error_RefInvalid is
     * raised.
     *
     * SEE ALSO:  operator ->(), operator *()
     */
    T * ptr ();
};
//------------------------------------------------------------------------------

#include "d_Ref_NoTx.cti"
//------------------------------------------------------------------------------
//------------------------------------------------------------------------------

#endif

---