classe apext::tsync::TsyncFvmErrorDomain

A função-membro [SWS_TS_14210] pertence à classe apext::tsync::TsyncFvmErrorDomain e é incluída através do ficheiro de cabeçalho apext/tsync/fvm_error_domain.h. Serve para a determinação síncrona da descrição textual de um código de erro ocorrido. Como parâmetro de entrada, a função recebe o código de erro numérico errorCode do tipo CodeType e retorna a mensagem de erro associada como um ponteiro para uma cadeia de carateres constante (const char *).

No que diz respeito à concorrência e tolerância a falhas, a especificação assegura garantias abrangentes: o método está classificado como thread-safe e pode, portanto, ser chamado a partir de threads concorrentes sem medidas adicionais de sincronização [SWS_TS_14210]. Além disso, a função está classificada como exception safe e provida com o identificador noexcept, o que exclui o lançamento de exceções durante a execução.

No módulo ts, existe uma estreita relação com o elemento de especificação [SWS_TS_00907]. Este define a função análoga Message para o domínio de erro ara::tsync::TsyncErrorDomain no cabeçalho ara/tsync/tsync_error_domain.h. Ambas as interfaces apresentam a mesma assinatura, bem como garantias idênticas quanto à segurança de threads e segurança contra exceções, assegurando uma consulta uniforme de textos de erro entre diferentes domínios.

A função-membro constante Name() da classe apext::tsync::TsyncFvmErrorDomain retorna um ponteiro para uma cadeia de carateres imutável (const char*), que representa o nome do domínio de erro para o Time-Synchronization-FVM [SWS_TS_14209]. A função serve para consultar o identificador do domínio de erro em tempo de execução. A chamada é executada de forma síncrona e sem parâmetros, exigindo a inclusão do ficheiro de cabeçalho apext/tsync/fvm_error_domain.h [SWS_TS_14209].

Relativamente ao comportamento em caso de erro, a interface está declarada como noexcept e é considerada segura contra exceções (exception safe) [SWS_TS_14209]. Como apenas referencia uma constante de cadeia de carateres fixa, não são retornados códigos de erro específicos nem ocorrem casos de erro. Quanto à concorrência, o método está expressamente classificado como seguro para threads (thread-safe) [SWS_TS_14209]. Chamadas paralelas a partir de múltiplas threads deverão, por isso, ser sempre admissíveis sem sincronização externa adicional ou mecanismos de proteção. Pergunta Q-6664ffba9d211592 (aberta)

Na interação arquitetural, a função sobrepõe (override) a interface para identificação do domínio de erro e complementa a função análoga de [SWS_TS_00906]. Enquanto [SWS_TS_00906] disponibiliza através de ara/tsync/tsync_error_domain.h o nome do domínio de erro ara::tsync::TsyncErrorDomain para a sincronização de tempo básica, [SWS_TS_14209] serve para a identificação do domínio de erro especializado apext::tsync::TsyncFvmErrorDomain. Ambos os métodos seguem, assim, o modelo de erros uniforme do AUTOSAR Adaptive.

A função-membro ThrowAsException do domínio de erro apext::tsync::TsyncFvmErrorDomain serve para o lançamento síncrono de uma exceção C++ com base num código de erro ([SWS_TS_14211]). A declaração está disponível através do cabeçalho apext/tsync/fvm_error_domain.h. O método recebe o parâmetro de entrada errorCode (const ara::core::ErrorCode &), instancia a partir dele uma apext::tsync::TsyncFvmException específica e lança-a diretamente ([SWS_TS_14211]). Do mesmo modo, a função especificada com noexcept(false) não possui valor de retorno.

Para o contexto de chamada, a função está especificada como segura para threads (thread-safe), contudo classificada como não segura contra exceções (not exception safe) ([SWS_TS_14211]). Interpretação: esta classificação como não segura contra exceções dever-se-á ao facto de o lançamento intencional de uma exceção terminar o fluxo de controlo regular. Pergunta Q-4d1dbde678635320 (aberta) Uma restrição central do compilador é definida por [SWS_CORE_10304]: se as exceções C++ estiverem desativadas na toolchain, a função não participa na resolução de sobrecargas.

No sistema global, a função complementa o tratamento de erros de forma análoga a [SWS_TS_00908] de ara::tsync::TsyncErrorDomain. Enquanto aí é lançada uma TsyncException, ThrowAsException permite, no domínio de erro FVM, a transformação uniforme de um ara::core::ErrorCode numa exceção C++ ([SWS_TS_14211]).

usar

O construtor padrão sem parâmetros TsyncFvmErrorDomain() cria de forma síncrona uma nova instância do domínio de erro apext::tsync::TsyncFvmErrorDomain [SWS_TS_14208]. Ele não espera parâmetros de entrada e é declarado como constexpr bem como noexcept. Para a integração, deve-se incluir o arquivo de cabeçalho apext/tsync/fvm_error_domain.h [SWS_TS_14208].

Tratamento de erros e simultaneidade

Como o construtor é especificado como noexcept, não ocorrem exceções durante a instanciação; a execução é considerada thread-safe e segura contra exceções [SWS_TS_14208]. O objeto criado gerencia e traduz códigos de erro da enumeração TsyncFvmErrc [SWS_TS_14202] (alias de tipo Errc [SWS_TS_14206]), que abrange os erros específicos kFVNotAvailable e kFVInitializeFailed [SWS_TS_14202].

Zusammenspiel e ciclo de vida

A instância do domínio disponibiliza interfaces para resolução de nome e de mensagem através de Name() [SWS_TS_14209] e Message() [SWS_TS_14210], bem como para o lançamento de exceções específicas do tipo via ThrowAsException() [SWS_TS_14211] utilizando Exception [SWS_TS_14207]. A destruição ocorre através do destrutor virtual ~TsyncFvmErrorDomain() [SWS_TS_14201]. No código da aplicação, uma construção manual direta raramente deve ser necessária; provavelmente, a instância singleton global é obtida em vez disso através de GetTsyncFvmErrorDomain() [SWS_TS_14212]. Pergunta Q-411a136f0129313a (aberta)