clase ara::com::ServiceVersionType

La clase ara::com::ServiceVersionType sirve para la representación y gestión estandarizadas de versiones de servicio en AUTOSAR Adaptive Platform ([SWS_CM_11515]). Las aplicaciones utilizan las instancias para la comprobación de compatibilidad mediante comparaciones de igualdad y de orden, para el almacenamiento en contenedores y para el registro mediante ToString() ([SWS_CM_11519]). El proveedor de Communication Management puede sobrescribir el tipo exacto, pero este debe cumplir los requisitos elementales de comparación y asignación de C++. Al utilizarla, debe tenerse en cuenta que todas las funciones miembro de la clase están clasificadas según la especificación como no seguras frente a excepciones.

más ›

Contexto

La clase ara::com::ServiceVersionType define en la cabecera ara/com/service/service_version.h (AUTOSAR_AP_SWS_CommunicationManagement §8.11 «Header: ara/com/service/service_version.h») la versión de un servicio de comunicación ([SWS_CM_11515]). Su responsabilidad principal consiste en hacer que las versiones de servicio sean manejables para el software de aplicación, de modo que este pueda almacenar, gestionar, comparar y registrar información de versiones ([SWS_CM_11515]).

Una particularidad arquitectónica reside en la flexibilidad de la plataforma: según [SWS_CM_11515], el proveedor de software de Communication Management puede sobrescribir o ampliar el tipo de datos concreto. Para garantizar, no obstante, un manejo coherente en aplicaciones portables, la especificación exige que el tipo satisfaga como mínimo los conceptos estándar de C++ [equalitycomparable] ([SWS_CM_11516]), [lessthancomparable] ([SWS_CM_11517]) y [copyassignable] ([SWS_CM_11518]) conforme a ISO/IEC 14882:2014.

Entre los interlocutores se cuentan, además del proveedor de software de Communication Management, las interfaces de servicio que proporcionan versiones como la constante estática serviceVersion (AUTOSAR_AP_SWS_CommunicationManagement p. 320), así como el software de aplicación que realiza cotejos de versiones.

Diagrama de contexto: integración de ara::com::ServiceVersionType entre el proveedor de software, la interfaz de servicio y la aplicación. Fuentes: [SWS_CM_11515], AUTOSAR_AP_SWS_CommunicationManagement p. 320, AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 «Class: ServiceVersionType».

Ciclo de vida

Las instancias de ara::com::ServiceVersionType están diseñadas como tipos de valor regulares (Value Types). La creación y la adopción de valores se efectúan mediante copia y asignación: a través del operador de asignación operator= se satisface el requisito [copyassignable] ([SWS_CM_11518]), permitiendo a las instancias adoptar nuevos valores.

En cuanto a las relaciones de pertenencia, ara::com::ServiceVersionType está sujeto al ámbito de visibilidad del llamador respectivo o se mantiene como constante de una definición de servicio (AUTOSAR_AP_SWS_CommunicationManagement p. 320). El tipo no posee una máquina de estados interna compleja, sino que encapsula un valor de versión discreto. Su destrucción se produce automáticamente al salir del ámbito de visibilidad.

Con respecto a la concurrencia, las operaciones de lectura operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) y ToString ([SWS_CM_11519]) están declaradas como const. Interpretación: los accesos concurrentes de lectura a la misma instancia desde múltiples hilos deberían ser seguros sin sincronización, mientras que las operaciones paralelas de escritura y asignación deben protegerse externamente. Pregunta Q-9582ce9a82b9b833 (abierta)

Ruta de uso

El flujo típico para el uso de ara::com::ServiceVersionType en una aplicación se divide en los siguientes pasos:

1. Consulta de versión: la aplicación accede a la información de versión de un servicio, por ejemplo a través de la constante estática serviceVersion de una interfaz (AUTOSAR_AP_SWS_CommunicationManagement p. 320).
2. Comprobación de compatibilidad: la aplicación compara la versión con una versión esperada mediante operator== ([SWS_CM_11516]). Para comprobaciones de orden o para el almacenamiento en contenedores estándar ordenados se utiliza operator< ([SWS_CM_11517]).
3. Gestión y almacenamiento: para transferir o almacenar localmente estados de versión, la aplicación utiliza el operador de asignación operator= ([SWS_CM_11518]).
4. Registro: para mensajes de diagnóstico o salidas de registro (log), la aplicación genera mediante el método ToString() una representación textual como ara::core::StringView ([SWS_CM_11519], AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 «ToString»).

Escenarios de error

Al utilizar la interfaz deben tenerse en cuenta condiciones de contorno específicas:

• Seguridad frente a excepciones: todas las funciones especificadas —operator= ([SWS_CM_11518]), operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) y ToString ([SWS_CM_11519])— están declaradas explícitamente en la especificación como not exception safe. En caso de error (por ejemplo, en asignaciones de memoria en implementaciones específicas del proveedor), las aplicaciones no deben confiar en garantías de recuperación automática.
• Validez del StringView: el método ToString() devuelve un ara::core::StringView ([SWS_CM_11519]). Interpretación: dado que un StringView no gestiona memoria propia, el tiempo de vida de la cadena referenciada debería estar ligado a la instancia subyacente o a memoria estática; un uso más allá de la validez de la fuente de datos provoca un comportamiento indefinido. Pregunta Q-fdb6e821db46af00 (abierta)