DbiRecord Class Reference

#include <DbiRecord.h>

Inheritance diagram for DbiRecord:

List of all members.

Public Member Functions
	DbiRecord ()
virtual	~DbiRecord ()
void	AddTableRowNames (std::set< std::string > &names) const
void	AdoptKey (DbiResultKey *key)
const DbiResultKey *	DeleteKey (const DbiResultKey *key)
Private Member Functions
Bool_t	CompareTableRowKeys (const DbiRecord *that, const std::string &tableRow, std::ostream *os) const
Private Attributes
TList	fKeys
	Current collection of DbiResultKeys.
Friends
std::ostream &	operator<< (std::ostream &os, const DbiRecord &rec)

---

Detailed Description

Id

DbiRecord.h,v 1.4 2006/08/08 10:51:32 west Exp

Definition at line 41 of file DbiRecord.h.

---

Constructor & Destructor Documentation

DbiRecord::DbiRecord

(

)

Definition at line 44 of file DbiRecord.cxx.

References Msg::kVerbose, LEA_CTOR, and MSG.

{
//
//
//  Purpose:  Default constructor
//
//  Contact:   N. West
//
//  Specification:-
//  =============
//
//  o  Create DbiRecord.

  LEA_CTOR    //Leak Checker

  MSG("Dbi", Msg::kVerbose) << "Creating DbiRecord" << endl;

}

DbiRecord::~DbiRecord

(

)

[virtual]

Definition at line 65 of file DbiRecord.cxx.

References Msg::kVerbose, LEA_DTOR, and MSG.

                      {
//
//
//  Purpose: Destructor
//
//  Contact:   N. West
//
//  Specification:-
//  =============
//
//  o  Destroy DbiRecord

  LEA_DTOR    //Leak Checker

  MSG("Dbi", Msg::kVerbose) << "Destroying DbiRecord" << endl;

}

---

Member Function Documentation

void DbiRecord::AddTableRowNames

(

std::set< std::string > &

names

)

const

Definition at line 85 of file DbiRecord.cxx.

References fKeys.

                                                                {
//
//
//  Purpose: Add TableRow names to supplied set. 
//

  TIter itr(&fKeys);
  while ( const DbiResultKey* key = dynamic_cast<const DbiResultKey*>(itr.Next() ) )
    names.insert(key->GetTableRowName());

}

void DbiRecord::AdoptKey

(

DbiResultKey *

key

)

Definition at line 98 of file DbiRecord.cxx.

References DbiResultKey::AsString(), fKeys, Msg::kDebug, Msg::kWarning, and MSG.

Referenced by DbiResult::RegisterKey().

                                          {
//
//
//  Purpose:  Adopt (take control of) a Dbikey.
//
//  Arguments: 
//    key          in    DbiResultKey to be adopted 
//

  if ( ! key ) {
    MSG("Dbi",Msg::kWarning) << "Attempting to adopt a null DbiResultKey!" << endl;
    return;
  }
  if ( fKeys.FindObject(key) ) {
    MSG("Dbi",Msg::kWarning) << "Attempting to adopt DbiResultKey at " << (void*) key 
                             << " which is already adopted." << endl; 
  }
  else {
    MSG("Dbi",Msg::kDebug) << "Adopting key: " << key->AsString() << endl;
    fKeys.Add(key);
  }

}

Bool_t DbiRecord::CompareTableRowKeys	(	const DbiRecord *	that,
		const std::string &	tableRow,
		std::ostream *	os
	)			const [private]

Definition at line 123 of file DbiRecord.cxx.

References fKeys.

                                                             {
//
//
//  Purpose: Compare all keys for a specific table::row with supplied DbiRecord
//
//  Arguments: 
//    that         in    The DbiRecord to be compared
//    tableRow     in    The table::row name used to select DbiesultKeys
//    os           in    stream on which to report results if not null.
//
//  Return:    =false  One or more keys don't exactly match
//             =true   All selected keys match (by maybe none were selected).

  typedef std::list<const DbiResultKey*> list_t;
  typedef std::list<const DbiResultKey*>::iterator list_itr_t;
  
  bool allMatch = true;

  //  Collect list of selected keys from both records.

  list_t list1, list2;
  TIter itr1(&fKeys);
  while ( const DbiResultKey* key = dynamic_cast<const DbiResultKey*>(itr1.Next() ) )
    if ( key->GetTableRowName() == tableRow ) list1.push_back(key);
  TIter itr2(&that->fKeys);
  while ( const DbiResultKey* key = dynamic_cast<const DbiResultKey*>(itr2.Next() ) )
    if ( key->GetTableRowName() == tableRow ) list2.push_back(key);

  //  Repeatedly find the best match between the 2 lists and remove it until
  //  no good matches remain.

  float bestMatch = 1.;
  list_itr_t bestItr1 = list1.begin();
  list_itr_t bestItr2 = list2.begin();

  while ( bestMatch > 0. ) {
    bestMatch = 0.;
    for ( list_itr_t itr1 = list1.begin(); itr1 != list1.end(); ++itr1 ) {
      for ( list_itr_t itr2 = list2.begin(); itr2 != list2.end(); ++itr2 ) {
        float match = (*itr1)->Compare(*itr2);
        if ( match > bestMatch ) {
          bestMatch = match;
          bestItr1 = itr1;
          bestItr2 = itr2;
        }
      }
    }
    if ( bestMatch > 0. ) {
      if ( os ) {
        if ( bestMatch == 1.) *os << "Found in both records. Exact match " << **bestItr1;
        else {
          *os << "Found in both records. Match " << bestMatch 
             << "  " <<  **bestItr1 << " " << **bestItr2;
          allMatch = false;
        }
      }
      list1.erase(bestItr1);
      list2.erase(bestItr2);
    }
  }

  // Deal with the leftovers.

  if ( list1.size() > 0 || list2.size() > 0 ) allMatch = false;
  if ( os ) {
    for ( list_itr_t itr1 = list1.begin(); itr1 != list1.end(); ++itr1 ) 
      *os << "Found in first record: " << **itr1;
    for ( list_itr_t itr2 = list2.begin(); itr2 != list2.end(); ++itr2 ) 
      *os << "Found in second record: " << **itr2;
  }

  return allMatch;
}

const DbiResultKey * DbiRecord::DeleteKey

(

const DbiResultKey *

key

)

Definition at line 201 of file DbiRecord.cxx.

References DbiResultKey::AsString(), fKeys, Msg::kDebug, Msg::kWarning, and MSG.

Referenced by DbiResult::DeRegisterKey().

                                                                {
//
//
//  Purpose:  Delete key.
//
//  Arguments: 
//    key          in    DbiResultKey to be deleted
//
//  Return:    = 0 If DbiRecord owned the key and has deleted it.
//             key (unchanged) if DbiRecord did not own it. 

// Remove takes a non-const pointer (don't ask me) so cast so that key
// can be a const (the caller doesn't own the DbiResultKey, this object does)
  DbiResultKey* myKey = const_cast<DbiResultKey*>(key);
  TObject* keyFound = fKeys.Remove(myKey);

  if ( keyFound ) {
    MSG("Dbi",Msg::kDebug) << "Deleting key: " << key->AsString() << endl;
    delete key;
    return 0;
  }
  else {
    MSG("Dbi",Msg::kWarning) << "Attempting to delete DbiResultKey at " << (void*) key 
                             << " which has not been adopted." << endl; 
    return key;
  }

}

---

Friends And Related Function Documentation

std::ostream& operator<<	(	std::ostream &	os,
		const DbiRecord &	rec
	)			[friend]

---

Member Data Documentation

TList DbiRecord::fKeys [private]

Current collection of DbiResultKeys.

Definition at line 69 of file DbiRecord.h.

Referenced by AddTableRowNames(), AdoptKey(), CompareTableRowKeys(), and DeleteKey().

---

The documentation for this class was generated from the following files:

• DbiRecord.h
• DbiRecord.cxx