DUNE-DAQ
DUNE Trigger and Data Acquisition software
Loading...
Searching...
No Matches
dunedaq::confmodel::VariableSet Class Reference

#include <VariableSet.hpp>

Inheritance diagram for dunedaq::confmodel::VariableSet:
[legend]
Collaboration diagram for dunedaq::confmodel::VariableSet:
[legend]

Public Member Functions

virtual void print (unsigned int offset, bool print_header, std::ostream &s) const
 Print details of the VariableSet object.
 
virtual std::vector< const dunedaq::conffwk::DalObject * > get (const std::string &name, bool upcast_unregistered=true) const
 Get values of relationships and results of some algorithms as a vector of dunedaq::conffwk::DalObject pointers.
 
const std::vector< const dunedaq::confmodel::VariableBase * > & get_contains () const
 Get "contains" relationship value. List of included variables or variable sets.
 
void set_contains (const std::vector< const dunedaq::confmodel::VariableBase * > &value)
 Set "contains" relationship value. List of included variables or variable sets.
 
virtual void print (unsigned int offset, bool print_header, std::ostream &s) const
 Print details of the VariableSet object.
 
virtual std::vector< const dunedaq::conffwk::DalObject * > get (const std::string &name, bool upcast_unregistered=true) const
 Get values of relationships and results of some algorithms as a vector of dunedaq::conffwk::DalObject pointers.
 
const std::vector< const dunedaq::confmodel::VariableBase * > & get_contains () const
 Get "contains" relationship value. List of included variables or variable sets.
 
void set_contains (const std::vector< const dunedaq::confmodel::VariableBase * > &value)
 Set "contains" relationship value. List of included variables or variable sets.
 
- Public Member Functions inherited from dunedaq::confmodel::VariableBase
const std::string & get_description () const
 Get "description" attribute value. Describes the purpose of the parameter.
 
void set_description (const std::string &value)
 Set "description" attribute value. Describes the purpose of the parameter.
 
const std::string & get_description () const
 Get "description" attribute value. Describes the purpose of the parameter.
 
void set_description (const std::string &value)
 Set "description" attribute value. Describes the purpose of the parameter.
 
- Public Member Functions inherited from dunedaq::conffwk::DalObject
const std::string & UID () const noexcept
 
const std::string & class_name () const noexcept
 
bool castable (const std::string &target) const noexcept
 
bool castable (const std::string *target) const noexcept
 
template<class TARGET >
const TARGET * cast () const noexcept
 Casts object to different class.
 
std::string full_name () const noexcept
 
const ConfigObjectconfig_object () const
 
DalRegistryregistry () const noexcept
 
Configurationconfiguration () const noexcept
 
void unread ()
 
void set (const ConfigObject &o) noexcept
 
void move (const std::string &at)
 
void rename (const std::string &new_id)
 
void p_hdr (std::ostream &s, unsigned int indent, const std::string &cl, const char *nm=nullptr) const
 print object headers
 
std::ostream & print_object (std::ostream &s) const
 print object details
 
void throw_init_ex (dunedaq::conffwk::Exception &ex)
 throw object initialisation exception (i.e.
 

Static Public Member Functions

static const std::string & __get_contains_str () noexcept
 
static const std::string & __get_contains_str () noexcept
 
- Static Public Member Functions inherited from dunedaq::confmodel::VariableBase
static const std::string & __get_description_str () noexcept
 
static const std::string & __get_description_str () noexcept
 
- Static Public Member Functions inherited from dunedaq::conffwk::DalObject
static void p_null (std::ostream &s)
 print "(null)"
 
static void p_rm (std::ostream &s)
 print "(deleted object)"
 
static void p_error (std::ostream &s, dunedaq::conffwk::Exception &ex)
 print error text
 
static void throw_get_ex (const std::string &what, const std::string &class_name, const DalObject *obj)
 throw exception in generated get method (i.e.
 
static bool is_null (const DalObject *ref) noexcept
 check a pointer on DAL object is null
 

Static Public Attributes

static const std::string & s_class_name
 
static const std::string s_contains = "contains"
 
- Static Public Attributes inherited from dunedaq::confmodel::VariableBase
static const std::string & s_class_name
 
static const std::string s_description = "description"
 

Protected Member Functions

 VariableSet (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
 
virtual ~VariableSet () noexcept
 
virtual void init (bool init_children)
 
bool get (const std::string &name, std::vector< const dunedaq::conffwk::DalObject * > &vec, bool upcast_unregistered, bool first_call) const
 
 VariableSet (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
 
virtual ~VariableSet () noexcept
 
virtual void init (bool init_children)
 
bool get (const std::string &name, std::vector< const dunedaq::conffwk::DalObject * > &vec, bool upcast_unregistered, bool first_call) const
 
- Protected Member Functions inherited from dunedaq::confmodel::VariableBase
 VariableBase (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
 
virtual ~VariableBase () noexcept
 
bool get (const std::string &name, std::vector< const dunedaq::conffwk::DalObject * > &vec, bool upcast_unregistered, bool first_call) const
 
 VariableBase (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
 
virtual ~VariableBase () noexcept
 
bool get (const std::string &name, std::vector< const dunedaq::conffwk::DalObject * > &vec, bool upcast_unregistered, bool first_call) const
 
- Protected Member Functions inherited from dunedaq::conffwk::DalObject
 DalObject (DalRegistry &db, const ConfigObject &o) noexcept
 
virtual ~DalObject ()
 
void clear () noexcept
 
void check () const
 
bool is_deleted () const
 
void increment_created () noexcept
 
void increment_read () noexcept
 
void check_init () const
 Check and initialize object if necessary.
 
template<typename T >
void _set_object (const std::string &name, const T *value)
 Helper method for generated set single-value relationship methods.
 
template<typename T >
void _set_objects (const std::string &name, const std::vector< const T * > &value)
 Helper method for generated set multi-value relationship methods.
 
bool get_rel_objects (const std::string &name, bool upcast_unregistered, std::vector< const DalObject * > &objs) const
 Read relationship values as DAL objects using DAL factory.
 
bool get_algo_objects (const std::string &name, std::vector< const DalObject * > &objs) const
 Run algorithm and return result as DAL objects using DAL factory.
 

Private Attributes

std::vector< const dunedaq::confmodel::VariableBase * > m_contains
 

Friends

class conffwk::Configuration
 
class conffwk::DalObject
 
class conffwk::DalFactory
 
class conffwk::DalRegistry
 

Additional Inherited Members

- Protected Attributes inherited from dunedaq::conffwk::DalObject
std::mutex m_mutex
 Used to protect changes of DAL object.
 
bool p_was_read
 is true, if the object was read
 
DalRegistryp_registry
 Configuration object.
 
ConfigObject p_obj
 Config object used by given template object.
 
std::string p_UID
 Is used for template objects (see dqm_conffwk)
 

Detailed Description

Set of variables or variable sets. Names and values of all nested variables are added to value of relationship using resource set.

Definition at line 27 of file VariableSet.hpp.

Constructor & Destructor Documentation

◆ VariableSet() [1/2]

dunedaq::confmodel::VariableSet::VariableSet ( conffwk::DalRegistry & db,
const conffwk::ConfigObject & obj )
protectednoexcept

Definition at line 26 of file VariableSet.cpp.

26 :
28 VariableBase(db, o)
29
30 {
31 ;
32 }
The base class for any generated DAL object.
Definition DalObject.hpp:45
VariableBase(conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept

◆ ~VariableSet() [1/2]

dunedaq::confmodel::VariableSet::~VariableSet ( )
protectedvirtualnoexcept

Definition at line 75 of file VariableSet.cpp.

76 {
77 }

◆ VariableSet() [2/2]

dunedaq::confmodel::VariableSet::VariableSet ( conffwk::DalRegistry & db,
const conffwk::ConfigObject & obj )
protectednoexcept

◆ ~VariableSet() [2/2]

virtual dunedaq::confmodel::VariableSet::~VariableSet ( )
protectedvirtualnoexcept

Member Function Documentation

◆ __get_contains_str() [1/2]

static const std::string & dunedaq::confmodel::VariableSet::__get_contains_str ( )
inlinestaticnoexcept

Definition at line 87 of file VariableSet.hpp.

87{ return s_contains; }
static const std::string s_contains

◆ __get_contains_str() [2/2]

static const std::string & dunedaq::confmodel::VariableSet::__get_contains_str ( )
inlinestaticnoexcept

Definition at line 87 of file VariableSet.hpp.

87{ return s_contains; }

◆ get() [1/4]

std::vector< const dunedaq::conffwk::DalObject * > dunedaq::confmodel::VariableSet::get ( const std::string & name,
bool upcast_unregistered = true ) const
virtual

Get values of relationships and results of some algorithms as a vector of dunedaq::conffwk::DalObject pointers.

Parameters are:

Parameters
namename of the relationship or algorithm
Returns
value of relationship or result of algorithm
Exceptions
std::exceptionif there is no relationship or algorithm with such name in this and base classes

Reimplemented from dunedaq::confmodel::VariableBase.

Definition at line 79 of file VariableSet.cpp.

80 {
81 std::vector<const dunedaq::conffwk::DalObject *> vec;
82
83 if (!get(name, vec, upcast_unregistered, true))
84 throw_get_ex(name, s_class_name, this);
85
86 return vec;
87 }
static void throw_get_ex(const std::string &what, const std::string &class_name, const DalObject *obj)
throw exception in generated get method (i.e.
Definition DalObject.cpp:82
static const std::string & s_class_name
virtual std::vector< const dunedaq::conffwk::DalObject * > get(const std::string &name, bool upcast_unregistered=true) const
Get values of relationships and results of some algorithms as a vector of dunedaq::conffwk::DalObject...

◆ get() [2/4]

virtual std::vector< const dunedaq::conffwk::DalObject * > dunedaq::confmodel::VariableSet::get ( const std::string & name,
bool upcast_unregistered = true ) const
virtual

Get values of relationships and results of some algorithms as a vector of dunedaq::conffwk::DalObject pointers.

Parameters are:

Parameters
namename of the relationship or algorithm
Returns
value of relationship or result of algorithm
Exceptions
std::exceptionif there is no relationship or algorithm with such name in this and base classes

Reimplemented from dunedaq::confmodel::VariableBase.

◆ get() [3/4]

bool dunedaq::confmodel::VariableSet::get ( const std::string & name,
std::vector< const dunedaq::conffwk::DalObject * > & vec,
bool upcast_unregistered,
bool first_call ) const
protected

Definition at line 89 of file VariableSet.cpp.

90 {
91 if (first_call)
92 {
93 std::lock_guard scoped_lock(m_mutex);
94
95 check();
96 check_init();
97
98 if (get_rel_objects(name, upcast_unregistered, vec))
99 return true;
100 }
101
102 if (VariableBase::get(name, vec, upcast_unregistered, false)) return true;
103
104 if (first_call)
105 return get_algo_objects(name, vec);
106
107 return false;
108 }
bool get_rel_objects(const std::string &name, bool upcast_unregistered, std::vector< const DalObject * > &objs) const
Read relationship values as DAL objects using DAL factory.
Definition DalObject.cpp:8
std::mutex m_mutex
Used to protect changes of DAL object.
bool get_algo_objects(const std::string &name, std::vector< const DalObject * > &objs) const
Run algorithm and return result as DAL objects using DAL factory.
Definition DalObject.cpp:25
void check_init() const
Check and initialize object if necessary.
virtual std::vector< const dunedaq::conffwk::DalObject * > get(const std::string &name, bool upcast_unregistered=true) const
Get values of relationships and results of some algorithms as a vector of dunedaq::conffwk::DalObject...

◆ get() [4/4]

bool dunedaq::confmodel::VariableSet::get ( const std::string & name,
std::vector< const dunedaq::conffwk::DalObject * > & vec,
bool upcast_unregistered,
bool first_call ) const
protected

◆ get_contains() [1/2]

const std::vector< const dunedaq::confmodel::VariableBase * > & dunedaq::confmodel::VariableSet::get_contains ( ) const
inline

Get "contains" relationship value. List of included variables or variable sets.

Returns
the relationship value
Exceptions
dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Definition at line 98 of file VariableSet.hpp.

99 {
100 std::lock_guard scoped_lock(m_mutex);
101 check();
102 check_init();
103 if (m_contains.empty())
104 {
105 std::ostringstream text;
106 text << "relationship \"" << s_contains << "\" of object " << this << " is empty";
107 throw dunedaq::conffwk::Generic(ERS_HERE, text.str().c_str());
108 }
109 return m_contains;
110 }
#define ERS_HERE
Generic configuration exception.
std::vector< const dunedaq::confmodel::VariableBase * > m_contains

◆ get_contains() [2/2]

const std::vector< const dunedaq::confmodel::VariableBase * > & dunedaq::confmodel::VariableSet::get_contains ( ) const
inline

Get "contains" relationship value. List of included variables or variable sets.

Returns
the relationship value
Exceptions
dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Definition at line 98 of file VariableSet.hpp.

99 {
100 std::lock_guard scoped_lock(m_mutex);
101 check();
102 check_init();
103 if (m_contains.empty())
104 {
105 std::ostringstream text;
106 text << "relationship \"" << s_contains << "\" of object " << this << " is empty";
107 throw dunedaq::conffwk::Generic(ERS_HERE, text.str().c_str());
108 }
109 return m_contains;
110 }

◆ init() [1/2]

void dunedaq::confmodel::VariableSet::init ( bool init_children)
protectedvirtual

Initialize object (method generated by genconffwk)

Parameters
init_childrenif true, initialize referenced objects

Reimplemented from dunedaq::confmodel::VariableBase.

Definition at line 61 of file VariableSet.cpp.

62 {
63 VariableBase::init(init_children);
64
65 TLOG_DEBUG(5) << "read object " << this << " (class " << s_class_name << ')';
66
67 try {
69 }
70 catch (dunedaq::conffwk::Exception & ex) {
71 throw_init_ex(ex);
72 }
73 }
void throw_init_ex(dunedaq::conffwk::Exception &ex)
throw object initialisation exception (i.e.
Definition DalObject.cpp:74
DalRegistry & p_registry
Configuration object.
ConfigObject p_obj
Config object used by given template object.
const T * _ref(ConfigObject &obj, const std::string &name, bool read_children)
Get signle value of object's relation and instantiate result with it (multi-thread safe).
virtual void init(bool init_children)
#define TLOG_DEBUG(lvl,...)
Definition Logging.hpp:112

◆ init() [2/2]

virtual void dunedaq::confmodel::VariableSet::init ( bool init_children)
protectedvirtual

Initialize object (method generated by genconffwk)

Parameters
init_childrenif true, initialize referenced objects

Reimplemented from dunedaq::confmodel::VariableBase.

◆ print() [1/2]

void dunedaq::confmodel::VariableSet::print ( unsigned int offset,
bool print_header,
std::ostream & s ) const
virtual

Print details of the VariableSet object.

Parameters are:

Parameters
offsetnumber of spaces to shift object right (useful to print nested objects)
print_headerif false, do not print object header (to print attributes of base classes)
soutput stream

Reimplemented from dunedaq::confmodel::VariableBase.

Definition at line 35 of file VariableSet.cpp.

36 {
37 check_init();
38
39 try {
40 const std::string str(indent+2, ' ');
41
42 if (print_header)
43 p_hdr(s, indent, s_class_name, "dunedaq::confmodel");
44
45
46 // print direct super-classes
47
49
50
51 // print direct relationships
52
54 }
55 catch (dunedaq::conffwk::Exception & ex) {
57 }
58 }
void p_hdr(std::ostream &s, unsigned int indent, const std::string &cl, const char *nm=nullptr) const
print object headers
Definition DalObject.cpp:65
static void p_error(std::ostream &s, dunedaq::conffwk::Exception &ex)
print error text
Definition DalObject.cpp:59
virtual void print(unsigned int offset, bool print_header, std::ostream &s) const
Print details of the VariableBase object.
void p_mv_rel(std::ostream &s, const std::string &str, const std::string &name, const T &objs) noexcept
print weak multi-value relationship

◆ print() [2/2]

virtual void dunedaq::confmodel::VariableSet::print ( unsigned int offset,
bool print_header,
std::ostream & s ) const
virtual

Print details of the VariableSet object.

Parameters are:

Parameters
offsetnumber of spaces to shift object right (useful to print nested objects)
print_headerif false, do not print object header (to print attributes of base classes)
soutput stream

Reimplemented from dunedaq::confmodel::VariableBase.

◆ set_contains() [1/2]

void dunedaq::confmodel::VariableSet::set_contains ( const std::vector< const dunedaq::confmodel::VariableBase * > & value)

Set "contains" relationship value. List of included variables or variable sets.

Parameters
valuenew relationship value
Exceptions
dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Definition at line 110 of file VariableSet.cpp.

111 {
112 _set_objects(s_contains, value);
113 }
void _set_objects(const std::string &name, const std::vector< const T * > &value)
Helper method for generated set multi-value relationship methods.

◆ set_contains() [2/2]

void dunedaq::confmodel::VariableSet::set_contains ( const std::vector< const dunedaq::confmodel::VariableBase * > & value)

Set "contains" relationship value. List of included variables or variable sets.

Parameters
valuenew relationship value
Exceptions
dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Friends And Related Symbol Documentation

◆ conffwk::Configuration

Definition at line 29 of file VariableSet.hpp.

◆ conffwk::DalFactory

conffwk::DalFactory
friend

Definition at line 31 of file VariableSet.hpp.

◆ conffwk::DalObject

Definition at line 30 of file VariableSet.hpp.

◆ conffwk::DalRegistry

Definition at line 32 of file VariableSet.hpp.

Member Data Documentation

◆ m_contains

std::vector< const dunedaq::confmodel::VariableBase * > dunedaq::confmodel::VariableSet::m_contains
private

Definition at line 78 of file VariableSet.hpp.

◆ s_class_name

static const std::string & dunedaq::confmodel::VariableSet::s_class_name
static

The name of the configuration class.

Definition at line 44 of file VariableSet.hpp.

◆ s_contains

static const std::string dunedaq::confmodel::VariableSet::s_contains = "contains"
inlinestatic

Definition at line 85 of file VariableSet.hpp.


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