DataObjectHandleBase Class Reference

DataObjectHandleBase GaudiKernel/DataObjectHandleBase.h. More...

#include </builds/gaudi/Gaudi/GaudiKernel/include/GaudiKernel/DataObjectHandleBase.h>

Inheritance diagram for DataObjectHandleBase:

Collaboration diagram for DataObjectHandleBase:

Public Member Functions
	DataObjectHandleBase (DataObjID k, Gaudi::DataHandle::Mode a, IDataHandleHolder *owner)
	DataObjectHandleBase (std::string k, Gaudi::DataHandle::Mode a, IDataHandleHolder *owner)
	~DataObjectHandleBase () override
	DataObjectHandleBase (const DataObjectHandleBase &)=delete
	DataObjectHandleBase (DataObjectHandleBase &&)
DataObjectHandleBase &	operator= (const DataObjectHandleBase &)
bool	isValid () const
Public Member Functions inherited from Gaudi::DataHandle
	DataHandle (DataObjID k, Mode a=Reader, IDataHandleHolder *owner=nullptr)
	DataHandle (DataObjID k, bool isCond, Mode a=Reader, IDataHandleHolder *owner=nullptr)
virtual	~DataHandle ()=default
virtual void	setOwner (IDataHandleHolder *o)
virtual IDataHandleHolder *	owner () const
virtual Mode	mode () const
virtual void	setKey (DataObjID key)
virtual void	updateKey (std::string key)
virtual const std::string &	objKey () const
virtual const DataObjID &	fullKey () const
virtual void	reset (bool)
virtual std::string	pythonRepr () const
virtual bool	isCondition () const

Protected Member Functions
bool	init () override
DataObject *	fetch () const

Protected Attributes
SmartIF< IDataProviderSvc >	m_EDS
SmartIF< IMessageSvc >	m_MS
bool	m_init = false
Protected Attributes inherited from Gaudi::DataHandle
DataObjID	m_key = { "NONE" }
	The key of the object behind this DataHandle Although it may look strange to have it mutable, this can actually change in case the object had alternative names, and it should not be visible to the end user, for which the Handle is still the same.
IDataHandleHolder *	m_owner = nullptr

Friends
std::ostream &	operator<< (std::ostream &str, const DataObjectHandleBase &d)

Additional Inherited Members
Public Types inherited from Gaudi::DataHandle
enum	Mode { Reader = 1 << 2 , Writer = 1 << 4 }
using	PropertyType = DataHandleProperty
Static Protected Attributes inherited from Gaudi::DataHandle
static const std::string	default_type = "unknown_t"

Detailed Description

DataObjectHandleBase GaudiKernel/DataObjectHandleBase.h.

Base class for handles to Data Objects in the Event Store, to simplify access via Properties.

Author

Charles Leggett

Date

2015-09-01

Definition at line 34 of file DataObjectHandleBase.h.

Constructor & Destructor Documentation

DataObjectHandleBase() [1/4]

DataObjectHandleBase::DataObjectHandleBase	(	DataObjID	k,
		Gaudi::DataHandle::Mode	a,
		IDataHandleHolder *	owner )

Definition at line 48 of file DataObjectHandleBase.cpp.

    : Gaudi::DataHandle( std::move( k ), a, owner ) {
  if ( !m_owner ) {
    throw GaudiException( "DataObjectHandleBase requires a non-null owner", "Invalid Owner", StatusCode::FAILURE );
  }
  m_owner->declare( *this );
}

DataObjectHandleBase() [2/4]

DataObjectHandleBase::DataObjectHandleBase	(	std::string	k,
		Gaudi::DataHandle::Mode	a,
		IDataHandleHolder *	owner )

Definition at line 58 of file DataObjectHandleBase.cpp.

    : DataObjectHandleBase( DataObjID{ std::move( k ) }, a, owner ) {}

~DataObjectHandleBase()

DataObjectHandleBase::~DataObjectHandleBase ( )

override

Definition at line 62 of file DataObjectHandleBase.cpp.

                                            {
  // Regular DataObjectHandles are declared to an owner during construction,
  // but destruction must remain harmless for exceptional or moved-from states.
  if ( owner() ) owner()->renounce( *this );
}

DataObjectHandleBase() [3/4]

DataObjectHandleBase::DataObjectHandleBase ( const DataObjectHandleBase & )

delete

DataObjectHandleBase() [4/4]

DataObjectHandleBase::DataObjectHandleBase

(

DataObjectHandleBase &&

other

)

Definition at line 26 of file DataObjectHandleBase.cpp.

    : Gaudi::DataHandle( other )
    , m_EDS( std::move( other.m_EDS ) )
    , m_MS( std::move( other.m_MS ) )
    , m_init( other.m_init ) {
  if ( !m_owner ) {
    throw GaudiException( "DataObjectHandleBase requires a non-null owner", "Invalid Owner", StatusCode::FAILURE );
  }
  m_owner->declare( *this );
}

Member Function Documentation

fetch()

DataObject * DataObjectHandleBase::fetch ( ) const

protected

Definition at line 69 of file DataObjectHandleBase.cpp.

                                              {
  // convenience towards users -- remind them to register
  // but as m_MS is not yet set, we cannot use a MsgStream...
  if ( !m_init ) {
    std::cerr << ( owner() ? owner()->name() : "<UNKNOWN>:" ) << "DataObjectHandle: uninitialized data handle"
              << std::endl;
  }
  DataObject* p = nullptr;
  m_EDS->retrieveObject( objKey(), p ).ignore();
  return p;
}

init()

bool DataObjectHandleBase::init ( )

overrideprotectedvirtual

Reimplemented from Gaudi::DataHandle.

Definition at line 83 of file DataObjectHandleBase.cpp.

                                {
  if ( m_init ) return true; // initialization already done
 
  if ( !owner() ) return false;
 
  Gaudi::Algorithm* algorithm = dynamic_cast<Gaudi::Algorithm*>( owner() );
  if ( algorithm ) {
    // Fetch the event Data Service from the algorithm
    m_EDS = algorithm->evtSvc();
    m_MS  = algorithm->msgSvc();
  } else {
    AlgTool* tool = dynamic_cast<AlgTool*>( owner() );
    if ( tool ) {
      m_EDS = tool->evtSvc();
      m_MS  = tool->msgSvc();
    } else {
      throw GaudiException( "owner is neither AlgTool nor Gaudi::Algorithm", "Invalid Cast", StatusCode::FAILURE );
    }
  }
  m_init = true;
  return true;
}

isValid()

bool DataObjectHandleBase::isValid

(

)

const

Definition at line 108 of file DataObjectHandleBase.cpp.

{ return fullKey() != INVALID_DATAOBJID; }

operator=()

DataObjectHandleBase & DataObjectHandleBase::operator=

(

const DataObjectHandleBase &

other

)

Definition at line 38 of file DataObjectHandleBase.cpp.

                                                                                       {
  // FIXME: operator= should not change our owner, only our 'value'
  Gaudi::DataHandle::operator=( other );
  m_EDS  = other.m_EDS;
  m_MS   = other.m_MS;
  m_init = other.m_init;
  return *this;
}

Friends And Related Symbol Documentation

operator<<

std::ostream & operator<< ( std::ostream & str, const DataObjectHandleBase & d )

friend

Definition at line 112 of file DataObjectHandleBase.cpp.

                                                                         {
 
  str << d.fullKey() << "  m: " << d.mode();
  if ( d.owner() ) str << "  o: " << d.owner()->name();
  return str;
}

Member Data Documentation

m_EDS

SmartIF<IDataProviderSvc> DataObjectHandleBase::m_EDS

protected

Definition at line 55 of file DataObjectHandleBase.h.

m_init

bool DataObjectHandleBase::m_init = false

protected

Definition at line 58 of file DataObjectHandleBase.h.

m_MS

SmartIF<IMessageSvc> DataObjectHandleBase::m_MS

protected

Definition at line 56 of file DataObjectHandleBase.h.

---

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

• GaudiKernel/include/GaudiKernel/DataObjectHandleBase.h
• GaudiKernel/src/Lib/DataObjectHandleBase.cpp