---

CdbBdbSSlaveRegistryP.ddl

Go to the documentation of this file.

#ifndef CDBBDBSHARED_SLAVE_REGISTRY_P_HH
#define CDBBDBSHARED_SLAVE_REGISTRY_P_HH

// File and Version Information:
//      $Id: CdbBdbSSlaveRegistryP.ddl,v 1.3 2002/09/23 22:41:12 gapon Exp $

#include "BdbUtil/Bdb.hh"

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

#include "CdbBdbShared/CdbBdbSRegistryP.hh"

/// A Registry for the SLAVE kind of databases
/**
  * See details below.
  */
class CdbBdbSSlaveRegistryP : public CdbBdbSRegistryP {

public:

  /// Factory method for objects of this class.
  /**
    * IMPORTANT: This operation can only be run against a federation, which
    *            already loaded with CDB infrastructure for the corresponding
    *            MASTER database.
    *
    * The parameters of the registry will be inquired from the collection
    * of origins by identifying one of the SLAVE kinds of them (origins) having
    * the same DBID range as the local one. It means that the origin should already
    * be known to the MASTER.
    */
    static CdbStatus create( BdbHandle(CdbBdbSRegistryP)& theRegistryH      /**< the resulting persistent object */
                           );

private:

  /// Default constructor (NOT IMPLEMENTED)

    CdbBdbSSlaveRegistryP( );

public:

  /// Normal constructor
  /**
    * NOTES:
    *
    * - the "id" of a SLAVE database must be the same as its MASTER's one.
    *
    * - the "origin" of a SLAVE must be not be the reserved one. See a list
    *   of the reserved identifiers in the header file of the CdbBdbSOriginP class.
    *
    * ATTENTION: Use the above defined static factory method to create
    *            persistent objects of this class.
    *
    * @see CdbBdbSSlaveRegistryP::create()
    * @see CdbBdbSOriginP
    */
    CdbBdbSSlaveRegistryP( d_UShort       theOriginId,              /**< the origin identifier of this part */
                           const char*    theDescription,           /**< the description of the database */
                           const BdbTime& theCreationTime,          /**< the time when the database is supposed to be created */
                           const BdbTime& theId                     /**< the unique identifier of the whole Condition/DB database */
                         );

  /// Destructor
  /**
    */
    virtual ~CdbBdbSSlaveRegistryP( );

  /// Check if it's the master

    virtual bool isMaster( ) const;

  // MASTER-only collections and resources. Null references are always
  // returned by these methods.

    virtual BdbRef(CdbBdbSOriginCollectionP) originCollection( ) const;

    virtual BdbRef(CdbBdbSRallocatorP< d_UShort >) originRallocator( ) const;
    virtual BdbRef(CdbBdbSRallocatorP< d_UShort >) partitionRallocator( ) const;

    virtual BdbRef(CdbBdbSClusterCollectionP) pClusterCollection( ) const;

    virtual BdbRef(CdbBdbSRallocatorP< d_UShort >) pClusterRallocator ( ) const;

  // These collection is needed since SLAVE may own partitions,
  // Therefore it needs to create local partition descriptors in a writable set
  // of databases. The contense of this P-Layout is a subject for re-synchronizations
  // done by the Data Distribution procedures.
  //
  // We don't need the Rallocator for partitions ID since partitions
  // are only created in the MASTER database. SLAVE-s may only write into these
  // partitions.
    
  // Neither we need the local clusters of partitionable conditions since
  // there is just one partitions layout amd since partitionable conditions can only be
  // created and assiciated with partitionable cluster at the MASTER database.

    virtual BdbRef(CdbBdbSPartitionsLayoutP) partitionsLayout  ( ) const;

private:

  // Data members

    BdbRef(CdbBdbSPartitionsLayoutP) _partitionsLayoutRef;

  // These data members are not currently used. They were introduced
  // by a mistake.

    BdbRef(CdbBdbSClusterCollectionP)      _pClusterCollectionRef;
    BdbRef(CdbBdbSRallocatorP< d_UShort >) _pClusterRallocatorRef;
};

#endif /* CDBBDBSHARED_SLAVE_REGISTRY_P_HH */

---