---

CdbBdbPrintObjectTree.hh

Go to the documentation of this file.

#ifndef CDBBDB_PRINT_OBJECT_TREE_HH
#define CDBBDB_PRINT_OBJECT_TREE_HH

// File and Version Information:
//      $Id: CdbBdbPrintObjectTree.hh,v 1.2 2004/10/21 20:35:51 gapon Exp $

#include "CdbBase/CdbCommon.hh"

#include <oo.h>     // ooRef(ooObj), ooHandle(ooObj)

// Forward declarations

class CdbBdbPrintObjectTreeUserAction;
class CdbBdbPrintObjectTreeImpl;

/// This class provides "print object tree" facility for persistent objects.
/**
  * This facility uses the Objectivity/DB Active Schema API to navigate accross
  * an arbitrary graph of objects by visiting and printing OID-s of each node
  * in the graph. Specified (if any) user defined action will be called for each node.
  * Each node is visited just once. But it (the object) still would be printed.
  * A user defined action object provides a feedback wether the operation should
  * propagate beyond a visited node or it should stop at this node or it should break
  * visiting due to a error.
  * 
  * IMPLEMENTATION NOTES:
  *
  *   (1) This class uses PIMPL idiom to protect end users
  *       of the class from being exposed to the buggy header
  *       files of the Objectivity/DB Active Schema API.
  *
  *   (2) This class violates CDB API convention on the inclusion
  *       of "CdbBase/CdbCommon.hh" header file to avoid STD namespace
  *       conflicts of the kind described above.
  *
  * ATTENTION:
  *
  *   - This group of classes has nothing in common with the famous "Visitor"
  *     pattern ("Go4").
  */
class CdbBdbPrintObjectTree {

private:

  /// Default constructor (NOT IMPLEMENTED)
  /**
    * There is no way to get the consistent object's context without user defined
    * parameters passed through the normal constructor.
    */
    CdbBdbPrintObjectTree( );

public:

  /// Normal constructor
  /**
    * Sets the initial context for the profiling. This context can be reused
    * accross multiple calls to the profiling method itself.
    *
    * A non-zero pointer onto a user defined action is required.
    *
    * The ownership to a user action does not get transferred
    * into the current object. We may need non-const pointer to let a user
    * to maintain the context of user action between calls.
    *
    * Note, a user action object can be overriden by passing another user action
    * object by calling a special "setUserAction" method.
    */
    CdbBdbPrintObjectTree( CdbBdbPrintObjectTreeUserAction* theUserAction,
                                                       bool verboseMode = false,
                                                       bool debugMode   = false );

  /// Destructor
  /**
    * More details...
    */
    virtual ~CdbBdbPrintObjectTree( );

  /// Visit the specified object
  /**
    * The operation will return "true" in case of success, it will return "false"
    * in case of any errors.
    */
    bool print( const ooHandle(ooObj)& theInputH );

  /// Set user action
  /**
    * If 0 pointer is passed then the current user action will be reset
    * and it will not be called anymore.
    *
    * The method will return a pointer onto the previous action (if any).
    *
    * @see class CdbBdbPrintObjectTreeUserAction
    */
    CdbBdbPrintObjectTreeUserAction* setUserAction( CdbBdbPrintObjectTreeUserAction* theUserAction );

private:

  // Here is my implementation

    CdbBdbPrintObjectTreeImpl* _myImpl;
};

#endif  // CDBBDB_PRINT_OBJECT_TREE_HH

---