clase ara::diag::SovdBulkData

usar

Se llama a la función virtual DeleteAllBulkData de la clase ara::diag::SovdBulkData para ejecutar el método SOVD «Delete All Bulk Data Defined by Category» [SWS_DM_01855]. La definición de la interfaz se encuentra en el encabezado ara/diag/sovd_bulk_data.h AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.1 «DeleteAllBulkData».

El método recibe los siguientes parámetros de transferencia:

• bulkDataCategory (ara::core::String): identifica la categoría de datos masivos de la que se deben eliminar todas las instancias [SWS_DM_01855].
• metaInfo (MetaInfo const &): transfiere metainformación contextual de la solicitud actual [SWS_DM_01855].
• cancellationHandler (CancellationHandler): informa sobre la cancelación prematura de la conversación en curso [SWS_DM_01855].

El resultado se pone a disposición de forma asíncrona mediante un ara::core::Future<DeleteByCategoryResult> [SWS_DM_01855]. Interpretación: dado que la purga de categorías enteras de datos masivos puede requerir mucho tiempo, es probable que la aplicación deba comprobar periódicamente el cancellationHandler transferido para reaccionar de inmediato ante posibles cancelaciones. Pregunta Q-59d2847dbe42f240 (abierta)

Tratamiento de fallos y seguridad frente a excepciones

El método está declarado como noexcept y seguro frente a excepciones (exception safe) [SWS_DM_01855]. Si la eliminación falla, se debe transmitir en el ara::core::Future un código de error SOVD adecuado conforme a ISO 17978-3 o ASAM SOVD 1.1 [SWS_DM_01855].

concurrencia

La seguridad para hilos es condicional (conditional): el ConcurrencyType transferido al constructor determina si la implementación debe diseñarse como segura para hilos o no segura para hilos [SWS_DM_01855].

Se llama al método DeleteSpecificBulkData de la interfaz ara::diag::SovdBulkData para eliminar un recurso de datos masivos específico en el marco del método SOVD «Delete Specific Bulk Data Resource» ([SWS_DM_01856], AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.2 «DeleteSpecificBulkData»). La declaración se realiza a través del archivo de encabezado #include "ara/diag/sovd_bulk_data.h".

Durante la llamada, se transfieren los siguientes parámetros a la implementación del servicio:

• bulkDataCategory: identifica la categoría de la instancia de datos masivos que se va a eliminar.
• bulkDataId: identificador unívoco del recurso de datos masivos específico que se debe suprimir.
• metaInfo: transfiere metainformación adicional de la solicitud SOVD entrante.
• cancellationHandler: supervisa el estado del proceso e informa en caso de que la conversación en curso se cancele.

La operación trabaja de forma asíncrona y devuelve un ara::core::Future<void> ([SWS_DM_01856]). En caso de eliminación exitosa, el future se resuelve sin valor. Si ocurre un error durante el procesamiento, el future debe completarse con un código de error SOVD aplicable según ISO 17978-3 o ASAM SOVD 1.1 ([SWS_DM_01856]).

En cuanto a la concurrencia, el método está declarado como noexcept y debe implementarse exception safe. La seguridad para hilos requerida es condicional: el ConcurrencyType transferido en el constructor determina si la función debe ejecutarse de forma segura para hilos ([SWS_DM_01856]). Es probable que la implementación deba garantizar que las tareas de limpieza eventuales se lleven a cabo de forma fiable incluso ante una notificación temprana por parte del cancellationHandler. Pregunta Q-2336b99585d8bf3c (abierta)

El método ara::diag::SovdBulkData::Offer sirve para activar el reenvío de solicitudes de diagnóstico: mediante la llamada, Diagnostic Management (DM) queda autorizado y capacitado para transmitir mensajes de solicitud entrantes de bulk data al manejador correspondiente ([SWS_DM_01857]).

Uso y semántica: la función cuenta con la firma ara::core::Result<void> Offer() noexcept, no tiene parámetros y garantiza, como segura frente a excepciones (exception safe), que no se lanzarán excepciones de C++ ([SWS_DM_01857]). Interpretación: dado que el resultado se devuelve directamente como ara::core::Result<void> y no a través de un objeto future asíncrono, es probable que el proceso de registro se ejecute de forma síncrona. Pregunta Q-9933248363829009 (abierta)

Tratamiento de errores: en caso de fallo del registro, la función devuelve un ara::core::Result con un código de error adecuado procedente del dominio de errores ([SWS_DM_01857]):

• DiagOfferErrc::kAlreadyOffered: el servicio ya se había ofrecido previamente para este manejador ([SWS_DM_01857]; véase también [SWS_DM_00514] así como [SWS_DM_00560]).
• DiagOfferErrc::kConfigurationMismatch: la configuración no coincide con los datos de especificación de diagnóstico (DEXT) ([SWS_DM_01857]).

Ambos errores disponen de una semántica de reversión, de modo que en caso de error no queda ningún registro incompleto ([SWS_DM_01857]).

Concurrencia e interacción: el método está especificado explícitamente como no seguro para hilos (not thread-safe) ([SWS_DM_01857]). Por lo tanto, deben evitarse las llamadas paralelas sobre la misma instancia del lado de la aplicación. SovdBulkData comparte el patrón de activación con otros servicios de DM como GenericRoutine ([SWS_DM_00557]), GenericUDSService ([SWS_DM_00619]) o CommunicationControl ([SWS_DM_00809]), que igualmente solo se habilitan para el procesamiento de solicitudes mediante Offer.

El método virtual RequestBulkDataDownload de la clase ara::diag::SovdBulkData se llama para la operación SOVD «Download Bulk Data» a fin de solicitar la descarga de datos masivos [SWS_DM_01873]. La declaración se realiza mediante el archivo de encabezado ara/diag/sovd_bulk_data.h AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.5 «RequestBulkDataDownload».

Como parámetros de entrada, el método toma la categoría de los datos masivos (bulkDataCategory), su identificador (bulkDataId), una lista de encabezados HTTP aceptados (acceptHeader), metainformación de la solicitud (metaInfo) y un cancellationHandler que informa sobre una cancelación de la conversación actual [SWS_DM_01873]. El procesamiento se realiza de forma asíncrona a través de un ara::core::Future. Este devuelve un ara::core::Variant que encapsula o bien una sesión de lectura en forma de tupla compuesta por DataTransferReadSession y BulkDataMetaDataDescriptor, o bien una redirección HTTP (HttpRedirect) [SWS_DM_01873].

En caso de error, a través del future se transmite mediante DiagSovdErrc un código de error SOVD adecuado conforme a ISO 17978-3 o ASAM SOVD 1.1 [SWS_DM_01873]. La función está declarada como noexcept y se considera segura frente a excepciones (exception safe) [SWS_DM_01873].

En cuanto a la concurrencia, la seguridad para hilos es condicional («conditional»): el ConcurrencyType transferido en el constructor determina si el método debe implementarse de forma segura para hilos [SWS_DM_01873]. Interpretación: si se señaliza una cancelación mediante el cancellationHandler, es probable que la implementación deba finalizar prematuramente los preparativos en curso de la transferencia de datos. Pregunta Q-1c74be85e810ac8e (abierta)

Uso y contexto de llamada

El método virtual puro RequestBulkDataUpload de la clase ara::diag::SovdBulkData es invocado por la instancia del servidor de diagnóstico en cuanto un cliente solicita el método SOVD «Upload Bulk Data» [SWS_DM_01793]. Sirve para la preparación de una subida de datos masivos para una categoría de datos determinada AUTOSAR AP SWS Diagnostics §8.53.1.1.3.6 «RequestBulkDataUpload».

Al realizar la llamada, se transfieren a la función los siguientes parámetros [SWS_DM_01854]:

• bulkDataCategory: designa la categoría de datos masivos para la que se va a subir una nueva instancia.
• bulkDataMetaData: descriptor de tipo BulkDataMetaDataDescriptor, precargado con la información disponible de los encabezados HTTP de la solicitud POST de SOVD.
• metaInfo: metainformación adicional de la solicitud.
• cancellationHandler: señaliza si se cancela la conversación actual.

El retorno se realiza de forma asíncrona a través de un ara::core::Future que, en caso de ejecución correcta, proporciona una tupla compuesta por una sesión de escritura DataTransferWriteSession y el BulkDataMetaDataDescriptor correspondiente [SWS_DM_01854].

Tratamiento de errores y concurrencia

Si se produce un error durante la preparación o la ejecución, se devuelve a través del Future el código de error SOVD correspondiente según ISO 17978-3 o ASAM SOVD 1.1 [SWS_DM_01854]. La función está declarada con noexcept y debe ser segura frente a excepciones (exception safe) [SWS_DM_01854].

La seguridad para subprocesos es condicional: que el método deba implementarse de forma segura para subprocesos depende del ConcurrencyType que se haya transferido al constructor de la instancia [SWS_DM_01854]. Interpretación: es de suponer que sea responsabilidad de la implementación de la aplicación supervisar el cancellationHandler transferido durante el proceso de escritura para liberar con prontitud los recursos asignados a la sesión de escritura en caso de interrupciones de la conexión. Pregunta Q-cc88a00d48a35d61 (abierta)

El método ara::diag::SovdBulkData::StopOffer del encabezado ara/diag/sovd_bulk_data.h desactiva el reenvío de mensajes de solicitud entrantes desde Diagnostic Management (DM) al objeto correspondiente [SWS_DM_01858]. No recibe parámetros y no posee valor de retorno [SWS_DM_01858].

En cuanto a ejecución y seguridad, se aplican las siguientes condiciones:

• Tratamiento de errores: la función está declarada como noexcept y clasificada como segura frente a excepciones (exception safe) [SWS_DM_01858]. No se lanzan excepciones ni se devuelven códigos de error [SWS_DM_01858].
• Concurrencia: la operación está especificada como no segura para hilos (not thread-safe) [SWS_DM_01858]. Las llamadas no deben ejecutarse sin protección en caso de uso paralelo de la misma instancia.
• Interacción y ciclo de vida: la llamada sirve para la cancelación del registro o la finalización de la disponibilidad del servicio. Tras la llamada, es probable que las solicitudes entrantes de DM ya no se transmitan a la aplicación. Este principio se corresponde con el patrón de provisión estandarizado para manejadores de diagnóstico en Adaptive AUTOSAR, tal como está definido de forma análoga para clases funcionales como [SWS_DM_00558] (GenericRoutine), [SWS_DM_00793] (DownloadService) o [SWS_DM_01017] (EcuResetRequest) (cf. también AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»). Pregunta Q-23639406c07ca7c1 (abierta)