A service that caches a pointer to the currently active store. It also implements the IProxyDict store interface. More...

#include <ActiveStoreSvc.h>

Inheritance diagram for ActiveStoreSvc:

Collaboration diagram for ActiveStoreSvc:

Public Member Functions
StoreGateSvc *	activeStore () const
	returns pointer to the active store as StoreGateSvc More...

StoreGateSvc *	operator-> () const
	dereference operator to access the active store More...

void	setStore (StoreGateSvc *s)
	set the active store pointer: used by the event loop mgrs More...

virtual SG::DataProxy *	proxy (const void *const pTransient) const override
	get proxy for a given data object address in memory More...

virtual SG::DataProxy *	proxy (const CLID &id, const std::string &key) const override
	get proxy with given id and key. Returns 0 to flag failure More...

virtual SG::DataProxy *	proxy_exact (SG::sgkey_t sgkey) const override
	Get proxy given a hashed key+clid. More...

virtual std::vector< const SG::DataProxy * >	proxies () const override
	return the list of all current proxies in store More...

StatusCode	addToStore (CLID id, SG::DataProxy *proxy) override
	Raw addition of a proxy to the store. More...

virtual SG::DataProxy *	recordObject (SG::DataObjectSharedPtr< DataObject > obj, const std::string &key, bool allowMods, bool returnExisting) override
	Record an object in the store. More...

virtual sgkey_t	stringToKey (const std::string &str, CLID clid) override
	Find the key for a string/CLID pair. More...

virtual const std::string *	keyToString (sgkey_t key) const override
	Find the string corresponding to a given key. More...

virtual const std::string *	keyToString (sgkey_t key, CLID &clid) const override
	Find the string and CLID corresponding to a given key. More...

virtual void	registerKey (sgkey_t key, const std::string &str, CLID clid) override
	Remember an additional mapping from key to string/CLID. More...

virtual StatusCode	initialize () override
	Service initialization. More...

virtual SG::DataProxy *	proxy (const CLID &id, const std::string &key) const=0
	TEMPORARY: avoid warnings. More...

virtual SG::DataProxy *	proxy (const void *const pTransient) const=0
	TEMPORARY: avoid warnings. More...

Private Member Functions
StoreGateSvc *	activeStoreOOL () const

Private Attributes
Gaudi::Property< std::string >	m_storeName {this, "StoreName", StoreID::storeName(StoreID::EVENT_STORE), "StoreGate instance name"}

Detailed Description

A service that caches a pointer to the currently active store. It also implements the IProxyDict store interface.

In most jobs the active store is simply the default event store (named "StoreGateSvc"). When doing pile-up (and perhaps later on in multi-threaded jobs, the active store changes during the event loop execution. It is important, for example, that converters always refer to the active store rather than to the default one.

Author: ATLAS Collaboration

Definition at line 29 of file ActiveStoreSvc.h.

Member Function Documentation

◆ activeStore()

StoreGateSvc* ActiveStoreSvc::activeStore ( ) const

inline

returns pointer to the active store as StoreGateSvc

Definition at line 36 of file ActiveStoreSvc.h.

                                            {
     // Can't just `return StoreGateSvc::currentStoreGate()` due to
     // a circular dependency
     return activeStoreOOL();
   }

◆ activeStoreOOL()

StoreGateSvc * ActiveStoreSvc::activeStoreOOL ( ) const

private

Definition at line 154 of file ActiveStoreSvc.cxx.

 {
   return StoreGateSvc::currentStoreGate();
 }

◆ addToStore()

StatusCode ActiveStoreSvc::addToStore	(	CLID	id,
		SG::DataProxy *	proxy
	)

override

Raw addition of a proxy to the store.

Definition at line 60 of file ActiveStoreSvc.cxx.

 {
   return activeStore()->addToStore (id, proxy);
 }

◆ initialize()

StatusCode ActiveStoreSvc::initialize ( )

overridevirtual

Service initialization.

Definition at line 17 of file ActiveStoreSvc.cxx.

                                          {
  
   CHECK( Service::initialize() );
  
   msg() << MSG::VERBOSE << "Initializing " << name() << endmsg;
  
   SmartIF<StoreGateSvc> storeGate{service(m_storeName, /*createIf*/true)};
   CHECK( storeGate.isValid() );
   storeGate->makeCurrent();
  
   return StatusCode::SUCCESS;
 }

◆ keyToString() [1/2]

virtual const std::string* ActiveStoreSvc::keyToString ( sgkey_t key ) const

overridevirtual

Find the string corresponding to a given key.

Parameters

key	The key to look up.

Returns: Pointer to the string found, or null. We can find keys as long as the corresponding string was given to either stringToKey() or registerKey().

◆ keyToString() [2/2]

virtual const std::string* ActiveStoreSvc::keyToString	(	sgkey_t	key,
		CLID &	clid
	)		const

overridevirtual

Find the string and CLID corresponding to a given key.

Parameters

key	The key to look up.
clid[out]	The found CLID.

Returns: Pointer to the string found, or null. We can find keys as long as the corresponding string was given to either stringToKey() or registerKey().

◆ operator->()

StoreGateSvc* ActiveStoreSvc::operator-> ( ) const

inline

dereference operator to access the active store

Definition at line 43 of file ActiveStoreSvc.h.

                                           {
     return activeStore();
   }

◆ proxies()

std::vector< const SG::DataProxy * > ActiveStoreSvc::proxies ( ) const

overridevirtual

return the list of all current proxies in store

Definition at line 54 of file ActiveStoreSvc.cxx.

                               {
   return activeStore()->proxies();
 }

◆ proxy() [1/4]

DataProxy * ActiveStoreSvc::proxy	(	const CLID &	id,
		const std::string &	key
	)		const

overridevirtual

get proxy with given id and key. Returns 0 to flag failure

Definition at line 43 of file ActiveStoreSvc.cxx.

                                                                 { 
   return activeStore()->proxy(id,key);
 }

◆ proxy() [2/4]

virtual SG::DataProxy* IProxyDict::proxy

TEMPORARY: avoid warnings.

◆ proxy() [3/4]

DataProxy * ActiveStoreSvc::proxy ( const void *const pTransient ) const

overridevirtual

get proxy for a given data object address in memory

Definition at line 37 of file ActiveStoreSvc.cxx.

                                                         {
   return activeStore()->proxy(pTransient);
 }

◆ proxy() [4/4]

virtual SG::DataProxy* IProxyDict::proxy

TEMPORARY: avoid warnings.

◆ proxy_exact()

SG::DataProxy * ActiveStoreSvc::proxy_exact ( SG::sgkey_t sgkey ) const

overridevirtual

Get proxy given a hashed key+clid.

Find an exact match; no handling of aliases, etc. Returns 0 to flag failure.

Definition at line 47 of file ActiveStoreSvc.cxx.

 {
   return activeStore()->proxy_exact (sgkey);
 }

◆ recordObject()

SG::DataProxy * ActiveStoreSvc::recordObject	(	SG::DataObjectSharedPtr< DataObject >	obj,
		const std::string &	key,
		bool	allowMods,
		bool	returnExisting
	)

overridevirtual

Record an object in the store.

Parameters

obj	The data object to store.
key	The key as which it should be stored.
allowMods	If false, the object will be recorded as const.
returnExisting	If true, return proxy if this key already exists.

Full-blown record. obj should usually be something deriving from SG::DataBucket.

Returns the proxy for the recorded object; nullptr on failure. If the requested CLID/key combination already exists in the store, the behavior is controlled by returnExisting. If true, then the existing proxy is returned; otherwise, nullptr is returned. In either case, obj is destroyed.

Definition at line 83 of file ActiveStoreSvc.cxx.

 {
   return activeStore()->recordObject (obj, key, allowMods, returnExisting);
 }

◆ registerKey()

void ActiveStoreSvc::registerKey	(	sgkey_t	key,
		const std::string &	str,
		CLID	clid
	)

overridevirtual

Remember an additional mapping from key to string/CLID.

Parameters

key	The key to enter.
str	The string to enter.
clid	The CLID associated with the string.

Returns: True if successful; false if the key already corresponds to a different string.

This registers an additional mapping from a key to a string; it can be found later through lookup() on the string. Logs an error if key already corresponds to a different string.

Definition at line 146 of file ActiveStoreSvc.cxx.

 {
   return activeStore()->registerKey (key, str, clid);
 }

◆ setStore()

void ActiveStoreSvc::setStore ( StoreGateSvc * s )

set the active store pointer: used by the event loop mgrs

Definition at line 31 of file ActiveStoreSvc.cxx.

                                              {
   s->makeCurrent();
 }

◆ stringToKey()

sgkey_t ActiveStoreSvc::stringToKey	(	const std::string &	str,
		CLID	clid
	)

overridevirtual

Find the key for a string/CLID pair.

Parameters

str	The string to look up.
clid	The CLID associated with the string.

Returns: A key identifying the string. A given string will always return the same key. Will abort in case of a hash collision!

Definition at line 100 of file ActiveStoreSvc.cxx.

 {
   return activeStore()->stringToKey (str, clid);
 }

Member Data Documentation

◆ m_storeName

Gaudi::Property<std::string> ActiveStoreSvc::m_storeName {this, "StoreName", StoreID::storeName(StoreID::EVENT_STORE), "StoreGate instance name"}

private

Definition at line 149 of file ActiveStoreSvc.h.

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

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ activeStore()

◆ activeStoreOOL()

◆ addToStore()

◆ initialize()

◆ keyToString() [1/2]

◆ keyToString() [2/2]

◆ operator->()

◆ proxies()

◆ proxy() [1/4]

◆ proxy() [2/4]

◆ proxy() [3/4]

◆ proxy() [4/4]

◆ proxy_exact()

◆ recordObject()

◆ registerKey()

◆ setStore()

◆ stringToKey()

Member Data Documentation

◆ m_storeName