In This Package:

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:

[legend]List of all members.

Public Member Functions
template<class OBJECT, class FUNCTION>
	ExceptionGuard (OBJECT obj, FUNCTION fun, MsgStream &log, IExceptionSvc *svc=0)
	~ExceptionGuard ()
	destructor
const StatusCode &	code () const
	the result of function evaluation
	operator const StatusCode & () const
	cast operator, useful for the implict conversions
Protected Member Functions
void	handle (const GaudiException &e, MsgStream &s)
	local handler of GaudiException
void	handle (const std::exception &e, MsgStream &s)
	local handler of std::xception
void	handle (MsgStream &s)
	local handler of UNKNOWN exceptions
Private Member Functions
	ExceptionGuard ()
	default constructor is disabled
	ExceptionGuard (const ExceptionGuard &)
	no copy
ExceptionGuard &	operator= (const ExceptionGuard &)
	no assignement
Private Attributes
StatusCode	m_sc
	status code : result of function evaluation

---

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_fun(&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 ibelyaev@physics.syr.edu

Date:

2007-03-07

Definition at line 108 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]

Definition at line 118 of file Guards.h.

        : m_sc  ( StatusCode::FAILURE ) 
      {
        try  
        { 
          // execute the functor:
          m_sc = fun ( obj ) ;  
          // in the case of error try use Exception Service 
          if ( 0 != 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 ( 0 != 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 ( 0 != svc ) { m_sc = svc -> handle ( *obj , e ) ; } 
        }
        catch ( ...  ) 
        {
          // Use the local handler and then (if possible) the Exception Service  
          handle (      log ) ; 
          if ( 0 != svc ) { m_sc = svc -> handle ( *obj     ) ; } 
        } 
      }   

Gaudi::Guards::ExceptionGuard::~ExceptionGuard

(

)

destructor

Gaudi::Guards::ExceptionGuard::ExceptionGuard

(

)

[private]

default constructor is disabled

Gaudi::Guards::ExceptionGuard::ExceptionGuard

(

const ExceptionGuard &

)

[private]

no copy

---

Member Function Documentation

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

(

)

const [inline]

the result of function evaluation

Definition at line 154 of file Guards.h.

{ return m_sc   ; }

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

(

)

const [inline]

cast operator, useful for the implict conversions

Definition at line 156 of file Guards.h.

{ return code() ; }

ExceptionGuard& Gaudi::Guards::ExceptionGuard::operator=

(

const ExceptionGuard &

)

[private]

no assignement

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

local handler of GaudiException

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

local handler of std::xception

void Gaudi::Guards::ExceptionGuard::handle

(

MsgStream &

s

)

[protected]

local handler of UNKNOWN exceptions

---

Member Data Documentation

StatusCode Gaudi::Guards::ExceptionGuard::m_sc [private]

status code : result of function evaluation

Definition at line 173 of file Guards.h.

---

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

• /home/dayabay/installs/trunk_2011_04_11_opt/NuWa-trunk/gaudi/GaudiKernel/GaudiKernel/Guards.h

---