DataSvc Class Reference

Data service base class. More...

#include <GaudiKernel/DataSvc.h>

Inheritance diagram for DataSvc:

Collaboration diagram for DataSvc:

Public Member Functions
CLID	rootCLID () const override
	IDataManagerSvc: Accessor for root event CLID.
const std::string &	rootName () const override
	IDataManagerSvc: Accessor for root event name.
StatusCode	registerAddress (std::string_view fullPath, IOpaqueAddress *pAddress) override
	IDataManagerSvc: Register object address with the data store.
StatusCode	registerAddress (IRegistry *parentObj, std::string_view objectPath, IOpaqueAddress *pAddress) override
	IDataManagerSvc: Register object address with the data store.
StatusCode	unregisterAddress (std::string_view fullPath) override
	IDataManagerSvc: Unregister object address from the data store.
StatusCode	unregisterAddress (IRegistry *pParent, std::string_view objPath) override
	IDataManagerSvc: Unregister object address from the data store.
StatusCode	objectLeaves (const DataObject *pObject, std::vector< IRegistry * > &refLeaves) override
	IDataManagerSvc: Explore the object store: retrieve all leaves attached to the object.
StatusCode	objectLeaves (const IRegistry *pRegistry, std::vector< IRegistry * > &refLeaves) override
	IDataManagerSvc: Explore the object store: retrieve all leaves attached to the object.
StatusCode	objectParent (const DataObject *pObject, IRegistry *&refpParent) override
	IDataManagerSvc: Explore the object store: retrieve the object's parent.
StatusCode	objectParent (const IRegistry *pRegistry, IRegistry *&refpParent) override
	IDataManagerSvc: Explore the object store: retrieve the object's parent.
StatusCode	clearSubTree (std::string_view sub_tree_path) override
	IDataManagerSvc: Remove all data objects below the sub tree identified by its full path name.
StatusCode	clearSubTree (DataObject *pObject) override
	IDataManagerSvc: Remove all data objects below the sub tree identified by the object.
StatusCode	clearStore () override
	IDataManagerSvc: Remove all data objects in the data store.
StatusCode	traverseSubTree (std::string_view sub_tree_path, IDataStoreAgent *pAgent) override
	IDataManagerSvc: Analyze by traversing all data objects below the sub tree identified by its full path name.
StatusCode	traverseSubTree (DataObject *pObject, IDataStoreAgent *pAgent) override
	IDataManagerSvc: Analyze by traversing all data objects below the sub tree.
StatusCode	traverseTree (IDataStoreAgent *pAgent) override
	IDataManagerSvc: Analyze by traversing all data objects in the data store.
StatusCode	setRoot (std::string root_name, DataObject *pRootObj) override
	Initialize data store for new event by giving new event path and root object.
virtual StatusCode	i_setRoot (std::string root_name, DataObject *pRootObj)
	Initialize data store for new event by giving new event path and root object.
StatusCode	setRoot (std::string root_path, IOpaqueAddress *pRootAddr) override
	Initialize data store for new event by giving new event path and address of root object.
virtual StatusCode	i_setRoot (std::string root_path, IOpaqueAddress *pRootAddr)
	Initialize data store for new event by giving new event path and address of root object.
StatusCode	setDataLoader (IConversionSvc *svc, IDataProviderSvc *dpsvc=nullptr) override
	IDataManagerSvc: IDataManagerSvc: Pass a default data loader to the service and optionally a data provider.
StatusCode	addPreLoadItem (const DataStoreItem &item) override
	Add an item to the preload list.
StatusCode	removePreLoadItem (const DataStoreItem &item) override
	Remove an item from the preload list.
StatusCode	resetPreLoad () override
	Clear the preload list.
virtual StatusCode	preLoad (int depth, int load_depth, DataObject *pObject)
	Execute one level of preloading and recursively load until the final level is reached.
StatusCode	preLoad () override
	load all preload items of the list
StatusCode	registerObject (std::string_view parentPath, std::string_view objPath, DataObject *pObject) override
	Register object with the data store.
StatusCode	registerObject (DataObject *parentObj, std::string_view objPath, DataObject *pObject) override
	Register object with the data store.
StatusCode	unregisterObject (std::string_view fullPath) override
	Unregister object from the data store.
StatusCode	unregisterObject (DataObject *pObject) override
	Unregister object from the data store.
StatusCode	unregisterObject (DataObject *pObject, std::string_view objectPath) override
	Unregister object from the data store.
StatusCode	retrieveObject (IRegistry *pDirectory, std::string_view path, DataObject *&pObject) override
	Retrieve object from data store.
StatusCode	findObject (std::string_view fullPath, DataObject *&pObject) override
	Find object identified by its full path in the data store.
StatusCode	findObject (IRegistry *pDirectory, std::string_view path, DataObject *&pObject) override
	Find object identified by its full path in the data store.
StatusCode	linkObject (IRegistry *from, std::string_view objPath, DataObject *to) override
	Add a link to another object.
StatusCode	linkObject (std::string_view fullPath, DataObject *to) override
	Add a link to another object.
StatusCode	unlinkObject (IRegistry *from, std::string_view objPath) override
	Remove a link to another object.
StatusCode	unlinkObject (DataObject *fromObj, std::string_view objPath) override
	Remove a link to another object.
StatusCode	unlinkObject (std::string_view fullPath) override
	Remove a link to another object.
StatusCode	updateObject (IRegistry *pDirectory) override
	Update object identified by its directory entry.
StatusCode	updateObject (DataObject *toUpdate) override
	Update object.
StatusCode	initialize () override
	Service initialization.
StatusCode	reinitialize () override
	Service initialization.
StatusCode	finalize () override
	Service initialization.
	DataSvc (const DataSvc &)=delete
	copy constructor disabled
DataSvc &	operator= (const DataSvc &)=delete
	Fake assignment operator (never implemented).
StatusCode	registerAddress (DataObject *parentObj, std::string_view objectPath, IOpaqueAddress *pAddress)
	Register object address with the data store.
StatusCode	unregisterAddress (DataObject *pParent, std::string_view objPath)
	Unregister object address from the data store.
StatusCode	registerObject (std::string_view fullPath, DataObject *pObject)
	Register object with the data store.
StatusCode	registerObject (std::string_view parentPath, int item, DataObject *pObject)
	Register object with the data store.
StatusCode	registerObject (DataObject *parentObj, int item, DataObject *pObject)
	Register object with the data store.
StatusCode	retrieveObject (std::string_view fullPath, DataObject *&pObject)
	Retrieve object identified by its full path from the data store.
StatusCode	retrieveObject (std::string_view parentPath, std::string_view objectPath, DataObject *&pObject)
	Retrieve object from data store.
StatusCode	retrieveObject (std::string_view parentPath, int item, DataObject *&pObject)
	Retrieve object from data store.
StatusCode	retrieveObject (DataObject *parentObj, std::string_view objectPath, DataObject *&pObject)
	Retrieve object from data store.
StatusCode	retrieveObject (DataObject *parentObj, int item, DataObject *&pObject)
	Retrieve object from data store.
StatusCode	findObject (std::string_view parentPath, std::string_view objectPath, DataObject *&pObject)
	Find object identified by its parent object and the path to the object relative to the parent.
StatusCode	findObject (std::string_view parentPath, int item, DataObject *&pObject)
	Find object identified by its parent object and an integer identifier in the data store.
StatusCode	findObject (DataObject *parentObj, std::string_view objectPath, DataObject *&pObject)
	Find object identified by its parent object and the path to the object relative to the parent.
StatusCode	findObject (DataObject *parentObj, int item, DataObject *&pObject)
	Find object identified by its parent object and an integer identifier in the data store.
StatusCode	linkObject (std::string_view fromPath, std::string_view objPath, DataObject *toObj)
	Add a link to another object.
StatusCode	linkObject (DataObject *fromObj, std::string_view objPath, DataObject *toObj)
	Add a link to another object.
StatusCode	unlinkObject (std::string_view fromPath, std::string_view objPath)
	Remove a link to another object.
Public Member Functions inherited from extends< Service, IDataProviderSvc, IDataManagerSvc >
void const *	i_cast (const InterfaceID &tid) const override
	Implementation of IInterface::i_cast.
StatusCode	queryInterface (const InterfaceID &ti, void **pp) override
	Implementation of IInterface::queryInterface.
std::vector< std::string >	getInterfaceNames () const override
	Implementation of IInterface::getInterfaceNames.
Public Member Functions inherited from Service
const std::string &	name () const override
	Retrieve name of the service.
StatusCode	configure () override
StatusCode	initialize () override
StatusCode	start () override
StatusCode	stop () override
StatusCode	finalize () override
StatusCode	terminate () override
Gaudi::StateMachine::State	FSMState () const override
Gaudi::StateMachine::State	targetFSMState () const override
StatusCode	reinitialize () override
StatusCode	restart () override
StatusCode	sysInitialize () override
	Initialize Service.
StatusCode	sysStart () override
	Initialize Service.
StatusCode	sysStop () override
	Initialize Service.
StatusCode	sysFinalize () override
	Finalize Service.
StatusCode	sysReinitialize () override
	Re-initialize the Service.
StatusCode	sysRestart () override
	Re-initialize the Service.
	Service (std::string name, ISvcLocator *svcloc)
	Standard Constructor.
SmartIF< ISvcLocator > &	serviceLocator () const override
	Retrieve pointer to service locator.
template<typename IFace = IService>
SmartIF< IFace >	service (const std::string &name, bool createIf=true) const
template<class T>
Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ToolHandle< T > &hndl, const std::string &doc="none")
template<class T>
StatusCode	declareTool (ToolHandle< T > &handle, bool createIf=true)
template<class T>
StatusCode	declareTool (ToolHandle< T > &handle, const std::string &toolTypeAndName, bool createIf=true)
	Declare used tool.
template<class T>
Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ToolHandleArray< T > &hndlArr, const std::string &doc="none")
template<class T>
void	addToolsArray (ToolHandleArray< T > &hndlArr)
const std::vector< IAlgTool * > &	tools () const
SmartIF< IAuditorSvc > &	auditorSvc () const
	The standard auditor service.May not be invoked before sysInitialize() has been invoked.
Public Member Functions inherited from PropertyHolder< CommonMessaging< implements< IService, IProperty, IStateful > > >
StatusCode	setProperty (const Gaudi::Details::PropertyBase &p)
	Set the property from a property.
StatusCode	setProperty (const std::string &name, const char *v)
	Special case for string literals.
StatusCode	setProperty (const std::string &name, const std::string &v)
	Special case for std::string.
StatusCode	setProperty (const std::string &name, const TYPE &value)
	set the property form the value
	PropertyHolder ()=default
Gaudi::Details::PropertyBase &	declareProperty (Gaudi::Details::PropertyBase &prop)
	Declare a property.
Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, TYPE &value, const std::string &doc="none")
	Helper to wrap a regular data member and use it as a regular property.
Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, Gaudi::Property< TYPE, VERIFIER, HANDLERS > &prop, const std::string &doc="none")
	Declare a PropertyBase instance setting name and documentation.
Gaudi::Details::PropertyBase *	declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="")
	Declare a remote property.
StatusCode	setProperty (const std::string &name, const Gaudi::Details::PropertyBase &p) override
	set the property from another property with a different name
StatusCode	setProperty (const std::string &s) override
	set the property from the formatted string
StatusCode	setProperty (const Gaudi::Details::PropertyBase &p)
	Set the property from a property.
StatusCode	setProperty (const std::string &name, const char *v)
	Special case for string literals.
StatusCode	setProperty (const std::string &name, const std::string &v)
	Special case for std::string.
StatusCode	setProperty (const std::string &name, const TYPE &value)
	set the property form the value
StatusCode	setPropertyRepr (const std::string &n, const std::string &r) override
	set the property from name and value string representation
StatusCode	getProperty (Gaudi::Details::PropertyBase *p) const override
	get the property
const Gaudi::Details::PropertyBase &	getProperty (std::string_view name) const override
	get the property by name
StatusCode	getProperty (std::string_view n, std::string &v) const override
	convert the property to the string
const std::vector< Gaudi::Details::PropertyBase * > &	getProperties () const override
	get all properties
bool	hasProperty (std::string_view name) const override
	Return true if we have a property with the given name.
Gaudi::Details::PropertyBase *	property (std::string_view name) const
	\fixme property and bindPropertiesTo should be protected
void	bindPropertiesTo (Gaudi::Interfaces::IOptionsSvc &optsSvc)
	PropertyHolder (const PropertyHolder &)=delete
PropertyHolder &	operator= (const PropertyHolder &)=delete
Public Member Functions inherited from CommonMessaging< implements< IService, IProperty, IStateful > >
MSG::Level	msgLevel () const
	get the cached level (originally extracted from the embedded MsgStream)
bool	msgLevel (MSG::Level lvl) const
	get the output level from the embedded MsgStream
Public Member Functions inherited from CommonMessagingBase
virtual	~CommonMessagingBase ()=default
	Virtual destructor.
const SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service.
MsgStream &	msgStream () const
	Return an uninitialized MsgStream.
MsgStream &	msgStream (const MSG::Level level) const
	Predefined configurable message stream for the efficient printouts.
MsgStream &	always () const
	shortcut for the method msgStream(MSG::ALWAYS)
MsgStream &	fatal () const
	shortcut for the method msgStream(MSG::FATAL)
MsgStream &	err () const
	shortcut for the method msgStream(MSG::ERROR)
MsgStream &	error () const
	shortcut for the method msgStream(MSG::ERROR)
MsgStream &	warning () const
	shortcut for the method msgStream(MSG::WARNING)
MsgStream &	info () const
	shortcut for the method msgStream(MSG::INFO)
MsgStream &	debug () const
	shortcut for the method msgStream(MSG::DEBUG)
MsgStream &	verbose () const
	shortcut for the method msgStream(MSG::VERBOSE)
MsgStream &	msg () const
	shortcut for the method msgStream(MSG::INFO)

Protected Member Functions
bool	checkRoot ()
	Check if root path is valid.
virtual IConversionSvc *	getDataLoader (IRegistry *pReg)
	Retrieve customizable data loader according to registry entry to be retrieved.
virtual DataObject *	createDefaultObject () const
	Create default objects in case forced creation of leaves is requested.
virtual StatusCode	loadObject (IRegistry *pNode)
	Invoke Persistency service to create transient object from its persistent representation.
virtual StatusCode	loadObject (IConversionSvc *pLoader, IRegistry *pNode)
	Invoke Persistency service to create transient object from its persistent representation.
StatusCode	retrieveEntry (DataSvcHelpers::RegistryEntry *pNode, std::string_view path, DataSvcHelpers::RegistryEntry *&pEntry)
	Retrieve registry entry from store.
DataObject *	handleDataFault (IRegistry *pReg, std::string_view path="")
	Invoke data fault handling if enabled.
Protected Member Functions inherited from Service
std::vector< IAlgTool * > &	tools ()
	~Service () override
int	outputLevel () const
	get the Service's output level
Protected Member Functions inherited from CommonMessaging< implements< IService, IProperty, IStateful > >
MSG::Level	setUpMessaging () const
	Set up local caches.
MSG::Level	resetMessaging ()
	Reinitialize internal states.
void	updateMsgStreamOutputLevel (int level)
	Update the output level of the cached MsgStream.

Protected Attributes
SmartIF< IIncidentSvc >	m_incidentSvc = nullptr
	Pointer to incident service.
Gaudi::Property< CLID >	m_rootCLID { this, "RootCLID", 110 , "CLID of root entry" }
Gaudi::Property< std::string >	m_rootName { this, "RootName", "/Event", "name of root entry" }
std::unique_ptr< DataSvcHelpers::RegistryEntry >	m_root
	Pointer to root entry.
Protected Attributes inherited from Service
Gaudi::StateMachine::State	m_state = Gaudi::StateMachine::OFFLINE
	Service state.
Gaudi::StateMachine::State	m_targetState = Gaudi::StateMachine::OFFLINE
	Service state.
Gaudi::Property< int >	m_outputLevel { this, "OutputLevel", MSG::NIL, "output level" }
	flag indicating whether ToolHandle tools have been added to m_tools
Gaudi::Property< bool >	m_auditorInitialize { this, "AuditInitialize", false, "trigger auditor on initialize()" }
Gaudi::Property< bool >	m_auditorStart { this, "AuditStart", false, "trigger auditor on start()" }
Gaudi::Property< bool >	m_auditorStop { this, "AuditStop", false, "trigger auditor on stop()" }
Gaudi::Property< bool >	m_auditorFinalize { this, "AuditFinalize", false, "trigger auditor on finalize()" }
Gaudi::Property< bool >	m_auditorReinitialize { this, "AuditReinitialize", false, "trigger auditor on reinitialize()" }
Gaudi::Property< bool >	m_auditorRestart { this, "AuditRestart", false, "trigger auditor on restart()" }
Gaudi::Property< bool >	m_autoRetrieveTools
Gaudi::Property< bool >	m_checkToolDeps
SmartIF< IAuditorSvc >	m_pAuditorSvc
	Auditor Service.

Private Member Functions
StatusCode	i_retrieveEntry (DataSvcHelpers::RegistryEntry *parentObj, std::string_view path, DataSvcHelpers::RegistryEntry *&pEntry)
DataObject *	i_handleDataFault (IRegistry *pReg, std::string_view path=std::string_view{})

Private Attributes
SmartIF< IConversionSvc >	m_dataLoader = nullptr
	Pointer to data loader service.
Gaudi::Property< bool >	m_forceLeaves
Gaudi::Property< std::vector< std::string > >	m_inhibitPathes { this, "InhibitPaths", {}, "inhibited leaves" }
Gaudi::Property< bool >	m_enableFaultHdlr
Gaudi::Property< std::string >	m_faultName { this, "DataFaultName", "DataFault", "Name of the data fault incident" }
Gaudi::Property< bool >	m_enableAccessHdlr
Gaudi::Property< std::string >	m_accessName { this, "DataAccessName", "DataAccess", "Name of the data access incident" }
std::vector< DataStoreItem >	m_preLoads
	Items to be pre-loaded.

Additional Inherited Members
Public Types inherited from extends< Service, IDataProviderSvc, IDataManagerSvc >
using	base_class
	Typedef to this class.
using	extend_interfaces_base
	Typedef to the base of this class.
Public Types inherited from Service
using	Factory = Gaudi::PluginService::Factory<IService*( const std::string&, ISvcLocator* )>
Public Types inherited from PropertyHolder< CommonMessaging< implements< IService, IProperty, IStateful > > >
using	PropertyHolderImpl
	Typedef used to refer to this class from derived classes, as in.
Public Types inherited from CommonMessaging< implements< IService, IProperty, IStateful > >
using	base_class
Public Types inherited from extend_interfaces< Interfaces... >
using	ext_iids
	take union of the ext_iids of all Interfaces...

Detailed Description

Data service base class.

A data service manages the transient data stores and implements the IDataProviderSvc and IDataManagerSvc interfaces.

Author

Markus Frank

Sebastien Ponce

Version

1.0

Definition at line 43 of file DataSvc.h.

Constructor & Destructor Documentation

DataSvc()

DataSvc::DataSvc ( const DataSvc & )

delete

copy constructor disabled

Member Function Documentation

addPreLoadItem()

StatusCode DataSvc::addPreLoadItem ( const DataStoreItem & item )

override

Add an item to the preload list.

Definition at line 749 of file DataSvc.cpp.

                                                              {
  auto i = std::find( begin( m_preLoads ), end( m_preLoads ), item );
  if ( i == end( m_preLoads ) ) m_preLoads.push_back( item );
  return StatusCode::SUCCESS;
}

checkRoot()

bool DataSvc::checkRoot ( )

inlineprotected

Check if root path is valid.

Definition at line 255 of file DataSvc.h.

{ return 0 != m_root; }

clearStore()

StatusCode DataSvc::clearStore ( )

override

IDataManagerSvc: Remove all data objects in the data store.

Definition at line 85 of file DataSvc.cpp.

                               {
  if ( checkRoot() ) m_root.reset();
  return StatusCode::SUCCESS;
}

clearSubTree() [1/2]

StatusCode DataSvc::clearSubTree ( DataObject * pObject )

override

IDataManagerSvc: Remove all data objects below the sub tree identified by the object.

Definition at line 74 of file DataSvc.cpp.

                                                      {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  RegEntry* entry = CAST_REGENTRY( RegEntry*, pObject->registry() );
  if ( !entry ) return Status::INVALID_OBJECT;
  RegEntry* parent = entry->parentEntry();
  if ( !parent ) return Status::INVALID_PARENT;
  parent->remove( entry );
  return StatusCode::SUCCESS;
}

clearSubTree() [2/2]

StatusCode DataSvc::clearSubTree ( std::string_view sub_tree_path )

override

IDataManagerSvc: Remove all data objects below the sub tree identified by its full path name.

Definition at line 59 of file DataSvc.cpp.

                                                               {
  DataObject* pObject = nullptr;
  StatusCode  status  = findObject( sub_tree_path, pObject );
  if ( !status.isSuccess() ) return status;
  RegEntry* node_entry = CAST_REGENTRY( RegEntry*, pObject->registry() );
  if ( !node_entry ) return Status::INVALID_OBJECT;
  RegEntry* parent = node_entry->parentEntry();
  if ( !parent ) return Status::INVALID_PARENT;
  parent->remove( node_entry );
  return StatusCode::SUCCESS;
}

createDefaultObject()

DataObject * DataSvc::createDefaultObject ( ) const

protectedvirtual

Create default objects in case forced creation of leaves is requested.

Definition at line 844 of file DataSvc.cpp.

{ return new DataObject(); }

finalize()

StatusCode DataSvc::finalize ( )

override

Service initialization.

Service initialisation.

Definition at line 828 of file DataSvc.cpp.

                             {
  // Nothing to do: just call base class initialisation
  setDataLoader( nullptr ).ignore();
  resetPreLoad().ignore();
  clearStore().ignore();
  m_incidentSvc.reset();
  return Service::finalize();
}

findObject() [1/6]

StatusCode IDataProviderSvc::findObject ( DataObject * parentObj, int item, DataObject *& pObject )

inline

Find object identified by its parent object and an integer identifier in the data store.

In case the object is not present the pointer will be set to NULL.

Parameters

parentObj	Pointer to parent node of the object.
item	Item identifier.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 368 of file IDataProviderSvc.h.

                                                                                 {
    return findObject( parentObj, itemToPath( item ), pObject );
  }

findObject() [2/6]

StatusCode IDataProviderSvc::findObject ( DataObject * parentObj, std::string_view objectPath, DataObject *& pObject )

inline

Find object identified by its parent object and the path to the object relative to the parent.

The result will be returned in the second argument. In case the object is not present the pointer will be set to NULL.

Parameters

parentObj	Pointer to parent node of the object.
objectPath	Relative path name of the object.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 356 of file IDataProviderSvc.h.

                                                                                                  {
    return findObject( parentObj ? parentObj->registry() : nullptr, objectPath, pObject );
  }

findObject() [3/6]

StatusCode DataSvc::findObject ( IRegistry * pDirectory, std::string_view path, DataObject *& pObject )

override

Find object identified by its full path in the data store.

Retrieve object identified by its directory from the data store.

Definition at line 610 of file DataSvc.cpp.

                                                                                                {
  pObject               = nullptr;
  IRegistry* pReg       = ( pRegistry ? pRegistry : m_root.get() );
  RegEntry*  root_entry = CAST_REGENTRY( RegEntry*, pReg );
  if ( root_entry ) {
    if ( !path.empty() ) pReg = root_entry->find( path );
    if ( !pReg ) return Status::INVALID_OBJ_PATH;
    pObject = pReg->object();
  }
  return ( !pObject ) ? Status::OBJ_NOT_LOADED : Status::IDataProviderSvc_NO_ERROR;
}

findObject() [4/6]

StatusCode DataSvc::findObject ( std::string_view fullPath, DataObject *& pObject )

override

Find object identified by its full path in the data store.

Definition at line 623 of file DataSvc.cpp.

                                                                          {
  pObject = nullptr;
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  if ( path.empty() || path == m_rootName.value() ) {
    pObject = m_root->object();
    return !pObject ? Status::OBJ_NOT_LOADED : Status::IDataProviderSvc_NO_ERROR;
  }
  return findObject( path.front() != SEPARATOR ? m_root.get() : nullptr, path, pObject );
}

findObject() [5/6]

StatusCode IDataProviderSvc::findObject ( std::string_view parentPath, int item, DataObject *& pObject )

inline

Find object identified by its parent object and an integer identifier in the data store.

In case the object is not present the pointer will be set to NULL.

Parameters

parentPath	Path to parent node of the object.
item	Item identifier.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 343 of file IDataProviderSvc.h.

                                                                                     {
    return findObject( parentPath, itemToPath( item ), pObject );
  }

findObject() [6/6]

StatusCode IDataProviderSvc::findObject ( std::string_view parentPath, std::string_view objectPath, DataObject *& pObject )

inline

Find object identified by its parent object and the path to the object relative to the parent.

The result will be returned in the second argument. In case the object is not present the pointer will be set to NULL.

Parameters

parentPath	Path to parent node of the object.
objectPath	Relative path name of the object.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 329 of file IDataProviderSvc.h.

                                                                                                      {
    DataObject* parent = nullptr;
    StatusCode  status = findObject( parentPath, parent );
    return status.isSuccess() ? findObject( parent, objectPath, pObject ) : status;
  }

getDataLoader()

IConversionSvc * DataSvc::getDataLoader ( IRegistry * pReg )

protectedvirtual

Retrieve customizable data loader according to registry entry to be retrieved.

Reimplemented in NTupleSvc.

Definition at line 849 of file DataSvc.cpp.

{ return m_dataLoader.get(); }

handleDataFault()

DataObject * DataSvc::handleDataFault ( IRegistry * pReg, std::string_view path = "" )

protected

Invoke data fault handling if enabled.

Parameters

pReg	[IN] Pointer to missing registry entry
path	[IN] Sub-path of requested object from pReg

Returns

Object corresponding to the specified leaf

Definition at line 408 of file DataSvc.cpp.

                                                                           {
  return i_handleDataFault( pReg, path );
}

i_handleDataFault()

DataObject * DataSvc::i_handleDataFault ( IRegistry * pReg, std::string_view path = std::string_view{} )

private

Definition at line 412 of file DataSvc.cpp.

                                                                             {
  if ( m_enableFaultHdlr ) {
    IRegistry* pLeaf = nullptr;
    if ( pReg && path.empty() ) {
      DataIncident incident( name(), m_faultName, pReg->identifier() );
      m_incidentSvc->fireIncident( incident );
      return pReg->object();
    }
    if ( pReg ) {
      std::string p = pReg->identifier();
      if ( path.front() != SEPARATOR ) p += SEPARATOR;
      p.append( path.data(), path.size() );
      DataIncident incident( name(), m_faultName, p );
      m_incidentSvc->fireIncident( incident );
      pLeaf = m_root->findLeaf( p );
    } else {
      std::string p = m_root->identifier();
      if ( path.front() != SEPARATOR ) p += SEPARATOR;
      p.append( path.data(), path.size() );
      DataIncident incident( name(), m_faultName, p );
      m_incidentSvc->fireIncident( incident );
      pLeaf = m_root->findLeaf( p );
    }
    if ( pLeaf ) { return pLeaf->object(); }
  }
  return nullptr;
}

i_retrieveEntry()

StatusCode DataSvc::i_retrieveEntry ( DataSvcHelpers::RegistryEntry * parentObj, std::string_view path, DataSvcHelpers::RegistryEntry *& pEntry )

private

Definition at line 515 of file DataSvc.cpp.

                                                                                                 {
  // A.Valassi 16.08.2001 avoid core dump if store is empty
  if ( !checkRoot() ) return Status::INVALID_ROOT;
 
  static constexpr auto empty = std::string_view{};
  auto                  sep   = find( path, SEPARATOR, 1 );
  pEntry                      = nullptr;
 
  if ( !parentObj ) {
    if ( path.empty() || path == m_rootName.value() ) {
      parentObj = m_root.get();
      path      = empty;
    } else if ( path.front() != SEPARATOR ) {
      parentObj = m_root.get();
    } else if ( sep != std::string_view::npos ) {
      if ( !m_root->object() ) {
        RegEntry* r      = nullptr;
        auto      status = i_retrieveEntry( m_root.get(), empty, r );
        if ( !status.isSuccess() ) return status;
      }
      parentObj = m_root.get();
      path      = path.substr( sep );
    } else {
      return Status::INVALID_OBJ_PATH;
    }
    sep = find( path, SEPARATOR, 1 );
  }
 
  StatusCode status{ Status::INVALID_ROOT };
  if ( sep != std::string_view::npos ) { // the string contains a separator (after pos 0)
    if ( !parentObj->object() ) {        // if the parent object has not been loaded yet, load it now
      status = loadObject( parentObj );
      if ( !status.isSuccess() ) return status;
    }
    auto      p_path     = path.substr( 0, sep );
    RegEntry* root_entry = parentObj->findLeaf( p_path );
    if ( !root_entry && m_enableFaultHdlr ) {
      // If not even the parent is there, an incident
      // to load the parent must be fired...
      i_handleDataFault( parentObj, p_path );
      root_entry = parentObj->findLeaf( p_path );
    }
    if ( root_entry ) {
      DataObject* pO = root_entry->object();
      if ( !pO ) {
        // Object is not loaded: load the object if at all possible
        status = loadObject( root_entry );
        if ( !status.isSuccess() ) return status;
      }
      if ( root_entry->isSoft() ) { root_entry = CAST_REGENTRY( RegEntry*, pO->registry() ); }
      return i_retrieveEntry( root_entry, path.substr( sep ), pEntry );
    }
    return Status::INVALID_OBJ_PATH;
  } else if ( path.empty() ) {
    pEntry = parentObj;
  } else {
    if ( !parentObj->object() ) { // if the parent object has not been loaded yet, load it now
      status = loadObject( parentObj );
      if ( !status.isSuccess() ) return status;
    }
    // last leave in search: find leaf and load
    pEntry = parentObj->findLeaf( path );
    // If no registry entry was found, trigger incident for action-on-demand
    if ( !pEntry && m_enableFaultHdlr ) {
      i_handleDataFault( parentObj, path );
      pEntry = ( path.empty() ? parentObj : parentObj->findLeaf( path ) );
    }
  }
 
  // Check results and return
  if ( !pEntry ) return Status::INVALID_OBJ_PATH;
  if ( !pEntry->object() ) return loadObject( pEntry );
 
  if ( m_enableAccessHdlr ) {
    // Fire data access incident
    // I do not know if this is a good idea....
    // This fires too often!
    //
    // DataIncident incident(name(), m_accessName, pEntry->identifier());
    // m_incidentSvc->fireIncident(incident);
    return StatusCode::SUCCESS;
  }
  return StatusCode::SUCCESS;
}

i_setRoot() [1/2]

StatusCode DataSvc::i_setRoot ( std::string root_path, DataObject * pRootObj )

virtual

Initialize data store for new event by giving new event path and root object.

Does not clear the store before reinitializing it. This could lead to errors and should be handle with care. Use setRoot if unsure

Definition at line 125 of file DataSvc.cpp.

                                                                         {
  if ( pRootObj ) {
    m_root = std::make_unique<RegEntry>( std::move( root_path ) );
    m_root->makeHard( pRootObj );
    m_root->setDataSvc( this );
    // No done with GaudiHive. preLoad().ignore();
  }
  return StatusCode::SUCCESS;
}

i_setRoot() [2/2]

StatusCode DataSvc::i_setRoot ( std::string root_path, IOpaqueAddress * pRootAddr )

virtual

Initialize data store for new event by giving new event path and address of root object.

Does not clear the store before reinitializing it. This could lead to errors and should be handle with care. Use setRoot if unsure

Definition at line 149 of file DataSvc.cpp.

                                                                              {
  if ( pRootAddr ) {
    m_root = std::make_unique<RegEntry>( std::move( root_path ) );
    m_root->makeHard( pRootAddr );
    m_root->setDataSvc( this );
    // Not done with GaudiHive. preLoad().ignore();
  }
  return StatusCode::SUCCESS;
}

initialize()

StatusCode DataSvc::initialize ( )

override

Service initialization.

Definition at line 795 of file DataSvc.cpp.

                               {
  // Nothing to do: just call base class initialisation
  StatusCode sc = Service::initialize();
  if ( !sc.isSuccess() ) return sc;
  m_incidentSvc = service( "IncidentSvc", true );
  if ( !m_incidentSvc ) { error() << "Failed to access incident service." << endmsg; }
  return sc;
}

linkObject() [1/4]

StatusCode IDataProviderSvc::linkObject ( DataObject * fromObj, std::string_view objPath, DataObject * toObj )

inline

Add a link to another object.

Both objects must already be registered with the data store. Once linked, the object can only be unregistered after unlinking.

Parameters

fromObj	Pointer to the object the link originates.
objPath	Path of the entry to be linked relative to from.
toObj	Pointer to the object the link points to.

Returns

Status code indicating success or failure.

Definition at line 498 of file IDataProviderSvc.h.

                                                                                                               {
  if ( fromObj ) {
    IRegistry* from_entry = fromObj->registry();
    if ( from_entry ) return linkObject( from_entry, objPath, toObj );
  }
  return Status::INVALID_PARENT;
}

linkObject() [2/4]

StatusCode DataSvc::linkObject ( IRegistry * from, std::string_view objPath, DataObject * to )

override

Add a link to another object.

Definition at line 683 of file DataSvc.cpp.

                                                                                        {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  try {
    RegEntry* from_entry = CAST_REGENTRY( RegEntry*, from );
    if ( from_entry ) {
      // First check if both objects are already registered to the store
      RegEntry* to_entry = m_root->findLeaf( to );
      if ( !to_entry ) return Status::INVALID_OBJECT;
      auto sep = objPath.rfind( SEPARATOR );
      if ( sep > 0 && sep != std::string_view::npos ) { // in case the objPath is a sub-directory itself
        DataObject* pO = nullptr;
        StatusCode  sc = retrieveObject( from, objPath.substr( 0, sep ), pO );
        return sc.isSuccess() ? linkObject( pO->registry(), objPath.substr( sep ), to ) : sc;
      }
      // Now register the soft link
      StatusCode status = from_entry->add( to_string( objPath ), to, true );
      return status.isSuccess() ? Status::IDataProviderSvc_NO_ERROR : Status::DOUBL_OBJ_PATH;
    }
  } catch ( ... ) {}
  return Status::INVALID_PARENT;
}

linkObject() [3/4]

StatusCode IDataProviderSvc::linkObject ( std::string_view fromPath, std::string_view objPath, DataObject * toObj )

inline

Add a link to another object.

Both objects must already be registered with the data store. Once linked, the object can only be unregistered after unlinking.

Parameters

fromPath	Path to the object the link originates.
objPath	Path of the entry to be linked relative to from.
toObj	Pointer to the object the link points to.

Returns

Status code indicating success or failure.

Definition at line 484 of file IDataProviderSvc.h.

                                                                                              {
    DataObject* pO     = nullptr;
    StatusCode  status = retrieveObject( fromPath, pO );
    return status.isSuccess() ? linkObject( pO->registry(), objPath, toObj ) : status;
  }

linkObject() [4/4]

StatusCode DataSvc::linkObject ( std::string_view fullPath, DataObject * to )

override

Add a link to another object.

Definition at line 706 of file DataSvc.cpp.

                                                                        {
  if ( fullPath.empty() ) return Status::INVALID_OBJ_PATH;
  if ( fullPath.front() != SEPARATOR ) { return linkObject( m_rootName.value(), fullPath, to ); }
  auto sep = fullPath.rfind( SEPARATOR );
  return linkObject( fullPath.substr( 0, sep ), fullPath.substr( sep ), to );
}

loadObject() [1/2]

StatusCode DataSvc::loadObject ( IConversionSvc * pLoader, IRegistry * pNode )

protectedvirtual

Invoke Persistency service to create transient object from its persistent representation.

Definition at line 451 of file DataSvc.cpp.

                                                                              {
  StatusCode  status  = Status::INVALID_OBJ_ADDR;
  DataObject* pObject = nullptr;
  if ( !pLoader ) { // Precondition: Data loader must be present
    return handleDataFault( pRegistry ) ? StatusCode::SUCCESS : StatusCode( Status::NO_DATA_LOADER );
  }
  if ( !pRegistry ) { // Precondition: Directory must be valid
    return handleDataFault( pRegistry ) ? StatusCode::SUCCESS : StatusCode( Status::INVALID_OBJ_ADDR );
  }
 
  VERMSG << "Requested object " << pRegistry->identifier() << endmsg;
 
  if ( m_enableAccessHdlr ) {
    // Fire data access incident
    DataIncident incident( name(), m_accessName, pRegistry->identifier() );
    m_incidentSvc->fireIncident( incident );
  }
  if ( !m_inhibitPathes.empty() ) {
    auto inhibit = std::find( m_inhibitPathes.begin(), m_inhibitPathes.end(), pRegistry->identifier() );
    if ( inhibit != m_inhibitPathes.end() ) { return Status::NO_ACCESS; }
  }
  IOpaqueAddress* pAddress = pRegistry->address();
  if ( !pAddress ) {                 // Precondition:
    return Status::INVALID_OBJ_ADDR; // Address must be valid
  }
  try {
    status = pLoader->createObj( pAddress, pObject ); // Call data loader
    if ( status.isSuccess() ) {
 
      VERMSG << "Object " << pRegistry->identifier() << " created" << endmsg;
 
      RegEntry* pEntry = CAST_REGENTRY( RegEntry*, pRegistry );
      pEntry->setObject( pObject );
 
      VERMSG << "Filling object " << pRegistry->identifier() << endmsg;
      status = pLoader->fillObjRefs( pAddress, pObject );
    }
  } catch ( const GaudiException& exc ) {
    if ( handleDataFault( pRegistry ) ) { return StatusCode::SUCCESS; }
    throw GaudiException( "GaudiException in loadObject() " + pRegistry->identifier(), name(), StatusCode::FAILURE,
                          exc );
  } catch ( const std::exception& x ) {
    if ( handleDataFault( pRegistry ) ) { return StatusCode::SUCCESS; }
    throw GaudiException( "std::exception in loadObject() " + pRegistry->identifier() + ": " +
                              System::typeinfoName( typeid( x ) ) + ", " + x.what(),
                          name(), StatusCode::FAILURE );
  } catch ( ... ) {
    if ( handleDataFault( pRegistry ) ) { return StatusCode::SUCCESS; }
    throw GaudiException( "UNKN exception in loadObject() " + pRegistry->identifier(), name(), StatusCode::FAILURE );
  }
  if ( !status.isSuccess() ) {
    if ( handleDataFault( pRegistry ) ) { return StatusCode::SUCCESS; }
  }
  ON_VERBOSE if ( status.isSuccess() ) {
    verbose() << "Object " << pRegistry->identifier() << " successfully loaded" << endmsg;
  }
  return status;
}

loadObject() [2/2]

StatusCode DataSvc::loadObject ( IRegistry * pNode )

protectedvirtual

Invoke Persistency service to create transient object from its persistent representation.

Definition at line 443 of file DataSvc.cpp.

                                                     {
  IConversionSvc* pLoader = getDataLoader( pRegistry );
  return loadObject( pLoader, pRegistry );
}

objectLeaves() [1/2]

StatusCode DataSvc::objectLeaves ( const DataObject * pObject, std::vector< IRegistry * > & refLeaves )

override

IDataManagerSvc: Explore the object store: retrieve all leaves attached to the object.

IDataManagerSvc: Explore an object identified by its pointer.

Definition at line 181 of file DataSvc.cpp.

                                                                                           {
  if ( !pObject ) return Status::INVALID_OBJECT;
  return objectLeaves( pObject->registry(), leaves );
}

objectLeaves() [2/2]

StatusCode DataSvc::objectLeaves ( const IRegistry * pRegistry, std::vector< IRegistry * > & refLeaves )

override

IDataManagerSvc: Explore the object store: retrieve all leaves attached to the object.

IDataManagerSvc: Explore an object identified by the pointer to the registry entry.

Definition at line 189 of file DataSvc.cpp.

                                                                                            {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  const RegEntry* node_entry = CAST_REGENTRY( const RegEntry*, pRegistry );
  if ( !node_entry ) return Status::INVALID_OBJECT;
  leaves = node_entry->leaves();
  return StatusCode::SUCCESS;
}

objectParent() [1/2]

StatusCode DataSvc::objectParent ( const DataObject * pObject, IRegistry *& refpParent )

override

IDataManagerSvc: Explore the object store: retrieve the object's parent.

Definition at line 167 of file DataSvc.cpp.

                                                                                    {
  if ( !pObject ) return Status::INVALID_OBJECT;
  return objectParent( pObject->registry(), refpParent );
}

objectParent() [2/2]

StatusCode DataSvc::objectParent ( const IRegistry * pRegistry, IRegistry *& refpParent )

override

IDataManagerSvc: Explore the object store: retrieve the object's parent.

Definition at line 172 of file DataSvc.cpp.

                                                                                     {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  const RegEntry* node_entry = CAST_REGENTRY( const RegEntry*, pRegistry );
  if ( !node_entry ) return Status::INVALID_OBJECT;
  refpParent = node_entry->parent();
  return StatusCode::SUCCESS;
}

operator=()

DataSvc & DataSvc::operator= ( const DataSvc & )

delete

Fake assignment operator (never implemented).

preLoad() [1/2]

StatusCode DataSvc::preLoad ( )

override

load all preload items of the list

Definition at line 784 of file DataSvc.cpp.

                            {
  DataObject* pObj = nullptr;
  for ( const auto& i : m_preLoads ) {
    StatusCode sc         = retrieveObject( i.path(), pObj );
    int        load_depth = i.depth();
    if ( sc.isSuccess() && load_depth > 1 ) { preLoad( 1, load_depth, pObj ).ignore(); }
  }
  return StatusCode::SUCCESS;
}

preLoad() [2/2]

StatusCode DataSvc::preLoad ( int depth, int load_depth, DataObject * pObject )

virtual

Execute one level of preloading and recursively load until the final level is reached.

Preload one level deep, then recursively call the next level.

Parameters

depth	current level of loading from requested parent
load_depth	maximum level of object loading
pObject	pointer to next level root object

Returns

Status code indicating success or failure.

Definition at line 768 of file DataSvc.cpp.

                                                                            {
  // unused:  StatusCode sc = StatusCode::FAILURE;
  if ( pObject && depth++ < load_depth ) {
    RegEntry* dir = CAST_REGENTRY( RegEntry*, pObject->registry() );
    if ( dir ) {
      for ( const auto& i : *dir ) {
        DataObject* pObj   = nullptr;
        StatusCode  status = retrieveObject( pObject, i->name(), pObj );
        if ( status.isSuccess() && depth < load_depth ) { preLoad( depth, load_depth, pObj ).ignore(); }
      }
    }
  }
  return StatusCode::SUCCESS;
}

registerAddress() [1/3]

StatusCode IDataManagerSvc::registerAddress ( DataObject * parentObj, std::string_view objectPath, IOpaqueAddress * pAddress )

inline

Register object address with the data store.

Connect the object identified by its pointer to the parent object and the relative path of the object with respect to the parent.

Parameters

parentObj	[IN] Pointer to parent object.
objectPath	[IN] Path of the object relative to the parent node
pAddress	[IN] Pointer to the object to be connected.

Returns

Status code indicating success or failure.

Definition at line 210 of file IDataManagerSvc.h.

                                                                                                           {
    return registerAddress( parentObj ? parentObj->registry() : nullptr, objectPath, pAddress );
  }

registerAddress() [2/3]

StatusCode DataSvc::registerAddress ( IRegistry * parentObj, std::string_view objectPath, IOpaqueAddress * pAddress )

override

IDataManagerSvc: Register object address with the data store.

Definition at line 204 of file DataSvc.cpp.

                                                                                                            {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  if ( objPath.empty() ) return Status::INVALID_OBJ_PATH;
 
  if ( !parentObj ) {
    if ( objPath.front() != SEPARATOR ) { return registerAddress( m_root.get(), objPath, pAddress ); }
    auto sep = find( objPath, SEPARATOR, 1 );
    if ( sep == std::string_view::npos || objPath.substr( 0, sep ) != m_rootName.value() ) {
      return Status::INVALID_PARENT;
    }
    return registerAddress( m_root.get(), objPath.substr( sep ), pAddress );
  }
  if ( objPath.front() != SEPARATOR ) { return registerAddress( parentObj, char( SEPARATOR ) + objPath, pAddress ); }
  RegEntry* par_entry = CAST_REGENTRY( RegEntry*, parentObj );
  if ( !par_entry ) return Status::INVALID_PARENT;
 
  auto sep = objPath.rfind( SEPARATOR );
  if ( sep > 0 && sep != std::string_view::npos ) {
    auto      p_path  = objPath.substr( 0, sep );
    auto      o_path  = objPath.substr( sep );
    RegEntry* p_entry = par_entry->findLeaf( p_path );
    // Create default object leafs if the
    // intermediate nodes are not present
    if ( !p_entry && m_forceLeaves ) {
      DataObject* pLeaf = createDefaultObject();
      StatusCode  sc    = registerObject( par_entry->identifier(), p_path, pLeaf );
      if ( sc.isFailure() ) delete pLeaf;
      p_entry = par_entry->findLeaf( p_path );
    }
    if ( !p_entry ) return Status::INVALID_PARENT;
    return registerAddress( p_entry, o_path, pAddress );
  }
  StatusCode status = par_entry->add( to_string( objPath ), pAddress );
  return status.isSuccess() ? status : Status::DOUBL_OBJ_PATH;
}

registerAddress() [3/3]

StatusCode DataSvc::registerAddress ( std::string_view fullPath, IOpaqueAddress * pAddress )

override

IDataManagerSvc: Register object address with the data store.

Definition at line 198 of file DataSvc.cpp.

                                                                                       {
  if ( fullPath.empty() ) return Status::INVALID_OBJ_PATH;
  return registerAddress( fullPath.front() != SEPARATOR ? m_root.get() : nullptr, fullPath, pAddress );
}

registerObject() [1/5]

StatusCode IDataProviderSvc::registerObject ( DataObject * parentObj, int item, DataObject * pObject )

inline

Register object with the data store.

Connect the object identified by its pointer to the node object identified by its pointer.

Parameters

parentObj	Pointer to parent object.
item	item number of the object linked to the parent
pObject	Pointer to the object to be connected.

Returns

Status code indicating success or failure.

Definition at line 112 of file IDataProviderSvc.h.

                                                                                    {
    return registerObject( parentObj, itemToPath( item ), pObject );
  }

registerObject() [2/5]

StatusCode DataSvc::registerObject ( DataObject * parentObj, std::string_view objPath, DataObject * pObject )

override

Register object with the data store.

Definition at line 288 of file DataSvc.cpp.

                                                                                                       {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
 
  if ( !parentObj ) {
    if ( !objPath.empty() ) {
      if ( objPath.front() != SEPARATOR ) { return registerObject( m_rootName.value(), objPath, pObject ); }
      auto sep = find( objPath, SEPARATOR, 1 );
      if ( sep != std::string_view::npos ) {
        return registerObject( objPath.substr( 0, sep ), objPath.substr( sep ), pObject );
      }
    }
    return Status::INVALID_OBJ_PATH;
  }
  RegEntry* node_entry = CAST_REGENTRY( RegEntry*, parentObj->registry() );
  if ( node_entry ) {
    StatusCode status = Status::INVALID_PARENT;
    auto       sep    = find( objPath, SEPARATOR, 1 );
    if ( sep != std::string_view::npos ) {
      auto      p_path    = objPath.substr( 0, sep );
      auto      o_path    = objPath.substr( sep );
      RegEntry* par_entry = node_entry->findLeaf( p_path );
      // Create default object leafs if the
      // intermediate nodes are not present
      if ( !par_entry && m_forceLeaves ) {
        DataObject* pLeaf = createDefaultObject();
        StatusCode  sc    = registerObject( parentObj, p_path, pLeaf );
        if ( !sc.isSuccess() ) delete pLeaf;
        par_entry = node_entry->findLeaf( p_path );
      } else if ( par_entry && !par_entry->object() ) {
        status = i_retrieveEntry( node_entry, p_path, par_entry );
        if ( !status.isSuccess() && !par_entry->address() && m_forceLeaves ) {
          DataObject* pLeaf = createDefaultObject();
          StatusCode  sc    = registerObject( parentObj, p_path, pLeaf );
          if ( !sc.isSuccess() ) delete pLeaf;
          par_entry = node_entry->findLeaf( p_path );
        }
      }
      node_entry = par_entry;
      if ( node_entry ) {
        DataObject* obj = node_entry->object();
        if ( obj ) status = registerObject( obj, o_path, pObject );
      }
    } else {
      RegEntry* leaf = node_entry->findLeaf( objPath );
      if ( !leaf ) {
        status = node_entry->add( to_string( objPath ), pObject );
      } else {
        DataObject* obj = leaf->object();
        if ( !obj ) {
          if ( !pObject ) {
            error() << "registerObject: trying to register null DataObject" << endmsg;
            return StatusCode::FAILURE;
          }
          pObject->setRegistry( leaf );
          leaf->setAddress( nullptr );
          leaf->setObject( pObject );
          status = StatusCode::SUCCESS;
        } else {
          status = Status::DOUBL_OBJ_PATH;
        }
      }
    }
    return status;
  }
  return Status::INVALID_PARENT;
}

registerObject() [3/5]

StatusCode IDataProviderSvc::registerObject ( std::string_view fullPath, DataObject * pObject )

inline

Register object with the data store.

Connect the object identified by its pointer to the node object identified by its path.

Parameters

fullPath	Path to parent node of the object.
pObject	Pointer to the object to be registered.

Returns

Status code indicating success or failure.

Definition at line 67 of file IDataProviderSvc.h.

                                                                            {
    return registerObject( nullptr, fullPath, pObject );
  }

registerObject() [4/5]

StatusCode IDataProviderSvc::registerObject ( std::string_view parentPath, int item, DataObject * pObject )

inline

Register object with the data store.

Connect the object identified by its pointer to the parent object and an integer identifier.

Parameters

parentPath	Path to parent node of the object.
item	item number of the object linked to the parent
pObject	Pointer to the object to be registered.

Returns

Status code indicating success or failure.

Definition at line 90 of file IDataProviderSvc.h.

                                                                                        {
    return registerObject( parentPath, itemToPath( item ), pObject );
  }

registerObject() [5/5]

StatusCode DataSvc::registerObject ( std::string_view parentPath, std::string_view objPath, DataObject * pObject )

override

Register object with the data store.

Definition at line 276 of file DataSvc.cpp.

                                                                                                           {
  DataObject* pO     = nullptr;
  StatusCode  status = retrieveObject( parentPath, pO );
  if ( !status.isSuccess() && m_forceLeaves ) {
    pO     = createDefaultObject();
    status = registerObject( parentPath, pO );
    if ( !status.isSuccess() ) pO->release();
  }
  return status.isSuccess() ? registerObject( pO, objPath, pObject ) : status;
}

reinitialize()

StatusCode DataSvc::reinitialize ( )

override

Service initialization.

Service reinitialization.

Definition at line 805 of file DataSvc.cpp.

                                 {
  // the finalize part is copied here
  setDataLoader( nullptr ).ignore();
  resetPreLoad().ignore();
  clearStore().ignore();
  m_incidentSvc.reset();
  // re-initialize the base class
  StatusCode sc = Service::reinitialize();
  if ( !sc.isSuccess() ) {
    error() << "Unable to reinitialize base class" << endmsg;
    return sc;
  }
  // the initialize part is copied here
  m_incidentSvc = service( "IncidentSvc", true );
  if ( !m_incidentSvc ) {
    error() << "Failed to access incident service." << endmsg;
    return StatusCode::FAILURE;
  }
 
  return StatusCode::SUCCESS;
}

removePreLoadItem()

StatusCode DataSvc::removePreLoadItem ( const DataStoreItem & item )

override

Remove an item from the preload list.

Definition at line 756 of file DataSvc.cpp.

                                                                 {
  m_preLoads.erase( std::remove( begin( m_preLoads ), end( m_preLoads ), item ), end( m_preLoads ) );
  return StatusCode::SUCCESS;
}

resetPreLoad()

StatusCode DataSvc::resetPreLoad ( )

override

Clear the preload list.

Definition at line 762 of file DataSvc.cpp.

                                 {
  m_preLoads.erase( begin( m_preLoads ), end( m_preLoads ) );
  return StatusCode::SUCCESS;
}

retrieveEntry()

StatusCode DataSvc::retrieveEntry ( DataSvcHelpers::RegistryEntry * pNode, std::string_view path, DataSvcHelpers::RegistryEntry *& pEntry )

protected

Retrieve registry entry from store.

Definition at line 511 of file DataSvc.cpp.

                                                                                               {
  return i_retrieveEntry( parentObj, path, pEntry );
}

retrieveObject() [1/6]

StatusCode IDataProviderSvc::retrieveObject ( DataObject * parentObj, int item, DataObject *& pObject )

inline

Retrieve object from data store.

The object to be retrieved is identified by the pointer to the parent object and an integer identifier. In case the object is not present it will be loaded and converted if possible.

Parameters

parentObj	Pointer to parent node of the object.
item	Item identifier.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 296 of file IDataProviderSvc.h.

                                                                                     {
    return retrieveObject( parentObj, itemToPath( item ), pObject );
  }

retrieveObject() [2/6]

StatusCode IDataProviderSvc::retrieveObject ( DataObject * parentObj, std::string_view objectPath, DataObject *& pObject )

inline

Retrieve object from data store.

The object to be retrieved is identified by the pointer to the parent object and the relative path with respect to the node. In case the object is not present it will be loaded and converted if possible.

Parameters

parentObj	Pointer to parent node of the object.
objectPath	Path of the object relative to the parent.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 282 of file IDataProviderSvc.h.

                                                                                                      {
    return retrieveObject( parentObj ? parentObj->registry() : nullptr, objectPath, pObject );
  }

retrieveObject() [3/6]

StatusCode DataSvc::retrieveObject ( IRegistry * pDirectory, std::string_view path, DataObject *& pObject )

override

Retrieve object from data store.

Retrieve object identified by its directory from the data store.

Definition at line 601 of file DataSvc.cpp.

                                                                                                    {
  pObject           = nullptr;
  RegEntry * result = nullptr, *parent = CAST_REGENTRY( RegEntry*, pRegistry );
  StatusCode status = i_retrieveEntry( parent, path, result );
  if ( status.isSuccess() ) pObject = result->object();
  return status;
}

retrieveObject() [4/6]

StatusCode IDataProviderSvc::retrieveObject ( std::string_view fullPath, DataObject *& pObject )

inline

Retrieve object identified by its full path from the data store.

The result will be returned in the second argument. In case the object is not present it will be loaded and converted if possible.

Parameters

fullPath	Path name of the object.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 238 of file IDataProviderSvc.h.

                                                                             {
    return retrieveObject( static_cast<IRegistry*>( nullptr ), fullPath, pObject );
  }

retrieveObject() [5/6]

StatusCode IDataProviderSvc::retrieveObject ( std::string_view parentPath, int item, DataObject *& pObject )

inline

Retrieve object from data store.

The object to be retrieved is identified by the path to the parent object and an integer identifier. In case the object is not present it will be loaded and converted if possible.

Parameters

parentPath	Path to parent node of the object.
item	Item identifier.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 268 of file IDataProviderSvc.h.

                                                                                         {
    return retrieveObject( parentPath, itemToPath( item ), pObject );
  }

retrieveObject() [6/6]

StatusCode IDataProviderSvc::retrieveObject ( std::string_view parentPath, std::string_view objectPath, DataObject *& pObject )

inline

Retrieve object from data store.

The object to be retrieved is identified by the path of the parent object and the relative path with respect to the node. In case the object is not present it will be loaded and converted if possible.

Parameters

parentPath	Path to parent node of the object.
objectPath	Path of the object relative to the parent.
pObject	Reference to the pointer of the object to be returned.

Returns

Status code indicating success or failure.

Definition at line 252 of file IDataProviderSvc.h.

                                                                                                          {
    DataObject* parent = nullptr;
    StatusCode  status = retrieveObject( parentPath, parent );
    return status.isSuccess() ? retrieveObject( parent, objectPath, pObject ) : status;
  }

rootCLID()

CLID DataSvc::rootCLID ( ) const

override

IDataManagerSvc: Accessor for root event CLID.

CLID for root Event.

Definition at line 838 of file DataSvc.cpp.

{ return (CLID)m_rootCLID; }

rootName()

const std::string & DataSvc::rootName ( ) const

override

IDataManagerSvc: Accessor for root event name.

Name for root Event.

Definition at line 841 of file DataSvc.cpp.

{ return m_rootName; }

setDataLoader()

StatusCode DataSvc::setDataLoader ( IConversionSvc * svc, IDataProviderSvc * dpsvc = nullptr )

override

IDataManagerSvc: IDataManagerSvc: Pass a default data loader to the service and optionally a data provider.

IDataManagerSvc: Pass a default data loader to the service.

Definition at line 160 of file DataSvc.cpp.

                                                                                        {
  m_dataLoader = pDataLoader;
  if ( m_dataLoader ) m_dataLoader->setDataProvider( dpsvc ? dpsvc : this ).ignore();
  return StatusCode::SUCCESS;
}

setRoot() [1/2]

StatusCode DataSvc::setRoot ( std::string root_path, DataObject * pRootObj )

override

Initialize data store for new event by giving new event path and root object.

Takes care to clear the store before reinitializing it

Definition at line 115 of file DataSvc.cpp.

                                                                       {
  clearStore().ignore();
  return i_setRoot( std::move( root_path ), pRootObj );
}

setRoot() [2/2]

StatusCode DataSvc::setRoot ( std::string root_path, IOpaqueAddress * pRootAddr )

override

Initialize data store for new event by giving new event path and address of root object.

Takes care to clear the store before reinitializing it

Definition at line 139 of file DataSvc.cpp.

                                                                            {
  clearStore().ignore();
  return i_setRoot( std::move( root_path ), pRootAddr );
}

traverseSubTree() [1/2]

StatusCode DataSvc::traverseSubTree ( DataObject * pObject, IDataStoreAgent * pAgent )

override

IDataManagerSvc: Analyze by traversing all data objects below the sub tree.

IDataManagerSvc: Analyse by traversing all data objects below the sub tree.

Definition at line 100 of file DataSvc.cpp.

                                                                                  {
  RegEntry* entry = CAST_REGENTRY( RegEntry*, pObject->registry() );
  return entry ? entry->traverseTree( pAgent ) : Status::INVALID_OBJECT;
}

traverseSubTree() [2/2]

StatusCode DataSvc::traverseSubTree ( std::string_view sub_tree_path, IDataStoreAgent * pAgent )

override

IDataManagerSvc: Analyze by traversing all data objects below the sub tree identified by its full path name.

IDataManagerSvc: Analyse by traversing all data objects below the sub tree identified by its full path name.

Definition at line 93 of file DataSvc.cpp.

                                                                                           {
  DataObject* pO     = nullptr;
  StatusCode  status = findObject( sub_tree_path, pO );
  return status.isSuccess() ? traverseSubTree( pO, pAgent ) : status;
}

traverseTree()

StatusCode DataSvc::traverseTree ( IDataStoreAgent * pAgent )

override

IDataManagerSvc: Analyze by traversing all data objects in the data store.

IDataManagerSvc: Analyse by traversing all data objects in the data store.

Definition at line 106 of file DataSvc.cpp.

                                                          {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  return m_root->traverseTree( pAgent );
}

unlinkObject() [1/4]

StatusCode DataSvc::unlinkObject ( DataObject * fromObj, std::string_view objPath )

override

Remove a link to another object.

Definition at line 742 of file DataSvc.cpp.

                                                                           {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  IRegistry* from_entry = m_root->findLeaf( from );
  return unlinkObject( from_entry, objPath );
}

unlinkObject() [2/4]

StatusCode DataSvc::unlinkObject ( IRegistry * from, std::string_view objPath )

override

Remove a link to another object.

Definition at line 714 of file DataSvc.cpp.

                                                                          {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  try {
    RegEntry* from_entry = CAST_REGENTRY( RegEntry*, from );
    if ( from_entry ) {
      auto sep = objPath.rfind( SEPARATOR );
      if ( sep > 0 && sep != std::string_view::npos ) { // in case the objPath is a sub-directory itself
        DataObject* pO = nullptr;
        StatusCode  sc = findObject( from, objPath.substr( 0, sep ), pO );
        return sc.isSuccess() ? unlinkObject( pO->registry(), objPath.substr( sep ) ) : sc;
      }
      StatusCode status = from_entry->remove( objPath );
      if ( status.isSuccess() ) return status;
      return Status::INVALID_OBJ_PATH;
    }
  } catch ( ... ) {}
  return Status::INVALID_PARENT;
}

unlinkObject() [3/4]

StatusCode IDataProviderSvc::unlinkObject ( std::string_view fromPath, std::string_view objPath )

inline

Remove a link to another object.

Both objects must be registered with the data store. This entry point can be used to unlink objects e.g. in order to unregister them.

Parameters

fromPath	Path to the object the link originates.
objPath	Path of the entry to be linked relative to from.

Returns

Status code indicating success or failure.

Definition at line 527 of file IDataProviderSvc.h.

                                                                             {
    DataObject* pObject = nullptr;
    StatusCode  status  = findObject( fromPath, pObject );
    return status.isSuccess() ? unlinkObject( pObject->registry(), objPath ) : status;
  }

unlinkObject() [4/4]

StatusCode DataSvc::unlinkObject ( std::string_view fullPath )

override

Remove a link to another object.

Definition at line 734 of file DataSvc.cpp.

                                                          {
  if ( fullPath.empty() ) return Status::INVALID_OBJ_PATH;
  if ( fullPath.front() != SEPARATOR ) return unlinkObject( m_rootName.value(), fullPath );
  auto sep = fullPath.rfind( SEPARATOR );
  return unlinkObject( fullPath.substr( 0, sep ), fullPath.substr( sep ) );
}

unregisterAddress() [1/3]

StatusCode IDataManagerSvc::unregisterAddress ( DataObject * pParent, std::string_view objPath )

inline

Unregister object address from the data store.

The object is identified by parent object and the path of the object relative to the parent.

Parameters

pParent	[IN] Pointer to parent object.
objPath	[IN] Path name of the object relative to the parent.

Returns

Status code indicating success or failure.

Definition at line 238 of file IDataManagerSvc.h.

                                                                              {
    return unregisterAddress( pParent ? pParent->registry() : nullptr, objPath );
  }

unregisterAddress() [2/3]

StatusCode DataSvc::unregisterAddress ( IRegistry * pParent, std::string_view objPath )

override

IDataManagerSvc: Unregister object address from the data store.

Definition at line 247 of file DataSvc.cpp.

                                                                                  {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  if ( objPath.empty() ) return Status::INVALID_OBJ_PATH;
 
  if ( !pParent ) {
    if ( objPath.front() != SEPARATOR ) return unregisterAddress( m_root.get(), objPath );
    auto sep = find( objPath, SEPARATOR, 1 );
    if ( sep != std::string_view::npos && objPath.substr( 0, sep ) == m_rootName.value() ) {
      return unregisterAddress( m_root.get(), objPath.substr( sep ) );
    }
    return Status::INVALID_PARENT;
  }
  if ( objPath.front() != SEPARATOR ) { return unregisterAddress( pParent, char( SEPARATOR ) + objPath ); }
  RegEntry* node_entry = CAST_REGENTRY( RegEntry*, pParent );
  if ( node_entry ) {
    RegEntry* leaf_entry = node_entry->findLeaf( objPath );
    if ( leaf_entry ) {
      auto sep = objPath.rfind( SEPARATOR );
      if ( sep > 0 && sep != std::string_view::npos ) {
        return unregisterAddress( leaf_entry->parent(), objPath.substr( sep ) );
      }
      StatusCode status = node_entry->remove( objPath );
      if ( status.isSuccess() ) return status;
    }
  }
  return Status::INVALID_PARENT;
}

unregisterAddress() [3/3]

StatusCode DataSvc::unregisterAddress ( std::string_view fullPath )

override

IDataManagerSvc: Unregister object address from the data store.

Definition at line 241 of file DataSvc.cpp.

                                                               {
  if ( fullPath.empty() ) return Status::INVALID_OBJ_PATH;
  return unregisterAddress( fullPath.front() != SEPARATOR ? m_root.get() : nullptr, fullPath );
}

unregisterObject() [1/3]

StatusCode DataSvc::unregisterObject ( DataObject * pObject )

override

Unregister object from the data store.

Definition at line 371 of file DataSvc.cpp.

                                                          {
  if ( !checkRoot() ) return Status::INVALID_ROOT;
  RegEntry* entry = m_root->findLeaf( pObject );
  if ( !entry ) return Status::INVALID_OBJECT;
  RegEntry* parent = entry->parentEntry();
  if ( !parent ) return Status::INVALID_PARENT;
  if ( !entry->isEmpty() ) return Status::DIR_NOT_EMPTY;
  if ( entry->object() ) entry->object()->addRef();
  if ( parent ) parent->remove( entry );
  return StatusCode::SUCCESS;
}

unregisterObject() [2/3]

StatusCode DataSvc::unregisterObject ( DataObject * pObject, std::string_view objectPath )

override

Unregister object from the data store.

Definition at line 384 of file DataSvc.cpp.

                                                                                        {
  if ( checkRoot() ) {
    try {
      RegEntry* parent = CAST_REGENTRY( RegEntry*, pParentObj->registry() );
      if ( parent ) {
        RegEntry* entry = parent->findLeaf( objectPath );
        if ( entry ) {
          if ( entry->isEmpty() ) {
            if ( entry->object() ) { entry->object()->addRef(); }
            parent->remove( entry );
            return StatusCode::SUCCESS;
          }
          return Status::DIR_NOT_EMPTY;
        }
        return Status::INVALID_OBJECT;
      }
    } catch ( ... ) {}
    return Status::INVALID_PARENT;
  }
  return Status::INVALID_ROOT;
}

unregisterObject() [3/3]

StatusCode DataSvc::unregisterObject ( std::string_view fullPath )

override

Unregister object from the data store.

Definition at line 356 of file DataSvc.cpp.

                                                              {
  DataObject* pObject = nullptr;
  StatusCode  status  = findObject( fullPath, pObject );
  if ( status.isFailure() ) return status;
  RegEntry* pEntry = CAST_REGENTRY( RegEntry*, pObject->registry() );
  if ( !pEntry ) return Status::INVALID_ROOT;
  if ( !pEntry->isEmpty() ) return Status::DIR_NOT_EMPTY;
  RegEntry* pParent = pEntry->parentEntry();
  if ( !pParent ) return Status::INVALID_PARENT;
  pObject->addRef();
  pParent->remove( pEntry );
  return StatusCode::SUCCESS;
}

updateObject() [1/2]

StatusCode DataSvc::updateObject ( DataObject * toUpdate )

override

Update object.

Definition at line 646 of file DataSvc.cpp.

                                                       {
  StatusCode status = Status::INVALID_OBJ_ADDR;
  if ( !toUpdate ) {               // Precondition:
    return Status::INVALID_OBJECT; // Address must be valid
  }
  IRegistry* pRegistry = toUpdate->registry(); // Precondition:
  if ( !pRegistry ) {                          // Need valid registry
    return Status::INVALID_OBJECT;
  }
  IOpaqueAddress* pAddress = pRegistry->address(); // Precondition:
  if ( !pAddress ) {                               // Need valid address
    return Status::INVALID_OBJ_ADDR;
  }
  IConversionSvc* pLoader = getDataLoader( pRegistry );
  if ( !pLoader ) {                // Precondition:
    return Status::NO_DATA_LOADER; // Data loader must be present
  }
  if ( !m_inhibitPathes.empty() ) {
    auto inhibit = std::find( m_inhibitPathes.begin(), m_inhibitPathes.end(), pRegistry->identifier() );
    if ( inhibit != m_inhibitPathes.end() ) { return Status::NO_ACCESS; }
  }
  try {
    status = pLoader->updateObj( pAddress, toUpdate ); // Call data loader
    if ( status.isSuccess() ) { status = pLoader->updateObjRefs( pAddress, toUpdate ); }
  } catch ( const GaudiException& exc ) {
    throw GaudiException( "GaudiException in updateObject() " + pRegistry->name(), name(), StatusCode::FAILURE, exc );
  } catch ( const std::exception& x ) {
    throw GaudiException( "std::exception in updateObject() " + pRegistry->name() + ": " +
                              System::typeinfoName( typeid( x ) ) + ", " + x.what(),
                          name(), StatusCode::FAILURE );
  } catch ( ... ) {
    throw GaudiException( "UNKN exception in updateObject() " + pRegistry->name(), name(), StatusCode::FAILURE );
  }
  return status;
}

updateObject() [2/2]

StatusCode DataSvc::updateObject ( IRegistry * pDirectory )

override

Update object identified by its directory entry.

Update object.

Definition at line 634 of file DataSvc.cpp.

                                                       {
  if ( !pRegistry ) {                // Precondition:
    return Status::INVALID_OBJ_ADDR; // Addres must be valid
  }
  DataObject* toUpdate = pRegistry->object();
  if ( !toUpdate ) { // Try first to load
    return loadObject( pRegistry );
  }
  return updateObject( toUpdate );
}

Member Data Documentation

m_accessName

Gaudi::Property<std::string> DataSvc::m_accessName { this, "DataAccessName", "DataAccess", "Name of the data access incident" }

private

Definition at line 66 of file DataSvc.h.

{ this, "DataAccessName", "DataAccess", "Name of the data access incident" };

m_dataLoader

SmartIF<IConversionSvc> DataSvc::m_dataLoader = nullptr

private

Pointer to data loader service.

Definition at line 46 of file DataSvc.h.

m_enableAccessHdlr

Gaudi::Property<bool> DataSvc::m_enableAccessHdlr

private

Initial value:

{ this, "EnableAccessHandler", false,
                                            "enable incidents on data access requests" }

Definition at line 64 of file DataSvc.h.

                                               { this, "EnableAccessHandler", false,
                                            "enable incidents on data access requests" };

m_enableFaultHdlr

Gaudi::Property<bool> DataSvc::m_enableFaultHdlr

private

Initial value:

{ this, "EnableFaultHandler", false,
                                           "enable incidents on data creation requests" }

Definition at line 60 of file DataSvc.h.

                                              { this, "EnableFaultHandler", false,
                                           "enable incidents on data creation requests" };

m_faultName

Gaudi::Property<std::string> DataSvc::m_faultName { this, "DataFaultName", "DataFault", "Name of the data fault incident" }

private

Definition at line 62 of file DataSvc.h.

{ this, "DataFaultName", "DataFault", "Name of the data fault incident" };

m_forceLeaves

Gaudi::Property<bool> DataSvc::m_forceLeaves

private

Initial value:

{ this, "ForceLeaves", false,
                                       "force creation of default leaves on registerObject" }

Definition at line 56 of file DataSvc.h.

                                                       { this, "ForceLeaves", false,
                                       "force creation of default leaves on registerObject" };

m_incidentSvc

SmartIF<IIncidentSvc> DataSvc::m_incidentSvc = nullptr

protected

Pointer to incident service.

Definition at line 50 of file DataSvc.h.

m_inhibitPathes

Gaudi::Property<std::vector<std::string> > DataSvc::m_inhibitPathes { this, "InhibitPaths", {}, "inhibited leaves" }

private

Definition at line 58 of file DataSvc.h.

{ this, "InhibitPaths", {}, "inhibited leaves" };

m_preLoads

std::vector<DataStoreItem> DataSvc::m_preLoads

private

Items to be pre-loaded.

Definition at line 69 of file DataSvc.h.

m_root

std::unique_ptr<DataSvcHelpers::RegistryEntry> DataSvc::m_root

protected

Pointer to root entry.

Definition at line 73 of file DataSvc.h.

m_rootCLID

Gaudi::Property<CLID> DataSvc::m_rootCLID { this, "RootCLID", 110 , "CLID of root entry" }

protected

Definition at line 52 of file DataSvc.h.

{ this, "RootCLID", 110 /*CLID_Event*/, "CLID of root entry" };

m_rootName

Gaudi::Property<std::string> DataSvc::m_rootName { this, "RootName", "/Event", "name of root entry" }

protected

Definition at line 53 of file DataSvc.h.

{ this, "RootName", "/Event", "name of root entry" };

---

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

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