classe ara::diag::DataTransferReadByPullHandler

A classe ara::diag::DataTransferReadByPullHandler serve para a disponibilização de dados de arquivos ou diretórios que são recuperados ativamente da aplicação pela camada de diagnóstico AraDiag no âmbito de uma operação de leitura UDS ([SWS_DM_01506]). O fluxo abrange a recuperação passo a passo de dados via Read() até o encerramento final da sessão via ExitRead(). Como condição estrita de ciclo de vida, uma instância de manipulador atribuída a exatamente uma única sessão de transferência não pode, sob hipótese alguma, ser destruída antes da chamada de ExitRead() ([SWS_DM_01510]).

mais ›

Contexto

A classe ara::diag::DataTransferReadByPullHandler ([SWS_DM_01506], AUTOSAR_AP_SWS_Diagnostics §8.10.2 «Class: DataTransferReadByPullHandler») processa transferências de dados iniciadas por solicitações de diagnóstico para leitura de arquivos ou diretórios (como RequestReadFile ou RequestReadDirectory). A arquitetura baseia-se em um procedimento pull, no qual a camada de diagnóstico AraDiag consulta ativamente ("pulled") os dados a serem transmitidos a partir da implementação.

Três componentes participam da interação: o cliente UDS externo (testador de diagnóstico), o subsistema de diagnóstico AraDiag e a implementação do manipulador específica da aplicação. O cliente externo envia solicitações de leitura, após o que AraDiag chama os métodos do manipulador para disponibilizar passo a passo chunks de dados e transmiti-los ao cliente UDS ([SWS_DM_01513]).

Ciclo de vida

O ciclo de vida de uma instância de manipulador está vinculado exclusivamente a uma única sessão de transferência de arquivos. O construtor padrão está declarado como protected ([SWS_DM_01507]). Interpretação: a aplicação concreta deve, portanto, implementar e instanciar uma subclasse derivada. Pergunta Q-cb78bc4a1d40968b (aberta)

As operações de cópia estão completamente desativadas: o construtor de cópia ([SWS_DM_01509]) e o operador de atribuição por cópia ([SWS_DM_01512]) estão especificados como excluídos (=delete), uma vez que os manipuladores são destinados ao uso descartável dentro de uma sessão ("only one way usage i.e. per single file transfer session"). Em contrapartida, as operações de movimentação (Move Constructor e Move Assignment) estão definidas como implementação padrão e declaradas como noexcept ([SWS_DM_01508], [SWS_DM_01511], AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.1.1 «Move Constructor»).

Para a liberação aplica-se uma pré-condição estrita: uma instância da classe não pode, de forma alguma, ser destruída antes que o método ExitRead() tenha sido chamado ([SWS_DM_01510], AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.1.2 «Destructor»). No que diz respeito à concorrência, os métodos de interface Read() e ExitRead() estão definidos como não thread-safe ("not thread-safe"), mas com segurança de exceção (noexcept) ([SWS_DM_01513], [SWS_DM_01514]).

Caminho de utilização

O fluxo regular de uma recuperação de dados divide-se nas seguintes etapas:

1. Inicialização: a aplicação instancia a classe derivada do manipulador para a sessão de transferência iminente.
2. Recuperação de dados: para disponibilizar os blocos de dados, AraDiag chama o método Read() ([SWS_DM_01513], AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.3.2 «Read»). A aplicação recebe uma visualização de memória response_data (do tipo ara::core::Span<const ara::core::Byte>) para um buffer pré-alocado por AraDiag, preenche-o com os próximos conteúdos do arquivo e conclui o ara::core::Future<std::uint32_t> com a quantidade de bytes gravados. AraDiag insere esses dados após o contador sequencial de blocos (blockSequenceCounter) como transferResponseParameterRecord na resposta positiva UDS ([SWS_DM_01513]). Esta etapa é repetida para os chunks subsequentes.
3. Encerramento da sessão: para o término regular da transferência, AraDiag chama ExitRead() ([SWS_DM_01514], AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.3.1 «ExitRead»). São passados o motivo do término exit_type, parâmetros específicos do fabricante (transfer_request_parameter_record), meta_info e um cancellation_handler. A implementação confirma isso por meio de um ara::core::Future<ara::core::Vector<ara::core::Byte>>, cujos valores de retorno são transmitidos após o SID na resposta positiva ([SWS_DM_01514]).
4. Liberação: o objeto manipulador só pode ser destruído após a chamada de ExitRead() ter sido efetuada ([SWS_DM_01510]).

Diagrama de sequência: fluxo típico da recuperação de dados via procedimento pull através de AraDiag. Fontes: [SWS_DM_01513], [SWS_DM_01514]

Cenários de erro

Se ocorrerem erros durante a preparação dos dados ou no encerramento, a aplicação relata isso por meio do Future retornado, fornecendo-o com um código de erro UDS (DiagUdsNrcErrc de acordo com a ISO 14229-1) ([SWS_DM_01513], [SWS_DM_01514]). Em seguida, AraDiag gera a resposta negativa UDS correspondente (NRC) para o testador.

Para o cancelamento prematuro, um CancellationHandler é passado para ambos os métodos ([SWS_DM_01513], [SWS_DM_01514]). A aplicação pode verificar através de cancellation_handler.IsCanceled() se a conversação foi cancelada ou registrar uma função de retorno de chamada via cancellation_handler.SetNotifier(). Os buffers disponibilizados (response_data e transfer_request_parameter_record) permanecem válidos até o cumprimento da promise ou até o cancelamento através do manipulador.

Se a instância for destruída antes da chamada de ExitRead(), ocorre uma violação da diretriz da especificação ([SWS_DM_01510]), o que pode levar a sessões de transferência incompletas e estados indefinidos do sistema.