clase ara::diag::SovdConfiguration

usar

El método Offer de la clase ara::diag::SovdConfiguration sirve para activar el reenvío de solicitudes de diagnóstico por parte de Diagnostic Management (DM) al manejador configurado [SWS_DM_01872]. La llamada se realiza de forma síncrona, no recibe parámetros y notifica el resultado a través de ara::core::Result<void> [SWS_DM_01872]. Mientras un manejador no haya sido proporcionado mediante Offer, el DM no reenvía ninguna solicitud entrante, lo que corresponde al patrón de provisión fundamental de las interfaces de diagnóstico (cf. [SWS_DM_01525], [SWS_DM_00809]).

Manejo de errores

En caso de error, se devuelve un ara::core::Result con un código de error de la enumeración DiagOfferErrc, aplicándose una semántica de reversión [SWS_DM_01872]:

• DiagOfferErrc::kAlreadyOffered: se notifica si el servicio ya se había ofrecido previamente [SWS_DM_01872].
• DiagOfferErrc::kConfigurationMismatch: ocurre cuando la configuración no coincide con los datos de descripción DEXT [SWS_DM_01872].

Concurrencia y restricciones

La operación está declarada como noexcept y es segura frente a excepciones (exception safe), pero está especificada como no segura para hilos (not thread-safe) [SWS_DM_01872]. Las llamadas simultáneas a la misma instancia desde varios hilos deben ser evitadas por la aplicación invocadora. Una nueva llamada tras un ofrecimiento ya realizado probablemente sea confirmada con un error sin cambio de estado. Pregunta Q-f9b1a995dbb002ef (abierta)

usar

El método virtual puro RequestGetConfiguration de la clase ara::diag::SovdConfiguration es invocado por la Diagnostic Server Instance cuando se ejecuta el método SOVD «Read Configuration» para una configuración SOVD modelada explícitamente ([SWS_DM_01787], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 «Configuration – Explicit Configurations»). Como parámetros se transfieren el ID de configuración de la instancia que se va a leer (configurationId), la metainformación de la solicitud (metaInfo), así como un cancellationHandler que informa sobre una eventual cancelación de la conversación en curso ([SWS_DM_01870]).

La función trabaja de forma asíncrona y devuelve un ara::core::Future que proporciona una tupla compuesta por una sesión de lectura de archivos (DataTransferReadSession) y la metainformación de configuración asociada (SovdConfigurationMetaInfo) ([SWS_DM_01870]). La interfaz está declarada como noexcept y especificada como segura frente a excepciones ([SWS_DM_01870]).

Tratamiento de errores y concurrencia

Si se produce un error durante el procesamiento, no se lanza ningún error de C++, sino que a través del Future se devuelve un código de error SOVD adecuado conforme a ISO 17978-3 o ASAM SOVD 1.1 ([SWS_DM_01870]).

En cuanto a la seguridad para hilos, rige la directriz «conditional»: el ConcurrencyType transferido al constructor determina si la implementación concreta de la función debe diseñarse como segura para hilos o no segura para hilos ([SWS_DM_01870]).

El método de API ara::diag::SovdConfiguration::RequestPutConfiguration es invocado por el Diagnostic Server cuando se debe ejecutar el método «Write Configuration» a través de la interfaz SOVD para una configuración modelada explícitamente [SWS_DM_01788], [SWS_DM_01871].

Invocación y parámetros

La declaración se encuentra en el encabezado ara/diag/sovd_configuration.h. La llamada transfiere los siguientes parámetros de entrada [SWS_DM_01871]:

• configurationId: ID de la instancia de configuración que se va a escribir como ara::core::String.
• metaInfo: metainformación sobre la solicitud entrante (MetaInfo const &).
• cancellationHandler: supervisa el proceso actual y señaliza en caso de que la comunicación haya sido cancelada.

El método posee una semántica asíncrona y devuelve un ara::core::Future que, en caso de éxito, pone a disposición una tupla formada por una sesión de escritura (DataTransferWriteSession) y los metadatos correspondientes (SovdConfigurationMetaInfo) [SWS_DM_01871].

Tratamiento de errores y concurrencia

En caso de error, el Future se resuelve con un código de error SOVD adecuado conforme a ISO 17978-3 o ASAM SOVD 1.1 [SWS_DM_01871]. La función está declarada como noexcept y es segura frente a excepciones (exception safe). La seguridad para hilos es condicional (conditional): el ConcurrencyType especificado en el constructor determina si la implementación concreta debe diseñarse como segura para hilos [SWS_DM_01871].

Interacción

La función constituye la contraparte de escritura de RequestGetConfiguration, la cual se utiliza para el método SOVD «Read Configuration» [SWS_DM_01787] (AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 «Configuration – Explicit Configurations»).

El método StopOffer() de la clase ara::diag::SovdConfiguration sirve para desactivar el reenvío de solicitudes (Request Messages) por parte del demonio del Diagnostic Management (DM) a la instancia de servicio [SWS_DM_01930]. Constituye la contrapartida del ofrecimiento del servicio y sigue el patrón uniforme de ciclo de vida de las interfaces de diagnóstico en AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Uso y signatura: la llamada se realiza sin parámetros y de forma síncrona a través de la cabecera ara/diag/sovd_configuration.h [SWS_DM_01930]. Dado que el método no devuelve ningún valor (void) y está declarado como noexcept, se considera seguro frente a excepciones (exception safe) [SWS_DM_01930]. No se transmiten ni códigos de error ni excepciones a quien realiza la llamada.

Concurrencia y restricciones: la función está especificada explícitamente como no segura para subprocesos (not thread-safe) [SWS_DM_01930]. Si se utilizan instancias de ara::diag::SovdConfiguration en entornos multihilo, los accesos simultáneos o los cambios del estado de provisión deben ser sincronizados por la Adaptive Application.

Interacción: el comportamiento corresponde a la semántica de desactivación de otros servicios del DM como ara::diag::CommunicationControl [SWS_DM_00810] o ara::diag::GenericRoutine [SWS_DM_00558]. Interpretación: tras la llamada a StopOffer(), las solicitudes de diagnóstico recibidas por el DM deberían descartarse o responderse negativamente hasta que la configuración vuelva a activarse mediante el correspondiente método de ofrecimiento. Pregunta Q-4c6212980015c119 (abierta)