namespace <SI-Namespace>::proxy::methods

O namespace <SI-Namespace>::proxy::methods disponibiliza as classes do lado do proxy para chamadas de método de um ServiceInterface no módulo com da AUTOSAR Adaptive Platform. Para cada ClientServerOperation, dependendo do atributo de metamodelo ClientServerOperation.fireAndForget, instancia-se a classe <Method> para chamadas regulares ou <FnFMethod> para chamadas unidirecionais. Enquanto métodos regulares suportam valores de retorno e mensagens de erro do lado do servidor, métodos fire-and-forget, por princípio, não processam mensagens de resposta. O tempo de vida dos objetos de método está diretamente vinculado à existência da instância de proxy superior. Pergunta (aberta)

mais ›

Contexto

O namespace <SI-Namespace>::proxy::methods mapeia, dentro do módulo com da AUTOSAR Adaptive Platform, as classes de interface específicas de métodos para proxies de serviço. Cada ClientServerOperation modelado em um ServiceInterface é mapeado, conforme suas propriedades de configuração, em uma classe de método correspondente. O namespace contém essencialmente dois padrões de classe: <Method> para operações com comportamento de resposta e <FnFMethod> para as chamadas operações fire-and-forget.

A responsabilidade primária dessas classes consiste em receber chamadas de método de uma aplicação cliente, preparar os parâmetros de passagem para o transporte e processar a comunicação com a camada de middleware subjacente. Os parceiros de interação são, no lado chamador, os componentes de cliente específicos da aplicação e, no lado de mediação, a classe proxy superior do namespace <SI-Namespace>::proxy, que agrega as instâncias de método.

A diferenciação das duas classes orienta-se pelo atributo de metamodelo ClientServerOperation.fireAndForget:

• <Method> é gerada para operações nas quais ClientServerOperation.fireAndForget == FALSE está configurado. Provavelmente, uma instância dessa classe encapsula a chamada assíncrona de um serviço e disponibiliza o resultado ou eventuais erros de aplicação por meio de um tipo de resultado futuro. Pergunta Q-75c8a4495ee9c1cb (aberta)
• <FnFMethod> é gerada quando ClientServerOperation.fireAndForget == TRUE está configurado. Um método dessa classe é provavelmente implementado como uma chamada unidirecional, que não espera nenhuma resposta do servidor e não fornece nenhum valor de retorno ao chamador. Pergunta Q-1f9698a27137b73d (aberta)

Ciclo de vida

A criação e destruição das classes de métodos definidas neste namespace estão estreitamente vinculadas ao proxy superior. O tempo de vida dos objetos de método deve estar vinculado ao tempo de vida da instância de proxy envolvente no namespace <SI-Namespace>::proxy. Pergunta Q-ec1ef4d1ebc90d5a (aberta) Na instanciação do objeto proxy, as instâncias associadas de <Method> e <FnFMethod> são inicializadas como membros e ficam imediatamente disponíveis para chamadas pela aplicação.

Em relação ao estado interno, os objetos de método mantêm uma prontidão permanente para chamadas após sua inicialização, desde que a instância de proxy permaneça válida. Transições de estado de chamadas individuais não afetam a instância de método em si, mas sim os contextos individuais de chamada. Em acessos concorrentes a partir de múltiplas threads da aplicação cliente, deve-se garantir que chamadas paralelas à mesma instância de método possam ser iniciadas de modo thread-safe. A destruição ocorre implicitamente ao sair do escopo de validade ou mediante a destruição explícita da instância de proxy, limpando-se os recursos de comunicação em aberto.

Caminho de utilização

O fluxo típico na utilização das classes de métodos por uma aplicação cliente segue uma sequência predefinida:

1. Disponibilização do proxy: a aplicação cria ou obtém uma instância inicializada do proxy de serviço a partir do namespace <SI-Namespace>::proxy.
2. Acesso ao método: A chamada da operação pretendida é efetuada através dos membros de método da instância do proxy que instanciam as classes <Method> ou <FnFMethod>.
3. Execução de uma operação regular: Ao chamar uma instância de <Method>, o cliente transmite os parâmetros de entrada necessários. A chamada aciona a transmissão para o sistema de destino. O objeto de retorno permite que a aplicação aguarde a chegada do resultado ou continue a processar de forma assíncrona.
4. Execução de uma operação fire-and-forget: Ao chamar uma instância de <FnFMethod>, os parâmetros são passados e transmitidos de imediato para reencaminhamento para a camada de transmissão. O método retorna ao chamador imediatamente após a transmissão.
5. Processamento do resultado: Nas chamadas de métodos regulares, o cliente avalia o resultado disponibilizado e verifica se a operação foi concluída com sucesso.

Cenários de erro

O tratamento de erros difere fundamentalmente entre os dois tipos de métodos: Em operações regulares através de <Method>, podem ocorrer tanto erros da camada de transmissão como erros específicos da aplicação que se encontrem definidos na interface. Uma vez que ClientServerOperation.fireAndForget == FALSE está configurado, as mensagens de resposta, incluindo potenciais mensagens de erro, são devolvidas do servidor para o proxy. A aplicação cliente pode avaliar estes erros através do objeto de retorno da chamada e iniciar rotinas de tratamento adequadas.

Pelo contrário, o design de <FnFMethod> exclui inerentemente, por via de ClientServerOperation.fireAndForget == TRUE, o retorno de erros do lado do servidor para o chamador. Erros que ocorram no servidor durante o processamento da operação não podem ser transmitidos para o proxy. As pré-condições e pós-condições limitam-se ao lado de chamada local: as pré-condições exigem valores de parâmetros válidos e uma infraestrutura de comunicação operacional. Se ocorrer um erro local aquando do envio, este pode ser sinalizado imediatamente na chamada do método, enquanto os erros de execução do lado do servidor passam despercebidos pelo chamador.