classe ara::diag::DataTransferReadByPushHandler

A classe ara::diag::DataTransferReadByPushHandler serve como interface base para transferências de leitura UDS, nas quais a aplicação empacota e disponibiliza ativamente conteúdos de arquivos [SWS_DM_01515]. Os blocos de dados são passados sequencialmente através de Read() e a sessão de transferência é subsequentemente encerrada de forma ordenada através de ExitRead() [SWS_DM_01523]. Cada manipulador está estritamente vinculado a exatamente uma sessão de transferência, razão pela qual as operações de cópia são impedidas. Como condição essencial de ciclo de vida, a instância não pode, em hipótese alguma, ser destruída antes da chamada de ExitRead() [SWS_DM_01519].

mais ›

Contexto

A classe ara::diag::DataTransferReadByPushHandler atua como classe base e de interface para transferências de dados de diagnóstico iniciadas por solicitações como RequestReadFile ou RequestReadDirectory [SWS_DM_01515]. O padrão de transmissão subjacente baseia-se no princípio push: os dados de arquivos ou diretórios são empacotados ativamente pela implementação específica da aplicação e passados ao gerenciamento de diagnóstico (Diagnostic Management, DM) AUTOSAR_AP_SWS_Diagnostics §8.10.3 «Class: DataTransferReadByPushHandler». A interação ocorre entre o cliente UDS externo, o componente de plataforma ara::diag e a implementação concreta do manipulador da aplicação.

Diagrama de contexto: enquadramento do manipulador push entre o cliente UDS externo e o Diagnostic Management. Fontes: [SWS_DM_01515], AUTOSAR_AP_SWS_Diagnostics §8.10.3 «Class: DataTransferReadByPushHandler»

Ciclo de vida

Como DataTransferReadByPushHandler é projetada como uma classe base abstrata, o construtor sem parâmetros possui visibilidade protegida (protected) [SWS_DM_01516]. A instanciação ocorre no contexto de uma classe derivada dentro da aplicação. As instâncias estão estritamente vinculadas a exatamente uma sessão de transferência de arquivos ("one way usage"); consequentemente, o construtor de cópia [SWS_DM_01518] bem como o operador de atribuição por cópia [SWS_DM_01521] estão explicitamente excluídos (=delete). Uma transferência de posse é possível por meio de operações de movimentação, pois o construtor de movimentação [SWS_DM_01517] e a atribuição por movimentação [SWS_DM_01520] existem como implementações padrão e estão declarados como com segurança de exceção (noexcept).

Para a destruição do manipulador, a especificação define uma pré-condição estrita: uma instância não pode, sob hipótese alguma, ser destruída antes que a sessão tenha sido encerrada através da chamada de ExitRead() [SWS_DM_01519], AUTOSAR_AP_SWS_Diagnostics §8.10.3.1.1.2 «Destructor». No que tange à concorrência, os métodos virtuais da classe estão especificados como não thread-safe ("not thread-safe") [SWS_DM_01522], [SWS_DM_01523], razão pela qual acessos simultâneos precisam ser sincronizados ou executados sequencialmente pela plataforma.

Caminho de utilização

O fluxo operacional divide-se na disponibilização repetitiva de fragmentos de dados e no encerramento ordenado da sessão. Após a inicialização do processo de leitura, ara::diag chama repetidamente o método Read() [SWS_DM_01522], AUTOSAR_AP_SWS_Diagnostics §8.10.3.1.3.2 «Read». Nessa etapa, o framework passa uma diretriz para o tamanho de retorno recomendado em bytes (recommended_number_bytes_to_return) a fim de obter uma taxa de transferência ideal, bem como o contexto de solicitação (MetaInfo) e um CancellationHandler. A aplicação gera o pacote de dados e transfere sua propriedade através de um ara::core::Future<ara::core::Vector<ara::core::Byte>> para o Diagnostic Management, que insere os dados úteis após o contador sequencial de blocos na mensagem de resposta UDS [SWS_DM_01522].

Assim que todos os blocos de dados tiverem sido transmitidos ou a sessão deva ser finalizada, ara::diag chama o método ExitRead() [SWS_DM_01523], AUTOSAR_AP_SWS_Diagnostics §8.10.3.1.3.1 «ExitRead». Além do motivo do término (DataTransferExitType exit_type), parâmetros de solicitação específicos do fabricante são passados através de transfer_request_parameter_record. O tempo de vida dessa extensão de parâmetros está obrigatoriamente acoplado até que a promise associada seja cumprida ou o processamento seja cancelado [SWS_DM_01523]. Após o retorno do conjunto final de parâmetros de resposta através da Future, a transferência é considerada finalizada, cumprindo a condição para a destruição segura do objeto manipulador [SWS_DM_01519].

Diagrama de sequência: sequência típica de interação entre Diagnostic Management e manipulador durante a transferência de leitura e o encerramento da transferência. Fontes: [SWS_DM_01522], [SWS_DM_01523], [SWS_DM_01519]

Cenários de erro

Se ocorrer um erro durante a montagem de blocos de dados ou no encerramento da sessão, ele será reportado assincronamente por meio do respectivo ara::core::Future. Em vez de uma estrutura de resposta positiva, o future é fornecido com um código de erro (ara::core::ErrorCode) do escopo DiagUdsNrcErrc, que corresponde a um identificador de resposta negativa apropriado (Negative Response Code, NRC) conforme a ISO 14229-1 [SWS_DM_01522], [SWS_DM_01523].

Se o diálogo de diagnóstico for interrompido ou o cliente enviar uma solicitação de cancelamento, o CancellationHandler passado entra em ação. A implementação pode consultar o status atual de cancelamento através de cancellation_handler.IsCanceled() ou registrar por meio de cancellation_handler.SetNotifier() uma função de retorno de chamada que é acionada mediante o cancelamento da conversação [SWS_DM_01522], [SWS_DM_01523]. O cumprimento ou o cancelamento da promise marca simultaneamente o fim da validade do conjunto de parâmetros em ExitRead() [SWS_DM_01523].