класс {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton

Класс служит серверным базовым классом для реализации сервисного интерфейса в ara::com, от которого наследуется приложение-поставщик сервиса. При создании через конструктор определяется, обрабатываются ли входящие вызовы методов по событиям или путем опроса [SWS_CM_00130]. Ошибочные процессы при объявленных исключениебезопасными методах сигнализируются через возвращаемый ara::core::Future в виде кода ошибки [SWS_CM_00191].

больше ›

Контекст

Класс {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton служит в Adaptive Platform в модуле com сгенерированным абстрактным базовым классом для серверного предоставления сервисного интерфейса. Специфичный для приложения компонент поставщика сервиса наследуется от этого skeleton-класса для реализации функциональной бизнес-логики сервиса. Класс выступает посредником между конкретным приложением-поставщиком сервиса и коммуникационным промежуточным ПО или базовым протокольным связыванием, таким как SOME/IP (SWS CommunicationManagement §8.1 «Method invocation»). К партнерам по взаимодействию относятся приложение-поставщик сервиса, которое создает экземпляр и владеет им, сам skeleton-класс, а также коммуникационная инфраструктура, которая принимает входящие сервисные запросы, десериализует их и пересылает в skeleton ([SWS_CM_10306], [SWS_CM_10307]).

Контекстная диаграмма: взаимодействие приложения-поставщика сервиса, ServiceSkeleton и коммуникационного промежуточного ПО. Источники: [SWS_CM_10306], [SWS_CM_10307], SWS CommunicationManagement §8.1 «Method invocation».

Жизненный цикл

Создание экземпляра skeleton выполняется через конструктор, которому передается желаемый режим обработки ara::com::MethodCallProcessingMode [SWS_CM_00130]. Этот режим определяет стратегию параллелизма для поступающих вызовов методов: если настроен kEvent или kEventSingleThread, входящие вызовы методов вызываются коммуникационным промежуточным ПО непосредственно по событиям [SWS_CM_10306]. Если вместо этого передается kPoll, обработка выполняется приложением на основе опроса [SWS_CM_10307]. Интерпретация: экземпляр skeleton, предположительно, остается во владении приложения-поставщика сервиса на протяжении всего активного предоставления сервиса и уничтожается только при завершении работы сервиса. Вопрос Q-ce25321f79393024 (открытый)

Путь использования

Типичный сценарий включает реализацию чисто виртуальных методов производным классом поставщика и последующее выполнение при поступлении запросов. Для обычных вызовов методов (запрос-ответ) skeleton определяет интерфейс, возвращающий ara::core::Future с соответствующим объектом вывода [SWS_CM_00191], [SWS_CM_99556]. Для методов типа «отправил и забыл» (fire-and-forget) без ответа skeleton предоставляет чисто виртуальные операции с типом возвращаемого значения void [SWS_CM_90434]. При входящих запросах коммуникационное промежуточное ПО десериализует полезные данные и перенаправляет вызов в соответствии с настроенным режимом обработки конкретной реализации skeleton-класса ([SWS_CM_10306], [SWS_CM_00191]).

Диаграмма последовательности: процесс вызова метода через skeleton. Источники: [SWS_CM_00191], [SWS_CM_10306], SWS CommunicationManagement §8.1 «Method invocation».

Сценарии ошибок

Как методы типа «запрос-ответ», так и методы типа «отправил и забыл» (fire-and-forget) аннотированы на уровне интерфейса с помощью noexcept и объявлены исключениебезопасными ([SWS_CM_00191], [SWS_CM_90434]). Ошибки при обработке обычных вызовов методов не передаются через исключения C++; вместо этого возвращаемый ara::core::Future в случае ошибки передает соответствующий код ошибки типа ara::com::ComErrc или ApApplicationError [SWS_CM_00191]. Для методов «отправил и забыл» спецификацией не предусмотрены ни возвращаемые значения, ни стандартизированные коды ошибок [SWS_CM_90434].