dbe::inner::configobject::gref< T > Class Template Reference

#include <config_reference_copy.hpp>

Public Types
typedef T	t_extractor
typedef std::function< void(dref const) >	config_action_notifiable

Public Member Functions
bool	is_null () const
void	notify (config_action_notifiable tele)

Private Types
typedef std::deque< t_extractor >	type_extractor_stack
typedef std::vector< dbe::tref >	type_ref_container

Private Member Functions
tref	rebuild ()
void	record (tref const &obj)
void	post ()

Private Attributes
type_extractor_stack	this_remove_stack
type_ref_container	this_notify_stack

Friends
class	inner::dbcontroller

Detailed Description

template<typename T = config_object_linker>
class dbe::inner::configobject::gref< T >

Holds a graph copy of the subgraph associated with the referenced object, which is the result of a deletion operation in dbcontroller. It can only be used to attempt reviving the object

The object copy can only be used for passing it to a dbcontroller for recreation of the associated objects. A gref does not support querying the underlying copy.

Definition at line 72 of file config_reference_copy.hpp.

Member Typedef Documentation

config_action_notifiable

template<typename T = config_object_linker>

typedef std::function<void ( dref const ) > dbe::inner::configobject::gref< T >::config_action_notifiable

Definition at line 76 of file config_reference_copy.hpp.

t_extractor

template<typename T = config_object_linker>

typedef T dbe::inner::configobject::gref< T >::t_extractor

Definition at line 75 of file config_reference_copy.hpp.

type_extractor_stack

template<typename T = config_object_linker>

typedef std::deque<t_extractor> dbe::inner::configobject::gref< T >::type_extractor_stack

private

Definition at line 95 of file config_reference_copy.hpp.

type_ref_container

template<typename T = config_object_linker>

typedef std::vector<dbe::tref> dbe::inner::configobject::gref< T >::type_ref_container

private

Definition at line 96 of file config_reference_copy.hpp.

Member Function Documentation

is_null()

template<typename T>

bool dbe::inner::configobject::gref< T >::is_null

(

)

const

Checks if the front of the queue is valid

Returns

true / false on condition evaluation of the state of the object at front

Definition at line 136 of file dbcontroller.cpp.

{
  return this_remove_stack.front().is_null();
}

notify()

template<typename T>

void dbe::inner::configobject::gref< T >::notify

(

config_action_notifiable

tele

)

Passing a notifiable to permits to make a callback with the object and notify of it having been in different states in the the program structure. The notifiable actually determines what type of modification may be sent.

Parameters

tele	is a notifiable that receives an object descriptor

Definition at line 96 of file dbcontroller.cpp.

{
  if (this_notify_stack.empty())
  {
    for (typename type_extractor_stack::value_type const & val : this_remove_stack)
    {
      tele(val.ref);
    }
  }
  else
  {
    for (typename type_ref_container::value_type const & val : this_notify_stack)
    {
      tele(val);
    }
  }
}

post()

template<typename T>

void dbe::inner::configobject::gref< T >::post ( )

private

Filtering function checks after deletion of objects and keep only those that have been removed

Definition at line 78 of file dbcontroller.cpp.

{
  type_extractor_stack acopy;
  std::swap(acopy, this_remove_stack);
 
  while (not acopy.empty())
  {
    t_extractor candidate = acopy.front();
    // Keep only objects that have been deleted
    if (not dbe::config::api::info::has_obj(candidate.ref.class_name(),
                                            candidate.ref.UID()))
    {
      this_remove_stack.push_back(candidate);
    }
    acopy.pop_front();
  }
}

rebuild()

template<typename T>

tref dbe::inner::configobject::gref< T >::rebuild ( )

private

Create the objects in the in the queue and return the last object created , i.e. the bottom of the queue.

Returns

the last object created

Definition at line 114 of file dbcontroller.cpp.

{
  if (not this_remove_stack.empty())
  {
    for (;;)
    {
      t_extractor record = this_remove_stack.front();
      tref last = dbcontroller::create_object_request(record.toimage());
      this_remove_stack.pop_front();
      if (not last.is_null())
      {
        this_notify_stack.push_back(last);
      }
      if (this_remove_stack.empty())
      {
        return last;
      }
    }
  }
  throw daq::dbe::gref_empty_internal_queue_is_invalid_state(ERS_HERE);
}

record()

template<typename T>

void dbe::inner::configobject::gref< T >::record ( tref const & obj )

private

Include a ConfigObject and all its descendants

Parameters

obj

Definition at line 65 of file dbcontroller.cpp.

{
  t_extractor obj(o);
  for (auto const & linked : obj.relations)
  {
    for (auto const & candidate : linked.second)
    {
      record(candidate.ref());
    }
  }
  this_remove_stack.push_back(obj);
}

Friends And Related Symbol Documentation

inner::dbcontroller

template<typename T = config_object_linker>

friend class inner::dbcontroller

friend

Definition at line 123 of file config_reference_copy.hpp.

Member Data Documentation

this_notify_stack

template<typename T = config_object_linker>

type_ref_container dbe::inner::configobject::gref< T >::this_notify_stack

private

Definition at line 121 of file config_reference_copy.hpp.

this_remove_stack

template<typename T = config_object_linker>

type_extractor_stack dbe::inner::configobject::gref< T >::this_remove_stack

private

Definition at line 120 of file config_reference_copy.hpp.

---

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

• /github/workspace/dunedaq/sourcecode/dbe/include/dbe/config_reference.hpp
• /github/workspace/dunedaq/sourcecode/dbe/include/dbe/config_reference_copy.hpp
• /github/workspace/dunedaq/sourcecode/dbe/src/internal/dbcontroller.cpp