dunedaq::confmodel::VirtualHost Class Reference

#include <VirtualHost.hpp>

Inheritance diagram for dunedaq::confmodel::VirtualHost:

Collaboration diagram for dunedaq::confmodel::VirtualHost:

Public Member Functions
virtual void	print (unsigned int offset, bool print_header, std::ostream &s) const
	Print details of the VirtualHost 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::HostComponent * > &	get_uses () const
	Get "uses" relationship value. Hardware resources required by this virtual host.
void	set_uses (const std::vector< const dunedaq::confmodel::HostComponent * > &value)
	Set "uses" relationship value. Hardware resources required by this virtual host.
const dunedaq::confmodel::PhysicalHost *	get_runs_on () const
	Get "runs_on" relationship value. The physical host that this virtual host runs on.
void	set_runs_on (const dunedaq::confmodel::PhysicalHost *value)
	Set "runs_on" relationship value. The physical host that this virtual host runs on.
virtual void	print (unsigned int offset, bool print_header, std::ostream &s) const
	Print details of the VirtualHost 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::HostComponent * > &	get_uses () const
	Get "uses" relationship value. Hardware resources required by this virtual host.
void	set_uses (const std::vector< const dunedaq::confmodel::HostComponent * > &value)
	Set "uses" relationship value. Hardware resources required by this virtual host.
const dunedaq::confmodel::PhysicalHost *	get_runs_on () const
	Get "runs_on" relationship value. The physical host that this virtual host runs on.
void	set_runs_on (const dunedaq::confmodel::PhysicalHost *value)
	Set "runs_on" relationship value. The physical host that this virtual host runs on.
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_uses_str () noexcept
static const std::string &	__get_runs_on_str () noexcept
static const std::string &	__get_uses_str () noexcept
static const std::string &	__get_runs_on_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_uses = "uses"
static const std::string	s_runs_on = "runs_on"

Protected Member Functions
	VirtualHost (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
virtual	~VirtualHost () 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
	VirtualHost (conffwk::DalRegistry &db, const conffwk::ConfigObject &obj) noexcept
virtual	~VirtualHost () 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::HostComponent * >	m_uses
const dunedaq::confmodel::PhysicalHost *	m_runs_on

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 30 of file VirtualHost.hpp.

Constructor & Destructor Documentation

VirtualHost() [1/2]

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

protectednoexcept

Definition at line 32 of file VirtualHost.cpp.

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

~VirtualHost() [1/2]

dunedaq::confmodel::VirtualHost::~VirtualHost ( )

protectedvirtualnoexcept

Definition at line 78 of file VirtualHost.cpp.

    {
    }

VirtualHost() [2/2]

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

protectednoexcept

~VirtualHost() [2/2]

virtual dunedaq::confmodel::VirtualHost::~VirtualHost ( )

protectedvirtualnoexcept

Member Function Documentation

__get_runs_on_str() [1/2]

static const std::string & dunedaq::confmodel::VirtualHost::__get_runs_on_str ( )

inlinestaticnoexcept

Definition at line 93 of file VirtualHost.hpp.

{ return s_runs_on; }

__get_runs_on_str() [2/2]

static const std::string & dunedaq::confmodel::VirtualHost::__get_runs_on_str ( )

inlinestaticnoexcept

Definition at line 93 of file VirtualHost.hpp.

{ return s_runs_on; }

__get_uses_str() [1/2]

static const std::string & dunedaq::confmodel::VirtualHost::__get_uses_str ( )

inlinestaticnoexcept

Definition at line 92 of file VirtualHost.hpp.

{ return s_uses; }

__get_uses_str() [2/2]

static const std::string & dunedaq::confmodel::VirtualHost::__get_uses_str ( )

inlinestaticnoexcept

Definition at line 92 of file VirtualHost.hpp.

{ return s_uses; }

get() [1/4]

std::vector< const dunedaq::conffwk::DalObject * > dunedaq::confmodel::VirtualHost::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::appmodel::ReadoutHost, and dunedaq::appmodel::ReadoutHost.

Definition at line 82 of file VirtualHost.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::VirtualHost::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::appmodel::ReadoutHost, and dunedaq::appmodel::ReadoutHost.

get() [3/4]

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

protected

Definition at line 92 of file VirtualHost.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::VirtualHost::get ( const std::string & name, std::vector< const dunedaq::conffwk::DalObject * > & vec, bool upcast_unregistered, bool first_call ) const

protected

get_runs_on() [1/2]

const dunedaq::confmodel::PhysicalHost * dunedaq::confmodel::VirtualHost::get_runs_on ( ) const

inline

Get "runs_on" relationship value. The physical host that this virtual host runs on.

Returns

the relationship value

Exceptions

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

Definition at line 137 of file VirtualHost.hpp.

        {
          std::lock_guard scoped_lock(m_mutex);
          check();
          check_init();
          if (!m_runs_on)
            {
              std::ostringstream text;
              text << "relationship \"" << s_runs_on << "\" of object " << this << " is not set";
              throw dunedaq::conffwk::Generic(ERS_HERE, text.str().c_str());
            }
          return m_runs_on;
        }

get_runs_on() [2/2]

const dunedaq::confmodel::PhysicalHost * dunedaq::confmodel::VirtualHost::get_runs_on ( ) const

inline

Get "runs_on" relationship value. The physical host that this virtual host runs on.

Returns

the relationship value

Exceptions

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

Definition at line 137 of file VirtualHost.hpp.

        {
          std::lock_guard scoped_lock(m_mutex);
          check();
          check_init();
          if (!m_runs_on)
            {
              std::ostringstream text;
              text << "relationship \"" << s_runs_on << "\" of object " << this << " is not set";
              throw dunedaq::conffwk::Generic(ERS_HERE, text.str().c_str());
            }
          return m_runs_on;
        }

get_uses() [1/2]

const std::vector< const dunedaq::confmodel::HostComponent * > & dunedaq::confmodel::VirtualHost::get_uses ( ) const

inline

Get "uses" relationship value. Hardware resources required by this virtual host.

Returns

the relationship value

Exceptions

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

Definition at line 104 of file VirtualHost.hpp.

        {
          std::lock_guard scoped_lock(m_mutex);
          check();
          check_init();
          if (m_uses.empty())
            {
              std::ostringstream text;
              text << "relationship \"" << s_uses << "\" of object " << this << " is empty";
              throw dunedaq::conffwk::Generic(ERS_HERE, text.str().c_str());
            }
          return m_uses;
        }

get_uses() [2/2]

const std::vector< const dunedaq::confmodel::HostComponent * > & dunedaq::confmodel::VirtualHost::get_uses ( ) const

inline

Get "uses" relationship value. Hardware resources required by this virtual host.

Returns

the relationship value

Exceptions

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

Definition at line 104 of file VirtualHost.hpp.

        {
          std::lock_guard scoped_lock(m_mutex);
          check();
          check_init();
          if (m_uses.empty())
            {
              std::ostringstream text;
              text << "relationship \"" << s_uses << "\" of object " << this << " is empty";
              throw dunedaq::conffwk::Generic(ERS_HERE, text.str().c_str());
            }
          return m_uses;
        }

init() [1/2]

void dunedaq::confmodel::VirtualHost::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::appmodel::ReadoutHost, and dunedaq::appmodel::ReadoutHost.

Definition at line 63 of file VirtualHost.cpp.

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

init() [2/2]

virtual void dunedaq::confmodel::VirtualHost::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::appmodel::ReadoutHost, and dunedaq::appmodel::ReadoutHost.

print() [1/2]

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

virtual

Print details of the VirtualHost 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::appmodel::ReadoutHost, and dunedaq::appmodel::ReadoutHost.

Definition at line 41 of file VirtualHost.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_uses, m_uses);
        dunedaq::conffwk::p_sv_rel(s, str, indent, s_runs_on, m_runs_on);
      }
      catch (dunedaq::conffwk::Exception & ex) {
        dunedaq::conffwk::DalObject::p_error(s, ex);
      }
    }

print() [2/2]

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

virtual

Print details of the VirtualHost 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::appmodel::ReadoutHost, and dunedaq::appmodel::ReadoutHost.

set_runs_on() [1/2]

void dunedaq::confmodel::VirtualHost::set_runs_on

(

const dunedaq::confmodel::PhysicalHost *

value

)

Set "runs_on" relationship value. The physical host that this virtual host runs on.

Parameters

value

new relationship value

Exceptions

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

Definition at line 116 of file VirtualHost.cpp.

    {
      _set_object(s_runs_on, value);
    }

set_runs_on() [2/2]

void dunedaq::confmodel::VirtualHost::set_runs_on

(

const dunedaq::confmodel::PhysicalHost *

value

)

Set "runs_on" relationship value. The physical host that this virtual host runs on.

Parameters

value

new relationship value

Exceptions

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

set_uses() [1/2]

void dunedaq::confmodel::VirtualHost::set_uses

(

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

value

)

Set "uses" relationship value. Hardware resources required by this virtual host.

Parameters

value

new relationship value

Exceptions

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

Definition at line 111 of file VirtualHost.cpp.

    {
      _set_objects(s_uses, value);
    }

set_uses() [2/2]

void dunedaq::confmodel::VirtualHost::set_uses

(

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

value

)

Set "uses" relationship value. Hardware resources required by this virtual host.

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 32 of file VirtualHost.hpp.

conffwk::DalFactory

conffwk::DalFactory

friend

Definition at line 34 of file VirtualHost.hpp.

conffwk::DalObject

conffwk::DalObject

friend

Definition at line 33 of file VirtualHost.hpp.

conffwk::DalRegistry

conffwk::DalRegistry

friend

Definition at line 35 of file VirtualHost.hpp.

Member Data Documentation

m_runs_on

const dunedaq::confmodel::PhysicalHost * dunedaq::confmodel::VirtualHost::m_runs_on

private

Definition at line 82 of file VirtualHost.hpp.

m_uses

std::vector< const dunedaq::confmodel::HostComponent * > dunedaq::confmodel::VirtualHost::m_uses

private

Definition at line 81 of file VirtualHost.hpp.

s_class_name

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

static

The name of the configuration class.

Definition at line 47 of file VirtualHost.hpp.

s_runs_on

static const std::string dunedaq::confmodel::VirtualHost::s_runs_on = "runs_on"

inlinestatic

Definition at line 90 of file VirtualHost.hpp.

s_uses

static const std::string dunedaq::confmodel::VirtualHost::s_uses = "uses"

inlinestatic

Definition at line 89 of file VirtualHost.hpp.

---

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

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