classe ara::diag::DiagErrorDomain

O construtor padrão DiagErrorDomain() inicializa uma instância do domínio de erro de diagnóstico ara::diag::DiagErrorDomain ([SWS_DM_00520], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.1.1 «Default Constructor»). Ele é declarado como constexpr e noexcept, não aceita parâmetros e não retorna nenhum valor ([SWS_DM_00520]). A chamada ocorre de forma síncrona e pode ser executada tanto em tempo de compilação como em tempo de execução.

No que diz respeito à segurança de execução e à concorrência, aplicam-se as seguintes propriedades:

• Segurança contra erros e exceções: A função é especificada como exception safe e, devido a noexcept, não pode lançar exceções ([SWS_DM_00520]). Códigos de erro específicos ou mensagens para DET ou DEM não estão definidos para a construção.
• Segurança de threads: A instanciação é classificada como thread-safe ([SWS_DM_00520]) e não está sujeita a restrições quanto ao contexto de chamada.

Em interação com o módulo Diagnostics, a classe DiagErrorDomain ([SWS_DM_00517], AUTOSAR_AP_SWS_Diagnostics §8.11.3 «Class: DiagErrorDomain») representa o domínio de erros de diagnóstico. Ela disponibiliza aliases de tipos centrais como Errc ([SWS_DM_00518]) e Exception ([SWS_DM_00519]). As instâncias do domínio oferecem também métodos para consulta de nome ([SWS_DM_00521]), para a tradução de códigos de erro em textos de mensagem via Message() ([SWS_DM_00522]), bem como para o lançamento de exceções específicas do domínio através de ThrowAsException() ([SWS_DM_00523]).

Na aplicação prática, uma instanciação manual direta através deste construtor raramente deverá ser necessária (interpretação), uma vez que já está disponível uma referência de instância global com a função ara::diag::GetDiagDomain() ([SWS_DM_00524]), utilizada, entre outros, por ara::diag::MakeErrorCode() ([SWS_DM_00525]) para gerar códigos de erro. Pergunta Q-95d533b0920260e0 (aberta)

O método Message da classe ara::diag::DiagErrorDomain serve para a tradução síncrona de um código de erro numérico em uma mensagem de texto legível ([SWS_DM_00522]). Ele sobrescreve a função básica do conceito de domínio de erros e é fornecido através do cabeçalho ara/diag/diag_error_domain.h ([SWS_DM_00522]).

Contexto de chamada e semântica

Como parâmetro de entrada, a função espera errorCode do tipo ara::core::ErrorDomain::CodeType ([SWS_DM_00522]). O valor de retorno é um ponteiro do tipo const char * para a mensagem de erro correspondente ([SWS_DM_00522]). A especificação garante de forma vinculativa que este valor de retorno nunca é nullptr ([SWS_DM_00522]). Interpretação: a cadeia de caracteres fornecida provavelmente aponta para literais de cadeia de caracteres estáticos, visto que a interface não prevê liberação dinâmica de memória e não pode falhar. Pergunta Q-a54b3a5f746357a8 (aberta)

Tratamento de erros e simultaneidade

Para a execução aplicam-se garantias estritas quanto à robustez e simultaneidade:

• Segurança contra exceções: A operação é declarada como noexcept e especificada como totalmente segura contra exceções (exception safe) ([SWS_DM_00522]). Ela não lança exceções C++ em caso de erro.
• Segurança de threads: A função é categorizada explicitamente como thread-safe ([SWS_DM_00522]). Por isso, pode ser chamada de forma segura por várias threads em paralelo, sem mecanismos externos de sincronização.

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

A função faz parte do relatório uniforme de erros no AUTOSAR Adaptive Diagnostic Management. Funções de tradução idênticas existem para outros domínios específicos do módulo:

• ara::diag::DiagUdsNrcErrorDomain::Message para a resolução em texto de NRCs de UDS ([SWS_DM_00534]),
• ara::diag::DiagOfferErrorDomain::Message para a descrição de erros em ofertas de diagnóstico ([SWS_DM_00994]),
• ara::diag::DiagReportingErrorDomain::Message para a resolução de códigos de erro de relatório ([SWS_DM_01001]),
• ara::diag::DiagSovdErrorDomain::Message para códigos de erro específicos de SOVD ([SWS_DM_01814]).

O método ara::diag::DiagErrorDomain::Name serve para a consulta padronizada do identificador do domínio de erros de diagnóstico ([SWS_DM_00521]). Ele é disponibilizado pelo cabeçalho ara/diag/diag_error_domain.h e retorna de forma síncrona o nome abreviado ApApplicationErrorDomain.SN como uma string C terminada em nulo do tipo const char * ([SWS_DM_00521]). A chamada ocorre sem parâmetros de entrada. Interpretação: o ponteiro retornado provavelmente aponta para um literal de cadeia de caracteres persistido estaticamente, uma vez que a especificação não prevê mecanismos de liberação. Pergunta Q-1ca098627210deb0 (aberta)

Em relação ao tratamento de erros, a função é declarada como noexcept, bem como especificada como segura contra exceções (exception safe) ([SWS_DM_00521]). Não são reportados códigos de erro nem exceções; uma chamada resulta sempre em um resultado válido.

No que diz respeito à concorrência e condições de contorno, o método está definido como thread-safe ([SWS_DM_00521]). Como é sem estado e qualificado como const, ele opera de modo reentrante e pode ser executado concorrentemente a partir de quaisquer threads sem sincronização externa.

Na interação arquitetural, a função integra-se ao Diagnostic Management (AUTOSAR_AP_SWS_Diagnostics p. 68). Métodos Name semelhantes para identificação de domínio existem para as classes relacionadas ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) e ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

A função-membro ThrowAsException da classe ara::diag::DiagErrorDomain serve para o lançamento síncrono de uma exceção C++ com base em um código de erro transmitido ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 «ThrowAsException»). O método espera como parâmetro de entrada uma referência constante para uma instância de ara::core::ErrorCode e não possui valor de retorno ([SWS_DM_00523]). Como o objetivo primário consiste no lançamento de uma exceção, a operação está declarada com noexcept(false), bem como não segura contra exceções (not exception safe) ([SWS_DM_00523]).

Em relação à concorrência, o método está especificado como seguro para threads (thread-safe) e pode, assim, ser chamado a partir de múltiplos contextos de execução sem sincronização adicional ([SWS_DM_00523]). Uma condição de contorno essencial diz respeito a ambientes sem suporte a exceções: de acordo com [SWS_CORE_10304], a função não participa da resolução de sobrecarga se as exceções C++ estiverem desativadas na toolchain do compilador utilizada ([SWS_DM_00523]).

Este esquema funcional é aplicado de forma consistente entre diferentes domínios de erro do módulo de diagnóstico. Implementações análogas de ThrowAsException encontram-se, entre outras, em ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException»), ara::diag::DiagOfferErrorDomain ([SWS_DM_00995]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01002]), bem como ara::diag::DiagSovdErrorDomain ([SWS_DM_01815]). Interpretação: devido à especificação com override, o método provavelmente mapeia uma operação de interface comum para o tratamento polimórfico de exceções. Pergunta Q-9c1e35e079af639d (aberta)