Service proxy fire-and-forget method class, one for each ClientServerOperation ( ClientServerOperation.fireAndForget==TRUE) defined in the ServiceInterface in the role method.
Permite a chamada não confirmada de métodos unidirecionais de uma interface de serviço sem valor de retorno ao nível do cliente.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: c09dd8b0ab24ProcedênciaPerguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Permite a chamada não confirmada de métodos unidirecionais de uma interface de serviço sem valor de retorno ao nível do cliente.
A classe proxy permite que a aplicação cliente dispare chamadas de método não confirmadas para operações de serviço com semântica fire-and-forget [SWS_CM_90435]. Ao chamar o operador de função, os parâmetros de entrada são transmitidos sem que um valor de retorno ou um future de resposta seja gerado para um resultado. Ao mesmo tempo, em cada chamada de método, a proteção ponta a ponta é executada, cujo estado de verificação atual pode ser consultado separadamente [SWS_CM_00147]. Uma chamada é segura quanto a exceções, mas falha com uma violação de autorização se os direitos de acesso forem insuficientes.
Contexto
A classe <SI-Namespace>::proxy::methods::<FnFMethod> representa um método fire-and-forget no lado do cliente ou do proxy no gerenciamento de comunicação da AUTOSAR Adaptive Platform [SWS_CM_90435]. Em uma arquitetura orientada a serviços, para cada operação definida na interface (ClientServerOperation) na qual ClientServerOperation.fireAndForget == TRUE está especificado, existe exatamente uma instância desse tipo na função de proxy [SWS_CM_90435], SWS CommunicationManagement §8.3.4.1.2.1 «operator()».
Sua responsabilidade principal reside no recebimento de argumentos de chamada e no seu encaminhamento para a camada de transmissão. Diferentemente das chamadas bidirecionais síncronas ou assíncronas, que notificam o chamador por meio de um ara::core::Future e transportam eventuais erros de aplicação [SWS_CM_00197], uma chamada fire-and-forget não exige resposta nem confirmação do lado do servidor. Os parceiros de interação incluem a aplicação cliente chamadora, a instância de método do proxy de serviço e o binding de comunicação subsequente, incluindo a proteção E2E.
Diagrama de contexto: componentes e relações de interface da classe de método proxy fire-and-forget. Fontes: [SWS_CM_90435], [SWS_CM_00147]
Ciclo de vida
A declaração da classe ocorre dentro do arquivo de cabeçalho gerado #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" no escopo hierárquico <SI-Namespace>::proxy::methods::<FnFMethod>[SWS_CM_90435]. O tempo de vida da instância de método deve estar vinculado ao tempo de vida do objeto de proxy de serviço superior (interpretação: o método é criado e destruído como um subobjeto juntamente com o proxy de serviço). Pergunta Q-9ee6da68f325c3d0 (aberta)
Além da chamada pura, a classe possui um estado interno referente à proteção E2E (End-to-End-Protection). Esse estado E2E é determinado a cada chamada de método por meio da função E2E_Check() e pode ser consultado via GetE2EStateMachineState(), que fornece o valor de status do tipo ara::com::e2e::SMState[SWS_CM_00147], SWS CommunicationManagement §8.3.4.1.1.1 «GetE2EStateMachineState». Todas as funções-membro são declaradas como noexcept[SWS_CM_00147], [SWS_CM_90435]; em caso de chamadas simultâneas a partir de múltiplas threads, uma sincronização externa provavelmente será necessária se o binding não garantir reentrância. Pergunta Q-e59aae09676d76c2 (aberta)
Caminho de utilização
O fluxo típico para uso de um método fire-and-forget inclui as seguintes etapas:
Disponibilização do proxy: a aplicação instancia ou obtém o proxy de serviço gerado por meio da interface de cabeçalho definida [SWS_CM_90435].
Executar a chamada de método: a aplicação chama o objeto de método por meio de operator() passando os parâmetros de entrada [SWS_CM_90435]. A função não fornece valor de retorno (void) e retorna imediatamente sem aguardar uma reação do servidor SWS CommunicationManagement §8.3.4.1.2.1 «operator()».
Atualização de E2E: durante a chamada de operator(), o middleware executa internamente a verificação de proteção E2E_Check() e atualiza a máquina de estados interna [SWS_CM_00147].
Diagrama de sequência: ordem típica de interação na chamada de um método fire-and-forget e posterior consulta de status. Fontes: [SWS_CM_90435], [SWS_CM_00147]
Cenários de erro
Tanto operator() quanto GetE2EStateMachineState() são seguros quanto a exceções (exception safe) e declarados como noexcept[SWS_CM_00147], [SWS_CM_90435]. Portanto, nenhuma exceção C++ é lançada.
Em caso de direitos de acesso ausentes, a imposição de permissões (Grant Enforcement) entra em ação: se faltarem as permissões necessárias ao contexto chamador, a chamada é recusada e um InsufficientPermissionsViolation é registrado [SWS_CM_90435].
Como não há retorno por meio de um ara::core::Future e as operações fire-and-forget não suportam a transmissão de um ApApplicationError ou ara::core::ErrorCode[SWS_CM_00197], os erros de transmissão não são reportados de volta ao chamador. Quaisquer falhas na segurança dos dados ou no canal de transmissão manifestam-se exclusivamente no estado da máquina de estados E2E, que pode ser diagnosticado por meio de GetE2EStateMachineState()[SWS_CM_00147].
Este guia é baseado na especificação AUTOSAR Adaptive Platform Release R25-11 e descreve o funcionamento da classe de métodos proxy fire-and-forget.
Diagrama de classes UML
Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.
Returns the state of the specific fnfmethod class, which was determined by the last run of E2E_Check() function invoked during the last call of operator()
Returns the state of the specific fnfmethod class, which was determined by the last run of E2E_Check() function invoked during the last call of operator()
gemini-3.8-flash-low· 2026-10-13 · Original em alemão