класс ara::diag::SovdServiceValidation

Класс ara::diag::SovdServiceValidation служит для специфичной для приложения проверки прав доступа и предусловий при входящих запросах к сервисам SOVD ([SWS_DM_01822]). После инстанцирования порта и явной активации через Offer() Diagnostic Management вызывает для каждого запрошенного ресурса асинхронный метод валидации Validate() ([SWS_DM_01827]). Если валидация возвращает ошибочное значение хотя бы для одного подресурса, система немедленно прерывает всю обработку и отклоняет запрос клиента. В то время как инстанцирование является потокобезопасным, такие методы, как Offer() и StopOffer(), должны синхронизироваться вызывающей стороной.

больше ›

Контекст

Класс ara::diag::SovdServiceValidation служит в Adaptive Platform для предоставления специфичных для производителя и поставщика проверок для Service-Oriented Vehicle Diagnostics (SOVD) внутри диагностического приложения ([SWS_DM_01822]). В то время как стандартизированные предусловия и условия окружения в рамках протокола SOVD оцениваются Diagnostic Management (DM) перед выполнением метода ([SWS_DM_01468]), этот интерфейс переносит пользовательскую логику валидации непосредственно в адаптивное приложение.

В валидации сервиса участвуют три ключевых участника:

• SOVD-клиент: инициирует диагностические запросы к автомобильной системе с помощью методов HTTP.
• Diagnostic Management (DM): принимает запросы SOVD, проверяет вышестоящие условия и делегирует валидацию сконфигурированным сопоставлениям портов ([SWS_DM_01467], SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
• Обработчик валидации: реализует специфичную для приложения специализацию SovdServiceValidation и принимает решение о допустимости запрошенной операции ([SWS_DM_01822], [SWS_DM_01827]).

Контекстная диаграмма: компоненты и взаимосвязи интерфейсов при валидации сервиса SOVD. Источники: [SWS_DM_01822], [SWS_DM_01823], SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»

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

Инстанцирование обработчика валидации выполняется через конструктор SovdServiceValidation, который через ara::core::InstanceSpecifier привязывается к PortPrototype, смоделированному в манифесте ([SWS_DM_01823]). При этом порт должен быть типизирован с помощью DiagnosticSovdServiceValidationInterface ([SWS_DM_01823]). С помощью параметра ConcurrencyType приложение строго определяет, рассчитана ли его реализация на конкурентные вызовы (kConcurrent) или должна обслуживаться неконкурентно (kNotConcurrent) ([SWS_DM_01823]).

После успешного конструирования экземпляр находится в инициализированном состоянии. Пересылка запросов через DM должна быть явно активирована вызовом Offer() ([SWS_DM_01825]). Если пересылку требуется приостановить или завершить, приложение отключает её через StopOffer() ([SWS_DM_01826]). Виртуальный деструктор ~SovdServiceValidation() корректно завершает жизненный цикл обработчика ([SWS_DM_01824]). Хотя сам конструктор специфицирован как потокобезопасный, Offer(), StopOffer() и деструктор не являются потокобезопасными и не должны вызываться конкурентно ([SWS_DM_01823], [SWS_DM_01824], [SWS_DM_01825], [SWS_DM_01826]).

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

Типичный процесс валидации делится на следующие фазы:

1. Инициализация и регистрация: приложение инстанцирует специализированный класс и активирует сервис для DM с помощью Offer() ([SWS_DM_01823], [SWS_DM_01825]). Интерпретация: обычно это происходит при запуске диагностической функциональности приложения. Вопрос (открытый)
2. Обработка запроса: при поступлении сообщения SOVD на Diagnostic Server последний вызывает метод Validate для каждого сопоставления порта, сконфигурированного в DiagnosticServiceValidationConfiguration, в установленном порядке (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
3. Проверка ресурсов: если вызов затрагивает коллекцию ресурсов (Resource Collection), DM вызывает Validate многократно: ровно один раз для самой коллекции и затем по одному разу для каждого ресурса, содержащегося в коллекции ([SWS_DM_01827]). Путь к проверяемому в данный момент ресурсу каждый раз передаётся в ara::diag::MetaInfo (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
4. Асинхронный результат: метод возвращает ara::core::Future<void> ([SWS_DM_01827]). Если проверка успешна, future разрешается без ошибки, и DM продолжает обработку запроса (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
5. Деактивация сервиса: перед завершением работы или при изменениях конфигурации приложение вызывает StopOffer() ([SWS_DM_01826]).

Диаграмма последовательности: процесс проверки запроса SOVD через Validate с итерацией по ресурсам и обработкой ошибок. Источники: [SWS_DM_01827], SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»

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

Ошибки могут возникать на различных фазах инициализации и выполнения:

• Нарушения при конструировании: если InstanceSpecifier не удаётся разрешить в модели или он не указывает на PortPrototype, сообщается о InstanceSpecifierMappingIntegrityViolation ([SWS_DM_01823]). Ошибка PortInterfaceMappingViolation возникает, если порт не соответствует интерфейсу DiagnosticSovdServiceValidationInterface ([SWS_DM_01823]). При отсутствии сопоставления с процессом возникает ProcessMappingViolation, а при многократном использовании одного и того же идентификатора следует InstanceSpecifierAlreadyInUseViolation ([SWS_DM_01823]).
• Ошибки регистрации при Offer: если сервис уже активно предлагался, Offer() возвращает ошибку DiagOfferErrc::kAlreadyOffered ([SWS_DM_01825]). Если конфигурация отличается от моделирования в DEXT, возникает ошибка DiagOfferErrc::kConfigurationMismatch ([SWS_DM_01825]).
• Функциональные ошибки валидации: метод Validate сообщает о недопустимости через коды ошибок из DiagSovdErrc ([SWS_DM_01827]). К ним относятся DiagSovdErrc::kInsufficientAccessRights при недостаточных правах клиента, DiagSovdErrc::kPreconditionNotFulfilled при невыполненных предусловиях, DiagSovdErrc::kTemporarilyNotAvailable при временной недоступности (например, отсутствие онлайн-валидации токена) или DiagSovdErrc::kSovdServerMisconfigured при ошибочной конфигурации ([SWS_DM_01827]).
• Немедленное прерывание при ошибках подресурсов: если валидация завершается неудачей хотя бы для одного содержащегося ресурса коллекции ресурсов, DM немедленно прерывает обработку общего запроса и напрямую возвращает сообщение об ошибке клиенту (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).