---

cImmutableObject.cpp

Go to the documentation of this file.

/******************************************************************************/
/*                                                                            */
/* POLiTe - Persistent Object Library Test                                    */
/*                                        Ph.D. Thesis by Mgr. Michal Kopecky */
/*                                                                            */
/* Charles University Prague                                                  */
/*                                                                            */
/******************************************************************************/
/*                                                                            */
/* File name: ...                                                             */
/* Module: ......                                                             */
/*                                                                            */
/******************************************************************************/

// Own Header
#include <cImmutableObject.h>

PROTOTYPE(ImmutableObject);
//Proto<ImmutableObject> ImmutableObject_class;

// Object destructor:
// Delete the Object object with the appropriate de-initialization.

ImmutableObject::~ImmutableObject()     // destructor
{
        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("ImmutableObject::~ImmutableObject() invoked");
        #endif

        _Free();

        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("ImmutableObject::~ImmutableObject() finished");
        #endif
}

//Locks a persistent object. Multiple locks can be placed on the object. The object
//can be removed from memory only when all the locks are released..

Object  *ImmutableObject::MemoryLock()
{
        Object  *retval;

        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("DatabaseObject *ImmutableObject::MemoryLock() invoked");
        #endif

        if (IsTransient())
                retval = this;
        else if (_MemoryLocks < ~(unsigned int)0) {
                _MemoryLocks++;
                retval = this;
                }
        else
                retval = NULL;

        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("DatabaseObject *ImmutableObject::MemoryLock() finished");
        #endif

        return retval;
}

//Unlocks a persistent object in memory. See MemoryLock.
//covered external events:
//· Unlock object in memory

bool ImmutableObject::MemoryUnlock()
{
        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("bool ImmutableObject::MemoryUnlock() invoked");
        #endif

        if (IsTransient())
                return true;
        else if (_MemoryLocks > 0) {
                _MemoryLocks--;

                #ifdef C_IMMUTABLEOBJECT_TRACE
                logmsg("bool ImmutableObject::MemoryUnlock() finished, returned true");
                #endif

                return true;
                }
        else {

                #ifdef C_IMMUTABLEOBJECT_TRACE
                logmsg("bool ImmutableObject::MemoryUnlock() finished, returned false");
                #endif

                return false;
                };
}

//Returns the number of memory locks on receiver or zero if it is not locked.

unsigned int ImmutableObject::MemoryLocked() const
{
        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("int ImmutableObject::MemoryLocked() invoked and finished");
        #endif

        return _MemoryLocks;
}

bool ImmutableObject::RemoveAllMemoryLocks()
//Removes all memory locks existing in the GEN.LIB
{
        #ifdef C_IMMUTABLEOBJECT_TRACE
        logmsg("int ImmutableObject::RemoveAllMemoryLocks() invoked and finished");
        #endif

        _MemoryLocks = 0;
        return true;
}

---