пространство имён ara::com::runtime

Пространство имен ara::com::runtime предоставляет центральные сервисы времени выполнения для разрешения коммуникационных конечных точек в управлении коммуникацией AUTOSAR_AP_SWS_CommunicationManagement с. 39. Его ключевая функция ResolveInstanceIDs транслирует абстрактные идентификаторы модели типа ara::core::InstanceSpecifier в конкретные ara::com::InstanceIdentifierContainer, применимые для прокси и скелетонов [SWS_CM_00118]. Если сопоставление формально действительного идентификатора в развертывании завершается неудачно, эта безопасная относительно исключений функция возвращает код ошибки ComErrc::kInstanceIDNotResolvable внутри ara::core::Result. Поэтому вызывающие стороны должны проверять объект результата перед инстанцированием сервиса.

больше ›

Контекст

Пространство имен ara::com::runtime предоставляет центральные функциональные возможности времени выполнения для управления коммуникацией (ara::com) AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_CommunicationManagement с. 39. Его основная функциональная обязанность заключается в разделении абстрактной архитектуры программного обеспечения и конкретной коммуникационной инфраструктуры во время выполнения. В то время как приложения и программные компоненты в своих интерфейсах привязаны к портам через абстрактные идентификаторы модели (ara::core::InstanceSpecifier), промежуточному программному обеспечению коммуникации для установления соединений требуются конкретные данные адресации и инстанцирования в виде объектов ara::com::InstanceIdentifier [SWS_CM_00118].

Объявленная в заголовке ara/com/runtime.h функция ResolveInstanceIDs образует мост между этими двумя уровнями абстракции [SWS_CM_00118]. Она принимает ara::core::InstanceSpecifier и преобразует его в ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement с. 40. Интерпретация: конкретное сопоставление внутренне, вероятно, основывается на конфигурациях манифеста и развертывания, сохраненных в контексте выполнения, благодаря чему код приложения остается переносимым и свободным от жестко заданных сетевых или протокольных адресов. Вопрос Q-8fab6de1c39a065a (открытый)

Контекстная диаграмма: позиционирование ara::com::runtime между архитектурой приложения и развертыванием коммуникации. Источники: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement с. 39.

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

Типичное использование пространства имен ara::com::runtime происходит на этапе инициализации и запуска адаптивного приложения до установления коммуникационных связей через сервисные прокси или сервисные скелетоны AUTOSAR_AP_SWS_CommunicationManagement с. 41. При этом потребитель или поставщик сервиса проходит детерминированный путь разрешения:

• Определение спецификатора: приложение создает экземпляр или ссылается на определенный для соответствующего коммуникационного порта идентификатор типа ara::core::InstanceSpecifier.
• Разрешение экземпляров: идентификатор передается функции ara::com::runtime::ResolveInstanceIDs [SWS_CM_00118].
• Проверка результата: вызов возвращает объект типа ara::core::Result<ara::com::InstanceIdentifierContainer>, который проверяется на успешность выполнения или состояния ошибок [SWS_CM_00118].
• Обработка контейнера: в случае успеха ara::com::InstanceIdentifierContainer содержит количество идентификаторов экземпляров, пропорциональное количеству найденных совпадений в развертывании [SWS_CM_00118]. Приложение может целенаправленно выбрать один экземпляр или выполнить итерацию по всем доступным экземплярам.
• Инстанцирование прокси или скелетона: разрешенные объекты ara::com::InstanceIdentifier затем используются для создания конкретных экземпляров прокси или скелетона AUTOSAR_AP_SWS_CommunicationManagement с. 42.

Диаграмма последовательности: процесс вызова и обработки разрешения экземпляра через ResolveInstanceIDs. Источники: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement с. 41.

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

Интерфейсы в пространстве имен ara::com::runtime следуют общеплатформенной парадигме надежной обработки ошибок без использования исключений. В соответствии со спецификацией ResolveInstanceIDs объявлена как noexcept и обладает уровнем безопасности исключений exception safe [SWS_CM_00118]. Поэтому ошибки никогда не сигнализируются через исключения C++, а полностью передаются через монаду ошибок ara::core::Result AUTOSAR_AP_SWS_CommunicationManagement с. 47.

Центральный специфицированный сценарий ошибки касается кода ошибки ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. Эта ошибка возникает, если переданный ara::core::InstanceSpecifier формально действителен, однако в текущей системной конфигурации или манифесте не может быть сопоставлен ни с одним существующим ara::com::InstanceIdentifier [SWS_CM_00118]. На практике это указывает на расхождения между моделированием и развертыванием, например, если поставщик сервиса не был развернут на другой машине или в манифесте отсутствует привязка. Для этой ошибки действует семантика отката (rollback_semantics): промежуточные состояния не создаются и ресурсы не связываются, благодаря чему вызывающая сторона может проверить конфигурацию или перейти в определенное состояние ошибки [SWS_CM_00118].