dunedaq::confmodel::ResourceTree Class Reference

#include <ResourceTree.hpp>

Inheritance diagram for dunedaq::confmodel::ResourceTree:

Collaboration diagram for dunedaq::confmodel::ResourceTree:

Public Member Functions
virtual void	print (unsigned int offset, bool print_header, std::ostream &s) const
	Print details of the ResourceTree 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::Resource * > &	get_disabled () const
	Get "disabled" relationship value. Resources that should not participate in the current run.
void	set_disabled (const std::vector< const dunedaq::confmodel::Resource * > &value)
	Set "disabled" relationship value. Resources that should not participate in the current run.
const dunedaq::confmodel::DisabledResources &	disabled_components () const
virtual const ResourceSet *	resource_root () const =0
virtual void	print (unsigned int offset, bool print_header, std::ostream &s) const
	Print details of the ResourceTree 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::Resource * > &	get_disabled () const
	Get "disabled" relationship value. Resources that should not participate in the current run.
void	set_disabled (const std::vector< const dunedaq::confmodel::Resource * > &value)
	Set "disabled" relationship value. Resources that should not participate in the current run.
const dunedaq::confmodel::DisabledResources &	disabled_components () const
virtual const ResourceSet *	resource_root () const =0
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 ConfigObject &	config_object () const
DalRegistry &	registry () const noexcept
Configuration &	configuration () 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_disabled_str () noexcept
static const std::string &	__get_disabled_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_disabled = "disabled"

Protected Member Functions
	ResourceTree (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
virtual	~ResourceTree () 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
	ResourceTree (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
virtual	~ResourceTree () 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::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::Resource * >	m_disabled
DisabledResources	m_disabled_resources

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
DalRegistry &	p_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

Definition at line 35 of file ResourceTree.hpp.

Constructor & Destructor Documentation

ResourceTree() [1/2]

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

protectednoexcept

Definition at line 20 of file ResourceTree.cpp.

                                                                                            :
      dunedaq::conffwk::DalObject(db, o)
    {
      ;
    }

~ResourceTree() [1/2]

dunedaq::confmodel::ResourceTree::~ResourceTree ( )

protectedvirtualnoexcept

Definition at line 62 of file ResourceTree.cpp.

    {
    }

ResourceTree() [2/2]

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

protectednoexcept

~ResourceTree() [2/2]

virtual dunedaq::confmodel::ResourceTree::~ResourceTree ( )

protectedvirtualnoexcept

Member Function Documentation

__get_disabled_str() [1/2]

static const std::string & dunedaq::confmodel::ResourceTree::__get_disabled_str ( )

inlinestaticnoexcept

Definition at line 98 of file ResourceTree.hpp.

{ return s_disabled; }

__get_disabled_str() [2/2]

static const std::string & dunedaq::confmodel::ResourceTree::__get_disabled_str ( )

inlinestaticnoexcept

Definition at line 98 of file ResourceTree.hpp.

{ return s_disabled; }

disabled_components() [1/2]

const dunedaq::confmodel::DisabledResources & dunedaq::confmodel::ResourceTree::disabled_components

(

)

const

Definition at line 102 of file ResourceTree.cpp.

    {
if (!m_disabled_resources.initialised()) {
 m_disabled_resources.update(resource_root(),get_disabled());
}
return m_disabled_resources;
    }

disabled_components() [2/2]

const dunedaq::confmodel::DisabledResources & dunedaq::confmodel::ResourceTree::disabled_components

(

)

const

get() [1/4]

std::vector< const dunedaq::conffwk::DalObject * > dunedaq::confmodel::ResourceTree::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

name	name of the relationship or algorithm

Returns

value of relationship or result of algorithm

Exceptions

std::exception

if there is no relationship or algorithm with such name in this and base classes

Implements dunedaq::conffwk::DalObject.

Reimplemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

Definition at line 66 of file ResourceTree.cpp.

    {
      std::vector<const dunedaq::conffwk::DalObject *> vec;
 
      if (!get(name, vec, upcast_unregistered, true))
        throw_get_ex(name, s_class_name, this);
 
      return vec;
    }

get() [2/4]

virtual std::vector< const dunedaq::conffwk::DalObject * > dunedaq::confmodel::ResourceTree::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

name	name of the relationship or algorithm

Returns

value of relationship or result of algorithm

Exceptions

std::exception

if there is no relationship or algorithm with such name in this and base classes

Implements dunedaq::conffwk::DalObject.

Reimplemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

get() [3/4]

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

protected

Definition at line 76 of file ResourceTree.cpp.

    {
      if (first_call)
        {
          std::lock_guard scoped_lock(m_mutex);
 
          check();
          check_init();
 
          if (get_rel_objects(name, upcast_unregistered, vec))
            return true;
        }
 
      if (first_call)
        return get_algo_objects(name, vec);
 
      return false;
    }

get() [4/4]

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

protected

get_disabled() [1/2]

const std::vector< const dunedaq::confmodel::Resource * > & dunedaq::confmodel::ResourceTree::get_disabled ( ) const

inline

Get "disabled" relationship value. Resources that should not participate in the current run.

Returns

the relationship value

Exceptions

dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Definition at line 109 of file ResourceTree.hpp.

        {
          std::lock_guard scoped_lock(m_mutex);
          check();
          check_init();
          return m_disabled;
        }

get_disabled() [2/2]

const std::vector< const dunedaq::confmodel::Resource * > & dunedaq::confmodel::ResourceTree::get_disabled ( ) const

inline

Get "disabled" relationship value. Resources that should not participate in the current run.

Returns

the relationship value

Exceptions

dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Definition at line 109 of file ResourceTree.hpp.

        {
          std::lock_guard scoped_lock(m_mutex);
          check();
          check_init();
          return m_disabled;
        }

init() [1/2]

void dunedaq::confmodel::ResourceTree::init ( bool init_children )

protectedvirtual

Initialize object (method generated by genconffwk)

Parameters

init_children

if true, initialize referenced objects

Implements dunedaq::conffwk::DalObject.

Reimplemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

Definition at line 48 of file ResourceTree.cpp.

    {
      p_was_read = true;
      increment_read();
      TLOG_DEBUG(5) << "read object " << this << " (class " << s_class_name << ')';
 
      try {
        p_registry._ref<dunedaq::confmodel::Resource>(p_obj, s_disabled, m_disabled, init_children);
      }
      catch (dunedaq::conffwk::Exception & ex) {
        throw_init_ex(ex);
      }
    }

init() [2/2]

virtual void dunedaq::confmodel::ResourceTree::init ( bool init_children )

protectedvirtual

Initialize object (method generated by genconffwk)

Parameters

init_children

if true, initialize referenced objects

Implements dunedaq::conffwk::DalObject.

Reimplemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

print() [1/2]

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

virtual

Print details of the ResourceTree object.

Parameters are:

Parameters

offset	number of spaces to shift object right (useful to print nested objects)
print_header	if false, do not print object header (to print attributes of base classes)
s	output stream

Implements dunedaq::conffwk::DalObject.

Reimplemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

Definition at line 27 of file ResourceTree.cpp.

    {
      check_init();
 
      try {
        const std::string str(indent+2, ' ');
 
        if (print_header)
          p_hdr(s, indent, s_class_name, "dunedaq::confmodel");
 
 
          // print direct relationships
 
        dunedaq::conffwk::p_mv_rel(s, str, indent, s_disabled, m_disabled);
      }
      catch (dunedaq::conffwk::Exception & ex) {
        dunedaq::conffwk::DalObject::p_error(s, ex);
      }
    }

print() [2/2]

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

virtual

Print details of the ResourceTree object.

Parameters are:

Parameters

offset	number of spaces to shift object right (useful to print nested objects)
print_header	if false, do not print object header (to print attributes of base classes)
s	output stream

Implements dunedaq::conffwk::DalObject.

Reimplemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

resource_root() [1/2]

virtual const ResourceSet * dunedaq::confmodel::ResourceTree::resource_root ( ) const

pure virtual

Implemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

resource_root() [2/2]

virtual const ResourceSet * dunedaq::confmodel::ResourceTree::resource_root ( ) const

pure virtual

Implemented in dunedaq::confmodel::Session, and dunedaq::confmodel::Session.

set_disabled() [1/2]

void dunedaq::confmodel::ResourceTree::set_disabled

(

const std::vector< const dunedaq::confmodel::Resource * > &

value

)

Set "disabled" relationship value. Resources that should not participate in the current run.

Parameters

value

new relationship value

Exceptions

dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Definition at line 95 of file ResourceTree.cpp.

    {
      _set_objects(s_disabled, value);
    }

set_disabled() [2/2]

void dunedaq::confmodel::ResourceTree::set_disabled

(

const std::vector< const dunedaq::confmodel::Resource * > &

value

)

Set "disabled" relationship value. Resources that should not participate in the current run.

Parameters

value

new relationship value

Exceptions

dunedaq::conffwk::Generic,dunedaq::conffwk::DeletedObject

Friends And Related Symbol Documentation

conffwk::Configuration

conffwk::Configuration

friend

Definition at line 37 of file ResourceTree.hpp.

conffwk::DalFactory

conffwk::DalFactory

friend

Definition at line 39 of file ResourceTree.hpp.

conffwk::DalObject

conffwk::DalObject

friend

Definition at line 38 of file ResourceTree.hpp.

conffwk::DalRegistry

conffwk::DalRegistry

friend

Definition at line 40 of file ResourceTree.hpp.

Member Data Documentation

m_disabled

std::vector< const dunedaq::confmodel::Resource * > dunedaq::confmodel::ResourceTree::m_disabled

private

Definition at line 86 of file ResourceTree.hpp.

m_disabled_resources

DisabledResources dunedaq::confmodel::ResourceTree::m_disabled_resources

mutableprivate

Definition at line 89 of file ResourceTree.hpp.

s_class_name

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

static

The name of the configuration class.

Definition at line 52 of file ResourceTree.hpp.

s_disabled

static const std::string dunedaq::confmodel::ResourceTree::s_disabled = "disabled"

inlinestatic

Definition at line 96 of file ResourceTree.hpp.

---

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

• /github/workspace/dunedaq/build/confmodel/codegen/include/confmodel/ResourceTree.hpp
• /github/workspace/dunedaq/build/confmodel/codegen/src/ResourceTree.hpp
• /github/workspace/dunedaq/build/confmodel/codegen/src/ResourceTree.cpp