classe ara::diag::DiagReportingErrorDomain

O construtor padrão sem parâmetros [SWS_DM_00999] inicializa uma instância do domínio de erro ara::diag::DiagReportingErrorDomain ([SWS_DM_00996], AUTOSAR_AP_SWS_Diagnostics §8.11.7.2.1.1 «Default Constructor»). Ele é declarado como constexpr, bem como noexcept, e cria o domínio de forma síncrona sem valor de retorno. A classe deve ser incluída através do arquivo de cabeçalho #include "ara/diag/diag_error_domain.h".

A operação está especificada como segura para threads e segura para exceções ([SWS_DM_00999]). Como o construtor é definido como noexcept, não ocorrem exceções em tempo de execução durante a instanciação. O domínio de erro criado serve para a classificação e atribuição de erros da enumeração DiagReportingErrc ([SWS_DM_00560], alias de tipo Errc em [SWS_DM_00997]), que mapeia causas de erro específicas no reporte de diagnóstico como kAlreadyOffered, kConfigurationMismatch, kDebouncingConfigurationInconsistent ou kReportIgnored.

Na interação com o domínio de erro, as funções membro Name ([SWS_DM_01000]) e Message ([SWS_DM_01001]) fornecem o nome do domínio, bem como textos de erro para os códigos de erro passados. Por meio de ThrowAsException ([SWS_DM_01002]), códigos de erro podem ser convertidos em objetos de exceção do tipo base DiagReportingException ([SWS_DM_00998]), enquanto MakeErrorCode ([SWS_DM_01006]) serve para a criação de novas instâncias de ara::core::ErrorCode. Interpretação: Uma instanciação manual por meio deste construtor raramente deve ser necessária em programas de aplicação, uma vez que o acesso normalmente ocorre através da função singleton global GetDiagReportingDomain ([SWS_DM_01004]). Pergunta Q-772337db203849c6 (aberta)

usar

O método Message da classe ara::diag::DiagReportingErrorDomain ([SWS_DM_01001]) serve para a tradução síncrona de um código de erro numérico (ara::core::ErrorDomain::CodeType errorCode) em uma mensagem de texto descritiva. Como valor de retorno, a função fornece um ponteiro do tipo const char *, que, de acordo com a especificação, nunca é nullptr ([SWS_DM_01001]). Devido ao tipo de retorno sem mecanismo de liberação, o ponteiro provavelmente deve apontar para memória estática (interpretação). Pergunta Q-6c1dffd8e5f8f2c2 (aberta) A interface é disponibilizada por meio do arquivo de cabeçalho #include "ara/diag/diag_error_domain.h" ([SWS_DM_01001]).

Tratamento de erros e simultaneidade

A função é definida como noexcept e exception safe ([SWS_DM_01001]). Como é contratualmente garantido que um ponteiro nulo nunca seja retornado, a função sempre gera uma cadeia de caracteres válida, mesmo para códigos de erro desconhecidos ([SWS_DM_01001]). Em relação à concorrência, Message é especificado como thread-safe ([SWS_DM_01001]). Dessa forma, as chamadas podem ocorrer em paralelo a partir de múltiplas threads sem sincronização adicional.

Interação

O método sobrescreve, como override, o método base de mesmo nome para tradução de códigos de erro no contexto do Adaptive AUTOSAR ([SWS_DM_01001]). Este padrão de comportamento uniforme também é compartilhado por outros domínios de erro do módulo de diagnóstico, como ara::diag::DiagErrorDomain ([SWS_DM_00522]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00534]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00994]) e ara::diag::DiagSovdErrorDomain ([SWS_DM_01814]).

A função-membro Name() da classe ara::diag::DiagReportingErrorDomain do cabeçalho #include "ara/diag/diag_error_domain.h" retorna o nome curto configurado (shortname) da área de erro ApApplicationErrorDomain.SN como uma string C terminada em nulo [SWS_DM_01000]. A chamada ocorre de forma síncrona e sem parâmetros de entrada, a fim de disponibilizar o identificador para fins de diagnóstico e registro em log no sistema AUTOSAR_AP_SWS_Diagnostics p. 68.

Para o tratamento de erros, não estão definidos códigos de erro específicos nem mensagens DET ou DEM. Pela especificação como noexcept e segura para exceções (exception safe), garante-se que a chamada da função seja sempre bem-sucedida e não lance exceções [SWS_DM_01000].

Em relação à concorrência e restrições, o método é especificado como seguro para threads (thread-safe) e permite o acesso paralelo e reentrante a partir de diferentes threads [SWS_DM_01000]. Interpretação: o ponteiro fornecido deve apontar para uma cadeia de caracteres imutável durante toda a vida útil da instância do domínio de erro. Pergunta Q-d67122aa15cc13f8 (aberta)

No sistema global, a interface segue o padrão uniforme para domínios de erro da Adaptive Platform. Ela corresponde funcionalmente aos métodos Name() equivalentes de domínios relacionados, como DiagErrorDomain [SWS_DM_00521], DiagUdsNrcErrorDomain [SWS_DM_00533], DiagOfferErrorDomain [SWS_DM_00993] bem como DiagSovdErrorDomain [SWS_DM_01813].

A função ThrowAsException da área ara::diag::DiagReportingErrorDomain serve para lançar uma exceção C++ correspondente ao código de erro passado ([SWS_DM_01002], AUTOSAR_AP_SWS_Diagnostics §8.11.7.2.2.3 «ThrowAsException»). A interface é disponibilizada por meio do arquivo de cabeçalho ara/diag/diag_error_domain.h ([SWS_DM_01002]).

Utilização e contexto de chamada

Como parâmetro de entrada, o método recebe uma instância do tipo const ara::core::ErrorCode& (errorCode) ([SWS_DM_01002]). Ele não possui valor de retorno (void) e é especificado com noexcept(false) ([SWS_DM_01002]). Se exceções C++ estiverem desativadas na toolchain do compilador, essa função não participará da resolução de sobrecarga ([SWS_DM_01002]).

Concorrência e segurança contra erros

A função é definida como thread-safe (thread-safe) ([SWS_DM_01002]). Em relação à segurança de exceções, ela é classificada como não segura para exceções (not exception safe), já que o lançamento da exceção constitui a semântica primária da operação ([SWS_DM_01002]).

Interação no módulo de diagnóstico

O método faz parte da abordagem uniforme de tratamento de erros em AUTOSAR Adaptive Diagnostics. Interfaces semelhantes com assinatura e semântica idênticas estão especificadas para outros domínios de erro de diagnóstico:

• ara::diag::DiagErrorDomain ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 „ThrowAsException“)
• ara::diag::DiagOfferErrorDomain ([SWS_DM_00995], AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 „ThrowAsException“)
• ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 „ThrowAsException“)
• ara::diag::DiagSovdErrorDomain ([SWS_DM_01815], AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.3 „ThrowAsException“)