classe ara::diag::DiagSovdErrorDomain

usar

O construtor padrão inicializa uma instância do domínio de erro ara::diag::DiagSovdErrorDomain [SWS_DM_01812] de acordo com AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.1.1 «Default Constructor». A função está declarada como constexpr e noexcept, exigindo a inclusão do cabeçalho #include "ara/diag/diag_sovd_error_domain.h" [SWS_DM_01812].

Interação e contexto de chamada

Em cenários de aplicação típicos, uma instanciação manual direta por meio deste construtor raramente deve ser necessária, uma vez que a interface funcional ara::diag::GetDiagSovdErrorDomain() já fornece uma referência para a instância global do domínio de erro [SWS_DM_01816]. Pergunta Q-8c4b22173b01dce7 (aberta)

A classe DiagSovdErrorDomain define a área de erro para SOVD e fornece tipos bem como funções essenciais:

• Aliases de tipos para códigos de erro Errc [SWS_DM_01810] e tratamento de exceções Exception [SWS_DM_01811].
• Criação de instâncias de códigos de erro por meio de MakeErrorCode() [SWS_DM_01817].
• Consulta de nome por meio de Name() [SWS_DM_01813] e tradução de texto via Message() [SWS_DM_01814], bem como disparo de exceções por meio de ThrowAsException() [SWS_DM_01815].

Tratamento de erros e simultaneidade

Como função noexcept sem parâmetros, o construtor não lança exceções. De acordo com a especificação, a chamada é segura contra exceções («exception safe») e concorrentemente segura para threads («thread-safe») [SWS_DM_01812]. Não há pré-requisitos específicos ou códigos de erro definidos para o construtor.

A função-membro Message da classe ara::diag::DiagSovdErrorDomain serve para a tradução síncrona de um código de erro numérico em uma mensagem de texto legível [SWS_DM_01814] (comprovado em AUTOSAR_AP_SWS_Diagnostics p. 69). Ela é disponibilizada por meio do arquivo de cabeçalho ara/diag/diag_sovd_error_domain.h no namespace ara::diag.

Para a chamada e o comportamento em tempo de execução, aplicam-se as seguintes características da especificação:

• Uso e semântica: Como parâmetro de entrada é passado errorCode do tipo ara::core::ErrorDomain::CodeType. A função retorna de forma síncrona um ponteiro para uma cadeia de caracteres constante (const char *), que contém a descrição textual do erro. A especificação garante de forma vinculativa que este valor de retorno nunca é nullptr [SWS_DM_01814].
• Tratamento de erros e robustez: A interface é qualificada com noexcept e definida como segura para exceções (exception safe) [SWS_DM_01814]. Nenhuma exceção C++ é lançada. Interpretação: na passagem de um código de erro não definido ou desconhecido, a implementação deve retornar um texto indicativo padronizado para cumprir a garantia contra ponteiros nulos. Pergunta Q-c115f3da24bde8bd (aberta)
• Concorrência: O método é declarado como operação const e explicitamente especificado como seguro para threads (thread-safe) [SWS_DM_01814]. Ele não altera estados internos, não está sujeito a condições de ordenação e pode ser chamado em paralelo a partir de múltiplas threads sem bloqueios externos ou mecanismos de sincronização.
• Interação no Diagnostic Management: O método disponibiliza a tradução padronizada de texto para o domínio de erro SOVD. Ele segue o padrão arquitetural uniforme da Adaptive Platform e corresponde em assinatura e comportamento às implementações Message de domínios de erro de diagnóstico relacionados, como DiagErrorDomain [SWS_DM_00522], DiagUdsNrcErrorDomain [SWS_DM_00534], DiagOfferErrorDomain [SWS_DM_00994] e DiagReportingErrorDomain [SWS_DM_01001].

usar

O método Name da classe ara::diag::DiagSovdErrorDomain retorna o nome curto (ApApplicationErrorDomain.SN) do domínio de erro SOVD de forma síncrona como string C (const char*) ([SWS_DM_01813]; AUTOSAR_AP_SWS_Diagnostics §7 «Diagnostics»). A função não espera parâmetros de entrada e é disponibilizada por meio do cabeçalho ara/diag/diag_sovd_error_domain.h ([SWS_DM_01813]). Interpretação: o ponteiro retornado deve apontar para uma cadeia de caracteres imutável e mantida estaticamente, que permanece válida durante todo o tempo de execução. Pergunta Q-b7b74a09ea645e46 (aberta)

Tratamento de erros e simultaneidade

A função é declarada como noexcept e considerada segura para exceções (exception safe) ([SWS_DM_01813]). Ela não relata códigos de erro e não gera entradas DET nem DEM. Para a concorrência, o método é especificado como seguro para threads (thread-safe) ([SWS_DM_01813]). Possui, portanto, propriedades reentrantes e pode ser chamado a partir de quaisquer threads sem mecanismos externos de sincronização.

Interação

A interface segue o padrão uniforme de consulta de nomes para domínios de erro no diagnóstico adaptativo. Implementações correspondentes encontram-se em ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]) bem como ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]). Ela serve tipicamente para o registro em log e identificação de domínios de erro no contexto de SOVD.

usar

O método ThrowAsException da classe ara::diag::DiagSovdErrorDomain ([SWS_DM_01815], declarado no cabeçalho ara/diag/diag_sovd_error_domain.h; ver AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.3 «ThrowAsException») serve para converter síncronamente um código de erro no tipo de exceção C++ atribuído. Ele aceita o parâmetro de entrada errorCode do tipo const ara::core::ErrorCode & e não possui valor de retorno (void). Na chamada, ele lança a exceção correspondente ao código de erro conforme a assinatura com noexcept(false).

Tratamento de erros e condições de contorno

A especificação classifica o método como “not exception safe” ([SWS_DM_01815]). Interpretação: esta classificação provavelmente se justifica pelo fato de que o fluxo regular de controle é abandonado devido ao lançamento intencional de uma exceção. Uma condição de contorno central diz respeito à toolchain do compilador: segundo [SWS_CORE_10304], ThrowAsException não participa da resolução de sobrecarga se exceções C++ estiverem desativadas no compilador. Pergunta Q-23924e13760f4186 (aberta)

Concorrência e interação

A função é classificada como thread-safe (thread-safe) ([SWS_DM_01815]) e permite a chamada concorrente. O comportamento segue o esquema padronizado para domínios de erro de diagnóstico no módulo DM. Definições análogas aplicam-se a ara::diag::DiagErrorDomain ([SWS_DM_00523], ver AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 «ThrowAsException»), ara::diag::DiagOfferErrorDomain ([SWS_DM_00995], ver AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 «ThrowAsException»), ara::diag::DiagReportingErrorDomain ([SWS_DM_01002], ver AUTOSAR_AP_SWS_Diagnostics §8.11.7.2.2.3 «ThrowAsException») bem como ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], ver AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException»).