classe ara::diag::DiagUdsNrcErrorDomain

O construtor padrão sem parâmetros inicializa uma instância do domínio de erro ara::diag::DiagUdsNrcErrorDomain de forma síncrona e sem parâmetros de passagem [SWS_DM_00532]. Devido à qualificação como constexpr, a instanciação já pode ocorrer em tempo de compilação AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 «Default Constructor». Na implementação prática, contudo, uma instanciação manual direta da classe de domínio [SWS_DM_00529] pelo código da aplicação raramente deverá ser necessária, uma vez que a referência global é obtida por padrão através da função GetDiagUdsNrcDomain() [SWS_DM_00536]. Pergunta Q-22c33afd620b536e (aberta)

Em relação à concorrência e à segurança contra exceções, o construtor é especificado como thread-safe e exception safe [SWS_DM_00532]. Ele é declarado como noexcept e não lança quaisquer exceções por si próprio. O domínio gerencia códigos de erro do tipo de enumeração DiagUdsNrcErrc através do alias Errc [SWS_DM_00530], os quais são gerados mediante MakeErrorCode() [SWS_DM_00537]. Além disso, a classe fornece métodos como Name() [SWS_DM_00533], Message() [SWS_DM_00534] bem como ThrowAsException() [SWS_DM_00535] no âmbito de DiagUdsNrcException [SWS_DM_00531].

Em interação com o Diagnostic Management, os erros deste domínio controlam o tratamento de respostas negativas. Se uma interface ara::diag retornar um erro de DiagUdsNrcErrorDomain, o Diagnostic Server deriva dele uma resposta negativa UDS (NRC) com o valor do código de erro na faixa válida de 0x01 a 0xFE [SWS_DM_02059], [SWS_DM_02060]. Se tal erro ocorrer ao obter um elemento ambiental, o servidor avalia a respetiva condição como não satisfeita e emite uma mensagem de Log-and-Trace [SWS_DM_00970].

usar

A função-membro síncrona Message da classe ara::diag::DiagUdsNrcErrorDomain converte um código de erro numérico em uma cadeia de caracteres legível [SWS_DM_00534]. Como parâmetro, é transmitido o valor de erro errorCode do tipo ara::core::ErrorDomain::CodeType. A chamada retorna um ponteiro constante (const char *) para a mensagem correspondente, sendo garantido que o valor de retorno nunca é nullptr [SWS_DM_00534].

Tratamento de erros e simultaneidade

O método está declarado como noexcept e assegura segurança completa contra exceções (exception safe) [SWS_DM_00534]. Nenhuma exceção é lançada. Mesmo com valores desconhecidos ou inválidos para errorCode, a implementação provavelmente deve fornecer uma mensagem de fallback estática, uma vez que um ponteiro nulo está explicitamente excluído [SWS_DM_00534]. Pergunta Q-e9724baf4aedc3ff (aberta) Além disso, a função está especificada como segura para threads (thread-safe) e pode ser chamada em paralelo a partir de múltiplas threads sem sincronização externa [SWS_DM_00534].

Interação no Diagnostic Management

Dentro do Diagnostic Management, Message implementa a sobreposição padronizada da resolução de mensagens de erro especialmente para UDS Negative Response Codes (NRC) [SWS_DM_00534]. Ela corresponde a funções semelhantes de outros domínios de erros de diagnóstico, tais como DiagErrorDomain [SWS_DM_00522], DiagOfferErrorDomain [SWS_DM_00994], DiagReportingErrorDomain [SWS_DM_01001] e DiagSovdErrorDomain [SWS_DM_01814].

usar

A função-membro Name da classe ara::diag::DiagUdsNrcErrorDomain retorna o nome abreviado (ApApplicationErrorDomain.SN) deste domínio de erros de diagnóstico específico [SWS_DM_00533]. A chamada ocorre de forma síncrona e está declarada no cabeçalho ara/diag/diag_uds_nrc_error_domain.h. O método não recebe parâmetros de entrada e retorna um ponteiro do tipo const char * para uma cadeia de caracteres terminada em nulo [SWS_DM_00533].

Tratamento de erros

A função está declarada como noexcept e possui a propriedade exception safe [SWS_DM_00533]. Ela não lança exceções e não retorna códigos de erro. Uma falha na consulta não está prevista no design da interface, razão pela qual não existem mensagens de erro separadas.

Simultaneidade e restrições

De acordo com a especificação, Name está classificada como thread-safe [SWS_DM_00533]. Ela pode ser chamada em paralelo por várias threads de forma reentrante e sem mecanismos externos de sincronização. A cadeia de caracteres referenciada provavelmente representa dados alocados estaticamente, de modo que o ponteiro deve permanecer válido e inalterado durante toda a vida útil da aplicação. Não existem condições especiais de ordenação para a chamada. Pergunta Q-d4a4d28af7a9c2df (aberta)

Interação

A operação implementa a consulta padronizada de nomes para domínios de erro do AUTOSAR Adaptive no contexto de diagnóstico. Ela corresponde estruturalmente às interfaces de mesmo nome de domínios de erro relacionados, como ara::diag::DiagErrorDomain::Name [SWS_DM_00521], ara::diag::DiagOfferErrorDomain::Name [SWS_DM_00993], ara::diag::DiagReportingErrorDomain::Name [SWS_DM_01000] e ara::diag::DiagSovdErrorDomain::Name [SWS_DM_01813]. Serve principalmente para identificar erros do ambiente UDS-NRC de forma legível para clientes de diagnóstico ou componentes de logging.

A função-membro ara::diag::DiagUdsNrcErrorDomain::ThrowAsException serve para converter sincronamente um erro do domínio de erros UDS-NRC em uma exceção C++ [SWS_DM_00535]. Como parâmetro, é transmitida a instância errorCode do tipo const ara::core::ErrorCode&. A função não possui valor de retorno, mas lança diretamente o tipo de exceção atribuído ao código de erro AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException».

Quanto ao comportamento de erro e de tempo de execução, o método está declarado com noexcept(false) e classificado como não seguro contra exceções (not exception safe), pois o lançamento da exceção constitui a sua semântica primária [SWS_DM_00535]. Para o contexto de chamada concorrente, a função está especificada como segura para threads (thread-safe) [SWS_DM_00535].

Na integração e configuração do sistema, aplicam-se as seguintes condições e referências de projeto:

• Restrição do compilador: Se as exceções C++ estiverem desativadas na toolchain do compilador, esta função não participa da resolução de sobrecarga (overload resolution) de acordo com [SWS_CORE_10304] [SWS_DM_00535].
• Interação com domínios de erro: O esquema idêntico para lançamento de exceções é implementado de forma uniforme em outros domínios de diagnóstico, como em DiagErrorDomain [SWS_DM_00523], DiagOfferErrorDomain [SWS_DM_00995], DiagReportingErrorDomain [SWS_DM_01002] e DiagSovdErrorDomain [SWS_DM_01815].