clase ara::diag::ReleaseHandler

La clase ara::diag::ReleaseHandler gestiona un estado compartido para determinar si un procesamiento de diagnóstico en curso puede cancelarse y si puede liberarse un recurso compartido [SWS_DM_01340]. Las aplicaciones pueden registrar una función de notificación mediante SetNotifier, así como consultar de forma síncrona mediante MayRelease si el recurso ya no está en uso [SWS_DM_01536]. Dado que la construcción por defecto y las operaciones de copia están prohibidas, la instancia se transfiere mediante semántica de movimiento, no siendo seguros para hilos ni las modificaciones ni la destrucción.

más ›

Contexto

En el módulo de diagnóstico de AUTOSAR Adaptive, la clase ara::diag::ReleaseHandler encapsula un estado compartido (Shared State) que indica si se debe cancelar un procesamiento en curso o si se debe liberar un recurso de uso compartido [SWS_DM_01340], AUTOSAR_AP_SWS_Diagnostics §8.23 «Header: ara/diag/release_handler.h». En la arquitectura de diagnóstico actúa como interfaz de sincronización y notificación entre el entorno de tiempo de ejecución de diagnóstico de AUTOSAR y los manejadores de diagnóstico específicos de la aplicación. Esto concierne en particular a procesamientos de mayor duración o con un uso intensivo de recursos, como los que se producen, por ejemplo, en el contexto de sesiones de transferencia de archivos y datos AUTOSAR_AP_SWS_Diagnostics §7.x «DataTransfer».

A través de ReleaseHandler, la aplicación tiene la posibilidad de recibir información sobre la finalización o cancelación de ciclos de procesamiento sin tener que recurrir a mecanismos bloqueantes. De este modo, la clase asume el rol de desacoplador entre el flujo interno del servidor de diagnóstico y las rutinas de procesamiento subyacentes de la aplicación.

Ciclo de vida

El ciclo de vida de una instancia de ReleaseHandler está sujeto a directrices semánticas estrictas. La clase prohíbe explícitamente una instanciación sin parámetros mediante el constructor por defecto [SWS_DM_01530], AUTOSAR_AP_SWS_Diagnostics §8.23.1.2.1.1 «Default Constructor». Puesto que no se especifica ningún otro constructor público, es de suponer que la creación real del objeto la realiza internamente el servidor de diagnóstico antes de transferir la instancia al manejador de servicio respectivo. Pregunta Q-05a2e8b6b7deca40 (abierta) Además, ReleaseHandler está diseñada como una clase exclusivamente de solo movimiento (Move-Only): tanto el constructor de copia [SWS_DM_01534] como el operador de asignación por copia [SWS_DM_01535] están eliminados.

La propiedad de la instancia solo puede transferirse mediante operaciones de movimiento. El constructor de movimiento está definido como seguro contra excepciones (noexcept) y explícitamente como seguro para hilos [SWS_DM_01532], AUTOSAR_AP_SWS_Diagnostics §8.23.1.2.1.2 «Move Constructor». Por el contrario, el operador de asignación por movimiento operator= también es seguro contra excepciones, pero no es seguro para hilos [SWS_DM_01533]. La destrucción se realiza a través del destructor ~ReleaseHandler() [SWS_DM_01531], AUTOSAR_AP_SWS_Diagnostics §8.23.1.2.1.4 «Destructor», el cual es seguro contra excepciones (noexcept), pero no debe invocarse de forma concurrente entre hilos.

Ruta de uso

La ruta típica de uso abarca el registro de una función de notificación, así como la comprobación síncrona o asíncrona del estado de liberación. Una aplicación registra una retrollamada mediante el método SetNotifier [SWS_DM_01537]. Como parámetro se pasa un invocable del tipo ReleaseHandlerSetNotifier, especificado como alias de tipo para std::function<void(void)> [SWS_DM_02079], AUTOSAR_AP_SWS_Diagnostics §8.23.1.1.1 «Type Alias: ReleaseHandlerSetNotifier». Una llamada repetida a SetNotifier sobrescribe por completo una función registrada previamente [SWS_DM_01537].

Tan pronto como el recurso compartido pueda liberarse o exista una cancelación, se activa el notificador registrado. Es de suponer que esta llamada se realice de forma asíncrona en el contexto de hilo del servidor de diagnóstico. Pregunta Q-d948326514d200a1 (abierta) En paralelo o en el marco del bucle de control regular, la aplicación puede comprobar mediante MayRelease() si el recurso compartido ya no está en uso [SWS_DM_01536]. El método devuelve true si el recurso puede liberarse y, en caso contrario, false [SWS_DM_01536].

Diagrama de secuencia: flujo para el registro de la notificación y la liberación de recursos compartidos. Fuentes: [SWS_DM_01536], [SWS_DM_01537], [SWS_DM_02079].

Escenarios de error

Todos los métodos de ReleaseHandler están anotados con noexcept y especificados como seguros contra excepciones; por consiguiente, no lanzan excepciones ni devuelven códigos de error ([SWS_DM_01531], [SWS_DM_01532], [SWS_DM_01533], [SWS_DM_01536], [SWS_DM_01537]). Por lo tanto, los escenarios de error se derivan principalmente de infracciones de precondiciones o de una sincronización insuficiente.

Una precondición fundamental al llamar a SetNotifier es que el objeto pasado debe contener un destino invocable (Callable) y su ejecución no debe lanzar excepciones [SWS_DM_01537]. Un objeto de función vacío o no válido constituye una infracción de precondición. En cuanto a la concurrencia, cabe señalar que SetNotifier, el operador de asignación por movimiento y el destructor están documentados como no seguros para hilos ([SWS_DM_01531], [SWS_DM_01533], [SWS_DM_01537]). Solo MayRelease() y el constructor de movimiento son explícitamente seguros para hilos ([SWS_DM_01532], [SWS_DM_01536]). Si los registros de notificador o las asignaciones se ejecutan de forma concurrente sin sincronización externa, esto provocará un comportamiento indefinido.