Класс so_4::disp::qt_ui::impl::dispatcher_t

Граф наследования:so_4::disp::qt_ui::impl::dispatcher_t:

Полный список членов класса

---

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

Диспетчер для Qt.

Начиная с:

v.4.2.6.1

Диспетчер обслуживает только агентов, которые должны работать на Qt GUI нити. Остальных агентов и нить таймера должен обслуживать дополнительный диспетчер, которые передается диспетчеру с активными группами в качестве параметра.

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

Для того, чтобы сделать агент работал на контексте Qt GUI нити необходимо вызвать метод introduce_agent(). При дерегистрации такого агента необходимо вызвать метод remove_agent().

Внимание:

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

Открытые члены
	dispatcher_t (so_4::rt::dispatcher_t *subordinate_disp, unsigned short qt_event_delta)
	Основной инициализирующий конструктор.
virtual ret_code_t	start ()
	Запустить диспетчер.
virtual void	shutdown ()
	Дать сигнал диспетчеру завершить работу.
virtual void	wait ()
	Ожидать полного завершения работы диспетчера.
virtual void	dispatch (int priority, const so_4::rt::event_data_t &event_data)
	Выполнить диспетчеризацию события.
virtual void	push_delayed_msg (const so_4::rt::msg_data_t &msg_data, unsigned int delay, unsigned int period=0)
	Поставить отложенное сообщение в очередь.
virtual void	destroy_all_agent_msg (const std::string &agent_name)
	Изъять все ожидающие сообщения данного агента.
Открытые статические члены
static void	introduce_agent (const std::string &agent_name)
	Добавить еще одного агента для Qt GUI нити.
static void	remove_agent (const std::string &agent_name)
	Изъять агента из Qt GUI нити.
static void	try_run_qt_ui_agent_event ()
	для агента Qt GUI нити.
Закрытые типы
typedef std::set< std::string >	agent_set_t
	Тип множества имен агентов Qt GUI нити.
Закрытые статические члены
static threads_1::mutex_sem_t &	lock ()
	частям диспетчера.
Закрытые данные
auto_ptr_3::obj_ptr_t< so_4::rt::dispatcher_t >	m_subordinate_disp
	Подчиненный диспетчер.
auto_ptr_3::obj_ptr_t< qt_event_processor_t >	m_qt_event_processor
	связанных с нашим диспетчером.
agent_set_t	m_agents
	Имена агентов Qt GUI нити.
demand_queue_t	m_demands
	Очередь заявок для агентов Qt GUI нити.
unsigned short	m_qt_event_delta
	Значение для получения уникального идентификатора QEvent.
Закрытые статические данные
static dispatcher_t *	m_instance
	рабочие нити для активных групп.

---

Конструктор(ы)

so_4::disp::qt_ui::impl::dispatcher_t::dispatcher_t (  so_4::rt::dispatcher_t *  subordinate_disp, unsigned short  qt_event_delta )

Основной инициализирующий конструктор. Аргументы: subordinate_disp  Подчиненный диспетчер. qt_event_delta  Значение для получения уникального идентификатора QEvent.

---

Методы

void so_4::disp::qt_ui::impl::dispatcher_t::destroy_all_agent_msg (  const std::string &  agent_name  )  [virtual]

Изъять все ожидающие сообщения данного агента. Задействуется подчиненный диспетчер. Замещает so_4::rt::dispatcher_t.

void so_4::disp::qt_ui::impl::dispatcher_t::dispatch (  int  priority, const so_4::rt::event_data_t &  event_data )  [virtual]

Выполнить диспетчеризацию события. Если событие относится к агенту Qt GUI нити, то событие передается в рабочую очередь данного диспетчера. В противном случае событие передается подчиненному диспетчеру. Замещает so_4::rt::dispatcher_t.

void so_4::disp::qt_ui::impl::dispatcher_t::introduce_agent (  const std::string &  agent_name  )  [static]

Добавить еще одного агента для Qt GUI нити. Аргументы: agent_name  Имя агента.

void so_4::disp::qt_ui::impl::dispatcher_t::push_delayed_msg (  const so_4::rt::msg_data_t &  msg_data, unsigned int  delay, unsigned int  period = 0 )  [virtual]

Поставить отложенное сообщение в очередь. Задействуется подчиненный диспетчер. Аргументы: delay  Для переодического сообщения указывает время, через которое сообщение должно возникнуть в первый раз period  Отличен от 0 для переодических сообщений Замещает so_4::rt::dispatcher_t.

void so_4::disp::qt_ui::impl::dispatcher_t::remove_agent (  const std::string &  agent_name  )  [static]

Изъять агента из Qt GUI нити. Аргументы: agent_name  Имя агента.

void so_4::disp::qt_ui::impl::dispatcher_t::shutdown (   )  [virtual]

Дать сигнал диспетчеру завершить работу. Вызывается shutdown у подчиненного диспетчера. Замещает so_4::rt::dispatcher_t.

ret_code_t so_4::disp::qt_ui::impl::dispatcher_t::start (   )  [virtual]

Запустить диспетчер. Сначала запускается подчиненный диспетчер. Затем, если все прошло нормально, наш диспетчер. Замещает so_4::rt::dispatcher_t.

void so_4::disp::qt_ui::impl::dispatcher_t::try_run_qt_ui_agent_event (   )  [static]

для агента Qt GUI нити. Внимание: Данный метод должен вызываться только на контексте Qt GUI нити!

void so_4::disp::qt_ui::impl::dispatcher_t::wait (   )  [virtual]

Ожидать полного завершения работы диспетчера. Сначала ожидается останов подчиненного диспетчера, затем уничтожаются все ожидающие заявки для агентов Qt GUI нити. Замещает so_4::rt::dispatcher_t.

---