clase ara::shwa::PropertyList

La clase final ara::shwa::PropertyList sirve para la agregación y transferencia de propiedades en el módulo shwa de AUTOSAR Adaptive. Su creación se realiza a través de un constructor de plantilla variádico, el cual está declarado como noexcept y, por tanto, es seguro frente a excepciones ([AP_SWS_SHWA_00802]). Interpretación: Es de esperar que las instancias se utilicen predominantemente como objetos de valor de corta duración para transferir atributos de configuración agrupados a interfaces de hardware. Pregunta Q-6303ee8ec36bf3e3 (abierta) Como restricción central, la clase no es segura para subprocesos (not thread-safe), motivo por el cual los accesos concurrentes desde múltiples hilos deben sincronizarse externamente ([AP_SWS_SHWA_00802]).

más ›

Contexto

La clase ara::shwa::PropertyList forma parte del módulo shwa (Smart Hardware Actuator) dentro de la AUTOSAR Adaptive Platform. La especificación define este tipo como clase final (class PropertyList final), lo que excluye de antemano la derivación por parte de clases de usuario. La función principal de la clase radica en la agrupación y transferencia estructurada de propiedades. A través de la plantilla de constructor [AP_SWS_SHWA_00802], la clase acepta una cantidad variable de objetos de propiedad. Interpretación: Es previsible que la clase sirva dentro del módulo como contenedor de agregación con seguridad de tipos, que compendia configuraciones heterogéneas o atributos de hardware para actuadores y sensores y los reenvía a las interfaces de procesamiento. Pregunta Q-70687f2df4a18776 (abierta)

En la interacción con otros componentes, la clase actúa como portadora de información. El llamador agrega propiedades específicas de la aplicación, mientras que el subsistema SHWA recibe estas listas para controlar operaciones próximas al hardware. Dado que la definición de la clase es final, PropertyList conforma una estructura de datos cerrada que impide una jerarquía de herencia directa y, por tanto, impone una semántica uniforme en la transferencia de parámetros.

Ciclo de vida

El ciclo de vida de una instancia de ara::shwa::PropertyList comienza con la inicialización directa a través del constructor variádico template <typename... Properties> PropertyList(Properties... props) conforme a [AP_SWS_SHWA_00802]. Mediante la declaración con noexcept, se garantiza que la creación de una instancia se desarrolle con total seguridad frente a excepciones, respetando la exception safety ([AP_SWS_SHWA_00802]). Si se producen errores durante la transferencia de parámetros o el procesamiento interno, esto conduce directamente a la interrupción del programa mediante std::terminate debido a la garantía noexcept, en caso de que las operaciones subyacentes lanzasen excepciones.

En cuanto al comportamiento frente a la concurrencia, la especificación establece que la clase no es segura para subprocesos (not thread-safe) ([AP_SWS_SHWA_00802]). Esto significa que las instancias no deben utilizarse simultáneamente desde varios hilos durante su creación ni en ninguna de las operaciones sucesivas sin mecanismos externos de sincronización. Interpretación: Las instancias de PropertyList típicamente se crearán como objetos de valor locales (Value Objects) en la pila o se transferirán a las funciones invocadas mediante semántica de movimiento (move semantics), materializando así relaciones de pertenencia locales al hilo sin estado compartido. Pregunta (abierta)

El fin del ciclo de vida sigue las reglas habituales para objetos de C++ automáticos o dinámicos. Dado que no se contemplan destructores virtuales ni herencia, todos los recursos contenidos se liberan de forma determinista al destruirse el objeto.

Ruta de uso

La ruta de uso habitual de ara::shwa::PropertyList abarca la recopilación de propiedades relevantes y la transferencia del objeto agregado al subsistema SHWA:

• Instanciación: El usuario crea un objeto de la clase transfiriendo las propiedades deseadas directamente al constructor variádico ([AP_SWS_SHWA_00802]). Mediante la plantilla es posible consolidar diferentes tipos de propiedades conforme a sus tipos en una única invocación.
• Transferencia: La instancia creada se transfiere a los métodos o interfaces de destino correspondientes del módulo shwa. Interpretación: Tras la construcción, el acceso a los valores agrupados se realiza presumiblemente de forma exclusivamente de lectura por parte de los componentes de procesamiento del subsistema de hardware. Pregunta Q-350de0ec77d53e28 (abierta)
• Saneamiento: Tras finalizar el procesamiento o al salir del ámbito de validez, la instancia se destruye automáticamente sin que se requieran pasos explícitos de desinicialización.

Escenarios de error

Dado que el constructor de ara::shwa::PropertyList está declarado explícitamente como noexcept, no se producen excepciones de C++ durante la invocación ([AP_SWS_SHWA_00802]). La seguridad frente a excepciones está designada expresamente en la especificación de requisitos como exception safe ([AP_SWS_SHWA_00802]). Por consiguiente, los usuarios no necesitan colocar bloques try-catch alrededor de la construcción de listas de propiedades.

Un escenario de fallo esencial reside en el incumplimiento de la seguridad para subprocesos. Dado que PropertyList está clasificada conforme a [AP_SWS_SHWA_00802] como not thread-safe, un acceso concurrente y no protegido de múltiples hilos de ejecución a la misma instancia da lugar a condiciones de carrera (race conditions) y comportamiento indefinido. Los desarrolladores deben asegurarse de que las instancias se utilicen exclusivamente de forma local al hilo o se protejan frente a accesos concurrentes mediante primitivas de sincronización adecuadas, tales como exclusiones mutuas (mutexes).