classe ara::tsync::TsyncErrorDomain

usar

O método Message da classe ara::tsync::TsyncErrorDomain serve para a recuperação síncrona de uma descrição textual de erro para um código de erro passado [SWS_TS_00907]. Ele é disponibilizado por meio do cabeçalho #include "ara/tsync/tsync_error_domain.h". Como parâmetro de entrada, a função recebe errorCode do tipo CodeType e retorna um ponteiro de string constante (const char *) para a mensagem correspondente [SWS_TS_00907].

Tratamento de erros e simultaneidade

A interface garante total segurança contra exceções (exception safe) e é declarada como noexcept, motivo pelo qual a chamada é garantida sem exceções C++ [SWS_TS_00907]. Além disso, a função é especificada como thread-safe e pode ser chamada concorrentemente a partir de múltiplas threads sem ressalvas [SWS_TS_00907]. Interpretação: O const char * retornado provavelmente aponta para uma memória estática e imutável, de modo que nenhuma liberação manual de memória seja necessária para o chamador. Pergunta Q-933f88e4fde03016 (aberta)

Interação

Como método sobrescrito (override), a função integra-se ao modelo de erro uniforme do AUTOSAR Adaptive [SWS_TS_00907]. De maneira semelhante, apext::tsync::TsyncFvmErrorDomain do cabeçalho #include "apext/tsync/fvm_error_domain.h" também implementa uma função homônima Message para a resolução de textos de erro específicos do domínio sob as mesmas garantias relativas à segurança de thread e contra exceções [SWS_TS_14210].

Utilização e contexto de chamada

A função-membro Name() da classe ara::tsync::TsyncErrorDomain retorna um ponteiro para uma string constante que identifica o domínio de erros [SWS_TS_00906]. A função requer o arquivo de cabeçalho ara/tsync/tsync_error_domain.h, é chamada de forma síncrona e não recebe parâmetros [SWS_TS_00906]. O tipo const char * é retornado como valor de retorno [SWS_TS_00906]. Interpretação: Como o valor de retorno é definido como uma constante de string, a área de memória provavelmente possui tempo de vida estático e não deve ser modificada nem liberada pelo chamador. Pergunta Q-f9cb9d4986d49755 (aberta)

Tratamento de erros e simultaneidade

O método é declarado como noexcept e especificado como seguro contra exceções («exception safe»), garantindo que nenhuma exceção seja lançada [SWS_TS_00906]. Códigos de erro específicos, mensagens DET ou DEM não existem para esta chamada. Em relação ao comportamento de concorrência, a função é classificada como thread-safe («thread-safe») [SWS_TS_00906]. Portanto, a chamada pode ocorrer em paralelo a partir de múltiplos contextos de execução sem sincronização externa.

Interação e requisitos relacionados

Com a marcação override, a função sobrescreve a interface padronizada para designação de domínio no módulo ts [SWS_TS_00906]. O mesmo padrão de projeto é implementado pelo domínio de erros relacionado apext::tsync::TsyncFvmErrorDomain, cuja função Name() de apext/tsync/fvm_error_domain.h também fornece o identificador correspondente de forma síncrona, thread-safe e segura contra exceções [SWS_TS_14209].

usar

A função-membro ThrowAsException da classe ara::tsync::TsyncErrorDomain cria de forma síncrona uma nova instância de TsyncException a partir do parâmetro errorCode passado e a lança como uma exceção C++ ([SWS_TS_00908]). A função não possui valor de retorno (void) e é disponibilizada por meio do cabeçalho ara/tsync/tsync_error_domain.h.

Tratamento de erros e segurança de exceções

O método é declarado com noexcept(false) e especificado como not exception safe ([SWS_TS_00908]). Interpretação: Esta classificação provavelmente se baseia no fato de que a função, por concepção, lança uma exceção e, assim, sai do fluxo de controle regular. Pergunta Q-cde17219378516c1 (aberta) Códigos de erro específicos não são retornados, mas sim transmitidos por meio do objeto de exceção lançado.

Simultaneidade e restrições

A função é classificada como thread-safe ([SWS_TS_00908]) e pode, portanto, ser chamada com segurança a partir de threads concorrentes. Uma restrição importante afeta a toolchain: de acordo com [SWS_CORE_10304], ThrowAsException não participa da resolução de sobrecarga (overload resolution) se exceções C++ estiverem desativadas na toolchain do compilador.

Interação

O comportamento corresponde ao padrão uniforme para domínios de erro no AUTOSAR Adaptive. Um equivalente direto é encontrado em apext::tsync::TsyncFvmErrorDomain ([SWS_TS_14211]), onde ThrowAsException lança uma apext::tsync::TsyncFvmException e também está sujeito às especificações de [SWS_CORE_10304].

usar

O construtor padrão sem parâmetros cria uma nova instância do domínio de erros ara::tsync::TsyncErrorDomain [SWS_TS_00905]. A declaração é fornecida por meio do cabeçalho #include "ara/tsync/tsync_error_domain.h" [SWS_TS_00905]. A execução ocorre de forma síncrona, não aceita parâmetros de entrada e não lança exceções C++ (noexcept) [SWS_TS_00905].

Interação e tratamento de erros

O domínio de erros criado serve para o encapsulamento e a interpretação de estados de erro específicos de sincronização no módulo Time Synchronization. Dentro do domínio, estão disponíveis os aliases de tipo Errc para a enumeração de códigos de erro TsyncErrc [SWS_TS_01266] e Exception para a classe base de exceções TsyncException [SWS_TS_01267]. Instâncias da classe fornecem por meio do método Name uma string constante com o nome do domínio [SWS_TS_00906] e por meio de Message a descrição textual do erro para um código de erro especificado [SWS_TS_00907]. Além disso, ThrowAsException permite a criação e o lançamento de uma TsyncException com base em um ara::core::ErrorCode, desde que as exceções C++ estejam ativadas no compilador [SWS_TS_00908]. Em cenários de aplicação típicos, raramente deve ser necessária uma instanciação própria por meio do construtor, uma vez que uma referência ao objeto de instância global já está disponível através de GetTsyncErrorDomain [SWS_TS_00909]. Pergunta Q-8ebaff4e52125b78 (aberta)

Simultaneidade e restrições

A chamada é especificada como segura contra exceções (exception safe) e thread-safe (thread-safe) [SWS_TS_00905]. A instanciação pode, portanto, ocorrer entre threads sem medidas adicionais de sincronização.