В коде сущности Server
используются транспортные типы и методы, которые будут сгенерированы во время сборки решения компилятором NK на основе EDL-описания сущности Server
.
Однако чтобы получить необходимые для реализации сущности типы и сигнатуры методов, вы можете воспользоваться компилятором NK непосредственно после создания EDL-описания сущности, CDL-описаний компонентов и IDL-описаний используемых интерфейсов взаимодействия. В результате необходимые типы и сигнатуры методов будут объявлены в сгенерированных файлах *.h
.
В реализации сущности server
необходимо:
Ping()
.Сигнатура реализации метода Ping()
должна в точности совпадать с сигнатурой интерфейсного метода Ping_Ping()
, который объявлен в файле Ping.idl.h.
ServiceLocatorRegister()
.На вход нужно передать имя IPC-соединения server_connection
, заданное ранее в файле init.yaml.
NkKosTransport
, передав полученный IPC-дескриптор в функцию NkKosTransport_Init()
.Ping
, используя функцию Ping_component_init()
.Server
, используя функцию Server_entity_init()
.nk_transport_recv()
.Server_entity_dispatch()
.Диспетчер вызовет необходимую реализацию метода на основе полученного от клиента идентификатора интерфейса (RIID
).
Client
, вызвав nk_transport_reply()
.server.c
#include <stdio.h>
#include <stdlib.h>
#include <stdbool.h>
/* Файлы, необходимые для инициализации транспорта. */
#include <coresrv/nk/transport-kos.h>
#include <coresrv/sl/sl_api.h>
/* Описания сущности-сервера на языке EDL. */
#include <Server.edl.h>
#include <assert.h>
/* Тип объекта реализующего интерфейс. */
typedef struct IPingImpl {
struct Ping base; // базовый интерфейс объекта
int step; // дополнительные парметры
} IPingImpl;
/* Реализация метода Ping. */
static nk_err_t Ping_impl(struct Ping *self,
const Ping_req *req,
const struct nk_arena* req_arena,
Ping_res* res,
struct nk_arena* res_arena)
{
IPingImpl *impl = (IPingImpl *)self;
/* Значение value, пришедшее в запросе от клиента, инкрементируем на
* величину шага step и помещаем в аргумент result, который будет
* отправлен клиенту в составе ответа от сервера. */
res->Ping.result = req->Ping.value + impl->step;
return NK_EOK;
}
/* Конструктор объекта IPing.
* step - шаг, то есть число, на которое будет увеличиваться входящее значение. */
static struct Ping *CreateIPingImpl(int step)
{
/* Таблица реализаций методов интерфейса IPing. */
static const struct Ping_ops ops = {
.Ping = Ping_impl
};
/* Объект, реализующий интерфейс. */
static struct IPingImpl impl = {
.base = {&ops}
};
impl.step = step;
return &impl.base;
}
/* Точка входа в сервер. */
int main(void)
{
NkKosTransport transport;
ServiceId iid;
/* Получаем серверный IPC-дескриптор соединения "server_connection". */
Handle handle = ServiceLocatorRegister("server_connection", NULL, 0, &iid);
assert(handle != INVALID_HANDLE);
/* Инициализируем транспорт до клиента. */
NkKosTransport_Init(&transport, handle, NK_NULL, 0);
/* Подготавливаем структуры запроса к сущности server: фиксированную
* часть и арену. Поскольку ни у одного из методов сущности server нет
* агрументов типа sequence, используются только фиксированные части
* запроса и ответа. Арены фактически не используются. Однако в серверные
* методы транспорта (nk_transport_recv, nk_transport_reply) и
* dispatch-метод server_entity_dispatch необходимо передать валидные
* арены запроса и ответа. */
Server_entity_req req;
char req_buffer[Server_entity_req_arena_size];
struct nk_arena req_arena = NK_ARENA_INITIALIZER(req_buffer, req_buffer + sizeof(req_buffer));
/* Подготавливаем структуры ответа: фиксированную часть и арену. */
Server_entity_res res;
char res_buffer[Server_entity_res_arena_size];
struct nk_arena res_arena = NK_ARENA_INITIALIZER(res_buffer, res_buffer + sizeof(res_buffer));
/* Инициализируем диспетчер компонента ping. 3 – величина шага,
* то есть число, на которое будет увеличиваться входящее значение. */
Ping_component component;
Ping_component_init(&component, CreateIPingImpl(3));
/* Инициализируем диспетчер сущности server. */
Server_entity entity;
Server_entity_init(&entity, &component);
fprintf(stderr, "Hello I'm server\n");
/* Реализация цикла обработки запросов. */
do
{
/* Сбрасываем буферы с запросом и ответом. */
nk_req_reset(&req);
nk_arena_reset(&req_arena);
nk_arena_reset(&res_arena);
/* Ожидаем поступление запроса к сущности-серверу. */
if (nk_transport_recv(&transport.base, &req.base_, &req_arena) != NK_EOK) {
fprintf(stderr, "nk_transport_recv error\n");
} else {
/* Обрабатываем полученный запрос, вызывая реализацию Ping_impl
* запрошенного интерфейсного метода Ping. */
Server_entity_dispatch(&entity, &req.base_, &req_arena, &res.base_, &res_arena);
}
/* Отправка ответа. */
if (nk_transport_reply(&transport.base, &res.base_, &res_arena) != NK_EOK) {
fprintf(stderr, "nk_transport_reply error\n");
}
}
while (true);
return EXIT_SUCCESS;
}
В начало