clase ara::diag::SovdOperationExecution

La interfaz sirve para el control y la monitorización específicos de la aplicación de una operación SOVD en curso en Diagnostic Management [SWS_DM_02197]. Mediante métodos protegidos procesa consultas de estado así como solicitudes para la ejecución de capacidades especiales o para la cancelación de la operación. Todos los retornos se realizan de forma asíncrona mediante futures, debiendo transmitirse los errores obligatoriamente como códigos de error SOVD estandarizados según ISO 17978-3 [SWS_DM_02384]. Además, las implementaciones deben ser seguras para hilos y vincular estrictamente los gestores de cancelación transferidos a la vida útil de la operación.

más ›

Contexto

La clase ara::diag::SovdOperationExecution define la interfaz de programación para el control y la monitorización de ejecuciones de operaciones SOVD (Service-Oriented Vehicle Diagnostics) en curso dentro del módulo diag de la AUTOSAR Adaptive Platform [SWS_DM_02197], SWS Diagnostics §8.62.5 «Class: SovdOperationExecution». Actúa como enlace entre Diagnostic Management (DM) y la lógica de aplicación ejecutora para rutinas relativas al diagnóstico según ASAM SOVD e ISO 17978-3.

Cuando un cliente SOVD externo inicia el arranque de una operación [SWS_DM_01396] y se ha superado con éxito la validación opcional del Proximity Challenge [SWS_DM_02174], el DM instanciada o vincula la ejecución a un identificador unívoco (execution-id) [SWS_DM_02177]. Todas las llamadas a métodos posteriores para esta operación en curso —en particular consultas de estado y comandos de cancelación— las reenvía el DM a aquella instancia de ara::diag::SovdOperationExecution que esté asignada a este identificador [SWS_DM_02180].

Diagrama de contexto: integración de SovdOperationExecution entre cliente SOVD, Diagnostic Management y lógica de operación específica de la aplicación. Fuentes: [SWS_DM_01396], [SWS_DM_02180], [SWS_DM_02197].

Ciclo de vida

La clase posee un constructor estándar declarado como noexcept=default [SWS_DM_02198] así como un destructor virtual definido igualmente como noexcept=default [SWS_DM_02199]. Dado que todos los métodos técnicos —ExecuteCapability [SWS_DM_02384], GetStatus [SWS_DM_02201] y Terminate [SWS_DM_02202]— son puramente virtuales (= 0) y protegidos (protected), la clase no es instanciable directamente. Interpretación: los desarrolladores de aplicaciones derivan clases propias de SovdOperationExecution para implementar las rutinas específicas de la aplicación. Pregunta Q-c1d622c7aa17382d (abierta)

Cada ejecución de operación activa se asigna en el DM a una execution-id [SWS_DM_02177], [SWS_DM_02180]. La especificación resalta que, en muchos casos, las operaciones solo permiten una única instancia concurrente SWS Diagnostics §7.3.3.5.5.6 «Operations – Terminate execution of an operation». Todos los métodos de interfaz están especificados como seguros para hilos (thread-safe) y seguros frente a excepciones (exception safe) [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Respecto a la gestión de memoria y los tiempos de vida se aplican requisitos estrictos: el parámetro sovd_content_data permanece válido hasta que se cumpla la promise asociada o se cancele el procesamiento mediante el cancellation_handler [SWS_DM_02384]. El propio objeto cancellation_handler no debe guardarse ni invocarse bajo ninguna circunstancia más allá de la vida útil de la operación respectiva [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Ruta de uso

El desarrollo típico para el acompañamiento de una operación SOVD se divide en los siguientes pasos:

• Solicitar capacidades: el DM puede solicitar para una operación en curso acciones como ejecutar, congelar o restablecer a través del método ExecuteCapability [SWS_DM_02384].
• Consultar estado: si el DM recibe la llamada SOVD «Read the Status of an operation» y la validación de proximidad requerida tiene éxito [SWS_DM_02173], llama a GetStatus de la instancia de SovdOperationExecution asignada [SWS_DM_02180], [SWS_DM_02201]. Tras un retorno exitoso, el DM responde al cliente con los atributos status (de GetStatusResponse.status), capability (valor execute) y parameters (derivado de GetStatusResponse.Parameters) [SWS_DM_02181].
• Terminar operación: si entra en el Diagnostic Server el método SOVD «Terminate execution of an Operation» [SWS_DM_01392], tras validar la respuesta de proximidad [SWS_DM_01391] se llama en la instancia al método Terminate indicando el motivo (TerminateOperationExecutionReason) [SWS_DM_02179], [SWS_DM_02202].

Diagrama de secuencia: secuencia de interacción entre Diagnostic Management y SovdOperationExecution en consultas de estado y terminación controlada. Fuentes: [SWS_DM_02180], [SWS_DM_02181], [SWS_DM_02179], [SWS_DM_02202].

Escenarios de error

Todos los métodos a ejecutar (ExecuteCapability, GetStatus, Terminate) funcionan de manera asíncrona y devuelven un ara::core::Future [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202]. Si el procesamiento dentro de la aplicación falla, el future debe cumplirse con un código de error SOVD aplicable según ISO 17978-3 o ASAM SOVD 1.1 [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Si el framework de diagnóstico cancela una solicitud en curso, el DM señala esto a través del objeto ara::diag::CancellationHandler proporcionado [SWS_DM_02384]. La implementación debe tener en cuenta el estado de cancelación de este gestor y finalizar de inmediato el procesamiento para evitar estados bloqueantes.