classe ara::diag::DiagOfferErrorDomain

O construtor padrão sem parâmetros [SWS_DM_00992] serve para a criação de uma instância da classe ara::diag::DiagOfferErrorDomain (SWS Diagnostics §8.11.5 «Class: DiagOfferErrorDomain»). Ele está declarado através do arquivo de cabeçalho ara/diag/diag_error_domain.h e possui a assinatura constexpr DiagOfferErrorDomain() noexcept; (SWS Diagnostics §8.11.5.2.1.1 «Default Constructor»). A chamada ocorre de forma síncrona, não processa parâmetros de entrada e, tipicamente para um construtor, não fornece valor de retorno [SWS_DM_00992].

Em relação à simultaneidade e à segurança contra erros, a função está especificada como thread-safe, bem como exception safe [SWS_DM_00992]. Pela especificação noexcept, é garantido que nenhuma exceção seja lançada durante a execução [SWS_DM_00992]. Códigos de erro específicos ou notificações através de DET ou DEM não estão previstos para este construtor.

No contexto do módulo, o domínio representa estados de erro em torno de serviços de diagnóstico, cujos códigos de erro estão definidos na enumeração DiagOfferErrc [SWS_DM_00559] e podem ser referenciados através do alias de tipo Errc [SWS_DM_00990]. A classe disponibiliza métodos padrão como Name() [SWS_DM_00993], Message() [SWS_DM_00994] e ThrowAsException() [SWS_DM_00995]. Em casos de uso, uma chamada direta do construtor raramente deve ser necessária (interpretação), uma vez que com a função ara::diag::GetDiagOfferDomain() já está disponível uma referência global para a instância [SWS_DM_01003], a qual é utilizada, entre outros, por ara::diag::MakeErrorCode() [SWS_DM_01005]. Pergunta Q-a98886da9b649096 (aberta)

A função-membro síncrona Message da classe ara::diag::DiagOfferErrorDomain serve para traduzir um código de erro numérico em uma mensagem de texto descritiva [SWS_DM_00994]. Os desenvolvedores incluem a interface por meio do arquivo de cabeçalho ara/diag/diag_error_domain.h [SWS_DM_00994].

Para o uso e o contexto de chamada aplicam-se as seguintes diretrizes:

• Parâmetros e valor de retorno: O valor de erro a ser consultado é passado para a função como ara::core::ErrorDomain::CodeType errorCode. Ela retorna um ponteiro para uma cadeia de caracteres constante (const char*), que, de acordo com a especificação, nunca é nullptr [SWS_DM_00994].
• Segurança contra erros e exceções: A função é declarada como noexcept e especificada como exception safe, de modo que não lança exceções C++ [SWS_DM_00994]. Códigos de erro desconhecidos ou inválidos devem ser mapeados para mensagens padrão predefinidas, a fim de cumprir a garantia de ponteiro não nulo. Pergunta Q-73eb1822df6a995d (aberta)
• Concorrência: A operação é declarada como método const e explicitamente classificada como thread-safe, permitindo chamadas concorrentes a partir de múltiplas threads sem sincronização externa [SWS_DM_00994].

O método sobrescreve uma interface base e segue o padrão uniforme de mensagens de erro do módulo de diagnóstico, que também é usado de forma análoga em outros domínios de erro, como ara::diag::DiagErrorDomain [SWS_DM_00522], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00534], ara::diag::DiagReportingErrorDomain [SWS_DM_01001] e ara::diag::DiagSovdErrorDomain [SWS_DM_01814].

O método Name() da classe ara::diag::DiagOfferErrorDomain serve para determinar de forma síncrona o nome curto exclusivo do domínio de erro ([SWS_DM_00993]). Ele está disponível por meio do arquivo de cabeçalho ara/diag/diag_error_domain.h e sobrescreve o método base para identificação de domínio no framework Adaptive ([SWS_DM_00993]).

Uso e semântica:

• Contexto de chamada e parâmetros: A chamada ocorre de forma síncrona, sem parâmetros e sem pré-condições, diretamente na instância de ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]).
• Valor de retorno: A função retorna um const char*, que representa o identificador ApApplicationErrorDomain.SN do domínio de erro ([SWS_DM_00993]). Interpretação: o ponteiro retornado deve apontar para uma cadeia de caracteres imutável e estática, que permanece válida durante todo o tempo de execução do programa. Pergunta Q-86836b3715182080 (aberta)
• Tratamento de erros: O método é declarado como noexcept e especificado como exception safe ([SWS_DM_00993]). Ele não relata códigos de erro nem lança exceções.
• Concorrência: A execução é classificada como thread-safe ([SWS_DM_00993]), de modo que chamadas paralelas a partir de múltiplas threads são permitidas sem sincronização externa.

Interação: O comportamento corresponde ao padrão arquitetural geral para domínios de erro no Diagnostic Management. Métodos Name() com especificação idêntica existem para domínios relacionados, como ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) e ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

A função-membro ThrowAsException do domínio de erro ara::diag::DiagOfferErrorDomain serve, de acordo com [SWS_DM_00995], para converter um código de erro passado do tipo ara::core::ErrorCode em uma exceção C++ correspondente e lançá-la (AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 «ThrowAsException»).

Em relação à semântica e ao design da interface, aplicam-se as seguintes propriedades:

• Chamada e parâmetros: O método recebe uma referência constante para uma instância de ara::core::ErrorCode, não possui valor de retorno (void) e é declarado com noexcept(false), pois, por definição, lança uma exceção [SWS_DM_00995].
• Restrição de compilação: De acordo com [SWS_CORE_10304], a função não participa da resolução de sobrecarga (Overload Resolution) se exceções C++ estiverem desativadas na toolchain do compilador [SWS_DM_00995].
• Segurança e concorrência: A função é especificada como thread-safe, permitindo chamadas paralelas além dos limites de threads; no entanto, ela é explicitamente indicada como not exception safe [SWS_DM_00995].
• Interação: O conceito corresponde ao modelo de erro padronizado para domínios de erro de diagnóstico, conforme implementado analogamente em ara::diag::DiagErrorDomain [SWS_DM_00523], ara::diag::DiagReportingErrorDomain [SWS_DM_01002], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00535] bem como ara::diag::DiagSovdErrorDomain [SWS_DM_01815]. A definição é incluída por meio do arquivo de cabeçalho #include "ara/diag/diag_error_domain.h" [SWS_DM_00995].

Devido à classificação como not exception safe, nenhuma proteção interna adicional contra erros deve atuar dentro do método durante o processo de lançamento no contexto do sistema (interpretação: os desenvolvedores devem capturar exceções no contexto da aplicação chamadora). Pergunta Q-72152cb488c24026 (aberta)