Define o domínio de erros do FVM do SecOC e mapeia códigos de erro específicos para textos de mensagem e exceções.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 815063923fbeProcedênciaPerguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Define o domínio de erros do FVM do SecOC e mapeia códigos de erro específicos para textos de mensagem e exceções.
A classe apext::com::secoc::ComSecOcFvmErrorDomain encapsula o domínio de erros para o Freshness Value Manager no módulo de comunicação SecOC do AUTOSAR Adaptive [SWS_CM_12514]. Ela mapeia códigos de erro de ComSecOcFvmErrc para textos descritivos e permite a sua conversão em exceções ComSecOcFvmException. O acesso ocorre habitualmente em todo o processo por meio da função auxiliar GetComSecOcFvmErrorDomain()[SWS_CM_12521]. Se as exceções do compilador estiverem desativadas, o método de geração de exceções é removido automaticamente da resolução de sobrecarga.
Contexto
A classe apext::com::secoc::ComSecOcFvmErrorDomain define o domínio de erros para o Freshness Value Manager (FVM) no âmbito da comunicação embarcada segura (SecOC) para o gerenciamento de comunicação do Adaptive AUTOSAR [SWS_CM_12514] (AUTOSAR_AP_SWS_CommunicationManagement §C.2.3 «Class: ComSecOcFvmErrorDomain»). Como subclasse final de ara::core::ErrorDomain, ela integra estados de erro de FVM específicos do domínio ao modelo de tratamento de erros em toda a plataforma do AUTOSAR Adaptive.
A criação de uma instância de ComSecOcFvmErrorDomain ocorre por meio do construtor padrão sem parâmetros [SWS_CM_12517]. Pela declaração como constexpr e noexcept, é garantido que a instanciação já possa ocorrer em tempo de compilação sem risco de alocação e seja completamente segura contra exceções.
Em operação contínua, o domínio de erros atua tipicamente como um singleton de longa duração e imutável no processo (interpretação). Pergunta Q-fc901552d01e33de (aberta) Componentes de aplicação e middleware normalmente não instanciam o domínio localmente, mas utilizam a referência constante [SWS_CM_12521] disponibilizada via GetComSecOcFvmErrorDomain(). Como as funções-membro Name()[SWS_CM_12518] e Message()[SWS_CM_12519] são sem estado e definidas como const noexcept, o acesso de leitura concorrente a partir de várias threads é seguro sem mecanismos adicionais de sincronização.
Caminho de utilização
Se ocorrer um erro no Freshness Value Manager, os chamadores interagem com o domínio de erros ao longo de uma sequência fixa:
Obter referência: o componente obtém a referência global do domínio por meio de GetComSecOcFvmErrorDomain()[SWS_CM_12521].
Identificação do domínio: através de Name(), pode-se consultar o identificador atribuído de forma fixa ao domínio de erros para fins de registro em log ou de diagnóstico [SWS_CM_12518].
Resolver mensagem de erro: com base em um código de erro passado (CodeType), Message() fornece um ponteiro para a descrição estática e legível por humanos do erro [SWS_CM_12519].
Lançar exceção: caso o caminho de erro deva ser tratado com base em exceções, ThrowAsException() transforma um objeto ara::core::ErrorCode na respectiva exceção [SWS_CM_12520].
As funções Name()[SWS_CM_12518] e Message()[SWS_CM_12519] possuem a segurança contra exceções noexcept e não lançam sob nenhuma circunstância. No caso de códigos de erro numéricos desconhecidos, Message() provavelmente retorna uma cadeia de caracteres padrão genérica (interpretação). Pergunta Q-4f9834f33957160b (aberta)
Em contrapartida, o método ThrowAsException(), por definição, não é seguro contra exceções (not exception safe), uma vez que sua tarefa explícita consiste em construir e lançar um objeto ComSecOcFvmException com base no ara::core::ErrorCode passado [SWS_CM_12520]. A configuração da toolchain aplica-se como uma pré-condição importante: se as exceções de C++ forem desativadas no compilador, ThrowAsException() não participa da resolução de sobrecarga [SWS_CM_12520]. Consequentemente, chamadores em ambientes de execução livres de exceções devem mapear o tratamento de erros por meio de ara::core::Result ou avaliações diretas de códigos de erro.
Este guia foi gerado por um sistema de IA com base na especificação AUTOSAR Adaptive R25-11.
Creates a new instance of apext::com::secoc::ComSecOcFvmException from errorCode and throws it. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
Returns a string constant associated with the apext::com::secoc:: ComSecOcFvmErrorDomain
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: c28253f0fde1ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
A função-membro Name() da classe de domínio de erros apext::com::secoc::ComSecOcFvmErrorDomain retorna uma constante de cadeia de caracteres que representa o identificador deste domínio de erros [SWS_CM_12518]. A declaração é disponibilizada através do ficheiro de cabeçalho #include "apext/com/secoc/fvm_error_domain.h"[SWS_CM_12518]. A função opera de forma puramente síncrona, não aceita parâmetros e retorna um ponteiro para uma cadeia de caracteres imutável do tipo const char *[SWS_CM_12518].
Relativamente ao tratamento de erros, a interface é especificada como exception safe e provida do identificador C++ noexcept[SWS_CM_12518]. Deste modo, uma chamada não pode falhar e não desencadeia exceções C++. Não existem códigos de erro específicos, descrições de retorno ou mensagens para o DET ou DEM para esta função de consulta.
Tratando-se de um método const de leitura, que retorna um ponteiro constante para uma string estática, a execução deverá ser reentrante e segura para threads (thread-safe). Pergunta Q-75fa65f59869d0ab (aberta) Não existem condições restritivas de ordem para o contexto de chamada.
O método integra-se nas extensões do Communication Management para SecOC e o Freshness Value Management AUTOSAR_AP_SWS_CommunicationManagement §1 «Release Changes» p. 3. Segue o mesmo padrão arquitetural que as funções homónimas de outros domínios de erro do módulo, nomeadamente em ara::com::ComErrorDomain[SWS_CM_11331] e em ara::com::e2e::ComE2EErrorDomain[SWS_CM_12507].
Esta nota de uso foi gerada automaticamente com base na especificação AUTOSAR R25-11.
Creates a new instance of apext::com::secoc::ComSecOcFvmException from errorCode and throws it. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: ce36f40333e6Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
usar
A função-membro ThrowAsException do domínio de erros apext::com::secoc::ComSecOcFvmErrorDomain (SWS Communication Management §C.2.3.2.2.3 «ThrowAsException», [SWS_CM_12520]) serve para a conversão de um código de erro numa exceção C++. Aceita como parâmetro de entrada uma referência para um código de erro errorCode do tipo const ara::core::ErrorCode& e não possui valor de retorno. A função cria uma nova instância de apext::com::secoc::ComSecOcFvmException com base no código de erro passado e lança-a de forma síncrona ([SWS_CM_12520]).
Tratamento de erros e segurança de exceções
O método é declarado com noexcept(false) e classificado, de acordo com a especificação, como não seguro contra exceções (not exception safe) ([SWS_CM_12520]). O padrão de execução regular prevê que a função não retorne normalmente, mas reporte diretamente a exceção apext::com::secoc::ComSecOcFvmException gerada ao chamador em caso de erro.
Restrições
Aplica-se à função uma restrição essencial relativa à configuração do compilador: caso as exceções C++ estejam desativadas na toolchain do compilador, ThrowAsException não participa, de acordo com [SWS_CORE_10304], na resolução de sobrecargas ([SWS_CM_12520]).
gemini-3.8-flash-low· 2026-10-13 · Original em alemão