estrutura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface6>StartOutput

A estrutura <RoutineInterface6>StartOutput do módulo diag da AUTOSAR Adaptive Platform encapsula todos os argumentos de saída para a operação de início de uma rotina de diagnóstico. Ao receber um pedido de início, a implementação de rotina específica da aplicação preenche os campos de dados da estrutura com os valores resultantes e passa a instância para a plataforma, presumivelmente integrada num objeto de retorno assíncrono. Pergunta (aberta) Os estados de erro, de acordo com a interpretação, não são sinalizados na própria estrutura de dados, mas sim através de códigos de erro separados, pelo que todos os parâmetros de saída exigidos devem estar sempre integral e consistentemente inicializados antes do retorno.

mais ›

Contexto

A estrutura <RoutineInterface6>StartOutput faz parte do módulo diag da AUTOSAR Adaptive Platform no Release R25-11. Dentro deste módulo de diagnóstico, o tipo serve como contentor de dados que agrupa os argumentos de saída para a operação de arranque de uma rotina de diagnóstico. Na execução de funções de diagnóstico através do controlo de rotinas, interagem tipicamente uma implementação de serviço específica da aplicação e a infraestrutura de diagnóstico da plataforma. A estrutura atua aqui na interface entre a implementação concreta da rotina e a camada de gestão de pedidos de diagnóstico.

Neste conjunto, <RoutineInterface6>StartOutput assume o papel de disponibilizar agregadamente todos os dados de saída que uma aplicação gera ao executar o comando de arranque. Interpretação: a estrutura serve presumivelmente como puro objeto de transferência de dados (Data Transfer Object, DTO) sem lógica de negócio própria, cujos campos de membro específicos correspondem aos parâmetros de saída da rotina definidos no modelo de interface. Pergunta Q-99209f0267b43982 (aberta) Graças a este encapsulamento, garante-se que a gestão de diagnóstico chamadora possa receber os valores de retorno em bloco e prepará-los para processamento posterior ou para a resposta a testadores de diagnóstico externos.

Ciclo de vida

O ciclo de vida de <RoutineInterface6>StartOutput está intimamente ligado ao contexto de execução da operação de início da rotina de diagnóstico. Uma instância desta estrutura é instanciada pela implementação de rotina da aplicação em execução assim que é processado um pedido para iniciar a rotina. Durante o processamento, a aplicação preenche os atributos individuais da estrutura com os dados resultantes do procedimento de arranque.

Quanto às relações de propriedade, o controlo sobre o objeto reside inicialmente de forma local na rotina executora. Devendo a devolução ser efetuada à gestão de diagnóstico, isso acontece tipicamente por passagem por valor ou por semântica de movimento, por exemplo no contexto de estruturas de retorno assíncronas da plataforma. Pergunta (aberta) Após a aceitação pelo ambiente de execução da plataforma e o encaminhamento dos dados para a camada de protocolo de diagnóstico, o ciclo de vida do objeto termina, sendo a estrutura destruída e a memória ocupada libertada. Como a estrutura é concebida como um mero contentor de dados, não possui máquina de estados interna própria; as fases de vida limitam-se a criação, preenchimento, devolução e libertação.

Caminho de utilização

A sequência típica de utilização de <RoutineInterface6>StartOutput divide-se numa sucessão fixa de passos dentro do processamento da rotina:

• Inicialização: ao chegar um pedido de arranque, a aplicação fornecedora instancia uma instância de <RoutineInterface6>StartOutput na pilha ou dentro do contexto de execução competente.
• Preenchimento dos campos de dados: a aplicação efetua as verificações funcionais e as ações para iniciar a rotina. Os dados de saída aí determinados são atribuídos aos campos da estrutura.
• Resposta: a estrutura totalmente preenchida é devolvida ao sistema de diagnóstico como resultado de função. Presumivelmente, o retorno ocorre integrado num contentor tipificado, como ara::core::Result ou ara::core::Future, de modo a cumprir a convenção de interface assíncrona da Adaptive Platform. Pergunta Q-08976b247fab2180 (aberta)
• Processamento pela plataforma: a plataforma lê os valores contidos, converte-os no respetivo telegrama de resposta de diagnóstico e conclui o processo de processamento.

Para os programadores de aplicações de diagnóstico, a tarefa principal consiste em assegurar a atribuição correta e completa de todos os valores de saída necessários antes de sair do método.

Cenários de erro

Uma vez que <RoutineInterface6>StartOutput está definida como estrutura de dados para parâmetros de saída regulares, não encapsula por si própria códigos de erro ou tratamentos de exceções. Os cenários de erro surgem sobretudo quando a rotina não pode ser iniciada corretamente ou quando são gerados valores de saída inválidos.

Interpretação: se a execução da operação de início falhar, os erros de diagnóstico resultantes não deverão ser transportados através dos campos desta estrutura, mas sim através do modelo de erros da plataforma, por exemplo mediante códigos de erro padronizados em ara::core::ErrorCode. Pergunta Q-fe76c79ba073f321 (aberta) A pré-condição para a utilização bem-sucedida da estrutura é que a ação de início desencadeadora tenha sido permitida e que as condições exigidas para a execução da rotina estejam cumpridas. Como pós-condição, aplica-se que todos os parâmetros de saída da estrutura declarados na interface sejam deixados num estado válido e consistente antes de ocorrer a transferência para o sistema de diagnóstico.