clase {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton

La clase sirve como clase base del lado del servidor para implementar una Service-Interface en ara::com, de la cual deriva la aplicación proveedora del servicio. Al crearla, se determina mediante el constructor si las llamadas a métodos entrantes se procesan controladas por eventos o por sondeo [SWS_CM_00130]. En los métodos declarados como seguros ante excepciones, las ejecuciones erróneas se señalan como código de error a través del ara::core::Future devuelto [SWS_CM_00191].

más ›

Contexto

La clase {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton sirve en la Adaptive Platform, dentro del módulo com, como clase base abstracta generada para la provisión del lado del servidor de una Service-Interface. Un componente proveedor de servicios específico de la aplicación deriva de esta clase skeleton para implementar la lógica de negocio funcional del servicio. La clase intermedia entre la aplicación proveedora de servicios concreta y el middleware de comunicación o el binding de protocolo subyacente, como SOME/IP (SWS CommunicationManagement §8.1 «Method invocation»). Entre los interlocutores de interacción se encuentran la aplicación proveedora del servicio, que crea y posee la instancia, la propia clase skeleton, así como la infraestructura de comunicación, que recibe las solicitudes de servicio entrantes, las deserializa y las reenvía al skeleton ([SWS_CM_10306], [SWS_CM_10307]).

Diagrama de contexto: interacción entre la aplicación proveedora del servicio, ServiceSkeleton y el middleware de comunicación. Fuentes: [SWS_CM_10306], [SWS_CM_10307], SWS CommunicationManagement §8.1 «Method invocation».

Ciclo de vida

La creación de la instancia del skeleton se realiza a través del constructor, al que se transfiere el modo de procesamiento deseado ara::com::MethodCallProcessingMode [SWS_CM_00130]. Este modo establece la estrategia de concurrencia para las llamadas a métodos entrantes: si se configura kEvent o kEventSingleThread, las llamadas a métodos entrantes son invocadas inmediatamente y controladas por eventos por el middleware de comunicación [SWS_CM_10306]. Si en su lugar se transfiere kPoll, el procesamiento se realiza mediante sondeo por parte de la aplicación [SWS_CM_10307]. Interpretación: es de suponer que la instancia del skeleton permanezca bajo la posesión de la aplicación proveedora del servicio durante toda la provisión activa del servicio y solo se destruya al apagar el servicio. Pregunta Q-ce25321f79393024 (abierta)

Ruta de uso

El flujo típico comprende la implementación de los métodos puramente virtuales por parte de la clase proveedora derivada y la posterior ejecución al recibir solicitudes entrantes. Para llamadas regulares a métodos (Request-Response), el skeleton define una interfaz que devuelve un ara::core::Future con el objeto de salida correspondiente [SWS_CM_00191], [SWS_CM_99556]. Para métodos Fire-and-Forget sin respuesta, el skeleton proporciona operaciones puramente virtuales con el tipo de retorno void [SWS_CM_90434]. Ante solicitudes entrantes, el middleware de comunicación deserializa los datos útiles y reenvía la llamada a la implementación concreta de la clase skeleton según el modo de procesamiento configurado ([SWS_CM_10306], [SWS_CM_00191]).

Diagrama de secuencia: flujo de una llamada a método a través del skeleton. Fuentes: [SWS_CM_00191], [SWS_CM_10306], SWS CommunicationManagement §8.1 «Method invocation».

Escenarios de error

Tanto los métodos Request-Response como los métodos Fire-and-Forget están anotados a nivel de interfaz con noexcept y declarados como seguros ante excepciones ([SWS_CM_00191], [SWS_CM_90434]). Los errores al procesar llamadas a métodos regulares no se transmiten mediante excepciones de C++; en su lugar, el ara::core::Future devuelto transporta en caso de error un código de error correspondiente del tipo ara::com::ComErrc o un ApApplicationError [SWS_CM_00191]. Para los métodos Fire-and-Forget, según la especificación no se prevén valores de retorno ni códigos de error estandarizados [SWS_CM_90434].