Статическое создание IPC-каналов при разработке на языке C++

Чтобы реализовать клиентскую программу, вызывающую метод службы, предоставляемой серверной программой, необходимо:

1. Подключить сгенерированный заголовочный файл описания (*.edl.cpp.h) клиентской программы.
2. Подключить сгенерированные заголовочные файлы описаний используемых интерфейсов (*.idl.cpp.h).
3. Подключить заголовочные файлы:
   • /opt/KasperskyOS-Community-Edition-<version>/sysroot-*-kos/include/kosipc/application.h
   • /opt/KasperskyOS-Community-Edition-<version>/sysroot-*-kos/include/kosipc/api.h
   • /opt/KasperskyOS-Community-Edition-<version>/sysroot-*-kos/include/kosipc/connect_static_channel.h
4. Инициализировать объект приложения, вызвав функцию kosipc::MakeApplicationAutodetect(). (Также можно использовать функции kosipc::MakeApplication() и kosipc::MakeApplicationPureClient().)
5. Получить клиентский IPC-дескриптор канала и идентификатор службы (riid) вызвав функцию kosipc::ConnectStaticChannel().

   Функция принимает имя IPC-канала (из файла init.yaml) и квалифицированное имя службы (из CDL- и EDL-описаний компонента решения).

6. Инициализировать прокси-объект для используемой службы, вызвав функцию MakeProxy().

Пример

// Создание и инициализация объекта приложения

kosipc::Application app = kosipc::MakeApplicationAutodetect();

// Создание и инициализация прокси-объекта

auto proxy = app.MakeProxy<IDLInterface>(

kosipc::ConnectStaticChannel(channelName, endpointName))

// Вызов метода требуемой службы

proxy->DoSomeWork();

Чтобы реализовать серверную программу, предоставляющую службы другим программам, необходимо:

1. Подключить сгенерированный заголовочный файл *.edl.cpp.h, содержащий описание компонентной структуры программы, включая все предоставляемые службы.
2. Подключить заголовочные файлы:
   • /opt/KasperskyOS-Community-Edition-<version>/sysroot-*-kos/include/kosipc/event_loop.h
   • /opt/KasperskyOS-Community-Edition-<version>/sysroot-*-kos/include/kosipc/api.h
   • /opt/KasperskyOS-Community-Edition-<version>/sysroot-*-kos/include/kosipc/serve_static_channel.h
3. Создать классы, содержащие реализации интерфейсов, которые данная программа и её компоненты предоставляют в виде служб.
4. Инициализировать объект приложения, вызвав функцию kosipc::MakeApplicationAutodetect().
5. Инициализировать структуру kosipc::components::Root, которая описывает компонентную структуру программы и описания интерфейсов всех предоставляемых программой служб.
6. Связать поля структуры kosipc::components::Root с объектами, реализующими соответствующие службы.

   Поля структуры Root повторяют иерархию компонентов и служб, заданную совокупностью CDL- и EDL-файлов.

7. Получить серверный IPC-дескриптор канала, вызвав функцию ServeStaticChannel().

   Функция принимает имя IPC-канала (из файла init.yaml) и структуру, созданную на шаге 5.

8. Создать объект kosipc::EventLoop, вызвав функцию MakeEventLoop().
9. Запустить цикл диспетчеризации входящих IPC-сообщений, вызвав метод Run() объекта kosipc::EventLoop.

Пример

// Создание объектов классов, которые реализуют интерфейсы,

// предоставляемые сервером в виде служб

MyIDLInterfaceImp_1 impl_1;

MyIDLInterfaceImp_2 impl_2;

// Создание и инициализация объекта приложения

kosipc::Application app = kosipc::MakeApplicationAutodetect();

// Создание и инициализация объекта root, описывающего

// компоненты и службы сервера

kosipc::components::Root root;

// Связывание объекта root с объектами классов, реализующими службы сервера

root.component1.endpoint1 = &impl_1;

root.component2.endpoint2 = &impl_2;

// Создание и инициализация объекта, который реализует

// цикл диспетчеризации входящих IPC-сообщений

kosipc::EventLoop loop = app.MakeEventLoop(ServeStaticChannel(channelName, root));

// Запуск цикла в текущем потоке

loop.Run();