namespace ara::com::runtime

El espacio de nombres ara::com::runtime proporciona servicios centrales de tiempo de ejecución para la resolución de extremos de comunicación en la gestión de comunicación AUTOSAR_AP_SWS_CommunicationManagement p. 39. Su función central ResolveInstanceIDs traduce identificadores de modelo abstractos de tipo ara::core::InstanceSpecifier en ara::com::InstanceIdentifierContainer concretos y utilizables para proxies y skeletons [SWS_CM_00118]. Si falla la asignación en el despliegue de un identificador formalmente válido, la función segura contra excepciones devuelve el código de error ComErrc::kInstanceIDNotResolvable dentro de un ara::core::Result. Por lo tanto, los llamadores deben evaluar el objeto Result antes de la instanciación del servicio.

más ›

Contexto

El espacio de nombres ara::com::runtime proporciona funcionalidades centrales de tiempo de ejecución para la gestión de comunicación (ara::com) de AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_CommunicationManagement p. 39. Su responsabilidad funcional primaria consiste en desacoplar la arquitectura de software abstracta de la infraestructura de comunicación concreta en tiempo de ejecución. Mientras que las aplicaciones y los componentes de software están vinculados a puertos en sus interfaces mediante identificadores de modelo abstractos (ara::core::InstanceSpecifier), el middleware de comunicación necesita, para el establecimiento de conexiones, datos concretos de direccionamiento e instanciación en forma de objetos ara::com::InstanceIdentifier [SWS_CM_00118].

La función ResolveInstanceIDs declarada en el encabezado ara/com/runtime.h forma el puente entre estos dos niveles de abstracción [SWS_CM_00118]. Acepta un ara::core::InstanceSpecifier y lo transforma en un ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement p. 40. Interpretación: Es de suponer que la asignación concreta se base internamente en las configuraciones de manifiesto y de despliegue depositadas en el contexto de ejecución, con lo cual el código de aplicación permanece portable y libre de direcciones de red o de protocolo fijas. Pregunta Q-8fab6de1c39a065a (abierta)

Diagrama de contexto: clasificación de ara::com::runtime entre la arquitectura de la aplicación y el despliegue de comunicación. Fuentes: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 39.

Ruta de uso

El uso típico del espacio de nombres ara::com::runtime tiene lugar durante la fase de inicialización y arranque de una aplicación adaptativa, antes de que se establezcan relaciones de comunicación a través de service proxies o service skeletons AUTOSAR_AP_SWS_CommunicationManagement p. 41. Durante este proceso, un service consumer o provider recorre una ruta de resolución determinista:

• Determinar el especificador: la aplicación instancia o referencia el identificador de tipo ara::core::InstanceSpecifier definido para el respectivo puerto de comunicación.
• Resolver instancias: el identificador se transfiere a la función ara::com::runtime::ResolveInstanceIDs [SWS_CM_00118].
• Comprobar el resultado: la llamada devuelve un objeto del tipo ara::core::Result<ara::com::InstanceIdentifierContainer>, el cual se comprueba en cuanto a ejecución correcta o estados de error [SWS_CM_00118].
• Procesar el contenedor: en caso de éxito, el ara::com::InstanceIdentifierContainer contiene una cantidad de identificadores de instancia que es proporcional al número de coincidencias encontradas en el despliegue [SWS_CM_00118]. La aplicación puede seleccionar específicamente una instancia o iterar sobre todas las instancias disponibles.
• Instanciar proxy o skeleton: los objetos ara::com::InstanceIdentifier resueltos se utilizan a continuación para la creación de instancias concretas de proxy o skeleton AUTOSAR_AP_SWS_CommunicationManagement p. 42.

Diagrama de secuencia: flujo de llamada y procesamiento de la resolución de instancias a través de ResolveInstanceIDs. Fuentes: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 41.

Escenarios de error

Las interfaces en el espacio de nombres ara::com::runtime siguen el paradigma de gestión de errores robusta y libre de excepciones aplicado a toda la plataforma. De acuerdo con la especificación, ResolveInstanceIDs está declarada como noexcept y posee el nivel de seguridad frente a excepciones exception safe [SWS_CM_00118]. Por lo tanto, los errores nunca se señalan mediante excepciones de C++, sino que se transportan íntegramente a través de la mónada de error ara::core::Result AUTOSAR_AP_SWS_CommunicationManagement p. 47.

El escenario central de error especificado atañe al código de error ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. Este error ocurre cuando el ara::core::InstanceSpecifier transferido es formalmente válido, pero no puede asignarse a ningún ara::com::InstanceIdentifier existente en la configuración actual del sistema o en el manifiesto [SWS_CM_00118]. En la práctica, esto apunta a discrepancias entre el modelado y el despliegue, por ejemplo si un service provider no se ha desplegado en otra máquina o si falta el enlace en el manifiesto. Para este error rige la semántica de reversión (rollback_semantics): no se generan estados parciales ni se vinculan recursos, de modo que el llamador puede comprobar la configuración o pasar a un estado de error definido [SWS_CM_00118].