Base class from which all the concrete tool classes should be derived. More...

#include <GaudiKernel/AlgTool.h>

Inheritance diagram for AlgTool:

[legend]

Collaboration diagram for AlgTool:

[legend]

Public Types
typedef Gaudi::PluginService::Factory< IAlgTool , const std::string &, const std::string &, const IInterface >	Factory

Public Types inherited from PropertyHolder< CommonMessaging< implements< IAlgTool, IDataHandleHolder, IProperty, IStateful > > >
using	PropertyHolderImpl = PropertyHolder< CommonMessaging< implements< IAlgTool, IDataHandleHolder, IProperty, IStateful > > >
	Typedef used to refer to this class from derived classes, as in. More...

Public Types inherited from CommonMessaging< implements< IAlgTool, IDataHandleHolder, IProperty, IStateful > >
using	base_class = CommonMessaging

Public Member Functions
StatusCode	queryInterface (const InterfaceID &riid, void **ppvUnknown) override
	Query for a given interface. More...

const std::string &	name () const override
	Retrieve full identifying name of the concrete tool object. More...

const std::string &	type () const override
	Retrieve type (concrete class) of the sub-algtool. More...

const IInterface *	parent () const override
	Retrieve parent of the sub-algtool. More...

StatusCode	configure () override

StatusCode	initialize () override

StatusCode	start () override

StatusCode	stop () override

StatusCode	finalize () override

StatusCode	terminate () override

StatusCode	reinitialize () override

StatusCode	restart () override

Gaudi::StateMachine::State	FSMState () const override

Gaudi::StateMachine::State	targetFSMState () const override

StatusCode	sysInitialize () override
	Initialize AlgTool. More...

StatusCode	sysStart () override
	Start AlgTool. More...

StatusCode	sysStop () override
	Stop AlgTool. More...

StatusCode	sysFinalize () override
	Finalize AlgTool. More...

StatusCode	sysReinitialize () override
	Initialize AlgTool. More...

StatusCode	sysRestart () override
	Start AlgTool. More...

	AlgTool (const std::string &type, const std::string &name, const IInterface *parent)
	Standard Constructor. More...

SmartIF< ISvcLocator > &	serviceLocator () const override
	Retrieve pointer to service locator. More...

ISvcLocator *	svcLoc () const
	shortcut for the method service locator More...

IDataProviderSvc *	evtSvc () const
	accessor to event service service More...

IToolSvc *	toolSvc () const
	The standard ToolSvc service, Return a pointer to the service if present. More...

StatusCode	setProperties ()
	Method for setting declared properties to the values specified in the jobOptions via the job option service. More...

template<class T >
StatusCode	service (const std::string &name, T *&svc, bool createIf=true) const
	Access a service by name, creating it if it doesn't already exist. More...

template<class T >
StatusCode	service (const std::string &type, const std::string &name, T *&svc) const
	Access a service by name, type creating it if it doesn't already exist. More...

SmartIF< IService >	service (const std::string &name, const bool createIf=true, const bool quiet=false) const
	Return a pointer to the service identified by name (or "type/name") More...

template<typename T >
SmartIF< T >	service (const std::string &name, const bool createIf=true, const bool quiet=false) 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, std::string toolTypeAndName="", bool createIf=true)

template<class T >
Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ToolHandleArray< T > &hndlArr, const std::string &doc="none")

virtual std::vector< Gaudi::DataHandle * >	inputHandles () const override

virtual std::vector< Gaudi::DataHandle * >	outputHandles () const override

virtual const DataObjIDColl &	extraInputDeps () const override

virtual const DataObjIDColl &	extraOutputDeps () const override

virtual void	acceptDHVisitor (IDataHandleVisitor *) const override

const DataObjIDColl &	inputDataObjs () const override

const DataObjIDColl &	outputDataObjs () const override

void	commitHandles () override

void	registerTool (IAlgTool *tool) const

void	deregisterTool (IAlgTool *tool) const

template<class T >
StatusCode	declarePublicTool (ToolHandle< T > &handle, std::string toolTypeAndName="", bool createIf=true)
	Declare used public tool. More...

template<class T >
StatusCode	declarePrivateTool (ToolHandle< T > &handle, std::string toolTypeAndName="", bool createIf=true)
	Declare used private tool. More...

const std::vector< IAlgTool * > &	tools () const

IAuditorSvc *	auditorSvc () const
	Access the auditor service. More...

IMonitorSvc *	monitorSvc () const
	Access the monitor service. More...

template<class T >
void	declareInfo (const std::string &name, const T &var, const std::string &desc) const
	Declare monitoring information. More...

void	declareInfo (const std::string &name, const std::string &format, const void *var, int size, const std::string &desc) const
	Declare monitoring information (special case) More...

	~AlgTool () override

Public Member Functions inherited from PropertyHolder< CommonMessaging< implements< IAlgTool, IDataHandleHolder, IProperty, IStateful > > >
	PropertyHolder ()=default

	~PropertyHolder () override=default

Gaudi::Details::PropertyBase &	declareProperty (Gaudi::Details::PropertyBase &prop)
	Declare a property. More...

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. More...

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, TYPE &value, const std::string &doc="none") const

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. More...

Gaudi::Details::PropertyBase *	declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="")
	Declare a remote property. More...

StatusCode	setProperty (const Gaudi::Details::PropertyBase &p) override
	set the property form another property More...

StatusCode	setProperty (const std::string &s) override
	set the property from the formatted string More...

StatusCode	setProperty (const std::string &n, const std::string &v) override
	set the property from name and the value More...

StatusCode	setProperty (const std::string &name, const TYPE &value)
	set the property form the value More...

StatusCode	getProperty (Gaudi::Details::PropertyBase *p) const override
	get the property More...

const Gaudi::Details::PropertyBase &	getProperty (const std::string &name) const override
	get the property by name More...

StatusCode	getProperty (const std::string &n, std::string &v) const override
	convert the property to the string More...

const std::vector< Gaudi::Details::PropertyBase * > &	getProperties () const override
	get all properties More...

bool	hasProperty (const std::string &name) const override
	Return true if we have a property with the given name. More...

	PropertyHolder (const PropertyHolder &)=delete

PropertyHolder &	operator= (const PropertyHolder &)=delete

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ToolHandle< TYPE > &ref, const std::string &doc="none")
	Specializations for various GaudiHandles. More...

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ServiceHandle< TYPE > &ref, const std::string &doc="none")

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ToolHandleArray< TYPE > &ref, const std::string &doc="none")

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, ServiceHandleArray< TYPE > &ref, const std::string &doc="none")

Gaudi::Details::PropertyBase *	declareProperty (const std::string &name, DataObjectHandle< TYPE > &ref, const std::string &doc="none")

Public Member Functions inherited from CommonMessagingBase
virtual	~CommonMessagingBase ()=default
	Virtual destructor. More...

SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service. More...

MsgStream &	msgStream () const
	Return an uninitialized MsgStream. More...

MsgStream &	msgStream (const MSG::Level level) const
	Predefined configurable message stream for the efficient printouts. More...

MsgStream &	always () const
	shortcut for the method msgStream(MSG::ALWAYS) More...

MsgStream &	fatal () const
	shortcut for the method msgStream(MSG::FATAL) More...

MsgStream &	err () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	error () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	warning () const
	shortcut for the method msgStream(MSG::WARNING) More...

MsgStream &	info () const
	shortcut for the method msgStream(MSG::INFO) More...

MsgStream &	debug () const
	shortcut for the method msgStream(MSG::DEBUG) More...

MsgStream &	verbose () const
	shortcut for the method msgStream(MSG::VERBOSE) More...

MsgStream &	msg () const
	shortcut for the method msgStream(MSG::INFO) More...

MSG::Level	msgLevel () const
	get the output level from the embedded MsgStream More...

MSG::Level	outputLevel () const __attribute__((deprecated))
	Backward compatibility function for getting the output level. More...

bool	msgLevel (MSG::Level lvl) const
	get the output level from the embedded MsgStream More...

Protected Member Functions
template<typename I >
void	declareInterface (I *i)

virtual void	declareInput (Gaudi::DataHandle *im) override

virtual void	declareOutput (Gaudi::DataHandle *im) override

std::vector< IAlgTool * > &	tools ()

Protected Member Functions inherited from PropertyHolder< CommonMessaging< implements< IAlgTool, IDataHandleHolder, IProperty, IStateful > > >
Gaudi::Details::PropertyBase *	property (const std::string &name) const

Protected Member Functions inherited from CommonMessaging< implements< IAlgTool, IDataHandleHolder, IProperty, IStateful > >
void	updateMsgStreamOutputLevel (int level)
	Update the output level of the cached MsgStream. More...

Protected Attributes
std::unique_ptr< IDataHandleVisitor >	m_updateDataHandles
	Hook for for derived classes to provide a custom visitor for data handles. More...

Private Types
typedef std::list< std::pair< InterfaceID, void * > >	InterfaceList

Private Member Functions
void	initToolHandles () const

StatusCode	service_i (const std::string &algName, bool createIf, const InterfaceID &iid, void **ppSvc) const
	flag indicating whether ToolHandle tools have been added to m_tools More...

StatusCode	service_i (const std::string &svcType, const std::string &svcName, const InterfaceID &iid, void **ppS) const

Private Attributes
std::vector< Gaudi::DataHandle * >	m_inputHandles

std::vector< Gaudi::DataHandle * >	m_outputHandles

DataObjIDColl	m_inputDataObjs

DataObjIDColl	m_outputDataObjs

std::string	m_type
	AlgTool type (concrete class name) More...

const std::string	m_name
	AlgTool full name. More...

const IInterface *	m_parent = nullptr
	AlgTool parent. More...

SmartIF< ISvcLocator >	m_svcLocator
	Pointer to Service Locator service. More...

SmartIF< IDataProviderSvc >	m_evtSvc
	Event data service. More...

SmartIF< IToolSvc >	m_ptoolSvc
	Tool service. More...

SmartIF< IMonitorSvc >	m_pMonitorSvc
	Online Monitoring Service. More...

SmartIF< IAuditorSvc >	m_pAuditorSvc
	Auditor Service. More...

InterfaceList	m_interfaceList
	Interface list. More...

Gaudi::Property< int >	m_outputLevel {this, "OutputLevel", MSG::NIL, "output level"}

Gaudi::Property< std::string >	m_monitorSvcName

Gaudi::Property< bool >	m_auditInit {this, "AuditTools", false, "[[deprecated]] unused"}

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< DataObjIDColl >	m_extInputDataObjs {this, "ExtraInputs", DataObjIDColl{}, "[[deprecated]]"}

Gaudi::Property< DataObjIDColl >	m_extOutputDataObjs {this, "ExtraOutputs", DataObjIDColl{}, "[[deprecated]]"}

std::string	m_threadID
	Thread Id for Alg Tool. More...

std::vector< IAlgTool * >	m_tools

std::vector< BaseToolHandle * >	m_toolHandles

std::vector< GaudiHandleArrayBase * >	m_toolHandleArrays

bool	m_toolHandlesInit = false

Gaudi::StateMachine::State	m_state = Gaudi::StateMachine::CONFIGURED
	state of the Tool More...

Gaudi::StateMachine::State	m_targetState = Gaudi::StateMachine::CONFIGURED
	state of the Tool More...

Detailed Description

Base class from which all the concrete tool classes should be derived.

Specific methods for doing something useful should be implemented in the concrete tools. Sub-types of this class could implement an additional interface for behavior common to sets of concrete tools (for example vertexers).

Author: Gloria Corti; Pere Mato

Definition at line 46 of file AlgTool.h.

Member Typedef Documentation

typedef Gaudi::PluginService::Factory<IAlgTool*, const std::string&, const std::string&, const IInterface*> AlgTool::Factory

Definition at line 51 of file AlgTool.h.

typedef std::list<std::pair<InterfaceID, void*> > AlgTool::InterfaceList

private

Definition at line 339 of file AlgTool.h.

Constructor & Destructor Documentation

AlgTool::AlgTool	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent
	)

Standard Constructor.

Parameters

type	the concrete class of the sub-algtool
name	the full name of the concrete sub-algtool
parent	the parent of the concrete sub-algtool

Definition at line 139 of file AlgTool.cpp.

     : m_type( type ),
       m_name( name ),
       m_parent( parent )
 {
   addRef(); // Initial count set to 1
 
   IInterface* _p = const_cast<IInterface*>( parent );
 
   // inherit output level from parent
   { // get the "OutputLevel" property from parent
     SmartIF<IProperty> pprop( _p );
     if ( pprop && pprop->hasProperty( "OutputLevel" ) ) {
       m_outputLevel.assign( pprop->getProperty( "OutputLevel" ) );
     }
   }
   m_outputLevel.declareUpdateHandler(
       [this]( Gaudi::Details::PropertyBase& ) { this->updateMsgStreamOutputLevel( this->m_outputLevel ); } );
 
   if ( Algorithm* _alg = dynamic_cast<Algorithm*>( _p ) ) {
     m_svcLocator = _alg->serviceLocator();
     m_threadID   = getGaudiThreadIDfromName( _alg->name() );
   } else if ( Service* _svc = dynamic_cast<Service*>( _p ) ) {
     m_svcLocator = _svc->serviceLocator();
     m_threadID   = getGaudiThreadIDfromName( _svc->name() );
   } else if ( AlgTool* _too = dynamic_cast<AlgTool*>( _p ) ) {
     m_svcLocator = _too->serviceLocator();
     m_threadID   = getGaudiThreadIDfromName( _too->m_threadID );
   } else if ( Auditor* _aud = dynamic_cast<Auditor*>( _p ) ) {
     m_svcLocator = _aud->serviceLocator();
     m_threadID   = getGaudiThreadIDfromName( _aud->name() );
   } else {
     throw GaudiException( "Failure to create tool '" + type + "/" + name + "': illegal parent type '" +
                               System::typeinfoName( typeid( *_p ) ) + "'",
                           "AlgTool", 0 );
   }
 
   {
     // Auditor monitoring properties
     // Initialize the default value from ApplicationMgr AuditAlgorithms
     Gaudi::Property<bool> audit( false );
     // note that here we need that the service locator is already defined
     auto appMgr = serviceLocator()->service<IProperty>( "ApplicationMgr" );
     if ( appMgr && appMgr->hasProperty( "AuditTools" ) ) {
       audit.assign( appMgr->getProperty( "AuditTools" ) );
     }
     m_auditInit           = audit;
     m_auditorInitialize   = audit;
     m_auditorStart        = audit;
     m_auditorStop         = audit;
     m_auditorFinalize     = audit;
     m_auditorReinitialize = audit;
     m_auditorRestart      = audit;
   }
 
   // check thread ID and try if tool name indicates thread ID
   if ( m_threadID.empty() ) {
     m_threadID = getGaudiThreadIDfromName( AlgTool::name() );
   }
 }

AlgTool::~AlgTool ( )

override

Definition at line 382 of file AlgTool.cpp.

 {
   if ( m_pMonitorSvc ) {
     m_pMonitorSvc->undeclareAll( this );
   }
 }

Member Function Documentation

void AlgTool::acceptDHVisitor ( IDataHandleVisitor * vis ) const

overridevirtual

Definition at line 504 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
   vis->visit( this );
 
   for ( auto tool : tools() ) {
     AlgTool* at = dynamic_cast<AlgTool*>( tool );
     vis->visit( at );
   }
 }

IAuditorSvc * AlgTool::auditorSvc ( ) const

Access the auditor service.

Definition at line 491 of file AlgTool.cpp.

 {
   //---------------------------------------------------------------------------
   if ( !m_pAuditorSvc ) {
     m_pAuditorSvc = service( "AuditorSvc", true );
     if ( !m_pAuditorSvc ) {
       throw GaudiException( "Service [AuditorSvc] not found", name(), StatusCode::FAILURE );
     }
   }
   return m_pAuditorSvc.get();
 }

void AlgTool::commitHandles ( )

override

Definition at line 516 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
 
   for ( auto h : m_outputHandles ) {
     h->commit();
   }
 
   for ( auto t : m_tools ) {
     AlgTool* at = dynamic_cast<AlgTool*>( t );
     if ( at != 0 ) at->commitHandles();
   }
 }

StatusCode AlgTool::configure ( )

inlineoverride

Definition at line 67 of file AlgTool.h.

67 { return StatusCode::SUCCESS; }

StatusCode::SUCCESS

Definition: StatusCode.h:30

template<class T >

void AlgTool::declareInfo	(	const std::string &	name,
		const T &	var,
		const std::string &	desc
	)		const

inline

Declare monitoring information.

Parameters

name	Monitoring information name known to the external system
var	Monitoring Listener address (the item to monitor...)
desc	Textual description of the information being monitored

Definition at line 315 of file AlgTool.h.

   {
     IMonitorSvc* mS = monitorSvc();
     if ( mS ) mS->declareInfo( name, var, desc, this );
   }

void AlgTool::declareInfo	(	const std::string &	name,
		const std::string &	format,
		const void *	var,
		int	size,
		const std::string &	desc
	)		const

inline

Declare monitoring information (special case)

Parameters

name	Monitoring information name known to the external system
format	Format information
var	Monitoring Listener address
size	Monitoring Listener address size
desc	Textual description of the information being monitored

Definition at line 328 of file AlgTool.h.

   {
     IMonitorSvc* mS = monitorSvc();
     if ( mS ) mS->declareInfo( name, format, var, size, desc, this );
   }

virtual void AlgTool::declareInput ( Gaudi::DataHandle * im )

inlineoverrideprotectedvirtual

Definition at line 191 of file AlgTool.h.

191 { m_inputHandles.push_back( im ); }

std::vector::push_back

T push_back(T...args)

AlgTool::m_inputHandles

std::vector< Gaudi::DataHandle * > m_inputHandles

Definition: AlgTool.h:209

template<typename I >

void AlgTool::declareInterface ( I * i )

inlineprotected

Definition at line 153 of file AlgTool.h.

   {
     m_interfaceList.emplace_back( I::interfaceID(), i );
   }

virtual void AlgTool::declareOutput ( Gaudi::DataHandle * im )

inlineoverrideprotectedvirtual

Definition at line 193 of file AlgTool.h.

193 { m_outputHandles.push_back( im ); }

std::vector::push_back

T push_back(T...args)

AlgTool::m_outputHandles

std::vector< Gaudi::DataHandle * > m_outputHandles

Definition: AlgTool.h:209

template<class T >

StatusCode AlgTool::declarePrivateTool	(	ToolHandle< T > &	handle,
		std::string	toolTypeAndName = `""`,
		bool	createIf = `true`
	)

inline

Declare used private tool.

Parameters

handle	ToolHandle<T>
toolTypeAndName
parent,default	public tool
create	if necessary, default true

Definition at line 261 of file AlgTool.h.

   {
 
     if ( toolTypeAndName == "" ) toolTypeAndName = handle.typeAndName();
 
     StatusCode sc = handle.initialize( toolTypeAndName, this, createIf );
     if ( UNLIKELY( !sc ) ) {
       throw GaudiException{"Cannot create handle for private tool " + toolTypeAndName, name(), sc};
     }
 
     m_toolHandles.push_back( &handle );
 
     return sc;
   }

template<class T >

Gaudi::Details::PropertyBase* AlgTool::declareProperty	(	const std::string &	name,
		ToolHandle< T > &	hndl,
		const std::string &	doc = `"none"`
	)

inline

Definition at line 163 of file AlgTool.h.

   {
     this->declareTool( hndl ).ignore();
     return PropertyHolderImpl::declareProperty( name, hndl, doc );
   }

template<class T >

Gaudi::Details::PropertyBase* AlgTool::declareProperty	(	const std::string &	name,
		ToolHandleArray< T > &	hndlArr,
		const std::string &	doc = `"none"`
	)

inline

Definition at line 183 of file AlgTool.h.

   {
     m_toolHandleArrays.push_back( &hndlArr );
     return PropertyHolderImpl::declareProperty( name, hndlArr, doc );
   }

template<class T >

StatusCode AlgTool::declarePublicTool	(	ToolHandle< T > &	handle,
		std::string	toolTypeAndName = `""`,
		bool	createIf = `true`
	)

inline

Declare used public tool.

Parameters

handle	ToolHandle<T>
toolTypeAndName
parent,default	public tool
create	if necessary, default true

Definition at line 238 of file AlgTool.h.

   {
 
     if ( toolTypeAndName == "" ) toolTypeAndName = handle.typeAndName();
 
     StatusCode sc = handle.initialize( toolTypeAndName, 0, createIf );
     if ( UNLIKELY( !sc ) ) {
       throw GaudiException{"Cannot create handle for public tool " + toolTypeAndName, name(), sc};
     }
 
     m_toolHandles.push_back( &handle );
 
     return sc;
   }

template<class T >

StatusCode AlgTool::declareTool	(	ToolHandle< T > &	handle,
		std::string	toolTypeAndName = `""`,
		bool	createIf = `true`
	)

inline

Definition at line 171 of file AlgTool.h.

   {
     if ( handle.isPublic() ) {
       return declarePublicTool( handle, toolTypeAndName, createIf );
     } else {
       return declarePrivateTool( handle, toolTypeAndName, createIf );
     }
   }

void AlgTool::deregisterTool ( IAlgTool * tool ) const

inline

Definition at line 219 of file AlgTool.h.

   {
     auto it = std::find( m_tools.begin(), m_tools.end(), tool );
     if ( it != m_tools.end() ) {
       if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) debug() << "De-Registering tool " << tool->name() << endmsg;
       m_tools.erase( it );
     } else {
       if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) debug() << "Could not de-register tool " << tool->name() << endmsg;
     }
   }

IDataProviderSvc * AlgTool::evtSvc ( ) const

accessor to event service service

Returns: pointer to detector service

Definition at line 93 of file AlgTool.cpp.

 {
   if ( !m_evtSvc ) {
     m_evtSvc = service( "EventDataSvc", true );
     if ( !m_evtSvc ) {
       throw GaudiException( "Service [EventDataSvc] not found", name(), StatusCode::FAILURE );
     }
   }
   return m_evtSvc.get();
 }

virtual const DataObjIDColl& AlgTool::extraInputDeps ( ) const

inlineoverridevirtual

Definition at line 198 of file AlgTool.h.

198 { return m_extInputDataObjs; }

AlgTool::m_extInputDataObjs

Gaudi::Property< DataObjIDColl > m_extInputDataObjs

Definition: AlgTool.h:367

virtual const DataObjIDColl& AlgTool::extraOutputDeps ( ) const

inlineoverridevirtual

Definition at line 199 of file AlgTool.h.

199 { return m_extOutputDataObjs; }

AlgTool::m_extOutputDataObjs

Gaudi::Property< DataObjIDColl > m_extOutputDataObjs

Definition: AlgTool.h:368

StatusCode AlgTool::finalize ( )

override

Definition at line 294 of file AlgTool.cpp.

 {
   // For the time being there is nothing to be done here.
   return StatusCode::SUCCESS;
 }

Gaudi::StateMachine::State AlgTool::FSMState ( ) const

inlineoverride

Definition at line 75 of file AlgTool.h.

75 { return m_state; }

AlgTool::m_state

Gaudi::StateMachine::State m_state

state of the Tool

Definition: AlgTool.h:383

StatusCode AlgTool::initialize ( )

override

Definition at line 224 of file AlgTool.cpp.

 {
   // For the time being there is nothing to be done here.
   // Setting the properties is done by the ToolSvc calling setProperties()
   // explicitly.
   return StatusCode::SUCCESS;
 }

void AlgTool::initToolHandles ( ) const

private

Definition at line 390 of file AlgTool.cpp.

 {
 
   IAlgTool* tool( 0 );
   for ( auto thArr : m_toolHandleArrays ) {
     if ( !thArr->retrieved() ) {
       if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) )
         debug() << "ToolHandleArray " << thArr->propertyName() << " not used: not registering any of its Tools"
                 << endmsg;
     } else {
       if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) )
         debug() << "Registering all Tools in ToolHandleArray " << thArr->propertyName() << endmsg;
       // Iterate over its tools:
       for ( auto toolHandle : thArr->getBaseArray() ) {
         // Try to cast it into a BaseToolHandle pointer:
         BaseToolHandle* bth = dynamic_cast<BaseToolHandle*>( toolHandle );
         if ( bth ) {
           // If the cast was successful, the code is pretty simple:
           tool = bth->get();
           if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) {
             debug() << "Adding " << ( bth->isPublic() ? "public" : "private" ) << " ToolHandle tool " << tool->name()
                     << " (" << tool->type() << ") from ToolHandleArray " << thArr->propertyName() << endmsg;
           }
           m_tools.push_back( tool );
         } else {
           // If it wasn't for some strange reason, then fall back on the
           // logic implemented previously:
           if ( toolSvc()->retrieveTool( toolHandle->typeAndName(), tool, this, false ).isSuccess() ) {
             if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) {
               debug() << "Adding private"
                       << " ToolHandle tool " << tool->name() << " (" << tool->type() << ") from ToolHandleArray "
                       << thArr->propertyName() << endmsg;
             }
             m_tools.push_back( tool );
           } else if ( toolSvc()->retrieveTool( toolHandle->typeAndName(), tool, 0, false ).isSuccess() ) {
             if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) {
               debug() << "Adding public"
                       << " ToolHandle tool " << tool->name() << " (" << tool->type() << ") from ToolHandleArray "
                       << thArr->propertyName() << endmsg;
             }
             m_tools.push_back( tool );
           } else {
             warning() << "Error retrieving Tool " << toolHandle->typeAndName() << " in ToolHandleArray "
                       << thArr->propertyName() << ". Not registered" << endmsg;
           }
         }
       }
     }
   }
 
   for ( auto th : m_toolHandles ) {
     tool = th->get();
     if ( tool ) {
       m_tools.push_back( tool );
       if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) )
         debug() << "Adding " << ( th->isPublic() ? "Public" : "Private" ) << " ToolHandle tool " << tool->name() << " ("
                 << tool->type() << ")" << endmsg;
     } else {
       if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) debug() << "ToolHandle " << th->typeAndName() << " not used" << endmsg;
     }
   }
   m_toolHandlesInit = true;
 }

const DataObjIDColl& AlgTool::inputDataObjs ( ) const

inlineoverride

Definition at line 203 of file AlgTool.h.

203 { return m_inputDataObjs; }

AlgTool::m_inputDataObjs

DataObjIDColl m_inputDataObjs

Definition: AlgTool.h:210

virtual std::vector<Gaudi::DataHandle*> AlgTool::inputHandles ( ) const

inlineoverridevirtual

Definition at line 195 of file AlgTool.h.

195 { return m_inputHandles; }

AlgTool::m_inputHandles

std::vector< Gaudi::DataHandle * > m_inputHandles

Definition: AlgTool.h:209

IMonitorSvc* AlgTool::monitorSvc ( ) const

inline

Access the monitor service.

Attention: Note that this method will return a NULL pointer if no monitor service is configured to be present. You must take this possibility into account when using the pointer

Returns: Pointer to the Monitor service

Return values

NULL	No monitor service is present
non-NULL	A monitor service is present and available to be used

Definition at line 302 of file AlgTool.h.

   {
     // If not already located try to locate it without forcing a creation
     if ( !m_pMonitorSvc ) m_pMonitorSvc = service( m_monitorSvcName, false, true );
     return m_pMonitorSvc.get();
   }

const std::string & AlgTool::name ( ) const

override

Retrieve full identifying name of the concrete tool object.

Definition at line 63 of file AlgTool.cpp.

 {
   return m_name;
 }

const DataObjIDColl& AlgTool::outputDataObjs ( ) const

inlineoverride

Definition at line 204 of file AlgTool.h.

204 { return m_outputDataObjs; }

AlgTool::m_outputDataObjs

DataObjIDColl m_outputDataObjs

Definition: AlgTool.h:210

virtual std::vector<Gaudi::DataHandle*> AlgTool::outputHandles ( ) const

inlineoverridevirtual

Definition at line 196 of file AlgTool.h.

196 { return m_outputHandles; }

AlgTool::m_outputHandles

std::vector< Gaudi::DataHandle * > m_outputHandles

Definition: AlgTool.h:209

const IInterface * AlgTool::parent ( ) const

override

Retrieve parent of the sub-algtool.

Definition at line 77 of file AlgTool.cpp.

 {
   return m_parent;
 }

StatusCode AlgTool::queryInterface	(	const InterfaceID &	riid,
		void **	ppvUnknown
	)

override

Query for a given interface.

Definition at line 44 of file AlgTool.cpp.

 {
   if ( !ppvi ) {
     return StatusCode::FAILURE;
   } // RETURN
   StatusCode sc = base_class::queryInterface( riid, ppvi );
   if ( sc.isSuccess() ) return sc;
   auto i = std::find_if( std::begin( m_interfaceList ), std::end( m_interfaceList ),
                          [&]( const std::pair<InterfaceID, void*>& item ) { return item.first.versionMatch( riid ); } );
   if ( i == std::end( m_interfaceList ) ) {
     *ppvi = nullptr;
     return NO_INTERFACE; // RETURN
   }
   *ppvi = i->second;
   addRef();
   return SUCCESS; // RETURN
 }

void AlgTool::registerTool ( IAlgTool * tool ) const

inline

Definition at line 213 of file AlgTool.h.

   {
     if ( UNLIKELY( msgLevel( MSG::DEBUG ) ) ) debug() << "Registering tool " << tool->name() << endmsg;
     m_tools.push_back( tool );
   }

StatusCode AlgTool::reinitialize ( )

override

Definition at line 321 of file AlgTool.cpp.

 {
   /* @TODO
    * MCl 2008-10-23: the implementation of reinitialize as finalize+initialize
    *                 is causing too many problems
    *
   // Default implementation is finalize+initialize
   StatusCode sc = finalize();
   if (sc.isFailure()) {
     error() << "reinitialize(): cannot be finalized" << endmsg;
     return sc;
   }
   sc = initialize();
   if (sc.isFailure()) {
     error() << "reinitialize(): cannot be initialized" << endmsg;
     return sc;
   }
   */
   return StatusCode::SUCCESS;
 }

StatusCode AlgTool::restart ( )

override

Definition at line 364 of file AlgTool.cpp.

 {
   // Default implementation is stop+start
   StatusCode sc = stop();
   if ( sc.isFailure() ) {
     error() << "restart(): cannot be stopped" << endmsg;
     return sc;
   }
   sc = start();
   if ( sc.isFailure() ) {
     error() << "restart(): cannot be started" << endmsg;
     return sc;
   }
   return StatusCode::SUCCESS;
 }

template<class T >

StatusCode AlgTool::service	(	const std::string &	name,
		T *&	svc,
		bool	createIf = `true`
	)		const

inline

Access a service by name, creating it if it doesn't already exist.

Definition at line 129 of file AlgTool.h.

   {
     return service_i( name, createIf, T::interfaceID(), (void**)&svc );
   }

template<class T >

StatusCode AlgTool::service	(	const std::string &	type,
		const std::string &	name,
		T *&	svc
	)		const

inline

Access a service by name, type creating it if it doesn't already exist.

Definition at line 137 of file AlgTool.h.

   {
     return service_i( type, name, T::interfaceID(), (void**)&svc );
   }

SmartIF< IService > AlgTool::service	(	const std::string &	name,
		const bool	createIf = `true`,
		const bool	quiet = `false`
	)		const

Return a pointer to the service identified by name (or "type/name")

Definition at line 484 of file AlgTool.cpp.

 {
   const ServiceLocatorHelper helper( *serviceLocator(), *this );
   return helper.service( name, quiet, createIf );
 }

template<typename T >

SmartIF<T> AlgTool::service	(	const std::string &	name,
		const bool	createIf = `true`,
		const bool	quiet = `false`
	)		const

inline

Definition at line 146 of file AlgTool.h.

   {
     return SmartIF<T>( service( name, createIf, quiet ) );
   }

StatusCode AlgTool::service_i	(	const std::string &	algName,
		bool	createIf,
		const InterfaceID &	iid,
		void **	ppSvc
	)		const

private

flag indicating whether ToolHandle tools have been added to m_tools

implementation of service method

Definition at line 470 of file AlgTool.cpp.

 {
   const ServiceLocatorHelper helper( *serviceLocator(), *this );
   return helper.getService( svcName, createIf, iid, ppSvc );
 }

StatusCode AlgTool::service_i	(	const std::string &	svcType,
		const std::string &	svcName,
		const InterfaceID &	iid,
		void **	ppS
	)		const

private

Definition at line 477 of file AlgTool.cpp.

 {
   const ServiceLocatorHelper helper( *serviceLocator(), *this );
   return helper.createService( svcType, svcName, iid, ppSvc );
 }

SmartIF< ISvcLocator > & AlgTool::serviceLocator ( ) const

override

Retrieve pointer to service locator.

Definition at line 84 of file AlgTool.cpp.

 {
   return m_svcLocator;
 }

StatusCode AlgTool::setProperties ( )

Method for setting declared properties to the values specified in the jobOptions via the job option service.

This method is called by the ToolSvc after creating the concrete tool, before passing it to the requesting parent and does not need to be called explicitly.

Definition at line 117 of file AlgTool.cpp.

 {
   if ( !m_svcLocator ) return StatusCode::FAILURE;
   auto jos = m_svcLocator->service<IJobOptionsSvc>( "JobOptionsSvc" );
   if ( !jos ) return StatusCode::FAILURE;
 
   // set first generic Properties
   StatusCode sc = jos->setMyProperties( getGaudiThreadGenericName( name() ), this );
   if ( sc.isFailure() ) return StatusCode::FAILURE;
 
   // set specific Properties
   if ( isGaudiThreaded( name() ) ) {
     if ( jos->setMyProperties( name(), this ).isFailure() ) {
       return StatusCode::FAILURE;
     }
   }
   updateMsgStreamOutputLevel( m_outputLevel );
   return StatusCode::SUCCESS;
 }

StatusCode AlgTool::start ( )

override

Definition at line 249 of file AlgTool.cpp.

 {
   // For the time being there is nothing to be done here.
   return StatusCode::SUCCESS;
 }

StatusCode AlgTool::stop ( )

override

Definition at line 272 of file AlgTool.cpp.

 {
   // For the time being there is nothing to be done here.
   return StatusCode::SUCCESS;
 }

ISvcLocator* AlgTool::svcLoc ( ) const

inline

shortcut for the method service locator

Definition at line 108 of file AlgTool.h.

108 { return serviceLocator(); }

AlgTool::serviceLocator

SmartIF< ISvcLocator > & serviceLocator() const override

Retrieve pointer to service locator.

Definition: AlgTool.cpp:84

StatusCode AlgTool::sysFinalize ( )

override

Finalize AlgTool.

Definition at line 280 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
   return attempt( *this, "sysFinalize", [&]() {
     m_targetState = Gaudi::StateMachine::ChangeState( Gaudi::StateMachine::FINALIZE, m_state );
     Gaudi::Guards::AuditorGuard guard( this,
                                        // check if we want to audit the initialize
                                        m_auditorFinalize ? auditorSvc() : nullptr, IAuditor::Finalize );
     StatusCode sc                 = finalize();
     if ( sc.isSuccess() ) m_state = m_targetState;
     return sc;
   } );
 }

StatusCode AlgTool::sysInitialize ( )

override

Initialize AlgTool.

Definition at line 202 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
   return attempt( *this, "sysInitialize", [&]() {
     m_targetState = Gaudi::StateMachine::ChangeState( Gaudi::StateMachine::INITIALIZE, m_state );
     Gaudi::Guards::AuditorGuard guard( this,
                                        // check if we want to audit the initialize
                                        m_auditorInitialize ? auditorSvc() : nullptr, IAuditor::Initialize );
     StatusCode sc = initialize();
     if ( !sc ) return sc;
 
     m_state = m_targetState;
     if (m_updateDataHandles) acceptDHVisitor(m_updateDataHandles.get());
 
     // visit all sub-tools, build full set
     DHHVisitor avis(m_inputDataObjs, m_outputDataObjs);
     acceptDHVisitor(&avis);
 
     return sc;
   } );
 }

StatusCode AlgTool::sysReinitialize ( )

override

Initialize AlgTool.

Definition at line 302 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
 
   // Check that the current status is the correct one.
   if ( Gaudi::StateMachine::INITIALIZED != FSMState() ) {
     error() << "sysReinitialize(): cannot reinitialize tool not initialized" << endmsg;
     return StatusCode::FAILURE;
   }
 
   return attempt( *this, "SysReinitialize()", [&]() {
     Gaudi::Guards::AuditorGuard guard( this,
                                        // check if we want to audit the initialize
                                        m_auditorReinitialize ? auditorSvc() : nullptr, IAuditor::ReInitialize );
     return reinitialize();
   } );
 }

StatusCode AlgTool::sysRestart ( )

override

Start AlgTool.

Definition at line 344 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
 
   // Check that the current status is the correct one.
   if ( Gaudi::StateMachine::RUNNING != FSMState() ) {
     error() << "sysRestart(): cannot reinitialize tool not started" << endmsg;
     return StatusCode::FAILURE;
   }
 
   return attempt( *this, "sysRestart", [&]() {
     m_targetState = Gaudi::StateMachine::ChangeState( Gaudi::StateMachine::START, m_state );
     Gaudi::Guards::AuditorGuard guard( this,
                                        // check if we want to audit the initialize
                                        m_auditorRestart ? auditorSvc() : nullptr, IAuditor::ReStart );
     return restart();
   } );
 }

StatusCode AlgTool::sysStart ( )

override

Start AlgTool.

Definition at line 234 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
   return attempt( *this, "sysStart", [&]() {
     m_targetState = Gaudi::StateMachine::ChangeState( Gaudi::StateMachine::START, m_state );
     Gaudi::Guards::AuditorGuard guard( this,
                                        // check if we want to audit the initialize
                                        m_auditorStart ? auditorSvc() : nullptr, IAuditor::Start );
     StatusCode sc                 = start();
     if ( sc.isSuccess() ) m_state = m_targetState;
     return sc;
   } );
 }

StatusCode AlgTool::sysStop ( )

override

Stop AlgTool.

Definition at line 257 of file AlgTool.cpp.

 {
   //-----------------------------------------------------------------------------
   return attempt( *this, "sysStop", [&]() {
     m_targetState = Gaudi::StateMachine::ChangeState( Gaudi::StateMachine::STOP, m_state );
     Gaudi::Guards::AuditorGuard guard( this,
                                        // check if we want to audit the initialize
                                        m_auditorStop ? auditorSvc() : nullptr, IAuditor::Stop );
     StatusCode sc                 = stop();
     if ( sc.isSuccess() ) m_state = m_targetState;
     return sc;
   } );
 }

Gaudi::StateMachine::State AlgTool::targetFSMState ( ) const

inlineoverride

Definition at line 76 of file AlgTool.h.

76 { return m_targetState; }

AlgTool::m_targetState

Gaudi::StateMachine::State m_targetState

state of the Tool

Definition: AlgTool.h:384

StatusCode AlgTool::terminate ( )

inlineoverride

Definition at line 72 of file AlgTool.h.

72 { return StatusCode::SUCCESS; }

StatusCode::SUCCESS

Definition: StatusCode.h:30

const std::vector< IAlgTool * > & AlgTool::tools ( ) const

Definition at line 454 of file AlgTool.cpp.

 {
   if ( UNLIKELY( !m_toolHandlesInit ) ) initToolHandles();
 
   return m_tools;
 }

std::vector< IAlgTool * > & AlgTool::tools ( )

protected

Definition at line 461 of file AlgTool.cpp.

 {
   if ( UNLIKELY( !m_toolHandlesInit ) ) initToolHandles();
 
   return m_tools;
 }

IToolSvc * AlgTool::toolSvc ( ) const

The standard ToolSvc service, Return a pointer to the service if present.

Definition at line 104 of file AlgTool.cpp.

 {
   if ( !m_ptoolSvc ) {
     m_ptoolSvc = service( "ToolSvc", true );
     if ( !m_ptoolSvc ) {
       throw GaudiException( "Service [ToolSvc] not found", name(), StatusCode::FAILURE );
     }
   }
   return m_ptoolSvc.get();
 }

const std::string & AlgTool::type ( ) const

override

Retrieve type (concrete class) of the sub-algtool.

Definition at line 70 of file AlgTool.cpp.

 {
   return m_type;
 }

Member Data Documentation

Gaudi::Property<bool> AlgTool::m_auditInit {this, "AuditTools", false, "[[deprecated]] unused"}

private

Definition at line 359 of file AlgTool.h.

Gaudi::Property<bool> AlgTool::m_auditorFinalize {this, "AuditFinalize", false, "trigger auditor on finalize()"}

private

Definition at line 363 of file AlgTool.h.

Gaudi::Property<bool> AlgTool::m_auditorInitialize {this, "AuditInitialize", false, "trigger auditor on initialize()"}

private

Definition at line 360 of file AlgTool.h.

Gaudi::Property<bool> AlgTool::m_auditorReinitialize {this, "AuditReinitialize", false, "trigger auditor on reinitialize()"}

private

Definition at line 364 of file AlgTool.h.

Gaudi::Property<bool> AlgTool::m_auditorRestart {this, "AuditRestart", false, "trigger auditor on restart()"}

private

Definition at line 365 of file AlgTool.h.

Gaudi::Property<bool> AlgTool::m_auditorStart {this, "AuditStart", false, "trigger auditor on start()"}

private

Definition at line 361 of file AlgTool.h.

Gaudi::Property<bool> AlgTool::m_auditorStop {this, "AuditStop", false, "trigger auditor on stop()"}

private

Definition at line 362 of file AlgTool.h.

SmartIF<IDataProviderSvc> AlgTool::m_evtSvc

mutableprivate

Event data service.

Definition at line 346 of file AlgTool.h.

Gaudi::Property<DataObjIDColl> AlgTool::m_extInputDataObjs {this, "ExtraInputs", DataObjIDColl{}, "[[deprecated]]"}

private

Definition at line 367 of file AlgTool.h.

Gaudi::Property<DataObjIDColl> AlgTool::m_extOutputDataObjs {this, "ExtraOutputs", DataObjIDColl{}, "[[deprecated]]"}

private

Definition at line 368 of file AlgTool.h.

DataObjIDColl AlgTool::m_inputDataObjs

private

Definition at line 210 of file AlgTool.h.

std::vector<Gaudi::DataHandle *> AlgTool::m_inputHandles

private

Definition at line 209 of file AlgTool.h.

InterfaceList AlgTool::m_interfaceList

private

Interface list.

Definition at line 351 of file AlgTool.h.

Gaudi::Property<std::string> AlgTool::m_monitorSvcName

private

Initial value:

{this, "MonitorService", "MonitorSvc",

"name to use for Monitor Service"}

Definition at line 356 of file AlgTool.h.

const std::string AlgTool::m_name

private

AlgTool full name.

Definition at line 342 of file AlgTool.h.

DataObjIDColl AlgTool::m_outputDataObjs

private

Definition at line 210 of file AlgTool.h.

std::vector<Gaudi::DataHandle *> AlgTool::m_outputHandles

private

Definition at line 209 of file AlgTool.h.

Gaudi::Property<int> AlgTool::m_outputLevel {this, "OutputLevel", MSG::NIL, "output level"}

private

Definition at line 354 of file AlgTool.h.

const IInterface* AlgTool::m_parent = nullptr

private

AlgTool parent.

Definition at line 343 of file AlgTool.h.

SmartIF<IAuditorSvc> AlgTool::m_pAuditorSvc

mutableprivate

Auditor Service.

Definition at line 349 of file AlgTool.h.

SmartIF<IMonitorSvc> AlgTool::m_pMonitorSvc

mutableprivate

Online Monitoring Service.

Definition at line 348 of file AlgTool.h.

SmartIF<IToolSvc> AlgTool::m_ptoolSvc

mutableprivate

Tool service.

Definition at line 347 of file AlgTool.h.

Gaudi::StateMachine::State AlgTool::m_state = Gaudi::StateMachine::CONFIGURED

private

state of the Tool

Definition at line 383 of file AlgTool.h.

SmartIF<ISvcLocator> AlgTool::m_svcLocator

mutableprivate

Pointer to Service Locator service.

Definition at line 345 of file AlgTool.h.

Gaudi::StateMachine::State AlgTool::m_targetState = Gaudi::StateMachine::CONFIGURED

private

state of the Tool

Definition at line 384 of file AlgTool.h.

std::string AlgTool::m_threadID

private

Thread Id for Alg Tool.

Definition at line 370 of file AlgTool.h.

std::vector<GaudiHandleArrayBase*> AlgTool::m_toolHandleArrays

mutableprivate

Definition at line 375 of file AlgTool.h.

std::vector<BaseToolHandle*> AlgTool::m_toolHandles

mutableprivate

Definition at line 374 of file AlgTool.h.

bool AlgTool::m_toolHandlesInit = false

mutableprivate

Definition at line 376 of file AlgTool.h.

std::vector<IAlgTool*> AlgTool::m_tools

mutableprivate

Definition at line 373 of file AlgTool.h.

std::string AlgTool::m_type

private

AlgTool type (concrete class name)

Definition at line 341 of file AlgTool.h.

std::unique_ptr<IDataHandleVisitor> AlgTool::m_updateDataHandles

protected

Hook for for derived classes to provide a custom visitor for data handles.

Definition at line 282 of file AlgTool.h.

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

GaudiKernel/GaudiKernel/AlgTool.h
GaudiKernel/src/Lib/AlgTool.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation