#include <GaudiKernel/IDataManagerSvc.h>

Inheritance diagram for IDataManagerSvc:

Collaboration diagram for IDataManagerSvc:

Public Member Functions
	DeclareInterfaceID (IDataManagerSvc, 2, 0)
	InterfaceID.
virtual CLID	rootCLID () const =0
	Get class ID of root Event.
virtual std::string	rootName () const =0
	Get Name of root Event.
virtual StatusCode	setDataLoader (IConversionSvc *svc)=0
	Pass a default data loader to the service.
virtual StatusCode	objectParent (const DataObject pObject, IRegistry &refpParent)=0
	IDataManagerSvc: Explore the object store: retrieve the object's parent.
virtual StatusCode	objectParent (const IRegistry pRegistry, IRegistry &refpParent)=0
	IDataManagerSvc: Explore the object store: retrieve the object's parent.
virtual StatusCode	objectLeaves (const DataObject pObject, std::vector< IRegistry > &refLeaves)=0
	Explore the object store: retrieve all leaves attached to the object The object is identified by its pointer.
virtual StatusCode	objectLeaves (const IRegistry pRegistry, std::vector< IRegistry > &refLeaves)=0
	Explore the object store: retrieve all leaves attached to the object The object is identified by the pointer to the registry entry.
virtual StatusCode	clearSubTree (const std::string &sub_path)=0
	Remove all data objects below the sub tree identified by its full path name.
virtual StatusCode	clearSubTree (DataObject *pObject)=0
	Remove all data objects below the sub tree identified by the object.
virtual StatusCode	clearStore ()=0
	Remove all data objects in the data store.
virtual StatusCode	traverseSubTree (const std::string &sub_path, IDataStoreAgent *pAgent)=0
	Analyse by traversing all data objects below the sub tree identified by its full path name.
virtual StatusCode	traverseSubTree (DataObject pObject, IDataStoreAgent pAgent)=0
	Analyse by traversing all data objects below the sub tree identified by the object.
virtual StatusCode	traverseTree (IDataStoreAgent *pAgent)=0
	Analyse by traversing all data objects in the data store.
virtual StatusCode	setRoot (const std::string &root_name, DataObject *pObject)=0
	Initialize data store for new event by giving new event path.
virtual StatusCode	setRoot (const std::string &root_path, IOpaqueAddress *pRootAddr)=0
	Initialize data store for new event by giving new event path.
virtual StatusCode	registerAddress (const std::string &fullPath, IOpaqueAddress *pAddress)=0
	Register object address with the data store.
virtual StatusCode	registerAddress (DataObject parentObj, const std::string &objectPath, IOpaqueAddress pAddress)=0
	Register object address with the data store.
virtual StatusCode	registerAddress (IRegistry parentObj, const std::string &objectPath, IOpaqueAddress pAddress)=0
	Register object address with the data store.
virtual StatusCode	unregisterAddress (const std::string &fullPath)=0
	Unregister object address from the data store.
virtual StatusCode	unregisterAddress (DataObject *pParent, const std::string &objPath)=0
	Unregister object address from the data store.
virtual StatusCode	unregisterAddress (IRegistry *pParent, const std::string &objPath)=0
	Unregister object address from the data store.

Detailed Description

The data manager interface of the service allows to:

Discard sub-trees or the entire data stored.
Initialize the top level root used for navigation.
Access the tree information of the data store: Given a reference to a store object, which can be identified by path, pointer or reference to the registry entry, it is possible to retrieve the parent object and to access iterators over the leaf entries.
Register addresses to the data store. Registered addresses contain the retrieve information for the underlying object.
Unregister addresses from the data store. The object will no longer be accessible and loadable.

Author:: Markus Frank

Version:: 1.0

Definition at line 44 of file IDataManagerSvc.h.

Member Function Documentation

virtual StatusCode IDataManagerSvc::clearStore ( ) [pure virtual]

Remove all data objects in the data store.

Returns:: Status code indicating success or failure

virtual StatusCode IDataManagerSvc::clearSubTree ( const std::string & sub_path ) [pure virtual]

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

Parameters:

sub_path [IN] Path to sub-tree node.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::clearSubTree ( DataObject * pObject ) [pure virtual]

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

The object itself is removed as well.

Parameters:

pObject [IN] Pointer to object

Returns:: Status code indicating success or failure

IDataManagerSvc::DeclareInterfaceID	(	IDataManagerSvc	,
		2	,
		0
	)

InterfaceID.

virtual StatusCode IDataManagerSvc::objectLeaves	(	const IRegistry *	pRegistry,
		std::vector< IRegistry * > &	refLeaves
	)		`[pure virtual]`

Explore the object store: retrieve all leaves attached to the object The object is identified by the pointer to the registry entry.

Allow to access and browse the leaf objects of the identified object.

Parameters:

pRegistry	[IN] Pointer to the registry of the obejct.
refLeaves	[OUT] Reference to storage location, where the objects leaves should be stored.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::objectLeaves	(	const DataObject *	pObject,
		std::vector< IRegistry * > &	refLeaves
	)		`[pure virtual]`

Explore the object store: retrieve all leaves attached to the object The object is identified by its pointer.

Allow to access and browse the leaf objects of the identified object.

Parameters:

pObject	[IN] Pointer to the object.
refLeaves	[OUT] Reference to storage location, where the objects leaves should be stored.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::objectParent	(	const DataObject *	pObject,
		IRegistry *&	refpParent
	)		`[pure virtual]`

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

The object is identified by its pointer.

Parameters:

pObject	[IN] Pointer to the object.
refpParent	[OUT] Reference to store the parent's registry entry.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::objectParent	(	const IRegistry *	pRegistry,
		IRegistry *&	refpParent
	)		`[pure virtual]`

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

The object is identified by the pointer to the registry entry.

Parameters:

pRegistry	[IN] Pointer to the object.
refpParent	[OUT] Reference to store the parent's registry entry.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::registerAddress	(	IRegistry *	parentObj,
		const std::string &	objectPath,
		IOpaqueAddress *	pAddress
	)		`[pure virtual]`

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.

virtual StatusCode IDataManagerSvc::registerAddress	(	const std::string &	fullPath,
		IOpaqueAddress *	pAddress
	)		`[pure virtual]`

Register object address with the data store.

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

Parameters:

fullPath	[IN] Path to parent node of the object.
pAddress	[IN] Pointer to the object to be registered.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::registerAddress	(	DataObject *	parentObj,
		const std::string &	objectPath,
		IOpaqueAddress *	pAddress
	)		`[pure virtual]`

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.

virtual CLID IDataManagerSvc::rootCLID ( ) const [pure virtual]

Get class ID of root Event.

virtual std::string IDataManagerSvc::rootName ( ) const [pure virtual]

Get Name of root Event.

virtual StatusCode IDataManagerSvc::setDataLoader ( IConversionSvc * svc ) [pure virtual]

Pass a default data loader to the service.

This service will be asked to load non existant data items.

Parameters:

svc	[IN] Pointer to persistency service instance

Returns:: Status code indicating success or failure

virtual StatusCode IDataManagerSvc::setRoot	(	const std::string &	root_path,
		IOpaqueAddress *	pRootAddr
	)		`[pure virtual]`

Initialize data store for new event by giving new event path.

Implicitly this clears the entire data store.

Parameters:

root_name	[IN] String containing root path name
pRootAddr	[IN] Pointer to opaque root node address

Returns:: Status code indicating success or failure

virtual StatusCode IDataManagerSvc::setRoot	(	const std::string &	root_name,
		DataObject *	pObject
	)		`[pure virtual]`

Initialize data store for new event by giving new event path.

Implicitly this clears the entire data store.

Parameters:

root_name	[IN] String containing root path name
pObject	[IN] Pointer to root node object

Returns:: Status code indicating success or failure

virtual StatusCode IDataManagerSvc::traverseSubTree	(	const std::string &	sub_path,
		IDataStoreAgent *	pAgent
	)		`[pure virtual]`

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

Parameters:

sub_path [IN] Path to sub-tree node.

Returns:: Status code indicating success or failure.

virtual StatusCode IDataManagerSvc::traverseSubTree	(	DataObject *	pObject,
		IDataStoreAgent *	pAgent
	)		`[pure virtual]`

Analyse by traversing all data objects below the sub tree identified by the object.

The object itself is removed as well.

Parameters:

pObject	[IN] Pointer to object
pAgent	[IN] Pointer to the datastore agent traversing the store

Returns:: Status code indicating success or failure

virtual StatusCode IDataManagerSvc::traverseTree ( IDataStoreAgent * pAgent ) [pure virtual]

Analyse by traversing all data objects in the data store.

Returns:: Status code indicating success or failure

virtual StatusCode IDataManagerSvc::unregisterAddress	(	IRegistry *	pParent,
		const std::string &	objPath
	)		`[pure virtual]`

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.

virtual StatusCode IDataManagerSvc::unregisterAddress	(	DataObject *	pParent,
		const std::string &	objPath
	)		`[pure virtual]`

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.

virtual StatusCode IDataManagerSvc::unregisterAddress ( const std::string & fullPath ) [pure virtual]

Unregister object address from the data store.

The object is identified by full path name.

Parameters:

fullPath [IN] Path name of the object.

Returns:: Status code indicating success or failure.

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

/afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v23r0/GaudiKernel/GaudiKernel/IDataManagerSvc.h

Gaudi Framework, version v23r0

IDataManagerSvc Class Reference

Public Member Functions

Detailed Description

Member Function Documentation