estrutura ara::exec::ExecutionErrorEvent

A estrutura de dados ara::exec::ExecutionErrorEvent serve para encapsular eventos de erro quando um processo dentro de um grupo de funções termina inesperadamente. Para este fim, agrupa o código de erro específico do processo afetado através do atributo executionError [SWS_EM_02545] com o respetivo functionGroup [SWS_EM_02546] no qual o incidente ocorreu. Com base nestes dados, o tratamento de erros de nível superior pode analisar o contexto e iniciar medidas adequadas de reinício ou de salvaguarda para o respetivo grupo de funções. Como estrutura de dados pura, o tipo não disponibiliza métodos próprios e requer sincronização externa em caso de acesso concorrente.

mais ›

Contexto

A estrutura ara::exec::ExecutionErrorEvent serve no módulo exec para representar um erro de execução ocorrido dentro de um grupo de funções. Na AUTOSAR Adaptive Platform, os processos são estruturados logicamente em grupos de funções para que o seu estado e ciclo de vida possam ser controlados de forma ordenada. Se ocorrer um erro grave durante a execução de um processo que conduza à sua terminação inesperada, este estado é mapeado como um evento estruturado. A estrutura de dados encapsula para tal os detalhes relevantes, associando o código de erro ocorrido ao grupo de funções afetado.

Entre os parceiros de interação primários encontram-se o processo afetado, cuja interrupção inesperada origina o valor de erro concreto executionError [SWS_EM_02545], bem como o respetivo grupo de funções functionGroup em cujo contexto o erro ocorreu [SWS_EM_02546]. Como outro parceiro de comunicação atua uma instância de nível superior do sistema global. Interpretação: esta instância de monitorização deverá receber e avaliar o evento para desencadear reações coordenadas ao nível do grupo. Pergunta (aberta)

Diagrama de contexto: interação dos componentes envolvidos aquando da ocorrência de um erro de execução. Fontes: [SWS_EM_02545], [SWS_EM_02546]

Ciclo de vida

A definição como struct ExecutionErrorEvent final caracteriza o tipo como uma estrutura de dados final e não polimórfica sem relações de herança. Como objeto de dados e de valor puro, a estrutura não possui máquinas de estados internas nem fases de ciclo de vida autónomas. Uma instância surge orientada por eventos exatamente quando um processo termina inesperadamente e este incidente é registado. Na criação, são inicializadas ambas as variáveis de membro públicas: o campo executionError com o valor de erro do processo específico do sistema [SWS_EM_02545], bem como o campo functionGroup com a instância do grupo de funções afetado [SWS_EM_02546].

Relativamente às relações de titularidade, a estrutura é habitualmente criada como um objeto de valor local e transmitida a rotinas de processamento e notificação quer diretamente por cópia de valor, quer através de referências constantes. Por norma, não é necessária uma alocação dinâmica de memória para o próprio objeto. A destruição ocorre de forma determinística ao sair do âmbito de validade da respetiva rotina de tratamento. Quanto à concorrência, a estrutura não implementa qualquer sincronização de acesso própria. Interpretação: se instâncias de ExecutionErrorEvent forem passadas além das fronteiras de threads, os chamadores devem sincronizar externamente o acesso concorrente de leitura e escrita. Pergunta Q-839283a2c3c3e269 (aberta)

Caminho de utilização

O caminho típico de utilização compreende a deteção, o reencaminhamento e a avaliação do evento de erro:

• Geração de eventos: um processo monitorizado dentro de um grupo de funções ativo é interrompido inesperadamente. O sistema instancia em seguida um objeto do tipo ExecutionErrorEvent.
• Atribuição de parâmetros: os atributos são preenchidos com os dados de contexto do incidente. O valor de erro específico é guardado no campo executionError [SWS_EM_02545], enquanto functionGroup assume a associação ao grupo de funções em execução [SWS_EM_02546].
• Transmissão a rotinas de tratamento: o evento inicializado é reencaminhado para a monitorização de erros competente ou para a gestão de reinício.
• Avaliação e reação: a instância recetora analisa functionGroup [SWS_EM_02546] para localizar o subsistema e faz a leitura de executionError [SWS_EM_02545]. Interpretação: com base nestas informações, a instância de monitorização deverá decidir sobre reinícios de processos ou uma mudança de estado do grupo de funções. Pergunta (aberta)

Cenários de erro

A estrutura ExecutionErrorEvent não define, por si própria, códigos de erro, valores de retorno ou exceções. Atua exclusivamente como suporte de informação para estados de erro originados ao nível do processo. O cenário primário de erro é, por conseguinte, a terminação inesperada de um processo, cuja causa é representada no campo executionError [SWS_EM_02545].

Como pré-condição para um processamento correto, considera-se que ambas as variáveis de membro estejam preenchidas de forma consistente. Um evento sem erro de processo válido [SWS_EM_02545] ou sem associação a um grupo de funções existente [SWS_EM_02546] impede um tratamento de erros orientado a objetivos. Como pós-condição da avaliação do evento, o grupo de funções afetado [SWS_EM_02546] deve ser reposto num estado seguro e definido.