---

CdbBdbObjectConvertor.hh

Go to the documentation of this file.

#ifndef CDBBDB_OBJECT_CONVERTOR_HH
#define CDBBDB_OBJECT_CONVERTOR_HH

// File and Version Information:
//      $Id: CdbBdbObjectConvertor.hh,v 1.3 2002/09/23 22:39:09 gapon Exp $

#include "CdbBase/CdbObjectPtrFwd.hh"

#include "BdbCond/BdbObject.hh"

/// This is a BDB specific Object Convertor
/**
  * This is a utility class providing an interface to technology-specific
  * implementations of the persistent object conversion. It's sussposed to be
  * a kind of "type bridge" between the technology-independent part of the API
  * and the technology-specific one.
  */
class CdbBdbObjectConvertor {

public:

  /// Narrow a transient meta-data object into a real persistent object
  /**
    * This operation will verify if the specified object pointer has expected
    * technology, and if so it will extract the persistent handle out of this object.
    *
    * Note, that it's up to teh end user to upcast from the resulting handle to
    * a handle of the actual class.
    *
    * @see CdbObject
    * @see CdbObjectPtr
    * @see CdbStatus
    */
    static CdbStatus narrow( BdbHandle(BdbObject)& thePersObj,      /**< a persistent handle to be set up */
                             const CdbObjectPtr&   thePtr           /**< a smart input for an input object */
                           );

  /// Narrow a transient meta-data object into a real persistent object of specified type
  /**
    * This operation is a functional superset of the CdbBdbObjectConvertor::narrow()
    * method. In addition it does the type matching for specified type. If the type does
    * not match then it returns a error status.
    *
    * @see CdbObject
    * @see CdbObjectPtr
    * @see CdbStatus
    */
    template< class P >
    static CdbStatus typeSafeNarrow( BdbHandle(P)&       thePersObj,    /**< a persistent handle to be set up */
                                     const CdbObjectPtr& thePtr         /**< a smart input for an input object */
                                   )
    {
        CdbStatus result = narrow( thePersObj, thePtr );
        if( CdbStatus::Success == result ) {
            if( !thePersObj.isValid( ) ||
                thePersObj.typeN( ) != ooTypeN(P)) {
                result = CdbStatus::Error;
            }
        }
        return result;
    }
};

#endif  // CDBBDB_OBJECT_CONVERTOR_HH

---