Bdb packages | Design docs | Source docs | Guidelines | Recent releases
	Search | Site Map .

                 

---

/BdbCondRemote/BdbCondRCacheNode.cc

Go to the documentation of this file.

//-----------------------------------------------------------------------------
//
// File and Version Information:
//      $Id: BdbCondRCacheNode.cc,v 1.2 2002/06/21 18:49:54 ryd Exp $
//
// Description:
//      This class provides a basic functionality for nodes of the hierarchical
//      cache of remote servers from this package.
//
//      This objects of this class could not be constructed on its own.
//      They must always be used as a base for the actual nodes.
//
// Environment:
//      Software developed for the BaBar Detector at the SLAC B-Factory.
//
// Author List:
//      Igor A. Gaponenko       Original Author
//
// Copyright Information:
//      Copyright (C) 2000      Lawrence Berkeley Laboratory
//
//-----------------------------------------------------------------------------

// -------------------------
// -- This Class's Header --
// -------------------------

#include "BdbCondRemote/BdbCondRCacheNode.hh"
#include <string>
using std::string;
#include <vector>
using std::vector;
#include <map>
using std::map;


// -------------------------
// -- Objectivity Headers --
// -------------------------

// -------------------
// -- BaBar Headers --
// -------------------

// ----------------------------
// -- BaBar Database Headers --
// ----------------------------

// ---------------
// -- C Headers --
// ---------------

// ---------------------------------
// -- Collaborating Class Headers --
// ---------------------------------

// --------------------------------------------------------------------------
// -- Local Macros, Typedefs, Structures, Unions, and Forward Declarations --
// --------------------------------------------------------------------------

// --------------------
// -- Static methods --
// --------------------

// ------------------
// -- Constructors --
// ------------------

template<class Object>
BdbCondRCacheNode<Object>::BdbCondRCacheNode( )
{
    _cache = new map<string, Object*>;
}

template<class Object>
BdbCondRCacheNode<Object>::BdbCondRCacheNode( const BdbCondRCacheNode<Object>& theNode )
{
    _cache = theNode._cache;
}

// ----------------
// -- Destructor --
// ----------------

template<class Object>
BdbCondRCacheNode<Object>::~BdbCondRCacheNode( )
{
  // Delete all objects from the cache following their pointers
  // and clear the cache.

    deleteObjects( );

  // Then delete the hash dictionary itself.

    delete _cache;
}

// ---------------
// -- Operators --
// ---------------

template<class Object>
BdbCondRCacheNode<Object>&
BdbCondRCacheNode<Object>::operator=( const BdbCondRCacheNode<Object>& theNode )
{
    if( this == &theNode ) return *this;

    _cache = theNode._cache;

    return *this;
}

// ---------------
// -- Accessors --
// ---------------

// ----------------
// -- Operations --
// ----------------

template<class Object>
void
BdbCondRCacheNode<Object>::keys( vector<string>& theList )
{
  // The input list is always cleared.

    theList.clear( );

  // Traverse the cache and put all found keys into the vector.

    string theKeyString;

    map<string, Object*>::iterator theItr=_cache->begin();
    while( theItr!=_cache->end()) {
        theKeyString = theItr->first;
        theList.push_back( theKeyString );
    }
}

template<class Object>
Object*
BdbCondRCacheNode<Object>::find( const char* theKey )
{
  // The "null is always null". We can't proceed safely for the null
  // pointers to the names used as keys.

    if( 0 == theKey ) return 0;

  // The default result is a null pointer.

    Object* theObjectPtr = 0;

  // Find the object pointer in the cache.
  //
  // NOTE: This operation (according to RW documentation) is expected
  //       to leave untouched the previous value of the pointer
  //       if the key was not found.

    string theKeyString( theKey );
    theObjectPtr=_cache->find( theKeyString)->second;

  // Return what we have found (if any).

    return theObjectPtr;
}

template<class Object>
Object*
BdbCondRCacheNode<Object>::add( const char* theKey,
                                Object*     theObjectPtr )
{
  // The "null is always null". We can't proceed safely for the null
  // pointers to the names used as keys.

    if( 0 == theKey ) return 0;

  // Find the old object pointer for this key if any.

    Object* theOldObjectPtr = find( theKey );

  // Stop right here and return null pointer if the new object pointer
  // is equal to old one. In that case there is no reason to continue.

    if(( 0 != theOldObjectPtr ) && ( theOldObjectPtr == theObjectPtr )) return 0;

  // Set/replace the objects pointer for specified key.

    string theKeyString( theKey );
    (*_cache)[theKeyString] = theObjectPtr;

  // And finally return the previous object (if any).

    return theOldObjectPtr;
}

template<class Object>
void
BdbCondRCacheNode<Object>::remove( const char* theKey )
{
  // The "null is always null". We can't proceed safely for the null names
  // used as keys.

    if( 0 == theKey ) return;

  // Find and delete the corresponding object pointer and the key from
  // the cache.

    string theKeyString( theKey );
    Object*   theObjectPtr;
    
    map<string, Object*>::iterator theItr=_cache->find(theKeyString);

    if( theItr!=_cache->end() ) {
        delete theItr->second;
        _cache->erase( theKeyString );
    }
}

template<class Object>
void
BdbCondRCacheNode<Object>::clear( )
{
  // Delete all objects from the cache following their pointers
  // and clear the cache.

    deleteObjects( );
}

template<class Object>
void
BdbCondRCacheNode<Object>::deleteObjects( )
{
  // Delete the objects for all the pointers found in the cache.

    Object* theObjectPtr;

    map<string, Object*>::iterator theItr=_cache->begin();
    while( theItr!=_cache->end()) {
        delete theItr->second;
    }

  // Reset the cache itself.

    _cache->clear( );
}

// ---------------
// -- Accessors --
// ---------------

/////////////////
// End Of File //
/////////////////

 

---

BaBar Public Site | SLAC | News | Links | Who's Who | Contact Us

Page Owner: Jacek Becla
Last Update: October 04, 2002