This service manages tools. More...

#include <src/ApplicationMgr/ToolSvc.h>

Inheritance diagram for ToolSvc:

Collaboration diagram for ToolSvc:

Public Types
typedef std::list< IAlgTool * >	ListTools

Public Types inherited from extends1< Service, IToolSvc >
typedef extends1	base_class
	Typedef to this class. More...

typedef extends1	base_class
	Typedef to this class. More...

typedef extend_interfaces1< IToolSvc >	extend_interfaces_base
	Typedef to the base of this class. More...

typedef extend_interfaces1< IToolSvc >	extend_interfaces_base
	Typedef to the base of this class. More...

typedef extend_interfaces_base::ext_iids	interfaces
	MPL set of all the implemented interfaces. More...

typedef extend_interfaces_base::ext_iids	interfaces
	MPL set of all the implemented interfaces. More...

Public Types inherited from Service
typedef Gaudi::PluginService::Factory< IService , const std::string &, ISvcLocator >	Factory

typedef Gaudi::PluginService::Factory< IService , const std::string &, ISvcLocator >	Factory

Public Types inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
typedef CommonMessaging	base_class

typedef CommonMessaging	base_class

Public Types inherited from implements3< IService, IProperty, IStateful >
typedef implements3	base_class
	Typedef to this class. More...

typedef implements3	base_class
	Typedef to this class. More...

typedef extend_interfaces3< IService, IProperty, IStateful >	extend_interfaces_base
	Typedef to the base of this class. More...

typedef extend_interfaces3< IService, IProperty, IStateful >	extend_interfaces_base
	Typedef to the base of this class. More...

typedef extend_interfaces_base::ext_iids	interfaces
	MPL set of all the implemented interfaces. More...

typedef extend_interfaces_base::ext_iids	interfaces
	MPL set of all the implemented interfaces. More...

Public Types inherited from extend_interfaces3< IService, IProperty, IStateful >
typedef mpl::fold< typename IService::iid::iids::type, typename mpl::fold< typename IProperty::iid::iids::type, typename IStateful::iid::iids::type, mpl::insert< mpl::_1, mpl::_2 > >::type, mpl::insert< mpl::_1, mpl::_2 > >::type	ext_iids
	MPL set of interfaces extended by this one. More...

typedef mpl::fold< typename IService::iid::iids::type, typename mpl::fold< typename IProperty::iid::iids::type, typename IStateful::iid::iids::type, mpl::insert< mpl::_1, mpl::_2 > >::type, mpl::insert< mpl::_1, mpl::_2 > >::type	ext_iids
	MPL set of interfaces extended by this one. More...

Public Types inherited from IInterface
enum	Status { SUCCESS = 1, NO_INTERFACE, VERSMISMATCH, LAST_ERROR, SUCCESS = 1, NO_INTERFACE, VERSMISMATCH, LAST_ERROR }
	Return status. More...

enum	Status { SUCCESS = 1, NO_INTERFACE, VERSMISMATCH, LAST_ERROR, SUCCESS = 1, NO_INTERFACE, VERSMISMATCH, LAST_ERROR }
	Return status. More...

typedef Gaudi::InterfaceId< IInterface, 0, 0 >	iid
	Interface ID. More...

typedef mpl::set1< iid >	ext_iids
	Extra interfaces. More...

typedef Gaudi::InterfaceId< IInterface, 0, 0 >	iid
	Interface ID. More...

typedef mpl::set1< iid >	ext_iids
	Extra interfaces. More...

Public Types inherited from extend_interfaces1< IToolSvc >
typedef IToolSvc::iid::iids::type	ext_iids
	MPL set of interfaces extended by this one. More...

typedef IToolSvc::iid::iids::type	ext_iids
	MPL set of interfaces extended by this one. More...

Public Member Functions
virtual StatusCode	initialize ()
	Initialize the service. More...

virtual StatusCode	finalize ()
	Finalize the service. More...

virtual StatusCode	start ()
	Start (from INITIALIZED to RUNNING). More...

virtual StatusCode	stop ()
	Stop (from RUNNING to INITIALIZED). More...

virtual StatusCode	retrieve (const std::string &type, const InterfaceID &iid, IAlgTool &tool, const IInterface parent, bool createIf)
	Retrieve tool, create it by default as common tool if it does not already exist. More...

virtual StatusCode	retrieve (const std::string &tooltype, const std::string &toolname, const InterfaceID &iid, IAlgTool &tool, const IInterface parent, bool createIf)
	Retrieve tool, create it by default as common tool if it does not already exist. More...

virtual std::vector< std::string >	getInstances (const std::string &toolType)
	Get names of all tool instances of a given type. More...

virtual std::vector< std::string >	getInstances () const
	Get names of all tool instances. More...

virtual std::vector< IAlgTool * >	getTools () const
	Get pointers to all tool instances. More...

virtual StatusCode	releaseTool (IAlgTool *tool)
	Release tool. More...

StatusCode	create (const std::string &type, const IInterface parent, IAlgTool &tool)
	Create Tool standard way with automatically assigned name. More...

StatusCode	create (const std::string &type, const std::string &name, const IInterface parent, IAlgTool &tool)
	Create Tool standard way with specified name. More...

bool	existsTool (const std::string &toolname) const
	Check if the tool instance exists. More...

std::string	nameTool (const std::string &nameByUser, const IInterface *parent)
	Get Tool full name by combining nameByUser and "parent" part. More...

unsigned long	refCountTool (IAlgTool *tool) const
	Get current refcount for tool. More...

	ToolSvc (const std::string &name, ISvcLocator *svc)
	Standard Constructor. More...

virtual	~ToolSvc ()
	Destructor. More...

virtual void	registerObserver (IToolSvc::Observer *obs)

virtual void	unRegisterObserver (IToolSvc::Observer *obs)

Public Member Functions inherited from extends1< Service, IToolSvc >
	extends1 (A1 a1, A2 a2, A3 a3)
	Templated constructor with 3 arguments. More...

	extends1 (A1 a1, A2 a2)
	Templated constructor with 2 arguments. More...

	extends1 (A1 a1)
	Templated constructor with 1 argument. More...

	extends1 ()
	Default constructor. More...

	extends1 (A1 a1, A2 a2, A3 a3)
	Templated constructor with 3 arguments. More...

	extends1 (A1 a1, A2 a2)
	Templated constructor with 2 arguments. More...

	extends1 (A1 a1)
	Templated constructor with 1 argument. More...

	extends1 ()
	Default constructor. More...

virtual void *	i_cast (const InterfaceID &tid) const
	Implementation of IInterface::i_cast. More...

virtual void *	i_cast (const InterfaceID &tid) const
	Implementation of IInterface::i_cast. More...

virtual StatusCode	queryInterface (const InterfaceID &ti, void **pp)
	Implementation of IInterface::queryInterface. More...

virtual StatusCode	queryInterface (const InterfaceID &ti, void **pp)
	Implementation of IInterface::queryInterface. More...

virtual std::vector< std::string >	getInterfaceNames () const
	Implementation of IInterface::getInterfaceNames. More...

virtual std::vector< std::string >	getInterfaceNames () const
	Implementation of IInterface::getInterfaceNames. More...

virtual	~extends1 ()
	Virtual destructor. More...

virtual	~extends1 ()
	Virtual destructor. More...

Public Member Functions inherited from Service
virtual unsigned long	release ()
	Release Interface instance. More...

virtual const std::string &	name () const
	Retrieve name of the service. More...

virtual StatusCode	configure ()
	Configuration (from OFFLINE to CONFIGURED). More...

virtual StatusCode	terminate ()
	Initialization (from CONFIGURED to OFFLINE). More...

virtual Gaudi::StateMachine::State	FSMState () const
	Get the current state. More...

virtual Gaudi::StateMachine::State	targetFSMState () const
	When we are in the middle of a transition, get the state where the transition is leading us. More...

virtual StatusCode	reinitialize ()
	Initialization (from INITIALIZED or RUNNING to INITIALIZED, via CONFIGURED). More...

virtual StatusCode	restart ()
	Initialization (from RUNNING to RUNNING, via INITIALIZED). More...

virtual StatusCode	sysInitialize ()
	Initialize Service. More...

virtual StatusCode	sysStart ()
	Initialize Service. More...

virtual StatusCode	sysStop ()
	Initialize Service. More...

virtual StatusCode	sysFinalize ()
	Finalize Service. More...

virtual StatusCode	sysReinitialize ()
	Re-initialize the Service. More...

virtual StatusCode	sysRestart ()
	Re-initialize the Service. More...

virtual StatusCode	setProperty (const Property &p)
	Set the property by property. More...

virtual StatusCode	setProperty (const std::string &s)
	Set the property by string. More...

virtual StatusCode	setProperty (const std::string &n, const std::string &v)
	Set the property by std::string. More...

virtual StatusCode	getProperty (Property *p) const
	Get the property by property. More...

virtual const Property &	getProperty (const std::string &name) const
	Get the property by name. More...

virtual StatusCode	getProperty (const std::string &n, std::string &v) const
	Get the property by std::string. More...

virtual const std::vector< Property * > &	getProperties () const
	Get list of properties. More...

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

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

	Service (const std::string &name, ISvcLocator *svcloc)
	Standard Constructor. More...

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

StatusCode	setProperties ()
	Method for setting declared properties to the values specified for the job. More...

template<class T >
StatusCode	service (const std::string &name, const T *&psvc, 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 &name, T *&psvc, bool createIf=true) const

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

template<class T >
Property *	declareProperty (const std::string &name, T &property, const std::string &doc="none") const
	Declare the named property. More...

Property *	declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="") const
	Declare remote named properties. More...

SmartIF< IAuditorSvc > &	auditorSvc () const
	The standard auditor service.May not be invoked before sysInitialize() has been invoked. More...

virtual unsigned long	release ()
	Release Interface instance. More...

virtual const std::string &	name () const
	Retrieve name of the service. More...

virtual StatusCode	configure ()
	Configuration (from OFFLINE to CONFIGURED). More...

virtual StatusCode	terminate ()
	Initialization (from CONFIGURED to OFFLINE). More...

virtual Gaudi::StateMachine::State	FSMState () const
	Get the current state. More...

virtual Gaudi::StateMachine::State	targetFSMState () const
	When we are in the middle of a transition, get the state where the transition is leading us. More...

virtual StatusCode	reinitialize ()
	Initialization (from INITIALIZED or RUNNING to INITIALIZED, via CONFIGURED). More...

virtual StatusCode	restart ()
	Initialization (from RUNNING to RUNNING, via INITIALIZED). More...

virtual StatusCode	sysInitialize ()
	Initialize Service. More...

virtual StatusCode	sysStart ()
	Initialize Service. More...

virtual StatusCode	sysStop ()
	Initialize Service. More...

virtual StatusCode	sysFinalize ()
	Finalize Service. More...

virtual StatusCode	sysReinitialize ()
	Re-initialize the Service. More...

virtual StatusCode	sysRestart ()
	Re-initialize the Service. More...

virtual StatusCode	setProperty (const Property &p)
	Set the property by property. More...

virtual StatusCode	setProperty (const std::string &s)
	Set the property by string. More...

virtual StatusCode	setProperty (const std::string &n, const std::string &v)
	Set the property by std::string. More...

virtual StatusCode	getProperty (Property *p) const
	Get the property by property. More...

virtual const Property &	getProperty (const std::string &name) const
	Get the property by name. More...

virtual StatusCode	getProperty (const std::string &n, std::string &v) const
	Get the property by std::string. More...

virtual const std::vector< Property * > &	getProperties () const
	Get list of properties. More...

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

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

	Service (const std::string &name, ISvcLocator *svcloc)
	Standard Constructor. More...

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

StatusCode	setProperties ()
	Method for setting declared properties to the values specified for the job. More...

template<class T >
StatusCode	service (const std::string &name, const T *&psvc, 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 &name, T *&psvc, bool createIf=true) const

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

template<class T >
Property *	declareProperty (const std::string &name, T &property, const std::string &doc="none") const
	Declare the named property. More...

Property *	declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="") const
	Declare remote named properties. More...

SmartIF< IAuditorSvc > &	auditorSvc () const
	The standard auditor service.May not be invoked before sysInitialize() has been invoked. More...

Public Member Functions inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
	CommonMessaging (const A1 &a1, const A2 &a2, const A3 &a3)
	Templated constructor with 3 arguments. More...

	CommonMessaging (const A1 &a1, const A2 &a2)
	Templated constructor with 2 arguments. More...

	CommonMessaging (const A1 &a1)
	Templated constructor with 1 argument. More...

	CommonMessaging ()
	Default constructor. More...

	CommonMessaging (const A1 &a1, const A2 &a2, const A3 &a3)
	Templated constructor with 3 arguments. More...

	CommonMessaging (const A1 &a1, const A2 &a2)
	Templated constructor with 2 arguments. More...

	CommonMessaging (const A1 &a1)
	Templated constructor with 1 argument. More...

	CommonMessaging ()
	Default constructor. More...

virtual	~CommonMessaging ()
	Virtual destructor. More...

virtual	~CommonMessaging ()
	Virtual destructor. More...

SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service. 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 &	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 &	always () const
	shortcut for the method msgStream(MSG::ALWAYS) More...

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

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

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

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

MsgStream &	error () 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 &	warning () const
	shortcut for the method msgStream(MSG::WARNING) More...

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

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

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

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

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

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

MsgStream &	msg () const
	shortcut for the method msgStream(MSG::INFO) 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...

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

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

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

Public Member Functions inherited from extend_interfaces3< IService, IProperty, IStateful >
virtual	~extend_interfaces3 ()
	Virtual destructor. More...

virtual	~extend_interfaces3 ()
	Virtual destructor. More...

Public Member Functions inherited from IService
	DeclareInterfaceID (IService, 3, 0)
	InterfaceID. More...

virtual	~IService ()
	virtual destructor More...

	DeclareInterfaceID (IService, 3, 0)
	InterfaceID. More...

virtual	~IService ()
	virtual destructor More...

Public Member Functions inherited from INamedInterface
	DeclareInterfaceID (INamedInterface, 1, 0)
	InterfaceID. More...

virtual	~INamedInterface ()
	Virtual destructor (always needed for abstract classes). More...

	DeclareInterfaceID (INamedInterface, 1, 0)
	InterfaceID. More...

virtual	~INamedInterface ()
	Virtual destructor (always needed for abstract classes). More...

Public Member Functions inherited from IInterface
virtual unsigned long	addRef ()=0
	Increment the reference count of Interface instance. More...

virtual unsigned long	refCount () const =0
	Current reference count. More...

virtual	~IInterface ()
	Virtual destructor. More...

virtual unsigned long	addRef ()=0
	Increment the reference count of Interface instance. More...

virtual unsigned long	refCount () const =0
	Current reference count. More...

virtual	~IInterface ()
	Virtual destructor. More...

Public Member Functions inherited from IProperty
	DeclareInterfaceID (IProperty, 2, 1)
	InterfaceID. More...

	DeclareInterfaceID (IProperty, 2, 1)
	InterfaceID. More...

Public Member Functions inherited from IStateful
	DeclareInterfaceID (IStateful, 1, 0)
	InterfaceID. More...

virtual	~IStateful ()

	DeclareInterfaceID (IStateful, 1, 0)
	InterfaceID. More...

virtual	~IStateful ()

Public Member Functions inherited from extend_interfaces1< IToolSvc >
virtual	~extend_interfaces1 ()
	Virtual destructor. More...

virtual	~extend_interfaces1 ()
	Virtual destructor. More...

Public Member Functions inherited from IToolSvc
	DeclareInterfaceID (IToolSvc, 2, 1)
	InterfaceID. More...

template<class T >
StatusCode	retrieveTool (const std::string &type, T &tool, const IInterface parent=0, bool createIf=true)
	Retrieve specified tool sub-type with tool dependent part of the name automatically assigned. More...

template<class T >
StatusCode	retrieveTool (const std::string &type, const std::string &name, T &tool, const IInterface parent=0, bool createIf=true)
	Retrieve specified tool sub-type with tool dependent part of the name tool dependent part of the name specified by the requester. More...

	DeclareInterfaceID (IToolSvc, 2, 1)
	InterfaceID. More...

template<class T >
StatusCode	retrieveTool (const std::string &type, T &tool, const IInterface parent=0, bool createIf=true)
	Retrieve specified tool sub-type with tool dependent part of the name automatically assigned. More...

template<class T >
StatusCode	retrieveTool (const std::string &type, const std::string &name, T &tool, const IInterface parent=0, bool createIf=true)
	Retrieve specified tool sub-type with tool dependent part of the name tool dependent part of the name specified by the requester. More...

Private Member Functions
unsigned long	totalToolRefCount () const
	The total number of refCounts on all tools in the instancesTools list. More...

unsigned long	totalToolRefCount (const ListTools &) const
	The total number of refCounts on all tools in the list. More...

unsigned long	minimumToolRefCount () const
	The minimum number of refCounts of all tools. More...

StatusCode	finalizeTool (IAlgTool *itool) const
	Finalize the given tool, with exception handling. More...

Private Attributes
ListTools	m_instancesTools
	Common Tools. More...

IHistorySvc *	m_pHistorySvc
	Pointer to HistorySvc. More...

std::vector< IToolSvc::Observer * >	m_observers

Additional Inherited Members
Static Public Member Functions inherited from IInterface
static const InterfaceID &	interfaceID ()
	Return an instance of InterfaceID identifying the interface. More...

static const InterfaceID &	interfaceID ()
	Return an instance of InterfaceID identifying the interface. More...

Protected Member Functions inherited from Service
virtual	~Service ()
	Standard Destructor. More...

int	outputLevel () const
	get the `Service's` output level More...

virtual	~Service ()
	Standard Destructor. More...

int	outputLevel () const
	get the `Service's` output level More...

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

void	updateMsgStreamOutputLevel (int level)
	Update the output level of the cached MsgStream. More...

Protected Attributes inherited from Service
IntegerProperty	m_outputLevel
	Service output level. More...

Gaudi::StateMachine::State	m_state
	Service state. More...

Gaudi::StateMachine::State	m_targetState
	Service state. More...

Protected Attributes inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
SmartIF< IMessageSvc >	m_msgsvc
	Pointer to the message service;. More...

std::auto_ptr< MsgStream >	m_msgStream
	The predefined message stream. More...

bool	m_streamWithService
	Flag to create a new MsgStream if it was created without the message service. More...

Detailed Description

This service manages tools.

Tools can be common, in which case a single instance can be shared by different algorithms, or private in which case it is necessary to specify the parent when requesting it. The parent of a tool can be an algortihm or a Service The environment of a tool is set by using that of the parent. A common tool is considered to belong to the ToolSvc itself.

Author: G. Corti, P. Mato

Definition at line 23 of file ToolSvc.h.

Member Typedef Documentation

typedef std::list<IAlgTool*> ToolSvc::ListTools

Definition at line 28 of file ToolSvc.h.

Constructor & Destructor Documentation

ToolSvc::ToolSvc	(	const std::string &	name,
		ISvcLocator *	svc
	)

Standard Constructor.

Parameters

name	String with service name
svc	Pointer to service locator interface

Definition at line 31 of file ToolSvc.cpp.

   : base_class(name, svc),
     m_pHistorySvc(0)
  { }

ToolSvc::~ToolSvc ( )

virtual

Destructor.

Definition at line 38 of file ToolSvc.cpp.

 {
 
 }

Member Function Documentation

StatusCode ToolSvc::create	(	const std::string &	type,
		const IInterface *	parent,
		IAlgTool *&	tool
	)

Create Tool standard way with automatically assigned name.

Definition at line 436 of file ToolSvc.cpp.

 {
   const std::string & toolname = tooltype;
   return create( tooltype, toolname, parent, tool);
 }

StatusCode ToolSvc::create	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent,
		IAlgTool *&	tool
	)

Create Tool standard way with specified name.

invoke create callbacks...

Definition at line 495 of file ToolSvc.cpp.

 {
   // protect against empty type
   if ( UNLIKELY(tooltype.empty()) ) {
     error() << "create(): No Tool Type given" << endmsg;
     return StatusCode::FAILURE;
   }
 
   // If parent has not been specified, assume it is the ToolSvc
   if ( 0 == parent ) parent = this;
 
   tool = 0;
   // Automatically deletes the tool if not explicitly kept (i.e. on success).
   // The tool is removed from the list of known tools too.
   ToolCreateGuard toolguard(m_instancesTools);
 
   // Check if the tool already exist : this should never happen
   const std::string fullname = nameTool(toolname, parent);
   if( UNLIKELY(existsTool(fullname)) ) {
     error() << "Tool " << fullname << " already exists" << endmsg;
     return StatusCode::FAILURE;
   }
   // instantiate the tool using the factory
   try {
     toolguard = AlgTool::Factory::create(tooltype, tooltype, fullname, parent);
     if ( UNLIKELY(! toolguard.get()) ){
        error() << "Cannot create tool " << tooltype << " (No factory found)" << endmsg;
        return StatusCode::FAILURE;
     }
   }
   catch ( const GaudiException& Exception )  {
     // (1) perform the printout of message
     fatal() << "Exception with tag=" << Exception.tag()
             << " is caught whilst instantiating tool '" << tooltype << "'" << endmsg;
     // (2) print  the exception itself
     // (NB!  - GaudiException is a linked list of all "previous exceptions")
     fatal() << Exception  << endmsg;
     return StatusCode::FAILURE;
   }
   catch( const std::exception& Exception ) {
     // (1) perform the printout of message
     fatal() << "Standard std::exception is caught whilst instantiating tool '"
             << tooltype << "'" << endmsg;
     // (2) print  the exception itself
     // (NB!  - GaudiException is a linked list of all "previous exceptions")
     fatal() << Exception.what()  << endmsg;
     return StatusCode::FAILURE;
   }
   catch(...) {
     // (1) perform the printout
     fatal() << "UNKNOWN Exception is caught whilst instantiating tool '"
             << tooltype << "'" << endmsg;
     return StatusCode::FAILURE;
   }
   ON_VERBOSE verbose() << "Created tool " << tooltype << "/" << fullname << endmsg;
 
   // Since only AlgTool has the setProperties() method it is necessary to cast
   // to downcast IAlgTool to AlgTool in order to set the properties via the JobOptions
   // service
   AlgTool* mytool = dynamic_cast<AlgTool*> (toolguard.get());
   if ( mytool != 0 ) {
     StatusCode sc = mytool->setProperties();
     if ( UNLIKELY(sc.isFailure()) ) {
       error() << "Error setting properties for tool '"
               << fullname << "'" << endmsg;
       return sc;
     }
   }
 
   // Initialize the Tool
   StatusCode sc (StatusCode::FAILURE,true);
   try {
     sc = toolguard->sysInitialize();
   }
   // Catch any exceptions
   catch ( const GaudiException & Exception )
     {
       error()
           << "GaudiException with tag=" << Exception.tag()
           << " caught whilst initializing tool '" << fullname << "'" << endmsg
           << Exception << endmsg;
       return StatusCode::FAILURE;
     }
   catch( const std::exception & Exception )
     {
       error()
           << "Standard std::exception caught whilst initializing tool '"
           << fullname << "'" << endmsg << Exception.what() << endmsg;
       return StatusCode::FAILURE;
     }
   catch (...)
     {
       error()
           << "UNKNOWN Exception caught whilst initializing tool '"
           << fullname << "'" << endmsg;
       return StatusCode::FAILURE;
     }
 
   // Status of tool initialization
   if ( UNLIKELY(sc.isFailure()) ) {
     error() << "Error initializing tool '" << fullname << "'" << endmsg;
     return sc;
   }
 
   // Start the tool if we are running.
   if (m_state == Gaudi::StateMachine::RUNNING) {
     sc = toolguard->sysStart();
 
     if (UNLIKELY(sc.isFailure())) {
       error() << "Error starting tool '" << fullname << "'" << endmsg;
       return sc;
     }
   }
 
 
   // The tool has been successfully created and initialized,
   // so we the guard can be released
   tool = toolguard.release();
 
   if (!m_observers.empty()) {
       std::for_each( m_observers.begin(),
                      m_observers.end(),
                      bl::bind(&IToolSvc::Observer::onCreate,
                               bl::_1,
                               tool));
   }
   // TODO: replace by generic callback
   // Register the tool with the HistorySvc
   if (m_pHistorySvc != 0 ||
       service("HistorySvc",m_pHistorySvc,false).isSuccess() ) {
     m_pHistorySvc->registerAlgTool(*tool).ignore();
   }
 
   return StatusCode::SUCCESS;
 
 }

bool ToolSvc::existsTool ( const std::string & toolname ) const

Check if the tool instance exists.

Definition at line 669 of file ToolSvc.cpp.

 {
   for ( ListTools::const_iterator it = m_instancesTools.begin();
         it != m_instancesTools.end(); ++it ) {
     if ( (*it)->name() == fullname ) { return true; }
   }
   return false;
 }

StatusCode ToolSvc::finalize ( )

virtual

Finalize the service.

Algorithm: 2 passes. First pass:

do not explicitly release any tools
finalize tools, in the order of increasing number of refCounts Second pass:
explicitly release all tools, one release() on all tools per loop. -> tools are deleted in the order of increasing number of refCounts.

Inner loop: full loop over all left-over tools

finalize tools with the minimum number of refCounts in the list.
Remove finalized tools from list of tools, and add them to the list of finalized tools, to be deleted at the end. This way, any non-finalized tools who still reference already finalized tools in their finalize() will still find a live tool. Outer loop: keep on going until nothing changes in the list of tools. Checking for:
number of left-over tools
total number of refcounts
minimum number of refcounts

Reimplemented from Service.

Definition at line 67 of file ToolSvc.cpp.

 {
   // Finalize and delete all left-over tools. Normally all tools created with
   // ToolSvc are left over, since ToolSvc holds a refCount (via AlgTool ctor).
   // Several cases need to be covered:
   // 1) Simple dependencies: no circular dependencies between tools,
   //    and tools not using other tools
   // 2) Tools-using-tools (but no circular dependencies)
   //   a) release() is called in the tool::finalize() (e.g. via GaudiAlgorithm)
   //   b) release() is called in the tool destructor  (e.g. via ToolHandle)
   // 3) Circular dependencies between tools
   //   a) release() is called in the tool::finalize() (e.g. via GaudiAlgorithm)
   //   b) release() is called in the tool destructor  (e.g. via ToolHandle)
   // 4) In addition to each of the above cases, refCounting of a particular tool
   //    might not have been done correctly in the code. Typically release()
   //    is not called, so we are left with a too high refCount.
   //    What to do with those, and how to avoid a crash while handling them...
 
   ListTools finalizedTools; // list of tools that have been finalized
   info()  << "Removing all tools created by ToolSvc" << endmsg;
 
   // Print out list of tools
   ON_DEBUG {
     MsgStream &log = debug();
     log << "  Tool List : ";
     for ( ListTools::const_iterator iTool = m_instancesTools.begin();
         iTool != m_instancesTools.end(); ++iTool ) {
       log << (*iTool)->name() << ":" << refCountTool( *iTool ) << " ";
     }
     log << endmsg;
   }
 
   //
   // first pass: Finalize all tools (but don't delete them)
   //
   bool fail(false);
   size_t toolCount = m_instancesTools.size();
   unsigned long startRefCount = 0;
   unsigned long endRefCount = totalToolRefCount();
   unsigned long startMinRefCount = 0;
   unsigned long endMinRefCount = minimumToolRefCount();
   while ( toolCount > 0 &&
           endRefCount > 0 &&
           (endRefCount != startRefCount || endMinRefCount != startMinRefCount) ) {
     ON_DEBUG if ( endMinRefCount != startMinRefCount ) {
       debug() << toolCount << " tools left to finalize. Summed refCounts: "
               << endRefCount << endmsg;
       debug() << "Will finalize tools with refCount <= "
               << endMinRefCount << endmsg;
     }
     startMinRefCount = endMinRefCount;
     startRefCount = endRefCount;
     unsigned long maxLoop = toolCount + 1;
     while ( --maxLoop > 0 &&  m_instancesTools.size() > 0 ) {
       IAlgTool* pTool = m_instancesTools.back();
       // removing tool from list makes ToolSvc::releaseTool( IAlgTool* ) a noop
       m_instancesTools.pop_back();
       unsigned long count = refCountTool( pTool );
       // cache tool name
       std::string toolName = pTool->name();
       if ( count <= startMinRefCount ) {
         ON_DEBUG debug() << "  Performing finalization of " << toolName
                          << " (refCount " << count << ")" << endmsg;
         // finalize of one tool may trigger a release of another tool
         //   pTool->sysFinalize().ignore();
         if (!finalizeTool(pTool).isSuccess()) {
           warning() << "    FAILURE finalizing " << toolName << endmsg;
           fail = true;
         }
         // postpone deletion
         finalizedTools.push_back(pTool);
       } else {
         // Place back in list to try again later
         // ToolSvc::releaseTool( IAlgTool* ) remains active for this tool
         ON_DEBUG debug() << "  Delaying   finalization of " << toolName
                          << " (refCount " << count << ")" << endmsg;
         m_instancesTools.push_front(pTool);
       }
     } // end of inner loop
     toolCount = m_instancesTools.size();
     endRefCount = totalToolRefCount();
     endMinRefCount = minimumToolRefCount();
   }; // end of outer loop
 
   //
   // Second pass: Delete all finalized tools
   //
   // Delete in the order of increasing number of refCounts.
   // Loop over tools in the same order as the order in which they were finalized.
   // All tools in the list of finalized tools are no longer in the instancesTools list.
   // If a tool destructor calls releaseTool() on another tool, this will have no
   // effect on the 'other tool' if this 'other tool' is in the list of finalized tools.
   // If this 'other tool' is still in the instancesTools list, it may trigger finalization
   // (in releaseTool()), deletion and removal from the instancesTools list.
   // Therefore, the check on non-finalised tools should happen *after* the deletion
   // of the finalized tools.
   ON_DEBUG debug() << "Deleting " << finalizedTools.size() << " finalized tools" << endmsg;
   unsigned long maxLoop = totalToolRefCount( finalizedTools ) + 1;
   while ( --maxLoop > 0 && finalizedTools.size() > 0 ) {
     IAlgTool* pTool = finalizedTools.front();
     finalizedTools.pop_front();
     unsigned long count = refCountTool( pTool );
     if ( count == 1 ) {
       ON_DEBUG debug() << "  Performing deletion of " << pTool->name() << endmsg;
     } else {
       ON_VERBOSE verbose() << "  Delaying   deletion of " << pTool->name()
           << " (refCount " << count << ")" << endmsg;
       // Put it back at the end of the list if refCount still not zero
       finalizedTools.push_back(pTool);
     }
     // do a forced release
     pTool->release();
   }
 
   // Error if by now not all tools are properly finalised
   if ( !m_instancesTools.empty() ) {
     error() << "Unable to finalize and delete the following tools : ";
     for ( ListTools::const_iterator iTool = m_instancesTools.begin();
           iTool != m_instancesTools.end(); ++iTool ) {
       error() << (*iTool)->name() << ": " << refCountTool( *iTool ) << " ";
     }
     error() << endmsg;
   }
 
   // by now, all tools should be deleted and removed.
   if ( finalizedTools.size() > 0 ) {
     error() << "Failed to delete the following " <<  finalizedTools.size()
             << " finalized tools. Bug in ToolSvc::finalize()?: ";
     for ( ListTools::const_iterator iTool = finalizedTools.begin();
           iTool != finalizedTools.end(); ++iTool ) {
       error() << (*iTool)->name() << ": " << refCountTool( *iTool ) << " ";
     }
     error() << endmsg;
   }
 
   if ( 0 != m_pHistorySvc ) {
     m_pHistorySvc->release();
   }
 
   // Finalize this specific service
   if (! Service::finalize().isSuccess() || fail) {
     return StatusCode::FAILURE;
   } else {
     return StatusCode::SUCCESS;
   }
 
 
 }

StatusCode ToolSvc::finalizeTool ( IAlgTool * itool ) const

private

Finalize the given tool, with exception handling.

Definition at line 680 of file ToolSvc.cpp.

 {
 
   // Cache tool name in case of errors
   const std::string toolName = itool->name();
   StatusCode sc;
 
   // Finalise the tool inside a try block
   try {
     sc = itool->sysFinalize();
   }
   // Catch any exceptions
   catch ( const GaudiException & Exception )
   {
     error()
         << "GaudiException with tag=" << Exception.tag()
         << " caught whilst finalizing tool '" << toolName << "'" << endmsg
         << Exception << endmsg;
     sc = StatusCode::FAILURE;
   }
   catch( const std::exception & Exception )
   {
     error()
         << "Standard std::exception caught whilst finalizing tool '"
         << toolName << "'" << endmsg << Exception.what() << endmsg;
     sc = StatusCode::FAILURE;
   }
   catch (...)
   {
     error()
         << "UNKNOWN Exception caught whilst finalizing tool '"
         << toolName << "'" << endmsg;
     sc = StatusCode::FAILURE;
   }
 
   return sc;
 
 }

std::vector< std::string > ToolSvc::getInstances ( const std::string & toolType )

virtual

Get names of all tool instances of a given type.

Implements IToolSvc.

Definition at line 369 of file ToolSvc.cpp.

 {
 
   std::vector<std::string> tools;
 
   for(auto tool: m_instancesTools) {
     if (tool->type() == toolType) {
       tools.push_back( tool->name() );
     }
   }
 
   return tools;
 
 }

std::vector< std::string > ToolSvc::getInstances ( ) const

virtual

Get names of all tool instances.

Implements IToolSvc.

Definition at line 385 of file ToolSvc.cpp.

 {
   std::vector<std::string> tools{m_instancesTools.size()};
   std::transform(std::begin(m_instancesTools), std::end(m_instancesTools),
                  std::begin(tools),
                  [](IAlgTool* tool) {return tool->name();});
   return tools;
 }

std::vector< IAlgTool * > ToolSvc::getTools ( ) const

virtual

Get pointers to all tool instances.

Implements IToolSvc.

Definition at line 395 of file ToolSvc.cpp.

 {
   return std::vector<IAlgTool*>{std::begin(m_instancesTools),
                                 std::end(m_instancesTools)};
 }

StatusCode ToolSvc::initialize ( )

virtual

Initialize the service.

Reimplemented from Service.

Definition at line 45 of file ToolSvc.cpp.

 {
 
   // initialize the Service Base class
   StatusCode status = Service::initialize();
   if (UNLIKELY(status.isFailure()))
   {
     error() << "Unable to initialize the Service" << endmsg;
     return status;
   }
 
   // set my own (ToolSvc) properties via the jobOptionService
   if (UNLIKELY(setProperties().isFailure())) {
     error() << "Unable to set base properties" << endmsg;
     return StatusCode::FAILURE;
   }
 
   return status;
 }

unsigned long ToolSvc::minimumToolRefCount ( ) const

private

The minimum number of refCounts of all tools.

Definition at line 739 of file ToolSvc.cpp.

 {
   unsigned long count = 0;
   if ( m_instancesTools.size() > 0 ) {
     ListTools::const_iterator iTool = m_instancesTools.begin();
     // start with first
     count = refCountTool( *iTool );
     // then compare the others
     for( ++iTool; iTool != m_instancesTools.end(); ++iTool ) {
       count = std::min( count, refCountTool( *iTool ) );
     }
   }
   return count;
 }

std::string ToolSvc::nameTool	(	const std::string &	nameByUser,
		const IInterface *	parent
	)

Get Tool full name by combining nameByUser and "parent" part.

Definition at line 640 of file ToolSvc.cpp.

 {
 
   std::string fullname = "";
   if ( parent == 0 ) { return this->name() + "." + toolname; }    // RETURN
 
 
   IInterface* cparent = const_cast<IInterface*>( parent ) ;
   // check that parent has a name!
   INamedInterface* _p = 0 ;
   StatusCode sc = cparent->queryInterface( INamedInterface::interfaceID() , pp_cast<void>(&_p) ) ;
   if ( sc.isSuccess() )
   {
     fullname = _p->name() + "." + toolname ;
     _p->release() ;
     return fullname ;                                          // RETURN
   }
 
   MsgStream log ( msgSvc(), name() );
   log << MSG::ERROR
       << "Private Tools only allowed for components implementing INamedInterface"
       << endmsg;
   //
   return "." + toolname ;
 }

unsigned long ToolSvc::refCountTool ( IAlgTool * tool ) const

inline

Get current refcount for tool.

Definition at line 79 of file ToolSvc.h.

79 { return tool->refCount(); }

IAlgTool::refCount

virtual unsigned long refCount() const =0

Current number of reference counts.

void ToolSvc::registerObserver ( IToolSvc::Observer * obs )

virtual

Implements IToolSvc.

Definition at line 755 of file ToolSvc.cpp.

                                                     {
   if ( 0 == obs )
     throw GaudiException( "Received NULL pointer", this->name() + "::registerObserver", StatusCode::FAILURE );
   m_observers.push_back(obs);
 }

StatusCode ToolSvc::releaseTool ( IAlgTool * tool )

virtual

Release tool.

Implements IToolSvc.

Definition at line 402 of file ToolSvc.cpp.

 {
   StatusCode sc(StatusCode::SUCCESS);
   // test if tool is in known list (protect trying to access a previously deleted tool)
   if ( m_instancesTools.rend() != std::find( m_instancesTools.rbegin(),
                                               m_instancesTools.rend(),
                                               tool ) ) {
     unsigned long count = refCountTool(tool);
     if ( count == 1 ) {
       MsgStream log( msgSvc(), name() );
       // finalize the tool
 
       if ( Gaudi::StateMachine::OFFLINE == m_targetState ) {
         // We are being called during ToolSvc::finalize()
         // message format matches the one in ToolSvc::finalize()
         log << MSG::DEBUG << "  Performing finalization of " << tool->name()
             << " (refCount " << count << ")" << endmsg;
         // message format matches the one in ToolSvc::finalize()
         log << MSG::DEBUG << "  Performing     deletion of " << tool->name() << endmsg;
       } else {
         log << MSG::DEBUG << "Performing finalization and deletion of " << tool->name() << endmsg;
       }
       sc = finalizeTool(tool);
       // remove from known tools...
       m_instancesTools.remove(tool);
     }
     tool->release();
   }
 
   return sc;
 }

StatusCode ToolSvc::retrieve	(	const std::string &	type,
		const InterfaceID &	iid,
		IAlgTool *&	tool,
		const IInterface *	parent,
		bool	createIf
	)

virtual

Retrieve tool, create it by default as common tool if it does not already exist.

Implements IToolSvc.

Definition at line 248 of file ToolSvc.cpp.

 {
 
   // protect against empty type
   if ( tooltype.empty() ) {
     error() << "retrieve(): No Tool Type/Name given" << endmsg;
     return StatusCode::FAILURE;
   }
 
   {
     // check for tools, which by name is required to be public:
     const std::string::size_type pos = tooltype.find ( s_PUBLIC ) ;
     if ( std::string::npos != pos )
     {
       // set parent for PUBLIC tool
       parent = this ;
       return retrieve ( std::string( tooltype , 0 , pos ) ,
                         iid , tool , parent , createIf ) ;
     }
   }
 
   const std::string::size_type pos = tooltype.find('/');
   if( std::string::npos == pos ) {
     return retrieve ( tooltype , tooltype , iid , tool , parent , createIf );
   }
   const std::string newtype ( tooltype ,       0 , pos               ) ;
   const std::string newname ( tooltype , pos + 1 , std::string::npos ) ;
   return retrieve ( newtype , newname , iid , tool , parent , createIf ) ;
 }

StatusCode ToolSvc::retrieve	(	const std::string &	tooltype,
		const std::string &	toolname,
		const InterfaceID &	iid,
		IAlgTool *&	tool,
		const IInterface *	parent,
		bool	createIf
	)

virtual

Retrieve tool, create it by default as common tool if it does not already exist.

invoke retrieve callbacks...

Implements IToolSvc.

Definition at line 286 of file ToolSvc.cpp.

 {
   // check the applicability of another method:
   // ignore the provided name if it is empty or the type contains a name
   if( toolname.empty() || (std::string::npos != tooltype.find('/')) )
   { return retrieve ( tooltype , iid , tool , parent , createIf ) ; }
 
   {
     // check for tools, which by name is required to be public:
     const std::string::size_type pos = toolname.find ( s_PUBLIC ) ;
     if ( std::string::npos != pos )
     {
       // set parent for PUBLIC tool
       parent = this ;
       return retrieve ( tooltype , std::string( toolname , 0 , pos ) ,
                         iid , tool , parent , createIf ) ;
     }
   }
 
   IAlgTool* itool = 0;
   StatusCode sc(StatusCode::FAILURE);
 
   tool = 0;
 
   // If parent is not specified it means it is the ToolSvc itself
   if( 0 == parent ) {
     parent = this;
   }
   const std::string fullname = nameTool( toolname, parent );
 
   // Find tool in list of those already existing, and tell its
   // interface that it has been used one more time
   ListTools::const_iterator it;
   for( it = m_instancesTools.begin(); it != m_instancesTools.end(); ++it ) {
     if( (*it)->name() == fullname ) {
       ON_DEBUG debug() << "Retrieved tool " << toolname << endmsg;
       itool = *it;
       break;
     }
   }
 
   if ( 0 == itool ) {
     // Instances of this tool do not exist, create an instance if desired
     // otherwise return failure
     if( UNLIKELY(!createIf) ) {
       warning() << "Tool " << toolname
                 << " not found and creation not requested" << endmsg;
       return sc;
     }
     else {
       sc = create( tooltype, toolname, parent, itool );
       if ( sc.isFailure() ) { return sc; }
     }
   }
 
   // Get the right interface of it
   sc = itool->queryInterface( iid, (void**)&tool);
   if( UNLIKELY(sc.isFailure()) ) {
     error() << "Tool " << toolname
         << " either does not implement the correct interface, or its version is incompatible"
         << endmsg;
     return sc;
   }
   if (!m_observers.empty()) {
      std::for_each( m_observers.begin(),
                     m_observers.end(),
                     bl::bind(&IToolSvc::Observer::onRetrieve,
                              bl::_1,
                              itool));
   }
 
   return sc;
 }

StatusCode ToolSvc::start ( )

virtual

Start (from INITIALIZED to RUNNING).

Reimplemented from Service.

Definition at line 769 of file ToolSvc.cpp.

 {
 
   ON_DEBUG debug() << "START transition for AlgTools" << endmsg;
 
   bool fail(false);
   for ( ListTools::const_iterator iTool = m_instancesTools.begin();
         iTool != m_instancesTools.end(); ++iTool ) {
     ON_VERBOSE verbose() << (*iTool)->name() << "::start()" << endmsg;
 
     if (UNLIKELY(!(*iTool)->sysStart().isSuccess())) {
       fail = true;
       error() << (*iTool)->name() << " failed to start()" << endmsg;
     }
 
   }
 
   if (UNLIKELY(fail)) {
     error() << "One or more AlgTools failed to start()" << endmsg;
     return StatusCode::FAILURE;
   } else {
     return StatusCode::SUCCESS;
   }
 
 }

StatusCode ToolSvc::stop ( )

virtual

Stop (from RUNNING to INITIALIZED).

Reimplemented from Service.

Definition at line 798 of file ToolSvc.cpp.

 {
 
   ON_DEBUG debug() << "STOP transition for AlgTools" << endmsg;
 
   bool fail(false);
   for ( ListTools::const_iterator iTool = m_instancesTools.begin();
         iTool != m_instancesTools.end(); ++iTool ) {
     ON_VERBOSE verbose() << (*iTool)->name() << "::stop()" << endmsg;
 
     if (UNLIKELY(!(*iTool)->sysStop().isSuccess())) {
       fail = true;
       error() << (*iTool)->name() << " failed to stop()" << endmsg;
     }
 
   }
 
   if (UNLIKELY(fail)) {
     error() << "One or more AlgTools failed to stop()" << endmsg;
     return StatusCode::FAILURE;
   } else {
     return StatusCode::SUCCESS;
   }
 
 }

unsigned long ToolSvc::totalToolRefCount ( ) const

private

The total number of refCounts on all tools in the instancesTools list.

Definition at line 733 of file ToolSvc.cpp.

 {
   return totalToolRefCount( m_instancesTools );
 }

unsigned long ToolSvc::totalToolRefCount ( const ListTools & toolList ) const

private

The total number of refCounts on all tools in the list.

Definition at line 721 of file ToolSvc.cpp.

 {
   unsigned long count = 0;
   for ( ListTools::const_iterator iTool = toolList.begin();
         iTool != toolList.end(); ++iTool ) {
     count += refCountTool( *iTool );
   }
   return count;
 }

void ToolSvc::unRegisterObserver ( IToolSvc::Observer * obs )

virtual

Implements IToolSvc.

Definition at line 761 of file ToolSvc.cpp.

                                                       {
   std::vector<IToolSvc::Observer*>::iterator i =
     find(m_observers.begin(),m_observers.end(),obs);
   if (i!=m_observers.end()) m_observers.erase(i);
 }

Member Data Documentation

ListTools ToolSvc::m_instancesTools

private

Common Tools.

Definition at line 111 of file ToolSvc.h.

std::vector<IToolSvc::Observer*> ToolSvc::m_observers

private

Definition at line 116 of file ToolSvc.h.

IHistorySvc* ToolSvc::m_pHistorySvc

private

Pointer to HistorySvc.

Definition at line 114 of file ToolSvc.h.

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

GaudiCoreSvc/src/ApplicationMgr/ToolSvc.h
GaudiCoreSvc/src/ApplicationMgr/ToolSvc.cpp

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation