#include <GaudiKernel/ServiceHandle.h>

Inheritance diagram for ServiceHandle< T >:

[legend]

Collaboration diagram for ServiceHandle< T >:

[legend]

Public Member Functions
	ServiceHandle (const std::string &serviceName, const std::string &theParentName)
	Create a handle ('smart pointer') to a service. More...

template<typename CT = T, typename NCT = std::remove_const_t<T>>
	requires (std::is_const_v< CT > &&!std::is_same_v< CT, NCT >) ServiceHandle(const ServiceHandle< NCT > &other)
	Copy constructor from a non const T to const T service handle. More...

template<std::derived_from< IProperty > OWNER>
	ServiceHandle (OWNER *owner, std::string PropName, const std::string &svcName, std::string doc="")
	Autodeclaring constructor with property name, service type/name and documentation. More...

StatusCode	initialize (const std::string &serviceName, const std::string &theParentName)

T *	get () const
	Allow non const access to the service, even from a const handle... More...

T *	operator-> () const
	Allow non const access to the service, even from a const handle... More...

T &	operator* () const

Public Member Functions inherited from GaudiHandle< T >
template<typename CT = T, typename NCT = std::remove_const_t<T>>
	GaudiHandle (const GaudiHandle< NCT > &other, std::enable_if_t< std::is_const_v< CT > &&!std::is_same_v< CT, NCT >> *=nullptr)
	Copy constructor needed for correct ref-counting. More...

	GaudiHandle (const GaudiHandle &other)
	Copy constructor needed for correct ref-counting. More...

template<typename CT = T, typename NCT = std::remove_const_t<T>>
std::enable_if_t< std::is_const_v< CT > &&!std::is_same_v< CT, NCT >, GaudiHandle & >	operator= (const GaudiHandle< NCT > &other)
	Assignment operator for correct ref-counting. More...

GaudiHandle &	operator= (const GaudiHandle &other)
	Assignment operator for correct ref-counting. More...

StatusCode	retrieve () const
	Retrieve the component. More...

StatusCode	release () const
	Release the component. More...

bool	isValid () const
	Check if the handle is valid (try to retrive the object is not done yet). More...

	operator bool () const
	For testing if handle has component. More...

T *	get ()
	Return the wrapped pointer, not calling retrieve() if null. More...

std::add_const_t< T > *	get () const
	Return the wrapped pointer, not calling retrieve() if null. More...

bool	isSet () const
	True if the wrapped pointer is not null. More...

T &	operator* ()

T *	operator-> ()

std::add_const_t< T > &	operator* () const

std::add_const_t< T > *	operator-> () const

std::string	getDefaultType ()
	Helper function to get default type string from the class type. More...

std::string	getDefaultName ()

Public Member Functions inherited from GaudiHandleBase
const std::string &	typeAndName () const
	The full type and name: "type/name". More...

std::string	type () const
	The concrete component class name: the part before the '/'. More...

std::string	name () const
	The instance name: the part after the '/'. More...

bool	empty () const
	Check if the handle has been set to empty string (i.e. More...

void	setTypeAndName (std::string myTypeAndName)
	The component "type/name" string. More...

void	setName (std::string_view myName)
	Set the instance name (part after the '/') without changing the class type. More...

std::string	pythonPropertyClassName () const override
	Name of the componentType with "Handle" appended. More...

std::string	messageName () const
	name used for printing messages More...

std::string	pythonRepr () const override
	Python representation of handle, i.e. More...

Public Member Functions inherited from GaudiHandleInfo
virtual	~GaudiHandleInfo ()
	virtual destructor so that derived class destructor is called. More...

const std::string &	componentType () const

const std::string &	propertyName () const
	name as used in declareProperty(name,gaudiHandle) More...

void	setPropertyName (std::string propName)
	set name as used in declareProperty(name,gaudiHandle). More...

const std::string &	parentName () const
	The name of the parent. More...

Protected Member Functions
StatusCode	retrieve (T *&service) const override
	Do the real retrieval of the Service. More...

template<Gaudi::IsInterface I = T>
StatusCode	i_retrieve (I *&service) const
	retrieve the service for ServiceHandles<ISomeInterfaces> More...

template<typename I = T>
	requires (!Gaudi::IsInterface< I >) StatusCode i_retrieve(I *&service) const
	retrieve the service for ServiceHandles<ActualService> More...

Protected Member Functions inherited from GaudiHandle< T >
	GaudiHandle (std::string myTypeAndName, std::string myComponentType, std::string myParentName)

virtual StatusCode	release (T *comp) const
	Release the component. More...

Protected Member Functions inherited from GaudiHandleBase
	GaudiHandleBase (std::string myTypeAndName, std::string myComponentType, std::string myParentName)
	Create a handle ('smart pointer') to a gaudi component. More...

Protected Member Functions inherited from GaudiHandleInfo
	GaudiHandleInfo (std::string myComponentType, std::string myParentName)
	Some basic information and helper functions shared between various handles/arrays. More...

void	setComponentType (std::string componentType)
	The component type. More...

void	setParentName (std::string parent)
	The name of the parent. More...

Private Member Functions
SmartIF< ISvcLocator > &	serviceLocator () const

SmartIF< IMessageSvc > &	messageSvc () const

Private Attributes
SmartIF< ISvcLocator >	m_pSvcLocator

SmartIF< IMessageSvc >	m_pMessageSvc

Additional Inherited Members
Public Types inherited from GaudiHandleBase
using	PropertyType = GaudiHandleProperty

Detailed Description

template<class T>
class ServiceHandle< T >

Handle to be used in lieu of naked pointers to services. This allows better control through the framework of service loading and usage.

Author: Marti.nosp@m.n.Wo.nosp@m.udstr.nosp@m.a@ce.nosp@m.rn.ch

Definition at line 42 of file ServiceHandle.h.

Constructor & Destructor Documentation

◆ ServiceHandle() [1/2]

template<class T >

ServiceHandle< T >::ServiceHandle	(	const std::string &	serviceName,
		const std::string &	theParentName
	)

inline

Create a handle ('smart pointer') to a service.

The arguments are passed on to ServiceSvc, and have the same meaning:

Parameters

serviceName	name of the service
parentName	name of the parent Algorithm, AlgTool or Service. It is used for log printout at retrieve(), and for retrieving a thread-dependent service (if applicable)

Definition at line 54 of file ServiceHandle.h.

55 : GaudiHandle<T>( serviceName, "Service", theParentName ) {}

◆ ServiceHandle() [2/2]

template<class T >

template<std::derived_from< IProperty > OWNER>

ServiceHandle< T >::ServiceHandle	(	OWNER *	owner,
		std::string	PropName,
		const std::string &	svcName,
		std::string	doc = `""`
	)

inline

Autodeclaring constructor with property name, service type/name and documentation.

Note: the use of requires is required to avoid ambiguities

Definition at line 65 of file ServiceHandle.h.

       : ServiceHandle( svcName, owner->name() ) {
     auto p = owner->OWNER::PropertyHolderImpl::declareProperty( std::move( PropName ), *this, std::move( doc ) );
     p->template setOwnerType<OWNER>();
   }

Member Function Documentation

◆ get()

template<class T >

T* ServiceHandle< T >::get ( ) const

inline

Allow non const access to the service, even from a const handle...

Definition at line 90 of file ServiceHandle.h.

90 { return ::details::nonConst( GaudiHandle<T>::get() ); }

◆ i_retrieve()

template<class T >

template<Gaudi::IsInterface I = T>

StatusCode ServiceHandle< T >::i_retrieve ( I *& service ) const

inlineprotected

retrieve the service for ServiceHandles<ISomeInterfaces>

Definition at line 102 of file ServiceHandle.h.

                                              {
     const ServiceLocatorHelper helper( *serviceLocator(), GaudiHandleBase::messageName(), this->parentName() );
     return helper.getService( GaudiHandleBase::typeAndName(), true, I::interfaceID(), (void**)&service );
   }

◆ initialize()

template<class T >

StatusCode ServiceHandle< T >::initialize	(	const std::string &	serviceName,
		const std::string &	theParentName
	)

inline

Definition at line 71 of file ServiceHandle.h.

                                                                                         {
  
     GaudiHandleBase::setTypeAndName( serviceName );
     GaudiHandleBase::setParentName( theParentName );
  
     return StatusCode::SUCCESS;
   }

◆ messageSvc()

template<class T >

SmartIF<IMessageSvc>& ServiceHandle< T >::messageSvc ( ) const

inlineprivate

Definition at line 140 of file ServiceHandle.h.

                                            { // not really const, because it may change m_pMessageSvc
     if ( !m_pMessageSvc ) {
       m_pMessageSvc = serviceLocator(); // default message service
       if ( !m_pMessageSvc ) {
         throw GaudiException( "Service [MessageSvc] not found", this->parentName(), StatusCode::FAILURE );
       }
     }
     return m_pMessageSvc;
   }

◆ operator*()

template<class T >

T& ServiceHandle< T >::operator* ( ) const

inline

Definition at line 94 of file ServiceHandle.h.

94 { return *::details::nonConst( GaudiHandle<T>::operator->() ); }

◆ operator->()

template<class T >

T* ServiceHandle< T >::operator-> ( ) const

inline

Allow non const access to the service, even from a const handle...

Definition at line 93 of file ServiceHandle.h.

93 { return ::details::nonConst( GaudiHandle<T>::operator->() ); }

◆ requires() [1/2]

template<class T >

template<typename I = T>

ServiceHandle< T >::requires ( !Gaudi::IsInterface< I > ) const &

inlineprotected

retrieve the service for ServiceHandles<ActualService>

Definition at line 109 of file ServiceHandle.h.

                                              {
     IService* svc = nullptr;
     return i_retrieve( svc ).andThen( [&] {
       service = dynamic_cast<I*>( svc );
       if ( !service )
         throw GaudiException( "unable to dcast Service " + this->typeAndName() + " to " +
                                   System::typeinfoName( typeid( T ) ),
                               this->typeAndName() + " retrieve", StatusCode::FAILURE );
     } );
   }

◆ requires() [2/2]

template<class T >

template<typename CT = T, typename NCT = std::remove_const_t<T>>

ServiceHandle< T >::requires ( std::is_const_v< CT > &&!std::is_same_v< CT, NCT > ) const &

inline

Copy constructor from a non const T to const T service handle.

Definition at line 59 of file ServiceHandle.h.

60 : GaudiHandle<CT>( other ) {}

◆ retrieve()

template<class T >

StatusCode ServiceHandle< T >::retrieve ( T *& service ) const

inlineoverrideprotectedvirtual

Do the real retrieval of the Service.

Implements GaudiHandle< T >.

Definition at line 98 of file ServiceHandle.h.

98 { return i_retrieve( service ); }

◆ serviceLocator()

template<class T >

SmartIF<ISvcLocator>& ServiceHandle< T >::serviceLocator ( ) const

inlineprivate

Definition at line 130 of file ServiceHandle.h.

                                                { // not really const, because it may change m_pSvcLocator
     if ( !m_pSvcLocator ) {
       m_pSvcLocator = Gaudi::svcLocator();
       if ( !m_pSvcLocator ) {
         throw GaudiException( "SvcLocator not found", "Core component not found", StatusCode::FAILURE );
       }
     }
     return m_pSvcLocator;
   }

Member Data Documentation

◆ m_pMessageSvc

template<class T >

SmartIF<IMessageSvc> ServiceHandle< T >::m_pMessageSvc

mutableprivate

Definition at line 153 of file ServiceHandle.h.

◆ m_pSvcLocator

template<class T >

SmartIF<ISvcLocator> ServiceHandle< T >::m_pSvcLocator

mutableprivate

Definition at line 152 of file ServiceHandle.h.

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

GaudiKernel/include/GaudiKernel/ServiceHandle.h

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

template<class T> class ServiceHandle< T >

Constructor & Destructor Documentation

◆ ServiceHandle() [1/2]

◆ ServiceHandle() [2/2]

Member Function Documentation

◆ get()

◆ i_retrieve()

◆ initialize()

◆ messageSvc()

◆ operator*()

◆ operator->()

◆ requires() [1/2]

◆ requires() [2/2]

◆ retrieve()

◆ serviceLocator()

Member Data Documentation

◆ m_pMessageSvc

◆ m_pSvcLocator

template<class T>
class ServiceHandle< T >