clase ara::diag::SovdSwUpdate

La función virtual pura DeleteUpdatePackage de la clase ara::diag::SovdSwUpdate es llamada conforme a [SWS_DM_01803] por la instancia del Diagnostic Server cuando debe ejecutarse el método SOVD «Delete Update Package from an SOVD Server» ([SWS_DM_01922]). Esta inicia la eliminación de un paquete de actualización en el lado del servidor.

La llamada se realiza de forma asíncrona y devuelve un ara::core::Future<void>, el cual indica la finalización correcta o proporciona un objeto de error [SWS_DM_01922]. La signatura requiere los siguientes parámetros de entrada:

• updatePackageId: designa como ara::core::String el ID unívoco del paquete de actualización a eliminar.
• metaInfo: transfiere como MetaInfo const& información de contexto adicional de la solicitud.
• cancellationHandler: transmite un objeto del tipo CancellationHandler que informa sobre si la conversación actual ha sido cancelada.

Si ocurre un error durante el procesamiento, el Future se rellena con un error de SOVD correspondiente. La especificación prescribe para ello el uso de códigos de error adecuados de ASAM SOVD 1.1 o ISO 17978-3 [SWS_DM_01922].

En relación con la concurrencia, el método está definido como condicionalmente seguro para subprocesos: si la implementación debe ser ejecutada como thread-safe o non-thread-safe se determina mediante el ConcurrencyType transferido en el constructor [SWS_DM_01922]. Además, la función está declarada como noexcept y segura frente a excepciones, por lo que no debe escapar ninguna excepción.

usar

El método virtual puro ExecuteUpdatePackage de la interfaz ara::diag::SovdSwUpdate sirve para ejecutar el método SOVD «Execute Installation of an Update» [SWS_DM_01920]. La declaración se encuentra en la cabecera ara/diag/sovd_sw_update.h AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 «ExecuteUpdatePackage». Como parámetros de entrada se transfieren el identificador del paquete de actualización (updatePackageId), así como los datos de la solicitud (metaInfo) [SWS_DM_01920]. Adicionalmente, el objeto cancellationHandler informa si la conversación en curso ha sido cancelada [SWS_DM_01920]. La llamada se realiza de forma asíncrona y devuelve un ara::core::Future<void>, el cual suministra un resultado positivo o notifica un error de SOVD [SWS_DM_01920].

Manejo de errores

La interfaz está especificada como noexcept y segura frente a excepciones («exception safe») [SWS_DM_01920]. En consecuencia, los errores durante la ejecución no deben lanzarse mediante excepciones de C++, sino que deben devolverse de forma asíncrona a través del ara::core::Future con códigos de error aplicables de ASAM SOVD 1.1 o ISO 17978-3 [SWS_DM_01920].

Concurrencia y condiciones de contorno

En cuanto a la seguridad para subprocesos existe un requisito condicional («conditional»): si la función debe implementarse de manera segura o no segura para subprocesos se determina mediante el parámetro ConcurrencyType que fue transferido al constructor [SWS_DM_01920]. La implementación debería tener que evaluar el cancellationHandler para finalizar de forma ordenada la instalación del paquete ante una cancelación de la conversación [SWS_DM_01920]. Pregunta Q-8fe6950e8f5a168c (abierta)

La función miembro ara::diag::SovdSwUpdate::Offer registra el manejador para actualizaciones de software de SOVD en el Diagnostic Management (DM) a fin de permitirle el reenvío de mensajes de solicitud entrantes al manejador [SWS_DM_01924]. La llamada se realiza de forma síncrona y sin parámetros a través de la cabecera ara/diag/sovd_sw_update.h y, conforme a noexcept, no desencadena excepciones de C++ [SWS_DM_01924].

El resultado de la operación se devuelve como ara::core::Result<void> [SWS_DM_01924]. Si el ofrecimiento del servicio falla, la función proporciona un error con semántica de reversión (rollback) [SWS_DM_01924]:

• DiagOfferErrc::kAlreadyOffered: el servicio ya se había ofrecido con éxito previamente para este manejador [SWS_DM_01924].
• DiagOfferErrc::kConfigurationMismatch: la configuración del monitor no coincide con la configuración DEXT [SWS_DM_01924].

En cuanto a la concurrencia, el método está especificado como exception safe, pero expresamente como no seguro para subprocesos (not thread-safe) [SWS_DM_01924]. Interpretación: ante accesos desde múltiples subprocesos, podría requerirse por tanto una sincronización externa por parte de la aplicación. Pregunta Q-4636ad27701d59df (abierta) El principio de provisión mediante Offer se corresponde con el esquema general para manejadores de diagnóstico como [SWS_DM_00557] o [SWS_DM_00735], en los cuales el DM solo puede reenviar solicitudes una vez que la interfaz correspondiente se ofrece activamente [SWS_DM_01525].

El método virtual puro PrepareUpdatePackage de la interfaz ara::diag::SovdSwUpdate sirve para preparar la instalación de un paquete de actualización de software en el marco del método SOVD «Prepare Installation of an Update» según [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 «PrepareUpdatePackage»).

Invocación y parámetros

La función se proporciona a través de la cabecera ara/diag/sovd_sw_update.h y recibe los siguientes parámetros:

• updatePackageId: identificador (ara::core::String) del paquete de actualización a preparar.
• metaInfo: metadatos (MetaInfo const&) relativos a la solicitud SOVD entrante.
• cancellationHandler: objeto de monitorización (CancellationHandler) que informa sobre la cancelación de la conversación actual.

La llamada está especificada como noexcept y se comporta de manera exception-safe. El resultado asíncrono se proporciona mediante un ara::core::Future<void>, el cual señaliza la finalización correcta o suministra un error [SWS_DM_01919].

Tratamiento de errores y concurrencia

Si se produce un error durante la preparación, debe devolverse en el Future un código de error adecuado conforme a ASAM SOVD 1.1 o ISO 17978-3 [SWS_DM_01919]. En cuanto a la seguridad para subprocesos, rige un requisito condicional (conditional): si la función debe implementarse de forma segura para subprocesos se determina mediante el ConcurrencyType especificado en el constructor durante la instanciación [SWS_DM_01919]. A través del objeto cancellationHandler, la aplicación debería poder cancelar pasos de preparación prolongados en caso de que la solicitud se finalice prematuramente. Pregunta Q-be4c53d9a0427ed5 (abierta)

usar

El método puramente virtual PutUpdatePackageAutomated se llama en el contexto del método SOVD «Automated Installation of an Update» [SWS_DM_01918]. Está declarado en el encabezado ara/diag/sovd_sw_update.h dentro de la clase ara::diag::SovdSwUpdate AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated». La función sirve para instalar de manera automatizada un paquete de actualización especificado mediante su identificador.

La interfaz espera los siguientes parámetros de entrada:

• updatePackageId (ara::core::String): identificador del paquete de actualización que se debe transferir a la instalación automatizada [SWS_DM_01918].
• metaInfo (MetaInfo const &): metainformación de la solicitud de servicio entrante [SWS_DM_01918].
• cancellationHandler (CancellationHandler): informa a la operación sobre si la conversación en curso ha sido cancelada [SWS_DM_01918].

La llamada posee una semántica asíncrona. Como valor de retorno sirve un ara::core::Future<void> que, tras finalizar, indica la ejecución correcta o contiene un estado de error [SWS_DM_01918].

Tratamiento de errores y concurrencia

En caso de error, debe devolverse a través del Future un código de error aplicable de ASAM SOVD 1.1 o ISO 17978-3 [SWS_DM_01918]. El método está especificado como seguro frente a excepciones (exception safe) y, al ser una función noexcept, no lanza excepciones de C++ AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated».

La seguridad para subprocesos del método es condicional (conditional): si la implementación debe ejecutarse de forma thread-safe o non-thread-safe se determina mediante el ConcurrencyType transferido en la llamada al constructor [SWS_DM_01918].

La función virtual pura RequestUpdatePackageRegistration de la clase ara::diag::SovdSwUpdate atiende el método SOVD «Register an Update at the SOVD Server» [SWS_DM_01923]. Inicia el registro de un paquete de actualización en el servidor e inicializa la correspondiente sesión de transferencia AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 «RequestUpdatePackageRegistration».

La llamada se realiza de forma asíncrona y devuelve un ara::core::Future que, en caso de éxito, contiene una tupla formada por un DataTransferWriteSession y un ara::core::String con el ID del paquete de actualización [SWS_DM_01923]. En la llamada se transfieren los siguientes parámetros:

• metaInfo: metainformación de la solicitud entrante.
• expectedSize: tamaño total esperado opcional del paquete (ara::core::Optional<uint64_t>), siempre que se haya declarado en la solicitud.
• cancellationHandler: señaliza si la conversación actual se cancela.

El método está definido como noexcept y es seguro frente a excepciones [SWS_DM_01923]. En consecuencia, los errores no se notifican mediante excepciones de C++, sino que se proporcionan de forma asíncrona a través del Future; para ello deben emplearse los correspondientes códigos de error de ASAM SOVD 1.1 o ISO 17978-3 [SWS_DM_01923].

La seguridad para subprocesos es condicional («conditional»): si el método debe implementarse de forma segura para subprocesos se determina mediante el ConcurrencyType especificado en el constructor [SWS_DM_01923]. Por tanto, la implementación concreta podría requerir mecanismos de sincronización propios según la instanciación. Pregunta Q-7e80e557bdd7627a (abierta)

usar

El método ara::diag::SovdSwUpdate::StopOffer finaliza el ofrecimiento del servicio y desactiva el reenvío de mensajes de solicitud entrantes desde el Diagnostic Management (DM) al componente de actualización de software [SWS_DM_01925]. La llamada se realiza a través de la interfaz de ara/diag/sovd_sw_update.h, carece de parámetros y no devuelve ningún valor [SWS_DM_01925]. La finalización de la provisión del servicio se realiza de forma síncrona y corresponde a la desactivación conceptual de funcionalidades de diagnóstico en AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Tratamiento de errores y concurrencia

La función cuenta con la especificación noexcept y, por tanto, es segura frente a excepciones; no están previstos estados de error mediante excepciones o códigos de error [SWS_DM_01925]. Para el contexto de llamada rige que la función está definida como no segura para subprocesos («not thread-safe») [SWS_DM_01925]. Las llamadas paralelas sobre la misma instancia deben sincronizarse por parte de la aplicación. Interpretación: una llamada repetida a StopOffer en estado ya inactivo no debería surtir efecto de error, ya que no existe tratamiento de errores. Pregunta Q-efaccde5507eb444 (abierta)

Interacción

En el sistema global, la función se integra en el esquema uniforme del ciclo de vida de los servicios del DM. Constituye el equivalente funcional al ofrecimiento del servicio y se comporta de forma análoga a las operaciones de desactivación de otros servicios de diagnóstico como ara::diag::DownloadService [SWS_DM_00793], ara::diag::GenericUDSService [SWS_DM_00620] y ara::diag::EcuResetRequest [SWS_DM_01017].