класс ara::fw::FwErrorDomain

Псевдоним типа Errc согласно [AP_SWS_Fw_83007] определен как псевдоним для перечисления кодов ошибок FwErrc (using Errc = FwErrc;). Элемент объявлен в области видимости класса ara::fw::FwErrorDomain и подключается через заголовочный файл ara/fw/fw_error_domain.h [AP_SWS_Fw_83007].

С точки зрения использования Errc не представляет собой исполняемый вызов функции и поэтому не имеет ни параметров, ни возвращаемых значений, ни синхронной или асинхронной семантики [AP_SWS_Fw_83007]. Он скорее предоставляет унифицированный идентификатор для перечисления доменно-специфичных причин ошибок. Интерпретация: псевдоним, по всей видимости, предоставляет разработчикам упрощенный и согласованный доступ к значениям перечисления FwErrc внутри ara::fw::FwErrorDomain для типизации и запроса состояний ошибок [AP_SWS_Fw_83007]. Вопрос Q-bd8949830961e459 (открытый)

Поскольку это исключительно конструкция времени компиляции, ограничения времени выполнения относительно реентерабельности, потокобезопасности или порядка вызовов отсутствуют [AP_SWS_Fw_83007]. Специфические значения ошибок или связи с сообщениями DET или DEM в элементе спецификации не заданы и определяются значениями базового перечисления [AP_SWS_Fw_83007].

Конструктор по умолчанию FwErrorDomain() объявлен удаленным ([AP_SWS_Fw_83009]). Прямое инстанцирование объектов класса ara::fw::FwErrorDomain через этот конструктор в коде приложения тем самым исключено. Интерпретация: удаление, вероятно, должно гарантировать, что домен ошибок управляется исключительно как синглтон. Вопрос Q-54f7bc341f074e2c (открытый)

Для использования домена ошибок доступна свободная функция GetFwErrorDomain() ([AP_SWS_Fw_83002]). Она потокобезопасно возвращает ссылку на существующий объект домена типа ara::core::ErrorDomain. Через эту ссылку можно использовать интерфейсы домена:

• Запрос имени домена ошибок через Name() ([AP_SWS_Fw_83010]).
• Определение описательных текстов к кодам ошибок с помощью Message() ([AP_SWS_Fw_83011]).
• Генерация исключений через ThrowAsException() ([AP_SWS_Fw_83012]), причем псевдоним Exception ссылается на FwException ([AP_SWS_Fw_83008]).

Соответствующие коды ошибок определяются перечислением FwErrc ([AP_SWS_Fw_83001]), которое внутри класса также доступно через псевдоним Errc ([AP_SWS_Fw_83007]). Допустимыми значениями являются kServiceNotAvailable, а также kInvalidStateDependentFirewall. Разработчикам поэтому следует не создавать собственные экземпляры, а всегда использовать глобальную ссылку.

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

Функция-член Name класса ara::fw::FwErrorDomain служит для получения идентификатора домена ошибок [AP_SWS_Fw_83010]. Вызов выполняется синхронно и требует включения заголовочного файла ara/fw/fw_error_domain.h [AP_SWS_Fw_83010]. Функция не принимает входных параметров и возвращает указатель типа const char *, который представляет имя домена [AP_SWS_Fw_83010]. Возвращаемое значение, по всей видимости, представляет собой строку с завершающим нулем, срок действия которой привязан ко времени жизни домена ошибок. Вопрос Q-6bd465d82e79a682 (открытый)

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

Метод объявлен с идентификатором noexcept [AP_SWS_Fw_83010]. Следовательно, он не генерирует исключений и не предусматривает специфических кодов ошибок или возврата ошибок [AP_SWS_Fw_83010].

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

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

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

Функция-член Message класса ara::fw::FwErrorDomain объявляется через заголовочный файл ara/fw/fw_error_domain.h и служит для синхронного получения сообщения об ошибке [AP_SWS_Fw_83011]. При вызове вызывающая сторона передает код ошибки errorCode типа CodeType. В качестве возвращаемого значения функция возвращает указатель типа const char * на строку, сопоставленную коду ошибки [AP_SWS_Fw_83011]. Функция переопределяет как override соответствующий интерфейс базового класса [AP_SWS_Fw_83011].

Параллелизм и потокобезопасность

Спецификация явно определяет Message как thread-safe [AP_SWS_Fw_83011]. Вызывающие стороны могут поэтому без дополнительных мер синхронизации вызывать метод параллельно из различных потоков для одного и того же экземпляра. Благодаря квалификации в качестве метода const состояние домена ошибок при вызове не изменяется [AP_SWS_Fw_83011].

Обработка ошибок и граничные условия

Благодаря объявлению в качестве noexcept метод гарантирует, что исключения C++ не будут сгенерированы [AP_SWS_Fw_83011]. Специфические коды ошибок или значения ошибок для неразрешимых кодов в элементе не определены [AP_SWS_Fw_83011]. Возвращаемый указатель, предположительно, указывает на неизменяемую статически выделенную строку, благодаря чему у вызывающей стороны отсутствует обязанность управления памятью. Вопрос Q-2e98884ffd517367 (открытый)

Функция-член ThrowAsException класса ara::fw::FwErrorDomain служит для создания экземпляра и вызова исключения FwException из переданного кода ошибки errorCode [AP_SWS_Fw_83012]. Функция подключается через заголовочный файл ara/fw/fw_error_domain.h и принимает константную ссылку на ara::core::ErrorCode в качестве единственного параметра [AP_SWS_Fw_83012]. Она не имеет возвращаемого значения (void) и объявлена с const, а также override [AP_SWS_Fw_83012].

Положением спецификации noexcept(false) явно определено, что при вызове метода допускается генерация исключений; функция детерминированно создает и выбрасывает FwException для соответствующего случая ошибки [AP_SWS_Fw_83012]. В отношении безопасности исключений метод классифицирован как not exception safe [AP_SWS_Fw_83012]. Вызывающий код должен быть готов к тому, что результирующее исключение прервет обычный поток управления, и должен предусмотреть соответствующие меры для обработки исключений.

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