clase ara::phm::SupervisedEntity

La clase plantilla ara::phm::SupervisedEntity sirve para la supervisión de funciones en Platform Health Management y permite a las aplicaciones notificar Checkpoints definidos [SWS_PHM_01127]. La instancia está ligada a un InstanceSpecifier, es móvil, pero no copiable [SWS_PHM_01123], [SWS_PHM_01212]. Mientras que ReportCheckpoint() es seguro para hilos, la activación asíncrona mediante Enable(), la desactivación mediante Disable() y el destructor no son seguros para hilos [SWS_PHM_01130], [SWS_PHM_01211].

más ›

Contexto

La clase plantilla ara::phm::SupervisedEntity representa una unidad funcional que debe supervisarse en Platform Health Management (PHM) de AUTOSAR Adaptive [SWS_PHM_01123]. Sirve a una aplicación como interfaz para notificar al PHM la consecución de puntos de control definidos (Checkpoints) [SWS_PHM_01127]. En función de los Checkpoints notificados, el subsistema PHM supervisa el comportamiento temporal y lógico de la entidad. La asignación a la arquitectura y a los elementos de modelado correspondientes se realiza a través de un ara::core::InstanceSpecifier, que hace referencia a un puerto correspondiente [SWS_PHM_01123]. Además, la clase permite a la aplicación activar o desactivar puntualmente la supervisión en caso necesario [SWS_PHM_01130], [SWS_PHM_01380].

Ciclo de vida

Un objeto de tipo ara::phm::SupervisedEntity se instancia explícitamente indicando un ara::core::InstanceSpecifier [SWS_PHM_01123]. La clase implementa una semántica de movimiento: el constructor de movimiento [SWS_PHM_01214], así como el operador de asignación por movimiento [SWS_PHM_01215], transfieren el recurso y están especificados como seguros para hilos y seguros frente a excepciones. El constructor de copia [SWS_PHM_01212] y el operador de asignación por copia [SWS_PHM_01213] están eliminados (delete), de modo que las instancias permanecen vinculadas a su propietario. El destructor ~SupervisedEntity() libera la entidad y está declarado como no seguro para hilos [SWS_PHM_01211]; por lo tanto, la destrucción debe realizarse de forma sincronizada si intervienen varios hilos.

Tras la creación, la supervisión se puede activar mediante Enable() [SWS_PHM_01130] o bien suspender mediante Disable() [SWS_PHM_01380]. Ambas funciones de control devuelven un ara::core::Future<void> y no son seguras para hilos, mientras que la notificación regular de Checkpoints a través de ReportCheckpoint() se puede ejecutar de forma segura para hilos [SWS_PHM_01127].

Ruta de uso

La interacción típica se divide en la inicialización, la activación opcional de la supervisión, la notificación cíclica o basada en eventos de Checkpoints, así como la liberación de la instancia. El siguiente diagrama de secuencias ilustra esta secuencia:

Diagrama de secuencias: Flujo típico de instanciación, activación, notificación de Checkpoint y desactivación de una SupervisedEntity. Fuentes: [SWS_PHM_01123], [SWS_PHM_01130], [SWS_PHM_01127], [SWS_PHM_01380], [SWS_PHM_01211]

En primer lugar, la aplicación instancia el objeto con el InstanceSpecifier configurado [SWS_PHM_01123]. En caso de que se deba activar la supervisión (en función del estado del grupo de funciones), la aplicación llama a Enable() y, en caso necesario, se sincroniza a través del ara::core::Future<void> devuelto [SWS_PHM_01130]. Durante la ejecución, la aplicación notifica los puntos de control alcanzados mediante ReportCheckpoint(checkpointId) [SWS_PHM_01127]. Antes de finalizar o en caso de cambios de estado funcional, la supervisión se puede suspender mediante Disable() [SWS_PHM_01380], antes de que la instancia sea finalmente destruida [SWS_PHM_01211].

Escenarios de error

Las condiciones de error se señalizan en ara::phm::SupervisedEntity principalmente mediante códigos de error asíncronos en valores de retorno, así como mediante infracciones del sistema (Violations) notificadas:

• Error de tiempo de ejecución en el control de estado: Si un llamador intenta llamar a Enable() [SWS_PHM_01130] o Disable() [SWS_PHM_01380] mientras ya se está ejecutando una solicitud de activación o desactivación, la llamada falla. En este caso, el ara::core::Future resultante notifica el código de error PhmErrc::kServiceNotReady (semántica de reversión o rollback).
• Infracciones de construcción: Al llamar al constructor [SWS_PHM_01123] se comprueban estrictas precondiciones:
  • AraNotInitializedViolation: El entorno de ejecución ARA aún no está inicializado.
  • InstanceSpecifierMappingIntegrityViolation: el identificador no se puede resolver en el contexto del ejecutable o no hace referencia a un PortPrototype.
  • PortInterfaceMappingViolation: Ningún SupervisionCheckpoint hace referencia al PortPrototype tipificado con PhmSupervisedEntityInterface.
  • ProcessMappingViolation: El proceso llamador no está autorizado en el modelo para los puntos de control correspondientes.
  • InstanceSpecifierAlreadyInUseViolation: el identificador ya está siendo utilizado en el mismo proceso por otra instancia.
• Infracción en la notificación de Checkpoint: Si ReportCheckpoint() es llamado por un proceso que no está asignado en el modelo mediante SupervisionCheckpoint.process, esto da lugar a una InsufficientPermissionsViolation [SWS_PHM_01127].