classe ara::diag::SovdBulkData

usar

A função virtual DeleteAllBulkData da classe ara::diag::SovdBulkData é chamada para executar o método SOVD “Delete All Bulk Data Defined by Category” [SWS_DM_01855]. A definição da interface encontra-se no cabeçalho ara/diag/sovd_bulk_data.h AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.1 «DeleteAllBulkData».

O método recebe os seguintes parâmetros de passagem:

• bulkDataCategory (ara::core::String): identifica a categoria de dados em massa da qual todas as instâncias devem ser excluídas [SWS_DM_01855].
• metaInfo (MetaInfo const &): transfere metainformações contextuais da requisição atual [SWS_DM_01855].
• cancellationHandler (CancellationHandler): informa sobre o cancelamento prematuro da conversação em andamento [SWS_DM_01855].

O resultado é disponibilizado de forma assíncrona por meio de um ara::core::Future<DeleteByCategoryResult> [SWS_DM_01855]. Interpretação: como a purga de categorias inteiras de dados em massa pode ser demorada, a aplicação presumivelmente deve verificar ciclicamente o cancellationHandler passado, a fim de reagir prontamente a eventuais cancelamentos. Pergunta Q-59d2847dbe42f240 (aberta)

Tratamento de erros e segurança contra exceções

O método é declarado como noexcept e seguro quanto a exceções (exception safe) [SWS_DM_01855]. Se a exclusão falhar, um código de erro SOVD apropriado conforme ISO 17978-3 ou ASAM SOVD 1.1 deve ser transmitido no ara::core::Future [SWS_DM_01855].

simultaneidade

A segurança de threads é condicional (conditional): se a implementação deve ser projetada como segura para threads ou não segura para threads, é determinado por meio do ConcurrencyType passado ao construtor [SWS_DM_01855].

O método DeleteSpecificBulkData da interface ara::diag::SovdBulkData é chamado para excluir um recurso específico de dados em massa no âmbito do método SOVD “Delete Specific Bulk Data Resource” ([SWS_DM_01856], AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.2 «DeleteSpecificBulkData»). A declaração ocorre por meio do arquivo de cabeçalho #include "ara/diag/sovd_bulk_data.h".

Na chamada, os seguintes parâmetros são passados para a implementação do serviço:

• bulkDataCategory: identifica a categoria da instância de dados em massa a ser excluída.
• bulkDataId: identificador unívoco do recurso específico de dados em massa que deve ser removido.
• metaInfo: transfere metainformações adicionais da requisição SOVD recebida.
• cancellationHandler: monitora o status do procedimento e informa caso a conversação em andamento seja cancelada.

A operação trabalha de forma assíncrona e retorna um ara::core::Future<void> ([SWS_DM_01856]). Em caso de exclusão bem-sucedida, o future é resolvido sem valor. Se ocorrer um erro durante o processamento, o future deve ser concluído com um código de erro SOVD aplicável de acordo com a ISO 17978-3 ou ASAM SOVD 1.1 ([SWS_DM_01856]).

Em relação à concorrência, o método é declarado como noexcept e deve ser implementado exception safe. A segurança de threads exigida é condicional: se a função deve ser executada de forma segura para threads, determina o ConcurrencyType passado no construtor ([SWS_DM_01856]). A implementação provavelmente deve garantir que eventuais tarefas de limpeza também ocorram de forma confiável em caso de notificação antecipada pelo cancellationHandler. Pergunta Q-2336b99585d8bf3c (aberta)

O método ara::diag::SovdBulkData::Offer serve para ativar o encaminhamento de requisições de diagnóstico: por meio da chamada, o Diagnostic Management (DM) é autorizado e habilitado a transmitir mensagens de requisição recebidas para bulk data ao respectivo handler ([SWS_DM_01857]).

Uso e semântica: a função possui a assinatura ara::core::Result<void> Offer() noexcept, é livre de parâmetros e garante como segura quanto a exceções (exception safe) que nenhuma exceção em C++ seja lançada ([SWS_DM_01857]). Interpretação: como o resultado é retornado diretamente como ara::core::Result<void> e não por meio de um objeto future assíncrono, o processo de registro presumivelmente é executado de forma síncrona. Pergunta Q-9933248363829009 (aberta)

Tratamento de erros: em caso de falha no registro, a função retorna um ara::core::Result com um código de erro adequado do domínio de erros ([SWS_DM_01857]):

• DiagOfferErrc::kAlreadyOffered: o serviço já foi oferecido anteriormente para este handler ([SWS_DM_01857]; ver também [SWS_DM_00514] bem como [SWS_DM_00560]).
• DiagOfferErrc::kConfigurationMismatch: a configuração não coincide com os dados de especificação de diagnóstico (DEXT) ([SWS_DM_01857]).

Ambos os erros possuem semântica de rollback, de modo que nenhum registro incompleto permaneça em caso de falha ([SWS_DM_01857]).

Concorrência e interação: o método é explicitamente especificado como não seguro para threads (not thread-safe) ([SWS_DM_01857]). Chamadas paralelas na mesma instância devem, portanto, ser evitadas pelo lado da aplicação. O padrão de ativação é compartilhado por SovdBulkData com outros serviços do DM, tais como GenericRoutine ([SWS_DM_00557]), GenericUDSService ([SWS_DM_00619]) ou CommunicationControl ([SWS_DM_00809]), que também só são liberados para o processamento de requisições por meio de Offer.

O método virtual RequestBulkDataDownload da classe ara::diag::SovdBulkData é chamado para a operação SOVD “Download Bulk Data” para solicitar o download de dados em massa [SWS_DM_01873]. A declaração é feita por meio do arquivo de cabeçalho ara/diag/sovd_bulk_data.h AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.5 «RequestBulkDataDownload».

Como parâmetros de entrada, o método aceita a categoria dos dados em massa (bulkDataCategory), seu identificador (bulkDataId), uma lista de cabeçalhos HTTP aceitos (acceptHeader), metainformações da requisição (metaInfo), bem como um cancellationHandler que informa sobre o cancelamento da conversa atual [SWS_DM_01873]. O processamento ocorre de forma assíncrona por meio de um ara::core::Future. Este retorna um ara::core::Variant, que encapsula ou uma sessão de leitura como tupla de DataTransferReadSession e BulkDataMetaDataDescriptor, ou um redirecionamento HTTP (HttpRedirect) [SWS_DM_01873].

Em caso de falha, um código de erro SOVD adequado de acordo com a ISO 17978-3 ou ASAM SOVD 1.1 é transmitido via Future por meio de DiagSovdErrc [SWS_DM_01873]. A função é declarada como noexcept e é considerada segura contra exceções (exception safe) [SWS_DM_01873].

Em relação à concorrência, a segurança de threads é condicional (“conditional”): se o método deve ser implementado como thread-safe é determinado pelo ConcurrencyType passado no construtor [SWS_DM_01873]. Interpretação: caso um cancelamento seja sinalizado através do cancellationHandler, a implementação deverá encerrar prematuramente os preparativos em andamento da transferência de dados. Pergunta Q-1c74be85e810ac8e (aberta)

Utilização e contexto de chamada

O método puramente virtual RequestBulkDataUpload da classe ara::diag::SovdBulkData é chamado pela instância do Diagnostic Server assim que um cliente requisita o método SOVD “Upload Bulk Data” [SWS_DM_01793]. Ele serve para a preparação de um upload de dados em massa para uma determinada categoria de dados AUTOSAR AP SWS Diagnostics §8.53.1.1.3.6 «RequestBulkDataUpload».

Na chamada, são passados os seguintes parâmetros para a função [SWS_DM_01854]:

• bulkDataCategory: designa a categoria de dados em massa para a qual uma nova instância deve ser enviada via upload.
• bulkDataMetaData: descritor do tipo BulkDataMetaDataDescriptor, pré-preenchido com as informações disponíveis dos cabeçalhos HTTP da requisição SOVD POST.
• metaInfo: metainformações adicionais da requisição.
• cancellationHandler: sinaliza se a conversação atual for cancelada.

O retorno ocorre de forma assíncrona por meio de um ara::core::Future, que, em caso de execução bem-sucedida, disponibiliza uma tupla composta por uma sessão de escrita DataTransferWriteSession e o BulkDataMetaDataDescriptor associado [SWS_DM_01854].

Tratamento de erros e simultaneidade

Se ocorrer um erro durante a preparação ou execução, um código de erro SOVD aplicável conforme a ISO 17978-3 ou ASAM SOVD 1.1 é retornado por meio do Future [SWS_DM_01854]. A função é declarada com noexcept e deve ser segura contra exceções (exception safe) [SWS_DM_01854].

A segurança de threads é condicional: se o método deve ser implementado como thread-safe depende do ConcurrencyType que foi passado para o construtor da instância [SWS_DM_01854]. Interpretação: deve ser responsabilidade da implementação da aplicação monitorar o cancellationHandler passado durante o processo de escrita, a fim de liberar oportunamente os recursos alocados da sessão de escrita em caso de quedas de conexão. Pergunta Q-cc88a00d48a35d61 (aberta)

O método ara::diag::SovdBulkData::StopOffer do cabeçalho ara/diag/sovd_bulk_data.h desativa o encaminhamento de mensagens de requisição recebidas do Diagnostic Management (DM) para o respectivo objeto [SWS_DM_01858]. Ele não aceita parâmetros e não possui valor de retorno [SWS_DM_01858].

Em relação à execução e à segurança, aplicam-se as seguintes condições:

• Tratamento de erros: a função é declarada como noexcept e classificada como segura quanto a exceções (exception safe) [SWS_DM_01858]. Não são lançadas exceções nem são retornados códigos de erro [SWS_DM_01858].
• Concorrência: a operação é especificada como não segura para threads (not thread-safe) [SWS_DM_01858]. As chamadas não devem ser executadas desprotegidas no caso de uso paralelo da mesma instância.
• Interação e ciclo de vida: a chamada serve para o cancelamento de registro ou encerramento da prontidão do serviço. Após a chamada, presume-se que as requisições recebidas do DM não sejam mais repassadas para a aplicação. Esse princípio corresponde ao padrão padronizado de disponibilização para handlers de diagnóstico no Adaptive AUTOSAR, conforme definido analogamente para classes funcionais como [SWS_DM_00558] (GenericRoutine), [SWS_DM_00793] (DownloadService) ou [SWS_DM_01017] (EcuResetRequest) (cf. também AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»). Pergunta Q-23639406c07ca7c1 (aberta)