Property holding a SG store/key/clid/attr name from which a ReadDecorHandle is made. More...

#include <ReadDecorHandleKey.h>

Inheritance diagram for SG::ReadDecorHandleKey< T >:

Collaboration diagram for SG::ReadDecorHandleKey< T >:

Public Types
typedef ReadHandleKey< T >	Base
	Base class. More...

typedef SG::TopBase< T >::type	topbase_t
	Class for which we set the CLID. See above. More...

using	PropertyType = SG::VarHandleKeyProperty
	Declare corresponding property type. More...

Public Member Functions
	ReadDecorHandleKey (const std::string &key="", const std::string &storeName=StoreID::storeName(StoreID::EVENT_STORE))
	Constructor. More...

	ReadDecorHandleKey (const VarHandleKey &contKey, const std::string &decorKey="", const std::string &storeName=StoreID::storeName(StoreID::EVENT_STORE))
	Constructor with associated container. More...

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>
	ReadDecorHandleKey (OWNER *owner, const std::string &name, const std::string &key={}, const std::string &doc="")
	auto-declaring Property Constructor. More...

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>
	ReadDecorHandleKey (OWNER *owner, const std::string &name, const VarHandleKey &contKey, const std::string &decorKey={}, const std::string &doc="")
	auto-declaring Property Constructor. More...

ReadDecorHandleKey &	operator= (const std::string &sgkey)
	Change the key of the object to which we're referring. More...

virtual StatusCode	assign (const std::string &sgkey) override
	Change the key of the object to which we're referring. More...

CLID	clid () const
	Return the class ID for the referenced object. More...

StatusCode	initialize (bool used=true)
	If this object is used as a property, then this should be called during the initialize phase. More...

const ReadHandleKey< T > &	contHandleKey () const
	Return the handle key for the container. More...

StatusCode	initialize (AllowEmptyEnum)
	If this object is used as a property, then this should be called during the initialize phase. More...

const std::string &	key () const
	Return the StoreGate ID for the referenced object. More...

bool	empty () const
	Test if the key is blank. More...

const ServiceHandle< IProxyDict > &	storeHandle () const
	Return handle to the referenced store. More...

VarHandleBase *	owningHandle ()
	Return the VarHandle that owns this key, if any. More...

bool	isEventStore () const
	Does this key reference the primary event store? More...

virtual StatusCode	start ()
	Called by the owning algorithm during the START transition. More...

SG::sgkey_t	hashedKey () const
	Return the hashed StoreGate key. More...

Private Member Functions
virtual std::string	pythonRepr () const override
	Python representation of Handle. More...

void	setOwningHandle (VarHandleBase *handle)

virtual void	setKey (DataObjID key) override final
	Don't allow calling these. More...

virtual void	updateKey (std::string key) override final
	Prevent this method from being called. More...

void	parseKey (const std::string &sgkey, const std::string &storeName)
	Handle assignment/construction from a string key. More...

void	updateHandle (const std::string &name)
	Update the name of the store to which we're referring. More...

Private Attributes
ReadHandleKey< T >	m_contHandleKey
	The container handle. More...

const VarHandleKey *	m_contKey {nullptr}
	Optional container from which decorations are read. More...

ServiceHandle< IProxyDict >	m_storeHandle
	Handle to the referenced store. More...

std::string	m_sgKey
	StoreGate key, that doesn't include the storename. More...

SG::sgkey_t	m_hashedKey = 0
	The hashed StoreGate key. May be 0 if not yet initialized. More...

bool	m_isEventStore = false
	Cache test for whether we're referencing the event store. More...

VarHandleBase *	m_owningHandle = nullptr
	Handle that owns this key, or nullptr if it is not owned. More...

Detailed Description

template<class T>
class SG::ReadDecorHandleKey< T >

Property holding a SG store/key/clid/attr name from which a ReadDecorHandle is made.

This class holds the key part of a ReadDecorHandle.

Use this to read a decoration on an object such that the scheduler is aware of it. This is used just like a ReadHandleKey (which see) except that the key string is of the form CCC.DDD, where CCC is the name of the container in StoreGate and DDD is the name of the decoration.

Example:

class MyAlgorithm : public AthReentrantAlgorithm {
  ...
  SG::ReadDecorHandleKey<MyCont> m_key{this, "Key", "container.decor"};
};
 
StatusCode MyAlgorithm::initialize()
{
  ATH_CHECK( m_key.initialize() );
  ...
}
 
StatusCode MyAlgorithm::execute (const EventContext& ctx) const
{
  SG::ReadDecorHandle<MyCont, float> h (m_key, ctx);
  for (const MyObj& o : *h) {  // Access the container.
    doSomething (h (o));  // Access the decoration.
    ...

Alternatively, one can construct the key with an additional VarHandleKey that represents the container and the key then only holds the decoration name. This is useful to avoid hard-coding the container name twice in case the algorithm also has a ReadHandleKey or WriteHandleKey for the container:

Example:

class MyAlgorithm : public AthReentrantAlgorithm {
  ...
  SG::ReadHandleKey<MyCont> m_rhkey{this, "RHKey", "container"};
  SG::ReadDecorHandleKey<MyCont> m_rdhkey{this, "Key", m_rhkey, "decor"};
};
...

One can run into issues with the scheduler if this is used in conjunction with inheritance. For example, if D derives from B, and one uses WriteDecorHandleKey, then the scheduler will know only about the B.DECOR output; it won't have a dependency for D.DECOR. That means that trying to use D.DECOR as a dependency downstream won't work. To solve this, we arrange that the CLID in the DataObjID for ReadDecorHandleKey<D> is actually that for B; in that case, the scheduler will be happy.

Definition at line 83 of file StoreGate/StoreGate/ReadDecorHandleKey.h.

Member Typedef Documentation

◆ Base

template<class T >

typedef ReadHandleKey<T> SG::ReadDecorHandleKey< T >::Base

Base class.

Definition at line 88 of file StoreGate/StoreGate/ReadDecorHandleKey.h.

◆ PropertyType

using SG::VarHandleKey::PropertyType = SG::VarHandleKeyProperty

inherited

Declare corresponding property type.

Definition at line 91 of file StoreGate/StoreGate/VarHandleKey.h.

◆ topbase_t

template<class T >

typedef SG::TopBase<T>::type SG::ReadDecorHandleKey< T >::topbase_t

Class for which we set the CLID. See above.

Definition at line 91 of file StoreGate/StoreGate/ReadDecorHandleKey.h.

Constructor & Destructor Documentation

◆ ReadDecorHandleKey() [1/4]

template<class T >

SG::ReadDecorHandleKey< T >::ReadDecorHandleKey	(	const std::string &	key = `""`,
		const std::string &	storeName = `StoreID::storeName(StoreID::EVENT_STORE)`
	)

Constructor.

Parameters

key	The StoreGate key for the object.
storeName	Name to use for the store, if it's not encoded in sgkey.

The provided key may actually start with the name of the store, separated by a "+": "MyStore+Obj". If no "+" is present the store named by storeName is used.

◆ ReadDecorHandleKey() [2/4]

template<class T >

SG::ReadDecorHandleKey< T >::ReadDecorHandleKey	(	const VarHandleKey &	contKey,
		const std::string &	decorKey = `""`,
		const std::string &	storeName = `StoreID::storeName(StoreID::EVENT_STORE)`
	)

explicit

Constructor with associated container.

Parameters

contKey	VarHandleKey of the associated container
decorKey	The decoration name.
storeName	Name to use for the store.

The decoration @decorKey will be read from the container referenced by @contKey.

◆ ReadDecorHandleKey() [3/4]

template<class T >

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>

SG::ReadDecorHandleKey< T >::ReadDecorHandleKey	(	OWNER *	owner,
		const std::string &	name,
		const std::string &	key = `{}`,
		const std::string &	doc = `""`
	)

auto-declaring Property Constructor.

Parameters

owner	Owning component.
name	name of the Property
key	default StoreGate key for the object.
doc	Documentation string.

will associate the named Property with this RHK via declareProperty

The provided key may actually start with the name of the store, separated by a "+": "MyStore+Obj". If no "+" is present the store named by storeName is used.

◆ ReadDecorHandleKey() [4/4]

template<class T >

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>

SG::ReadDecorHandleKey< T >::ReadDecorHandleKey	(	OWNER *	owner,
		const std::string &	name,
		const VarHandleKey &	contKey,
		const std::string &	decorKey = `{}`,
		const std::string &	doc = `""`
	)

auto-declaring Property Constructor.

Parameters

owner	Owning component.
name	name of the Property
contKey	VarHandleKey of the associated container
decorKey	name The decoration name.
doc	Documentation string.

will associate the named Property with this WDHK via declareProperty

Member Function Documentation

◆ assign()

template<class T >

virtual StatusCode SG::ReadDecorHandleKey< T >::assign ( const std::string & sgkey )

overridevirtual

Change the key of the object to which we're referring.

Parameters

sgkey The StoreGate key for the object.

The provided key may actually start with the name of the store, separated by a "+": "MyStore+Obj". If no "+" is present the store is not changed. A key name that starts with a slash is interpreted as a hierarchical key name, not an empty store name.

Returns failure the key string format is bad.

Reimplemented from SG::VarHandleKey.

◆ clid()

template<class T >

CLID SG::ReadDecorHandleKey< T >::clid ( ) const

Return the class ID for the referenced object.

Overridden here to return the CLID for T instead of topbase_t.

◆ contHandleKey()

template<class T >

const ReadHandleKey<T>& SG::ReadDecorHandleKey< T >::contHandleKey ( ) const

Return the handle key for the container.

◆ empty()

bool SG::VarHandleKey::empty ( ) const

inherited

Test if the key is blank.

Definition at line 150 of file AthToolSupport/AsgDataHandles/Root/VarHandleKey.cxx.

 {
   return m_sgKey.empty();
 }

◆ hashedKey()

SG::sgkey_t SG::VarHandleKey::hashedKey ( ) const

inherited

Return the hashed StoreGate key.

May be 0 if not yet initialized.

◆ initialize() [1/2]

StatusCode SG::VarHandleKey::initialize ( AllowEmptyEnum )

inherited

If this object is used as a property, then this should be called during the initialize phase.

This variant will allow the key to be blank.

Parameters

Flag	to select this variant. Call like ATH_CHECK( key.initialize (SG::AllowEmpty) );

Definition at line 129 of file AthToolSupport/AsgDataHandles/Root/VarHandleKey.cxx.

 {
   if (key().empty()) {
     return StatusCode::SUCCESS;
   }
   return initialize (true);
 }

◆ initialize() [2/2]

template<class T >

StatusCode SG::ReadDecorHandleKey< T >::initialize ( bool used = true )

If this object is used as a property, then this should be called during the initialize phase.

It will fail if the requested StoreGate service cannot be found or if the key is blank.

Parameters

used	If false, then this handle is not to be used. Instead of normal initialization, the key will be cleared.

◆ isEventStore()

bool SG::VarHandleKey::isEventStore ( ) const

inherited

Does this key reference the primary event store?

◆ key()

const std::string & SG::VarHandleKey::key ( ) const

inherited

Return the StoreGate ID for the referenced object.

Definition at line 141 of file AthToolSupport/AsgDataHandles/Root/VarHandleKey.cxx.

 {
   return m_sgKey;
 }

◆ operator=()

template<class T >

ReadDecorHandleKey& SG::ReadDecorHandleKey< T >::operator= ( const std::string & sgkey )

Change the key of the object to which we're referring.

Parameters

sgkey The StoreGate key for the object.

The provided key may actually start with the name of the store, separated by a "+": "MyStore+Obj". If no "+" is present, the store is not changed.

◆ owningHandle()

VarHandleBase* SG::VarHandleKey::owningHandle ( )

inherited

Return the VarHandle that owns this key, if any.

This should only be non-null for keys that are created automatically by a VarHandle when it is not created from a VarHandleKey. This should always be null for keys that are created explicitly.

◆ parseKey()

void SG::VarHandleKey::parseKey	(	const std::string &	key,
		const std::string &	storeName
	)

privateinherited

Handle assignment/construction from a string key.

Parameters

sgkey The StoreGate key for the referenced object.

The provided key may actually start with the name of the store, separated by a "+": "MyStore+Obj". If no "+" is present, the store named by storeName is used. A key name that starts with a slash is interpreted as a hierarchical key name, not an empty store name.

see implementation comments for further details

Parameters

sgkey The StoreGate key for the referenced object.

The provided key may actually start with the name of the store, separated by a "+": "MyStore+Obj". If no "+" is present the store named by storeName is used. A key name that starts with a slash is interpreted as a hierarchical key name, not an empty store name.

we also have to check that if the key contains the store name, it matches the store name that they Handle was constructed with

blank keys result in blank DataObjIDs

Definition at line 217 of file StoreGate/src/VarHandleKey.cxx.

 {
   m_hashedKey = 0;
  
   std::string sn;
   // test if storeName has classname
   std::string::size_type sp = storeName.find('/');
   if (sp == std::string::npos) {
     sn = storeName;
   } else {
     sn = storeName.substr(sp+1,storeName.length()-sp+1);
   }
  
   if (key.empty()) {
     this->updateHandle(sn);
     Gaudi::DataHandle::updateKey("");
     m_sgKey.clear();
     return;
   }
  
   // StoreName separator is "+"
   sp = key.find(storeSeparator);
   if(sp == std::string::npos) {
     m_sgKey = key;
   } else {
     sn = key.substr(0,sp);
     m_sgKey = key.substr(sp+1,key.length()-sp-1);
   }
  
  
   this->updateHandle(sn);
  
   StoreID::type st;
   // would be nice if we could get the storeID from the storeHandle, but
   // we can't be sure that the store has been created when the VHK is
   // constructed.
   //
  
   st = StoreID::findStoreID(sn);
  
   if (st != StoreID::CONDITION_STORE && st != StoreID::METADATA_STORE) {
     if (m_sgKey.find('/') != std::string::npos) {
       throw SG::ExcBadHandleKey("key \"" + key 
                                 + "\": keys with \"/\" only allowed for "
                                 + StoreID::storeName(StoreID::CONDITION_STORE) 
                                 + " - store is \""
                                 + sn + "\"");
     }
   } else {
     sp = m_sgKey.rfind('/');
     if (sp != std::string::npos) {
       if (sp == 0
       && m_sgKey.size() == 1) {
         // Replace '\' with blank key
         m_sgKey.clear();
       } else if ( sp == m_sgKey.length()-1) {
         throw SG::ExcBadHandleKey("key \"" + key 
                                   + "\": must not end with a \"/\"");
       }
     }
   }
   
   if (m_sgKey.empty()) {
     Gaudi::DataHandle::updateKey("");
   } else {
     Gaudi::DataHandle::updateKey(sn + storeSeparator + m_sgKey);
   }
  
  
 }

◆ pythonRepr()

template<class T >

virtual std::string SG::ReadDecorHandleKey< T >::pythonRepr ( ) const

overrideprivatevirtual

Python representation of Handle.

Reimplemented from SG::VarHandleKey.

◆ setKey()

void SG::VarHandleKey::setKey ( DataObjID key )

finaloverrideprivatevirtualinherited

Don't allow calling these.

Prevent this method from being called.

Definition at line 186 of file StoreGate/src/VarHandleKey.cxx.

 {
   throw SG::ExcForbiddenMethod ("VarHandleKey::setKey");
 }

◆ setOwningHandle()

void SG::VarHandleKey::setOwningHandle ( VarHandleBase * handle )

privateinherited

◆ start()

virtual StatusCode SG::VarHandleKey::start ( )

virtualinherited

Called by the owning algorithm during the START transition.

AthAlgorithm and friends will call this during START. This allows for extra initialization that we can't do during initialize(), such as retrieving a conditions container from the store.

The default implementation is a no-op.

◆ storeHandle()

const ServiceHandle<IProxyDict>& SG::VarHandleKey::storeHandle ( ) const

inherited

Return handle to the referenced store.

◆ updateHandle()

void SG::VarHandleKey::updateHandle ( const std::string & name )

privateinherited

Update the name of the store to which we're referring.

Parameters

name	The new store name.

Definition at line 294 of file StoreGate/src/VarHandleKey.cxx.

 {
   // Don't invalidate a stored pointer if the handle is already pointing
   // at the desired service.
   if (m_storeHandle.name() != name) {
     m_hashedKey = 0;
     m_storeHandle = ServiceHandle<IProxyDict>(name, "VarHandleKey");
     m_isEventStore =  (name == StoreID::storeName(StoreID::EVENT_STORE) ||
                        name == StoreID::storeName(StoreID::PILEUP_STORE));
   }
 }

◆ updateKey()

void SG::VarHandleKey::updateKey ( std::string key )

finaloverrideprivatevirtualinherited

Prevent this method from being called.

Definition at line 195 of file StoreGate/src/VarHandleKey.cxx.

 {
   throw SG::ExcForbiddenMethod ("VarHandleKey::updateKey");
 }

Member Data Documentation

◆ m_contHandleKey

template<class T >

ReadHandleKey<T> SG::ReadDecorHandleKey< T >::m_contHandleKey

private

The container handle.

Definition at line 218 of file StoreGate/StoreGate/ReadDecorHandleKey.h.

◆ m_contKey

template<class T >

const VarHandleKey* SG::ReadDecorHandleKey< T >::m_contKey {nullptr}

private

Optional container from which decorations are read.

If used, this is really the same as our own m_contHandleKey. So we could just keep it in a (non-)owning pointer depending on the use-case. But that would require a dedicated copy constructor for this class, etc.

Definition at line 227 of file StoreGate/StoreGate/ReadDecorHandleKey.h.

◆ m_hashedKey

SG::sgkey_t SG::VarHandleKey::m_hashedKey = 0

privateinherited

The hashed StoreGate key. May be 0 if not yet initialized.

Definition at line 250 of file StoreGate/StoreGate/VarHandleKey.h.

◆ m_isEventStore

bool SG::VarHandleKey::m_isEventStore = false

privateinherited

Cache test for whether we're referencing the event store.

Definition at line 253 of file StoreGate/StoreGate/VarHandleKey.h.

◆ m_owningHandle

VarHandleBase* SG::VarHandleKey::m_owningHandle = nullptr

privateinherited

Handle that owns this key, or nullptr if it is not owned.

Definition at line 256 of file StoreGate/StoreGate/VarHandleKey.h.

◆ m_sgKey

std::string SG::VarHandleKey::m_sgKey

privateinherited

StoreGate key, that doesn't include the storename.

Definition at line 247 of file StoreGate/StoreGate/VarHandleKey.h.

◆ m_storeHandle

ServiceHandle<IProxyDict> SG::VarHandleKey::m_storeHandle

privateinherited

Handle to the referenced store.

Definition at line 244 of file StoreGate/StoreGate/VarHandleKey.h.

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

StoreGate/StoreGate/ReadDecorHandleKey.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<class T> class SG::ReadDecorHandleKey< T >

Member Typedef Documentation

◆ Base

◆ PropertyType

◆ topbase_t

Constructor & Destructor Documentation

◆ ReadDecorHandleKey() [1/4]

◆ ReadDecorHandleKey() [2/4]

◆ ReadDecorHandleKey() [3/4]

◆ ReadDecorHandleKey() [4/4]

Member Function Documentation

◆ assign()

◆ clid()

◆ contHandleKey()

◆ empty()

◆ hashedKey()

◆ initialize() [1/2]

◆ initialize() [2/2]

◆ isEventStore()

◆ key()

◆ operator=()

◆ owningHandle()

◆ parseKey()

◆ pythonRepr()

◆ setKey()

◆ setOwningHandle()

◆ start()

◆ storeHandle()

◆ updateHandle()

◆ updateKey()

Member Data Documentation

◆ m_contHandleKey

◆ m_contKey

◆ m_hashedKey

◆ m_isEventStore

◆ m_owningHandle

◆ m_sgKey

◆ m_storeHandle

template<class T>
class SG::ReadDecorHandleKey< T >