Gaudi::Guards::ExceptionGuard Class Reference

The most simple guard - it execute the certain code withing typical "try {} catch" clause, used in Auditor, Algorithm, AlgTool, etc. More...

#include <GaudiKernel/Guards.h>

Collaboration diagram for Gaudi::Guards::ExceptionGuard:

Public Member Functions
template<class OBJECT , class FUNCTION >
	ExceptionGuard (OBJECT obj, FUNCTION fun, MsgStream &log, IExceptionSvc *svc=0)
	~ExceptionGuard ()
	destructor More...
const StatusCode &	code () const
	the result of function evaluation More...
	operator const StatusCode & () const
	cast operator, useful for the implicit conversions More...

Protected Member Functions
void	handle (const GaudiException &e, MsgStream &s)
	local handler of GaudiException More...
void	handle (const std::exception &e, MsgStream &s)
	local handler of std::exception More...
void	handle (MsgStream &s)
	local handler of UNKNOWN exceptions More...

Private Member Functions
	ExceptionGuard ()=delete
	ExceptionGuard (const ExceptionGuard &)=delete
ExceptionGuard &	operator= (const ExceptionGuard &)=delete

Private Attributes
StatusCode	m_sc = StatusCode::FAILURE
	status code : result of function evaluation More...

Detailed Description

The most simple guard - it execute the certain code withing typical "try {} catch" clause, used in Auditor, Algorithm, AlgTool, etc.

. classes

The usage is fairly trivial:

// get the stream:
MsgStream& log = ... ;

// create the guard object and execute this->initialize()
// within the  standard "try"-clause:
Gaudi::Guards::Guard guard
        ( this                               ,   
          std::mem_fn(&IAuditor::initialize) ,   
          log                                ) ; 

// extract the status code"
StatusCode sc = guard.code() ;

The utility could be reused for member-function, regular functions, etc.. It could be easily combined with STL-idioms Essentially it required only the semantical validity of the expression "StatusCode sc = fun(obj)"

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

Constructor & Destructor Documentation

template<class OBJECT , class FUNCTION >

Gaudi::Guards::ExceptionGuard::ExceptionGuard ( OBJECT  obj, FUNCTION  fun, MsgStream &  log, IExceptionSvc *  svc = 0  )

inline

< execute the functor

Definition at line 113 of file Guards.h.

                                                                                         {
        try {
          // execute the functor:
          m_sc = fun( obj ); 
          // in the case of error try use Exception Service
          if ( svc && m_sc.isFailure() ) { m_sc = svc->handleErr( *obj, m_sc ); }
        } catch ( const GaudiException& e ) {
          // Use the local handler and then (if possible) the Exception Service
          handle( e, log );
          if ( svc ) { m_sc = svc->handle( *obj, e ); }
        } catch ( const std::exception& e ) {
          // Use the local handler and then (if possible) the Exception Service
          handle( e, log );
          if ( svc ) { m_sc = svc->handle( *obj, e ); }
        } catch ( ... ) {
          // Use the local handler and then (if possible) the Exception Service
          handle( log );
          if ( svc ) { m_sc = svc->handle( *obj ); }
        }
      }

Gaudi::Guards::ExceptionGuard::~ExceptionGuard

(

)

destructor

Definition at line 51 of file Guards.cpp.

{ m_sc.ignore(); }

Gaudi::Guards::ExceptionGuard::ExceptionGuard ( )

privatedelete

Gaudi::Guards::ExceptionGuard::ExceptionGuard ( const ExceptionGuard &  )

privatedelete

Member Function Documentation

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

inline

the result of function evaluation

Definition at line 138 of file Guards.h.

{ return m_sc; }

void Gaudi::Guards::ExceptionGuard::handle ( const GaudiException &  e, MsgStream &  s  )

protected

local handler of GaudiException

Definition at line 24 of file Guards.cpp.

                                                                                  {
  // the general printout
  log << MSG::FATAL << System::typeinfoName( typeid( exc ) ) << "('" << exc.tag() << "') is caught!" << endmsg;
  // print the detailes about the exception:
  log << MSG::ERROR << exc << endmsg;
  // get the status code form the exception:
  m_sc = exc.code();
}

void Gaudi::Guards::ExceptionGuard::handle ( const std::exception &  e, MsgStream &  s  )

protected

local handler of std::exception

Definition at line 35 of file Guards.cpp.

                                                                                {
  // the general printout
  log << MSG::FATAL << System::typeinfoName( typeid( exc ) ) << " is caught!" << endmsg;
  // print the detailes abotu the exception:
  log << MSG::ERROR << exc.what() << endmsg;
}

void Gaudi::Guards::ExceptionGuard::handle ( MsgStream &  s )

protected

local handler of UNKNOWN exceptions

Definition at line 44 of file Guards.cpp.

                                                       {
  // the general printout
  log << MSG::FATAL << "UNKNOWN exception is caught!" << endmsg;
}

Gaudi::Guards::ExceptionGuard::operator const StatusCode & ( ) const

inline

cast operator, useful for the implicit conversions

Definition at line 140 of file Guards.h.

{ return code(); }

ExceptionGuard& Gaudi::Guards::ExceptionGuard::operator= ( const ExceptionGuard &  )

privatedelete

Member Data Documentation

StatusCode Gaudi::Guards::ExceptionGuard::m_sc = StatusCode::FAILURE

private

status code : result of function evaluation

Definition at line 158 of file Guards.h.

---

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

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