DataObjectHandle< T > Class Template Reference

DataObjectHandle.h GaudiKernel/DataObjectHandle.h. More...

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

Inheritance diagram for DataObjectHandle< T >:

Collaboration diagram for DataObjectHandle< T >:

Public Member Functions
T *	get () const
	Retrieve object from transient data store.
T *	getIfExists () const
	Bypass check of existence of object in transient store Only uses main location of the.
bool	exist () const
	Check the existence of the object in the transient store.
T *	getOrCreate () const
	Get object from store or create a new one if it doesn't exist.
T *	put (std::unique_ptr< T > object) const
	Register object in transient store.
std::string	pythonRepr () const override
	DataObjectHandleBase (DataObjID k, Gaudi::DataHandle::Mode a, IDataHandleHolder *owner)
	DataObjectHandleBase (std::string k, Gaudi::DataHandle::Mode a, IDataHandleHolder *owner)
	DataObjectHandleBase (const DataObjectHandleBase &)=delete
	DataObjectHandleBase (DataObjectHandleBase &&)
Public Member Functions inherited from DataObjectHandleBase
	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 bool	isCondition () const

Private Member Functions
T *	get (bool mustExist) const
	Try to retrieve from the transient store.

Additional Inherited Members
Public Types inherited from Gaudi::DataHandle
enum	Mode { Reader = 1 << 2 , Writer = 1 << 4 }
using	PropertyType = DataHandleProperty
Protected Member Functions inherited from DataObjectHandleBase
bool	init () override
DataObject *	fetch () const
Protected Attributes inherited from DataObjectHandleBase
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
Static Protected Attributes inherited from Gaudi::DataHandle
static const std::string	default_type = "unknown_t"

Detailed Description

template<typename T>
class DataObjectHandle< T >

DataObjectHandle.h GaudiKernel/DataObjectHandle.h.

Templated Handle class for objects in the event store

Inheritance: DataHandle->DataObjectHandleBase->DataObjectHandle<T>

Author

Charles Leggett

Date

2015-09-01

Definition at line 110 of file DataObjectHandle.h.

Member Function Documentation

DataObjectHandleBase() [1/4]

template<typename T>

DataObjectHandleBase::DataObjectHandleBase ( const DataObjectHandleBase & )

delete

DataObjectHandleBase() [2/4]

template<typename T>

DataObjectHandleBase::DataObjectHandleBase

(

DataObjectHandleBase &&

other

)

Definition at line 42 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 ) {
  m_owner->declare( *this );
}

DataObjectHandleBase() [3/4]

template<typename T>

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

Definition at line 37 of file DataObjectHandleBase.cpp.

    : Gaudi::DataHandle( std::move( k ), a, owner ) {
  m_owner->declare( *this );
}

DataObjectHandleBase() [4/4]

template<typename T>

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

Definition at line 38 of file DataObjectHandleBase.cpp.

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

exist()

template<typename T>

bool DataObjectHandle< T >::exist ( ) const

inline

Check the existence of the object in the transient store.

Definition at line 128 of file DataObjectHandle.h.

{ return get( false ) != nullptr; }

get() [1/2]

template<typename ValueType>

auto DataObjectHandle< ValueType >::get ( ) const

inline

Retrieve object from transient data store.

Definition at line 117 of file DataObjectHandle.h.

{ return get( true ); }

get() [2/2]

template<typename T>

T * DataObjectHandle< T >::get ( bool mustExist ) const

private

Try to retrieve from the transient store.

If the retrieval succeeds and we are in a debug build, perform a dynamic cast to verify the type of the object. In optimized builds the type check is skipped and a static cast is used directly.

Definition at line 158 of file DataObjectHandle.h.

                                                  {
  auto dataObj = fetch();
  if ( !dataObj ) {
    if ( mustExist ) { // Problems in getting from the store
      throw GaudiException( "Cannot retrieve \'" + objKey() + "\' from transient store.",
                            m_owner ? owner()->name() : "no owner", StatusCode::FAILURE );
    }
    return nullptr;
  }
#ifndef NDEBUG
  ::details::verifyType<T>( dataObj );
#endif
  return static_cast<T*>( dataObj );
}

getIfExists()

template<typename T>

T * DataObjectHandle< T >::getIfExists ( ) const

inline

Bypass check of existence of object in transient store Only uses main location of the.

Definition at line 123 of file DataObjectHandle.h.

{ return get( false ); }

getOrCreate()

template<typename T>

T * DataObjectHandle< T >::getOrCreate

(

)

const

Get object from store or create a new one if it doesn't exist.

Definition at line 184 of file DataObjectHandle.h.

                                          {
  T* obj = get( false );
  return obj ? obj : put( std::make_unique<T>() );
}

put()

template<typename T>

T * DataObjectHandle< T >::put

(

std::unique_ptr< T >

object

)

const

Register object in transient store.

Definition at line 175 of file DataObjectHandle.h.

                                                            {
  assert( m_init );
  StatusCode sc = m_EDS->registerObject( objKey(), objectp.get() );
  if ( !sc.isSuccess() ) { throw GaudiException( "Error in put of " + objKey(), "DataObjectHandle<T>::put", sc ); }
  return objectp.release();
}

pythonRepr()

template<typename T>

std::string DataObjectHandle< T >::pythonRepr ( ) const

inlineoverridevirtual

Reimplemented from Gaudi::DataHandle.

Definition at line 140 of file DataObjectHandle.h.

                                        {
    return ::details::replace_all( DataObjectHandleBase::pythonRepr(), default_type,
                                   System::typeinfoName( typeid( T ) ) );
  }

---

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

• GaudiKernel/include/GaudiKernel/AlgTool.h
• GaudiKernel/include/GaudiKernel/DataObjectHandle.h