Класс so_4::transport_layer::channel_owner_notificator_t

Граф наследования:so_4::transport_layer::channel_owner_notificator_t:

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

---

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

Интерфейс объекта, отвечающего за уведомление владельца канала о происходящих с каналом событиях.

Начиная с:

v.4.4.0-b4 Производные классы могут выбирать различные стратегии уведомления. Например, отсылать сообщения транспортному агенту.

В некоторых случаях, например, в проекте so_alt_channel, могут потребоваться специфические нотификаторы, которые отсылают уведомления не транспортному агенту, а вспомогательному агенту, отвечающему за переключение каналов.

Неотъемлимой частью нотификатора является хранение идентификатора канала. Идентификатор назначается владельцем канала и хранится в объекте-нотификаторе. Нотификатор подставляет его в отсылаемые владельцу канала уведомления.

Открытые члены
virtual channel_id_t	channel_id () const =0
	Получить значение идентификатора канала.
virtual so_4::ret_code_t	on_success (channel_controller_auto_ptr_t controller)=0
	Отсылка уведомления об успешном создании канала.
virtual so_4::ret_code_t	on_failure (const std::string &reason)=0
	Отсылка уведомления о неудачном создании канала.
virtual so_4::ret_code_t	on_lost (const std::string &reason)=0
	Отсылка уведомления о потере канала.

---

Методы

virtual so_4::ret_code_t so_4::transport_layer::channel_owner_notificator_t::on_success

(

channel_controller_auto_ptr_t

controller

)

[pure virtual]

Отсылка уведомления об успешном создании канала.

Аргументы:

controller

Управляющий интерфейс для нового канала.

Замещается в so_4::transport_layer::std_channel_owner_notificator_t.

virtual so_4::ret_code_t so_4::transport_layer::channel_owner_notificator_t::on_failure

(

const std::string &

reason

)

[pure virtual]

Отсылка уведомления о неудачном создании канала.

Аргументы:

reason

Причина неудачи. Не всегда эта причина может быть известна.

Замещается в so_4::transport_layer::std_channel_owner_notificator_t.

virtual so_4::ret_code_t so_4::transport_layer::channel_owner_notificator_t::on_lost

(

const std::string &

reason

)

[pure virtual]

Отсылка уведомления о потере канала.

Инициируется как при обнаружении закрытия канала удаленной стороной, так и при принудительном закрытии канала при возникновении каких-либо проблем.

Аргументы:

reason

Причина закрытия.

Замещается в so_4::transport_layer::std_channel_owner_notificator_t.