класс ara::exec::ExecErrorDomain

Конструктор по умолчанию ExecErrorDomain() инициализирует новый экземпляр домена ошибок ara::exec::ExecErrorDomain согласно [SWS_EM_02286]. Вызов выполняется синхронно, не принимает параметров и не имеет возвращаемого значения. Объявление подключено через заголовочный файл ara/exec/exec_error_domain.h.

В отношении надежности и параллелизма конструктор объявлен как noexcept, считается исключениебезопасным (exception safe) и специфицирован как полностью потокобезопасный (thread-safe) [SWS_EM_02286]. Обработка ошибок при создании объекта не требуется, так как операция выполняется безошибочно и не вызывает кодов ошибок или исключений.

В системе в целом созданный объект служит для представления и описания специфических для модуля ошибок Execution Management. Через экземпляр можно запросить имя домена [SWS_EM_02287], получить текстовые сообщения для кодов ошибок [SWS_EM_02288] или выбросить ошибки в виде C++-исключения [SWS_EM_02289]. Явная инициализация через этот конструктор вряд ли потребуется в модулях приложений, поскольку через свободную функцию GetExecErrorDomain() уже предоставляется глобальная ссылка на экземпляр [SWS_EM_02290]. Вопрос Q-df8efc87e6547216 (открытый)

Метод Message является виртуальной функцией-членом класса ara::exec::ExecErrorDomain в составе функционального кластера Execution Management [SWS_EM_02288]. Он подключается через заголовочный файл ara/exec/exec_error_domain.h и переопределяет соответствующий интерфейс для определения текстовых сообщений об ошибках [SWS_EM_02288].

Использование выглядит следующим образом:

• Вызов и семантика: вызов выполняется синхронно и спроектирован как операция чтения (const) [SWS_EM_02288].
• Параметры: в качестве входного параметра передается errorCode типа CodeType, который представляет собой числовой идентификатор ошибки [SWS_EM_02288].
• Возвращаемое значение: функция возвращает указатель типа const char * на сообщение об ошибке, связанное с кодом ошибки [SWS_EM_02288]. Интерпретация: следует исходить из того, что этот указатель указывает на статическую строку, так что вызывающей стороне не требуется освобождение памяти. Вопрос Q-3e254e008a07294e (открытый)

Что касается обработки ошибок, функция объявлена как noexcept и специфицирована как exception safe [SWS_EM_02288]. Сама функция не генерирует исключений C++. Собственные коды ошибок или каналы обратной связи для ошибочных вызовов в спецификации не предусмотрены [SWS_EM_02288].

В отношении параллелизма метод классифицирован как thread-safe [SWS_EM_02288]. Поскольку он не изменяет состояние домена ошибок, его можно безопасно вызывать параллельно из нескольких потоков без внешних механизмов синхронизации [SWS_EM_02288].

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

Функция-член Name класса ara::exec::ExecErrorDomain синхронно возвращает указатель на символьную константу (const char *), которая обозначает домен ошибок [SWS_EM_02287]. Возвращаемое значение соответствует определению для ara::exec::ExecErrorDomain из [SWS_CORE_90023]. Метод подключается через заголовочный файл ara/exec/exec_error_domain.h, не ожидает входных параметров и действует как константная функция-член на экземплярах домена ошибок [SWS_EM_02287].

Обработка ошибок и параллелизм

Интерфейс объявлен как noexcept и, таким образом, классифицирован как полностью исключебно-безопасный (exception safe) [SWS_EM_02287]. Коды ошибок не возвращаются, исключения не генерируются. В отношении параллельного доступа функция специфицирована как потокобезопасная (thread-safe) [SWS_EM_02287]. Следовательно, вызовы могут выполняться параллельно из различных потоков без дополнительных мер синхронизации.

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

Благодаря объявлению как override функция реализует общий интерфейс для запроса имени домена в рамках [SWS_CORE_90023]. Возвращаемая строка предположительно служит для того, чтобы однозначно идентифицировать домен ошибок в удобочитаемом виде в выводе протокола или диагностики [SWS_EM_02287]. Вопрос Q-ae1f9de8510d7ff9 (открытый)

Метод ThrowAsException домена ошибок ara::exec::ExecErrorDomain служит для синхронной генерации исключения C++ на основе возникшего кода ошибки [SWS_EM_02289]. Он принимает в качестве входного параметра ссылку на errorCode (тип const ara::core::ErrorCode &), создает из нее объект исключения типа ExecException и непосредственно выбрасывает его как исключение C++ [SWS_EM_02289]. Функция не возвращает значения.

В отношении поведения при ошибках и во время выполнения необходимо учитывать следующие аспекты:

• Безопасность исключений: поскольку предполагаемое поведение функции заключается в выбросе исключения, она аннотирована как noexcept(false) и формально классифицирована как небезопасная относительно исключений (not exception safe) [SWS_EM_02289]. Поэтому вызывающие стороны должны быть готовы к перехвату или обработке ExecException.
• Параллелизм: спецификация определяет функцию-член как потокобезопасную (thread-safe) [SWS_EM_02289]. Таким образом, ее можно безопасно вызывать из параллельных потоков.
• Ограничения инструментария сборки: согласно [SWS_CORE_10304], ThrowAsException не участвует в разрешении перегрузки, если исключения C++ отключены в инструментарии компилятора [SWS_EM_02289]. Следовательно, в средах без поддержки исключений этот вызов недоступен.