This is an old revision of
Doc/API/part7 from 2009-10-22 15:49:04..
7. Подсистема “Протоколы коммуникационных интерфейсов” (TProtocolS)
Подсистема «Протоколы коммуникационных интерфейсов» представлена объектом TProtocolS, который содержит на уровне подсистемы модульные объекты отдельных протоколов TProtocol. Каждый протокол содержит объекты открытых сеансов входящих протоколов TProtocolIn.
Объект TProtocolS предоставляет доступ к входящим и исходящим протоколам отдельно взятых типов транспортных протоколов. Внутренняя сторона исходящего протокола строится по потоковому принципу с индивидуальной структурой потока для каждой реализации протокола.
7.1. Объект подсистемы «Протоколы коммуникационных интерфейсов» (TProtocolS)
Публичные методы:
- int subVer( ); -- Версия подсистемы.
- AutoHD<TProtocol> at( const string &id ); -- Подключение к модулю протокола <id>.
- string optDescr( ); -- Локализованная помощь по опциям командной строки и параметрам конфигурационного файла.
7.2. Модульный объект протокола (TProtocol)
| Наследует: | TModule. |
| Наследуется: | Корневыми объектами модулей подсистемы «Протоколы». |
Публичные методы:
- void list( vector<string> &list ); -- Список открытых входящих сеансов.
- bool openStat( const string &name ); -- Проверка на открытость входящего сеанса с указанным именем.
- void open( const string &name, const string &tr ); -- Открытие входящего сеанса от имени транспорта <tr>.
- void close( const string &name ); -- Закрытие входящего сеанса.
- AutoHD<TProtocolIn> at( const string &name ); -- Подключение к открытому входящему сеансу.
- virtual void outMess( XMLNode &io, TTransportOut &tro ); -- Отправка данных в дереве XML <in> посредством данного протокола и транспорта <tro>.
7.3. Объект сеанса входящего протокола (TProtocolIn)
| Наследует: | TCntrNode. |
| Наследуется: | Объектами сеанса входящего протокола модулей подсистемы «Протоколы». |
Публичные методы:
- TProtocolIn( const string &name ); -- Инициализирующий конструктор.
- const string &name( ); -- Имя входящего сеанса.
- const string &srcTr( ); -- Адрес транспорта-источника открытия данного сеанса входящего протокола.
- void setSrcTr( const string &vl ); -- Установка адреса транспорта-источника открытия данного сеанса входящего протокола.
- virtual bool mess( const string &request, string &answer, const string &sender ); -- Передача неструктурированных данных на обработку протоколу.
- TProtocol &owner( ); -- Протокол – владелец входящего сеанса.