класс ara::sm::SmErrorDomain

Функция-член ara::sm::SmErrorDomain::Message служит для синхронного определения текстового сообщения об ошибке, сопоставленного определенному коду ошибки домена ошибок State Management [SWS_SM_81249]. Она объявлена в файле заголовка ara/sm/sm_error_domain.h в области видимости класса ara::sm::SmErrorDomain и имеет в спецификации статус DRAFT AUTOSAR_AP_SWS_StateManagement §8.1.3.2.2.1 «Message».

Интерфейс имеет следующие параметры и возвращаемые значения [SWS_SM_81249]:

• Параметр: errorCode типа CodeType принимает числовой номер ошибки, для которого запрашивается соответствующее текстовое сообщение.
• Возвращаемое значение: Указатель типа const char * на сообщение об ошибке, сопоставленное переданному коду ошибки.

Для выполнения действуют строгие гарантии относительно параллелизма и обработки исключений: функция специфицирована как thread-safe и exception safe, а также объявлена с идентификатором noexcept [SWS_SM_81249]. Таким образом, ее можно безопасно вызывать из произвольных потоков без синхронизирующих блокировок или блоков try-catch.

В рамках управления ошибками AUTOSAR Adaptive метод переопределяет виртуальную функцию базового домена ошибок. Интерпретация: поскольку возвращаемое значение определено как const char * без интерфейса выделения памяти, указатель, вероятно, обычно ссылается на статические строковые литералы, остающиеся действительными на протяжении всего времени выполнения процесса. Вопрос Q-03fc170f18f910b4 (открытый)

API-метод Name класса домена ошибок ara::sm::SmErrorDomain служит для запроса стандартизированного имени домена ошибок State Management ([SWS_SM_81248]). Согласно спецификации, синхронный вызов всегда возвращает постоянное строковое значение "Sm" (SWS StateManagement §8.1.3.2.2.2 «Name»). Для использования необходимо подключить соответствующий файл заголовка ara/sm/sm_error_domain.h.

Функция-член не принимает входных параметров и обеспечивает полную безопасность относительно исключений: она специфицирована как noexcept и exception safe ([SWS_SM_81248]), благодаря чему гарантированно возвращает управление без генерации исключений и не создает кодов ошибок. Интерпретация: поскольку в качестве типа возвращаемого значения задан const char * с фиксированным значением "Sm", функция, вероятно, ссылается на статический строковый литерал с неограниченным временем жизни. Вопрос Q-855d1837679010a7 (открытый)

Что касается контекста вызова и параллелизма, метод классифицирован как thread-safe ([SWS_SM_81248]). Таким образом, его можно выполнять параллельно из нескольких потоков без ручной синхронизации. Для интеграторов и разработчиков также актуально то, что требование в релизе R25-11 имеет статус DRAFT (SWS StateManagement §8.1.3.2.2.2 «Name»).

Использование

Конструктор по умолчанию SmErrorDomain() синхронно создает экземпляр домена ошибок ara::sm::SmErrorDomain ([SWS_SM_81247]). Объявление находится в заголовочном файле ara/sm/sm_error_domain.h. Вызов не требует входных параметров и напрямую возвращает инициализированный объект домена (SWS StateManagement §8.1.3.2.1.1 «Default Constructor»).

Обработка ошибок

Функция снабжена идентификатором noexcept и классифицирована как безопасная относительно исключений (exception safe) ([SWS_SM_81247]). При создании коды ошибок не возникают и исключения не генерируются.

Параллелизм и ограничения

Создание специфицировано как thread-safe ([SWS_SM_81247]). Таким образом, экземпляры могут создаваться параллельно в многопоточных средах без необходимости использования дополнительных механизмов синхронизации. Особых требований к порядку не предъявляется.

Взаимодействие

Созданный объект принадлежит классу ara::sm::SmErrorDomain ([SWS_SM_81241]), который специфицирован в соответствии с [SWS_CORE_90023]. Внутри модуля State Management домен ошибок взаимодействует со следующими элементами:

• Errc ([SWS_SM_81245]) и Exception ([SWS_SM_81246]) в качестве синонимов типов для кодов ошибок (SmErrc) и обработки исключений (SmException).
• Name() ([SWS_SM_81248]) возвращает имя домена "Sm".
• Message() ([SWS_SM_81249]) преобразует коды ошибок в текстовые описания.
• ThrowAsException() ([SWS_SM_81250]) выбрасывает код ошибки в виде исключения, если включены исключения C++ ([SWS_CORE_10304]).
• GetSmDomain() ([SWS_SM_81251]) в качестве альтернативы предоставляет глобальный экземпляр домена ошибок.

Функция ara::sm::SmErrorDomain::ThrowAsException служит для непосредственной генерации кода ошибки из домена ошибок State Management в виде C++-исключения [SWS_SM_81250]. Она объявлена в файле заголовка ara/sm/sm_error_domain.h и переопределяет соответствующую базовую функцию для доменов ошибок (SWS StateManagement §8.1.3.2.2.3 «ThrowAsException»).

Вызов и параметры

Метод вызывается синхронно и принимает в качестве единственного входного параметра константную ссылку на errorCode (типа ara::core::ErrorCode) [SWS_SM_81250]. Он не возвращает значения (void), поскольку создает экземпляр и инициирует исключение, соответствующее переданному коду ошибки, тем самым прерывая штатный поток управления в месте вызова [SWS_SM_81250].

Параллелизм и граничные условия

• Потокобезопасность: Функция явно специфицирована как потокобезопасная (thread-safe) и поэтому может без проблем вызываться из параллельных потоков [SWS_SM_81250].
• Безопасность исключений: Поведение задокументировано как not exception safe [SWS_SM_81250]; интерпретация: это, вероятно, обусловлено тем обстоятельством, что выброс исключения выходит из штатного потока управления, и метод по определению завершается сбоем или распространяет исключение. Вопрос Q-5afbb1be303b657b (открытый)
• Ограничение компилятора: В соответствии с [SWS_CORE_10304] функция не участвует в разрешении перегрузки (overload resolution), если C++-исключения отключены в тулчейне компилятора [SWS_SM_81250].