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 215 of file Guards.h.

Constructor & Destructor Documentation

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

constructor

Definition at line 58 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 63 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 73 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 79 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 91 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 96 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 106 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 112 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 127 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 242 of file Guards.h.

{ return *m_sc; }

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

inlineprivate

Definition at line 287 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 268 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 260 of file Guards.h.

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

private

Flag to remember which event type was used.

Definition at line 266 of file Guards.h.

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

private

Event type (standard events)

Definition at line 258 of file Guards.h.

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

private

the guarded object

Definition at line 252 of file Guards.h.

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

private

the guarded object name (if there is no INamedInterface)

Definition at line 254 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 264 of file Guards.h.

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

private

auditor service

Definition at line 256 of file Guards.h.

---

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

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