classe ara::diag::SovdOperationExecution

A interface serve ao controle e ao monitoramento específicos da aplicação de uma operação SOVD em andamento no Diagnostic Management [SWS_DM_02197]. Através de métodos protegidos, ela processa consultas de status, bem como requisições para a execução de capacidades especiais ou para o cancelamento da operação. Todos os retornos ocorrem de forma assíncrona via futures, sendo que erros devem obrigatoriamente ser transmitidos como códigos de erro SOVD padronizados segundo a ISO 17978-3 [SWS_DM_02384]. Além disso, as implementações devem ser seguras para threads e vincular estritamente handlers de cancelamento fornecidos ao ciclo de vida da operação.

mais ›

Contexto

A classe ara::diag::SovdOperationExecution define a interface de programação para controle e monitoramento de execuções de operações SOVD (Service-Oriented Vehicle Diagnostics) em andamento dentro do módulo diag da AUTOSAR Adaptive Platform [SWS_DM_02197], SWS Diagnostics §8.62.5 «Class: SovdOperationExecution». Ela funciona como elo de ligação entre o Diagnostic Management (DM) e a lógica de aplicação executora para rotinas relacionadas a diagnóstico segundo a ASAM SOVD e a ISO 17978-3.

Quando um cliente SOVD externo inicia a inicialização de uma operação [SWS_DM_01396] e a validação opcional do Proximity Challenge foi concluída com sucesso [SWS_DM_02174], o DM instancia ou vincula a execução a um identificador exclusivo (execution-id) [SWS_DM_02177]. Todas as chamadas de método subsequentes para esta operação em andamento – em particular consultas de status e comandos de cancelamento – são encaminhadas pelo DM àquela instância de ara::diag::SovdOperationExecution que está atribuída a este identificador [SWS_DM_02180].

Diagrama de contexto: integração de SovdOperationExecution entre cliente SOVD, Diagnostic Management e lógica de operação específica da aplicação. Fontes: [SWS_DM_01396], [SWS_DM_02180], [SWS_DM_02197].

Ciclo de vida

A classe possui um construtor padrão declarado como noexcept=default [SWS_DM_02198], bem como um destrutor virtual que também é definido como noexcept=default [SWS_DM_02199]. Como todos os métodos funcionais – ExecuteCapability [SWS_DM_02384], GetStatus [SWS_DM_02201] e Terminate [SWS_DM_02202] – são puramente virtuais (= 0) e protegidos (protected), a classe não é diretamente instanciável. Interpretação: desenvolvedores de aplicações derivam suas próprias classes a partir de SovdOperationExecution para implementar as rotinas específicas da aplicação. Pergunta Q-c1d622c7aa17382d (aberta)

Cada execução de operação ativa é atribuída no DM a um execution-id [SWS_DM_02177], [SWS_DM_02180]. A especificação ressalta que operações, em muitos casos, permitem apenas uma única instância simultânea SWS Diagnostics §7.3.3.5.5.6 «Operations – Terminate execution of an operation». Todos os métodos de interface são especificados como seguros para threads (thread-safe) e seguros quanto a exceções (exception safe) [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

No que diz respeito ao gerenciamento de memória e aos tempos de vida, aplicam-se regras estritas: o parâmetro sovd_content_data permanece válido até que a promise associada seja cumprida ou o processamento seja cancelado através do cancellation_handler [SWS_DM_02384]. O próprio objeto cancellation_handler não deve sob hipótese alguma ser armazenado ou chamado além do tempo de vida da respectiva operação [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Caminho de utilização

O fluxo típico para o acompanhamento de uma operação SOVD divide-se nas seguintes etapas:

• Requisitar capacidades: o DM pode requisitar para uma operação em andamento, através do método ExecuteCapability, ações como executar, congelar ou redefinir [SWS_DM_02384].
• Consultar status: se o DM receber a chamada SOVD «Read the Status of an operation» e a validação de proximidade requerida for bem-sucedida [SWS_DM_02173], ele chama GetStatus da instância de SovdOperationExecution atribuída [SWS_DM_02180], [SWS_DM_02201]. Após o retorno bem-sucedido, o DM responde ao cliente com os atributos status (de GetStatusResponse.status), capability (valor execute) e parameters (derivado de GetStatusResponse.Parameters) [SWS_DM_02181].
• Terminar operação: se o Diagnostic Server receber o método SOVD “Terminate execution of an Operation” [SWS_DM_01392], após a validação da resposta de proximidade [SWS_DM_01391], o método Terminate é chamado na instância informando o motivo (TerminateOperationExecutionReason) [SWS_DM_02179], [SWS_DM_02202].

Diagrama de sequência: sequência de interação entre Diagnostic Management e SovdOperationExecution em consultas de estado e terminação controlada. Fontes: [SWS_DM_02180], [SWS_DM_02181], [SWS_DM_02179], [SWS_DM_02202].

Cenários de erro

Todos os métodos a serem executados (ExecuteCapability, GetStatus, Terminate) operam de forma assíncrona e retornam um ara::core::Future [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202]. Se o processamento dentro da aplicação falhar, a future deve ser preenchida com um código de erro SOVD aplicável de acordo com a ISO 17978-3 ou ASAM SOVD 1.1 [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Se uma requisição em andamento for cancelada por parte do framework de diagnóstico, o DM sinaliza isso através do objeto fornecido ara::diag::CancellationHandler [SWS_DM_02384]. A implementação deve levar em consideração o estado de cancelamento deste handler e encerrar o processamento sem demora, a fim de evitar estados bloqueantes.