so_4::disp::active_group

Пространство имен so_4::disp::active_group

Подробное описание

Диспетчер с активными группами.

Начиная с:
v.4.2.6


Пространства имен

namespace  impl
 Детали реализации диспетчера с активными группами.

Функции

so_4::rt::dispatcher_t * create_disp (so_4::rt::dispatcher_t *subordinate_disp)
 Создание диспетчера.
so_4::rt::agent_traits_t * create_active_group_traits (const std::string &group_name)
 Получить свойство, делающее агента членом активной группы.
void make_member (so_4::rt::agent_t &agent, const std::string &group_name)
 Упрощенный способ сделать агента членом активной группы.

Функции

so_4::rt::agent_traits_t * so_4::disp::active_group::create_active_group_traits (  const std::string &  group_name  ) 
 

Получить свойство, делающее агента членом активной группы.

Начиная с:
v.4.2.6
Для того, чтобы сделать агент членом активной группы необходимо поместить в список свойств объекта (agent_traits) указатель на специальное свойство, которое создается данной функцией.

Внимание:
Полученное с помощью данного метода свойство должно назначаться агенту ТОЛЬКО с помощью метода so_4::rt::agent_t::so_add_destroyable_traits(), т.к. свойство является динамически созданным объектом.
Возвращает:
Указатель на динамически созданный объект, который должен быть уничтожен посредством delete.
Пример применения: 
class my_agent_t : public so_4::rt::agent_t {
  typedef so_4::rt::agent_t base_type_t;

  public :
    my_agent_t( const char * agent_name ) :
      base_type_t( agent_name )
    {
      so_add_destroyable_traits(
        so_4::disp::active_group::create_active_group_traits(
          "my_active_group" ) );
    }
  ...
};
Аргументы:
group_name  Имя активной группы, в составе которой должен работать агент.

so_4::rt::dispatcher_t * so_4::disp::active_group::create_disp (  so_4::rt::dispatcher_t *  subordinate_disp  ) 
 

Создание диспетчера.

Начиная с:
v.4.2.6
Диспетчер обслуживает только агентов, которые входят в активные группы. Остальных агентов и нить таймера должен обслуживать дополнительный диспетчер, которые передается диспетчеру с активными группами в качестве параметра: 
// Основным является диспетчер с активными группами,
// подчиненным -- диспетчер с активными объектами.
std::auto_ptr< so_4::rt::dispatcher > disp(
  so_4::disp::active_group::create_disp(
    so_4::disp::active_obj::create_disp(
      // Таймер будет уничтожен диспетчером.
      so_4::timer_thread::simple::create_timer_thread(),
      so_4::auto_destroy_timer ) ) );
либо: 
// Основным является диспетчер с активными группами,
// подчиненным -- диспетчер с одной рабочей нитью.
std::auto_ptr< so_4::rt::dispatcher > disp(
  so_4::disp::active_group::create_disp(
    so_4::disp::one_thread::create_disp(
      // Таймер будет уничтожен диспетчером.
      so_4::timer_thread::simple::create_timer_thread(),
      so_4::auto_destroy_timer ) ) );

Подчиненый диспетчер должен быть динамически созданным объектом, который будет уничтожен в деструкторе диспетчера с активными группами.

Возвращает:
Указатель на динамически созданный объект, который должен быть уничтожен посредством оператора delete.
Внимание:
Данный диспетчер спроектирован так, чтобы в программе был только один диспетчер этого типа.
Аргументы:
subordinate_disp  Подчиненный диспетчер.

void so_4::disp::active_group::make_member (  so_4::rt::agent_t &  agent,
const std::string &  group_name
)  [inline]
 

Упрощенный способ сделать агента членом активной группы.

Начиная с:
v.4.2.7
Пример использования: 
class my_agent_t : public so_4::rt::agent_t {
  typedef so_4::rt::agent_t base_type_t;

  public :
    my_agent_t( const char * agent_name ) :
      base_type_t( agent_name )
    {
      so_4::disp::active_group::make_member(
        *this, "my_active_group" );
    }
  ...
};

Документация по SObjectizer. Последние изменения: Thu Jan 12 10:52:50 2006. Создано системой  doxygen 1.4.6-NO
Hosted by uCoz