класс ara::com::ComErrorDomain

Класс ara::com::ComErrorDomain представляет домен коммуникационных ошибок для идентификации общих, не зависящих от конкретного интерфейса ошибок в API ara::com ([SWS_CM_11265]). Он предоставляет описания ошибок для таких кодов ошибок, как ComErrc::kCommunicationFailure, и позволяет запрашивать их через Message() или преобразовывать в исключение с помощью ThrowAsException() ([SWS_CM_11332]). Поскольку его конструктор по умолчанию удален, он выступает в качестве не имеющего состояния, потокобезопасного экземпляра домена для несущего ошибку ara::core::Result.

больше ›

Контекст

Класс ara::com::ComErrorDomain представляет стандартизированный домен коммуникационных ошибок Adaptive Platform для функционального кластера Communication Management (SWS CommunicationManagement с. 439). Он наследует от базового класса ara::core::ErrorDomain и определяет семантический контекст для общих ошибок, которые могут возникать во время вызовов методов или передачи данных, но не специфичны для отдельного ServiceInterface ([SWS_CM_11265]). В архитектуре ошибок ara::com он систематически разграничивает общие сбои коммуникации, ошибки контроля E2E и специфичные для приложения ошибки сервисов (SWS CommunicationManagement §7.5.22.6 «Error Related Data Types»).

К его ключевым участникам взаимодействия относятся Adaptive Application, реализации сервисов и прокси промежуточного ПО, а также типы данных базовой системы ara::core::ErrorCode и ara::core::Result (EXP ARAComAPI §4.7 «Error Handling»). Для семантического связывания типов класс предоставляет псевдонимы типов Errc для перечисления кодов ошибок ComErrc ([SWS_CM_11336]) и Exception для соответствующего класса исключений ComException ([SWS_CM_11337]).

Контекстная диаграмма: интеграция ComErrorDomain в архитектуру ошибок ara::com. Источники: [SWS_CM_11265], EXP ARAComAPI §4.7 «Error Handling», SWS CommunicationManagement §7.5.22.6 «Error Related Data Types»

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

Как класс спецификации домена ошибок, создание ara::com::ComErrorDomain предотвращено удалением конструктора по умолчанию ComErrorDomain() = delete; ([SWS_CM_11330]). Интерпретация: предоставление экземпляра домена, вероятно, выполняется платформой в виде статического синглтона, поэтому компонентам приложения не требуется динамически инстанцировать домен или управлять им. Вопрос Q-bf957a108c0a5378 (открытый)

Экземпляр выступает в роли дескриптора без состояния, не имеющего изменяемых атрибутов. Все предоставляемые методы, такие как Name() ([SWS_CM_11331]) и Message() ([SWS_CM_11332]), объявлены как const noexcept. Это гарантирует полную потокобезопасность при параллельных запросах ошибок несколькими потоками приложения и промежуточного ПО.

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

Типичный сценарий использования включает обнаружение, передачу и обработку ошибки через интерфейсы ara::com:

1. Приложение инициирует взаимодействие с сервисом, например, через оператор вызова класса методов operator() ([SWS_CM_00196]).
2. Если промежуточное ПО обнаруживает ошибочную ситуацию во время обработки, такую как сбой связи или несконфигурированная ошибка приложения ([SWS_CM_00048]), вызывается операция SetError у соответствующего Promise (SWS CommunicationManagement с. 300).
3. При этом конструируется ara::core::ErrorCode, домен которого установлен в ara::com::ComErrorDomain ([SWS_CM_11329]), а его числовой код — в определенное значение перечисления, такое как ComErrc::kCommunicationFailure ([SWS_CM_10432]).
4. Возвращенный приложению ara::core::Future или ara::core::Result передает код ошибки вызывающей стороне в состоянии ошибки (EXP ARAComAPI §4.7 «Error Handling»).
5. Приложение проверяет Result и использует функции домена Name() ([SWS_CM_11331]) и Message() ([SWS_CM_11332]) для разрешения сообщений об ошибках с целью журналирования или диагностики.
6. Если логика приложения ожидает исключение и исключения C++ активированы, преобразование в ComException может быть инициировано с помощью ThrowAsException() ([SWS_CM_11333]).

Диаграмма последовательности: сигнализация и опрос коммуникационной ошибки через ComErrorDomain. Источники: [SWS_CM_00196], [SWS_CM_10432], [SWS_CM_11329], [SWS_CM_11332], SWS CommunicationManagement с. 300

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

Концепция ошибок ara::com строго разграничивает устранимые ошибки (recoverable errors) и серьезные нарушения программирования (violations или corruptions) (EXP ARAComAPI §4.7 «Error Handling»). Устранимые ошибки обрабатываются через ara::core::Result и ara::core::ErrorCode, причем коды ошибок домена ComErrorDomain адресуются через псевдоним идентификатора Errc ([SWS_CM_11336]).

Если, к примеру, во время удаленного вызова происходит прерывание передачи, система сообщает о ComErrc::kCommunicationFailure ([SWS_CM_10432]). При несконфигурированной ошибке приложения промежуточное ПО прерывает вызов и также устанавливает соответствующий код ошибки домена ([SWS_CM_00048], SWS CommunicationManagement с. 300).

Если код ошибки должен быть выброшен в виде исключения, ThrowAsException() инстанцирует исключение типа ComException ([SWS_CM_11337]) и выбрасывает его ([SWS_CM_11333]). Этот метод не является безопасным с точки зрения исключений (not exception safe) и, согласно спецификации, не участвует в разрешении перегрузки при отключенных исключениях C++ ([SWS_CM_11333]). Неустранимые системные нарушения, напротив, приводят непосредственно к аварийному завершению платформы и не обрабатываются через ComErrorDomain (EXP ARAComAPI §4.7 «Error Handling»).