ers::IssueFactory Class Reference

Implements factory pattern for user defined Issues. More...

#include <IssueFactory.hpp>

Public Member Functions
Issue *	create (const std::string &name, const Context &context) const
	build an empty issue for a given name
Issue *	create (const std::string &name, const std::list< std::string > &inheritance, const Context &context, Severity severityseverity, const system_clock::time_point &time, const std::string &message, const std::vector< std::string > &qualifiers, const std::map< std::string, std::string > &parameters, const Issue *cause=0) const
	build issue out of all the given parameters
void	register_issue (const std::string &name, IssueCreator creator)
	register an issue factory

Static Public Member Functions
static IssueFactory &	instance ()
	method to access singleton

Private Types
typedef Issue *(*	IssueCreator) (const ers::Context &)
typedef std::map< std::string, IssueCreator >	FunctionMap

Private Member Functions
	IssueFactory ()

Private Attributes
FunctionMap	m_creators

Friends
template<class>
class	SingletonCreator

Detailed Description

Implements factory pattern for user defined Issues.

This class implements factory pattern for Issues. The main responsibility of this class is to keep track of the existing types of Issues Each user defined issue class should register one factory method for creating instances of this class. This is required for reconstructing issues produced in the context of a different process.

Author

Serguei Kolos

Definition at line 55 of file IssueFactory.hpp.

Member Typedef Documentation

FunctionMap

typedef std::map<std::string,IssueCreator> ers::IssueFactory::FunctionMap

private

Definition at line 60 of file IssueFactory.hpp.

IssueCreator

typedef Issue *(* ers::IssueFactory::IssueCreator) (const ers::Context &)

private

Definition at line 59 of file IssueFactory.hpp.

Constructor & Destructor Documentation

IssueFactory()

ers::IssueFactory::IssueFactory ( )

inlineprivate

Definition at line 81 of file IssueFactory.hpp.

        { ; }

Member Function Documentation

create() [1/2]

ers::Issue * ers::IssueFactory::create	(	const std::string &	name,
		const Context &	context ) const

build an empty issue for a given name

Builds an issue out of the name it was registered with

Parameters

name	the name used to indentify the class

Returns

an newly allocated instance of type name or AnyIssue

Note

If the requested type cannot be resolved an instance of type AnyIssue

Definition at line 60 of file IssueFactory.cpp.

{
    FunctionMap::const_iterator it = m_creators.find(name); 
    if ( it == m_creators.end() )
    {
    ERS_INTERNAL_DEBUG( 1, "Creator for the \"" << name << "\" issue is not found" );
        return new ers::AnyIssue( name, context );
    }
    
    ERS_INTERNAL_DEBUG( 2, "Creating the \"" << name << "\" issue" );
    return (it->second)( context ); 
}

create() [2/2]

Issue * ers::IssueFactory::create	(	const std::string &	name,
		const std::list< std::string > &	inheritance,
		const Context &	context,
		Severity	severity,
		const system_clock::time_point &	time,
		const std::string &	message,
		const std::vector< std::string > &	qualifiers,
		const std::map< std::string, std::string > &	parameters,
		const Issue *	cause = 0 ) const

build issue out of all the given parameters

instance()

ers::IssueFactory & ers::IssueFactory::instance ( )

static

method to access singleton

Returns the singleton instance of the factory.

Returns

a reference to the singleton instance

Definition at line 33 of file IssueFactory.cpp.

{
    static ers::IssueFactory * instance = ers::SingletonCreator<ers::IssueFactory>::create();
    
    return *instance;
} // instance

register_issue()

void ers::IssueFactory::register_issue	(	const std::string &	name,
		IssueCreator	creator )

register an issue factory

Register an issue type with the factory

Parameters

name	the name that will be used to lookup new instances
creator	a pointer to the function used to create new instance for that particular type of function

Definition at line 45 of file IssueFactory.cpp.

{
    FunctionMap::const_iterator it = m_creators.find(name); 
    if ( it == m_creators.end() )
    {
    m_creators[name] = creator;
    }
}

Friends And Related Symbol Documentation

SingletonCreator

template<class>

friend class SingletonCreator

friend

Definition at line 57 of file IssueFactory.hpp.

Member Data Documentation

m_creators

FunctionMap ers::IssueFactory::m_creators

private

Definition at line 84 of file IssueFactory.hpp.

---

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

• /github/workspace/dunedaq/sourcecode/ers/include/ers/IssueFactory.hpp
• /github/workspace/dunedaq/sourcecode/ers/src/IssueFactory.cpp