Gaudi::Guards::AuditorGuard Class Reference

It is a simple guard, which "locks" the scope for the Auditor Service is am exception-safe way. More...

#include <GaudiKernel/Guards.h>

Collaboration diagram for Gaudi::Guards::AuditorGuard:

Public Member Functions
	AuditorGuard (INamedInterface *obj, IAuditor *svc, IAuditor::StandardEventType evt)
	constructor More...
	AuditorGuard (INamedInterface *obj, IAuditor *svc, IAuditor::CustomEventTypeRef evt)
	constructor More...
	AuditorGuard (INamedInterface *obj, IAuditor *svc, IAuditor::StandardEventType evt, const StatusCode &sc)
	constructor More...
	AuditorGuard (INamedInterface *obj, IAuditor *svc, IAuditor::CustomEventTypeRef evt, const StatusCode &sc)
	constructor More...
	AuditorGuard (std::string name, IAuditor *svc, IAuditor::StandardEventType evt)
	constructor More...
	AuditorGuard (std::string name, IAuditor *svc, IAuditor::CustomEventTypeRef evt)
	constructor More...
	AuditorGuard (std::string name, IAuditor *svc, IAuditor::StandardEventType evt, const StatusCode &sc)
	constructor More...
	AuditorGuard (std::string name, IAuditor *svc, IAuditor::CustomEventTypeRef evt, const StatusCode &sc)
	constructor More...
	~AuditorGuard ()
	dectructor More...
const StatusCode &	code () const

Private Member Functions
	AuditorGuard ()=delete
	AuditorGuard (const AuditorGuard &right)=delete
AuditorGuard &	operator= (const AuditorGuard &right)=delete
void	i_before ()
void	i_after ()

Private Attributes
INamedInterface *	m_obj = nullptr
	the guarded object More...
std::string	m_objName
	the guarded object name (if there is no INamedInterface) More...
SmartIF< IAuditor >	m_svc = nullptr
	auditor service More...
IAuditor::StandardEventType	m_evt
	Event type (standard events) More...
IAuditor::CustomEventType	m_cevt
	Event type (custom events) More...
const StatusCode *	m_sc = nullptr
	Pointer to a status code instance, to be passed to the "after" function if needed The instance must have a scope larger than the one of the guard. More...
bool	m_customEvtType = false
	Flag to remember which event type was used. More...

Detailed Description

It is a simple guard, which "locks" the scope for the Auditor Service is am exception-safe way.

The pattern ensures that "post-action" will be always executed

StatusCode Algorithm::sysInitialize ()
 {
    AuditorGuard auditor ( this ,
      auditSvc()                ,   
      IAuditor::Initialize      ) ; 
    ...
    StatusCode sc = ... ;
    ...
    return sc ;                  
 }

StatusCode Algorithm::sysExecute ()
 {
    AuditorGuard auditor ( this       ,
      auditSvc()                      ,   
      IAuditor::execute               ) ; 
    ...
    StatusCode sc = ... ;
    ...
    auditor.setCode ( sc ) ;
    ...
    return sc ;                  
 }

Author

Vanya BELYAEV ibely.nosp@m.aev@.nosp@m.physi.nosp@m.cs.s.nosp@m.yr.ed.nosp@m.u

Date

2007-03-07

Definition at line 214 of file Guards.h.

Constructor & Destructor Documentation

Gaudi::Guards::AuditorGuard::AuditorGuard	(	INamedInterface *	obj,
		IAuditor *	svc,
		IAuditor::StandardEventType	evt
	)

constructor

Definition at line 64 of file Guards.cpp.

                                                                   :
                 m_obj(obj),
                 m_svc(svc),
                 m_evt(evt)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	INamedInterface *	obj,
		IAuditor *	svc,
		IAuditor::CustomEventTypeRef	evt
	)

constructor

Definition at line 73 of file Guards.cpp.

                                                                      :
                 m_obj(obj),
                 m_svc(svc),
                 m_evt(IAuditor::Initialize), // Windows needs an explicit value
                 m_cevt(std::move(evt)),
                 m_customEvtType(true)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	INamedInterface *	obj,
		IAuditor *	svc,
		IAuditor::StandardEventType	evt,
		const StatusCode &	sc
	)

constructor

Definition at line 84 of file Guards.cpp.

                                            :
      m_obj(obj),
      m_svc(svc),
      m_evt(evt),
      m_sc(&sc),
      m_customEvtType(false)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	INamedInterface *	obj,
		IAuditor *	svc,
		IAuditor::CustomEventTypeRef	evt,
		const StatusCode &	sc
	)

constructor

Definition at line 96 of file Guards.cpp.

                                                 :
      m_obj(obj),
      m_svc(svc),
      m_evt(IAuditor::Initialize), // Windows needs an explicit value
      m_cevt(std::move(evt)),
      m_sc(&sc),
      m_customEvtType(true)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	std::string	name,
		IAuditor *	svc,
		IAuditor::StandardEventType	evt
	)

constructor

Definition at line 109 of file Guards.cpp.

                                         :
      m_objName(std::move(name)),
      m_svc(svc),
      m_evt(evt),
      m_customEvtType(false)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	std::string	name,
		IAuditor *	svc,
		IAuditor::CustomEventTypeRef	evt
	)

constructor

Definition at line 119 of file Guards.cpp.

                                               :
      m_objName(std::move(name)),
      m_svc(svc),
      m_evt(IAuditor::Initialize), // Windows needs an explicit value
      m_cevt(std::move(evt)),
      m_customEvtType(true)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	std::string	name,
		IAuditor *	svc,
		IAuditor::StandardEventType	evt,
		const StatusCode &	sc
	)

constructor

Definition at line 130 of file Guards.cpp.

                                           :
      m_objName(std::move(name)),
      m_svc(svc),
      m_evt(evt),
      m_sc(&sc),
      m_customEvtType(false)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::AuditorGuard	(	std::string	name,
		IAuditor *	svc,
		IAuditor::CustomEventTypeRef	evt,
		const StatusCode &	sc
	)

constructor

Definition at line 142 of file Guards.cpp.

                                                 :
      m_objName(std::move(name)),
      m_svc(svc),
      m_evt(IAuditor::Initialize), // Windows needs an explicit value
      m_cevt(std::move(evt)),
      m_sc(&sc),
      m_customEvtType(true)
{
  i_before();
}

Gaudi::Guards::AuditorGuard::~AuditorGuard

(

)

dectructor

Definition at line 158 of file Guards.cpp.

{
  i_after();
}

Gaudi::Guards::AuditorGuard::AuditorGuard ( )

privatedelete

Gaudi::Guards::AuditorGuard::AuditorGuard ( const AuditorGuard &  right )

privatedelete

Member Function Documentation

const StatusCode& Gaudi::Guards::AuditorGuard::code ( ) const

inline

Definition at line 260 of file Guards.h.

{ return *m_sc ; }

void Gaudi::Guards::AuditorGuard::i_after ( )

inlineprivate

Definition at line 302 of file Guards.h.

                            {
        if ( m_svc ) { // if the service is not available, we cannot do anything
          if ( m_obj) {
            if (m_customEvtType) {
              if ( m_sc) {
                m_svc->after(m_cevt,m_obj,*m_sc);
              } else {
                m_svc->after(m_cevt,m_obj);
              }
            } else {
              if (m_sc) {
                m_svc->after(m_evt,m_obj,*m_sc);
              } else {
                m_svc->after(m_evt,m_obj);
              }
            }
          } else { // use object name
            if (m_customEvtType) {
              if (m_sc) {
                m_svc->after(m_cevt,m_objName,*m_sc);
              } else {
                m_svc->after(m_cevt,m_objName);
              }
            } else {
              if (m_sc) {
                m_svc->after(m_evt,m_objName,*m_sc);
              } else {
                m_svc->after(m_evt,m_objName);
              }
            }
          }
          m_svc.reset();
        }
      }

void Gaudi::Guards::AuditorGuard::i_before ( )

inlineprivate

Definition at line 284 of file Guards.h.

                             {
        if ( m_svc ) { // if the service is not available, we cannot do anything
          if (m_obj) {
            if (m_customEvtType) {
              m_svc->before(m_cevt,m_obj);
            } else {
              m_svc->before(m_evt,m_obj);
            }
          } else { // use object name
            if (m_customEvtType) {
              m_svc->before(m_cevt,m_objName);
            } else {
              m_svc->before(m_evt,m_objName);
            }
          }
        }
      }

AuditorGuard& Gaudi::Guards::AuditorGuard::operator= ( const AuditorGuard &  right )

privatedelete

Member Data Documentation

IAuditor::CustomEventType Gaudi::Guards::AuditorGuard::m_cevt

private

Event type (custom events)

Definition at line 276 of file Guards.h.

bool Gaudi::Guards::AuditorGuard::m_customEvtType = false

private

Flag to remember which event type was used.

Definition at line 282 of file Guards.h.

IAuditor::StandardEventType Gaudi::Guards::AuditorGuard::m_evt

private

Event type (standard events)

Definition at line 274 of file Guards.h.

INamedInterface* Gaudi::Guards::AuditorGuard::m_obj = nullptr

private

the guarded object

Definition at line 268 of file Guards.h.

std::string Gaudi::Guards::AuditorGuard::m_objName

private

the guarded object name (if there is no INamedInterface)

Definition at line 270 of file Guards.h.

const StatusCode* Gaudi::Guards::AuditorGuard::m_sc = nullptr

private

Pointer to a status code instance, to be passed to the "after" function if needed The instance must have a scope larger than the one of the guard.

No check is performed.

Definition at line 280 of file Guards.h.

SmartIF<IAuditor> Gaudi::Guards::AuditorGuard::m_svc = nullptr

private

auditor service

Definition at line 272 of file Guards.h.

---

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

• GaudiKernel/GaudiKernel/Guards.h
• GaudiKernel/src/Lib/Guards.cpp