Processa e armazena blocos de dados de entrada em transferências de arquivos de gravação na aplicação.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: eacdeba00b95ProcedênciaPerguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Processa e armazena blocos de dados de entrada em transferências de arquivos de gravação na aplicação.
No AUTOSAR Adaptive, a classe ara::diag::DataTransferWriteHandler serve para o processamento, pelo lado da aplicação, de transferências de ficheiros de escrita iniciadas por RequestWriteFile nos modos AddFile, ResumeFile ou ReplaceFile[SWS_DM_01539]. Os pacotes de dados recebidos são gravados assincronamente na memória através de Write() e a sessão é subsequentemente concluída através de ExitWrite(). Uma instância está estritamente vinculada a uma única sessão de transferência e não deve, de forma alguma, ser destruída antes da chamada de ExitWrite()[SWS_DM_01541].
Contexto
A classe base abstrata ara::diag::DataTransferWriteHandler define, na AUTOSAR Adaptive Platform, a interface para transferências de ficheiros de escrita [SWS_DM_01539] (AUTOSAR_AP_SWS_Diagnostics §8.10.6 «Class: DataTransferWriteHandler»). Serve para o processamento, pelo lado da aplicação, de transferências de dados iniciadas no âmbito de RequestWriteFile através dos modos de operação AddFile, ResumeFile ou ReplaceFile.
Dentro da arquitetura de diagnóstico, o gestor interage com o cliente UDS externo, o middleware de diagnóstico e a aplicação. O cliente transmite blocos de dados segmentados que são recebidos por uma implementação derivada do gestor e armazenados na memória da aplicação [SWS_DM_01546]. Presume-se que o Diagnostic Management da plataforma assuma a coordenação do protocolo UDS e encaminhe os dados úteis para a aplicação de destino através da interface do gestor. Pergunta Q-484dc9dd80e56af4 (aberta)
Ciclo de vida
A instanciação de ara::diag::DataTransferWriteHandler ocorre exclusivamente através de subclasses especializadas da aplicação: o construtor sem parâmetros está definido com protected e noexcept=default[SWS_DM_01540], o que impede uma instanciação direta da classe base. Uma instância do gestor está estritamente vinculada a uma única sessão de transferência de ficheiros ("one way usage i.e. per single file transfer session"). Por esse motivo, o construtor de cópia [SWS_DM_01544] (AUTOSAR_AP_SWS_Diagnostics §8.10.6.1.2.1 «DataTransferWriteHandler») e o operador de atribuição por cópia [SWS_DM_01545] foram eliminados (=delete).
Para a destruição da instância aplica-se uma pré-condição vinculativa: uma instância desta classe não pode, em caso algum, ser destruída antes de o método ExitWrite() ter sido chamado [SWS_DM_01541] (AUTOSAR_AP_SWS_Diagnostics §8.10.6.1.1.2 «Destructor»). O destrutor virtual ~DataTransferWriteHandler() só pode ser chamado após a conclusão integral de ExitWrite(). As funções-membro e o destrutor estão especificados como não seguros para threads (not thread-safe) [SWS_DM_01541], [SWS_DM_01546], [SWS_DM_01547].
Diagrama de estados: ciclo de vida e sequência de chamadas de uma instância de DataTransferWriteHandler. Fontes: [SWS_DM_01541], [SWS_DM_01544].
Caminho de utilização
O fluxo regular de uma transferência de escrita engloba a receção progressiva de blocos de dados e a subsequente conclusão da sessão:
Para cada segmento de dados recebido, o sistema de diagnóstico chama o método puramente virtual Write()[SWS_DM_01546] (AUTOSAR_AP_SWS_Diagnostics §8.10.6.1.3.2 «Write»). Os dados são transmitidos como ara::core::Span<ara::core::Byte>. A validade desta área de memória mantém-se até que o Promise correspondente seja cumprido ou a operação seja cancelada. A aplicação anexa os dados ao buffer interno e retorna um ara::core::Future<void>.
Após terem sido transferidos todos os segmentos, a plataforma chama o método puramente virtual ExitWrite()[SWS_DM_01547] (AUTOSAR_AP_SWS_Diagnostics §8.10.6.1.3.1 «ExitWrite»). São transmitidos o motivo de terminação (DataTransferExitType), parâmetros específicos do fabricante do veículo (transferRequestParameterRecord), metaInfo bem como um CancellationHandler.
O método ExitWrite() retorna um ara::core::Future<ara::core::Vector<ara::core::Byte>>. Em caso de conclusão bem-sucedida, os dados nele contidos são inseridos como transferResponseParameterRecord a seguir ao ID de serviço na mensagem de resposta UDS positiva [SWS_DM_01547].
Diagrama de sequência: sequência de chamadas das operações Write e ExitWrite durante uma sessão de transferência. Fontes: [SWS_DM_01546], [SWS_DM_01547].
Cenários de erro
Os erros durante o processamento de dados e a transferência são geridos através de valores de retorno estandardizados e mecanismos de cancelamento:
Se a escrita de um bloco de dados ou a terminação da transferência falhar, o respetivo Future é disponibilizado com um ara::core::ErrorCode proveniente de DiagUdsNrcErrc[SWS_DM_01546], [SWS_DM_01547]. Isto leva à geração de uma resposta UDS negativa correspondente (NRC de acordo com a ISO 14229-1) para o cliente.
Ambos os métodos fornecem um CancellationHandler. A aplicação pode verificar através de cancellationHandler.IsCanceled() se a conversação foi cancelada ou registar, através de cancellationHandler.SetNotifier(), uma função de notificação a ser executada em caso de cancelamento da conversação [SWS_DM_01546], [SWS_DM_01547].
Se a instância for destruída antes da chamada de ExitWrite(), ocorre uma violação da regra de ciclo de vida especificada [SWS_DM_01541], o que provavelmente resulta num estado de sistema indefinido e em ficheiros incompletos. Pergunta Q-cc032c11ac89a5b1 (aberta) Além disso, um acesso concorrente desprotegido provoca inconsistências de dados, dado que a interface é explicitamente não segura para threads.
Este guia foi elaborado por um assistente de curadoria baseado em IA com base no AUTOSAR R25-11.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 459b3563e8d0Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
usar
A função membro virtual ara::diag::DataTransferWriteHandler::ExitWrite termina uma sessão de transferência de dados em curso para acessos de escrita [SWS_DM_01547] (AUTOSAR_AP_SWS_Diagnostics §8.10.6.1.3.1 «ExitWrite», cabeçalho #include "ara/diag/data_transfer.h"). Os parâmetros de chamada compreendem:
exitType: determina o motivo para o término da sessão [SWS_DM_01547].
transferRequestParameterRecord: parâmetros específicos do fabricante do veículo para apoiar a transferência de dados; a validade do span tem de ser mantida até que a promise associada seja cumprida ou a operação seja cancelada [SWS_DM_01547].
metaInfo: Metainformações da solicitação de diagnóstico [SWS_DM_01547].
cancellationHandler: Permite a consulta do estado de cancelamento via cancellationHandler.IsCanceled() bem como o registro de um notifier via cancellationHandler.SetNotifier()[SWS_DM_01547].
A função opera de forma assíncrona e retorna um ara::core::Future<ara::core::Vector<ara::core::Byte>>, cujos dados de resultado, em caso de sucesso, são inseridos como transferResponseParameterRecord após o SID na mensagem de resposta positiva [SWS_DM_01547].
Tratamento de erros
Se a finalização falhar, a future deve ser disponibilizada com um Negative Response Code (NRC) adequado conforme a ISO 14229-1 via DiagUdsNrcErrc[SWS_DM_01547]. A função é especificada como noexcept e com segurança de exceção (exception safe) [SWS_DM_01547].
Concorrência e interação
A implementação não é segura para threads (not thread-safe) [SWS_DM_01547]. Em relação ao ciclo de vida do objeto, existe uma condição de ordem estrita: uma instância da classe de handler só pode ser destruída depois que ExitWrite() for chamado [SWS_DM_01541].
Esta nota de utilização foi gerada automaticamente com base nas especificações AUTOSAR para o Release R25-11.
This parameter record contains parameter(s), which are required by the server to support the transfer of data. Format and length of this parameter(s) are vehicle manufacturer specific. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
Returns a Future, which either gets readied to OperationOutput (transferResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message) Data in OperationOutput.response_ data will be placed after SID as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: a81be0f54500ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método Write da interface ara::diag::DataTransferWriteHandler serve para anexar blocos de dados recebidos à área de memória da aplicação numa transferência de ficheiros UDS [SWS_DM_01546]. A chamada é realizada pela instância do Diagnostic Server quando, no âmbito de um processo iniciado por RequestFileTransfer (0x38), é recebido um pedido UDS TransferData (0x36) [SWS_DM_01317].
Parâmetros e semântica
Os conteúdos de ficheiro a escrever são passados através de requestData como ara::core::Span<ara::core::Byte>; o buffer referenciado permanece válido até que a promise associada seja cumprida ou o processamento seja cancelado [SWS_DM_01546]. O parâmetro metaInfo disponibiliza metainformações do pedido de diagnóstico. Através de cancellationHandler, é possível verificar o estado de cancelamento atual mediante IsCanceled ou registar um callback de notificação através de SetNotifier[SWS_DM_01546].
Tratamento de erros e simultaneidade
O resultado é devolvido de forma assíncrona como ara::core::Future<void>. Em caso de sucesso, o future é concluído vazio; em caso de erros, deve ser completado com um Negative Response Code (NRC) adequado de DiagUdsNrcErrc em conformidade com a ISO 14229-1 [SWS_DM_01546]. A função está especificada como exception safe, mas expressamente como not thread-safe[SWS_DM_01546]; o Diagnostic Server deverá, portanto, garantir chamadas sequenciais para a mesma sessão. Pergunta Q-e60d55fe09b9a2c5 (aberta)
Interação e fluxo
O manipulador de escrita é registado através de construtores de modelo (template) dentro de DataTransferWriteSession[SWS_DM_01317]. Assim que a transferência for concluída com RequestTransferExit (0x37), o servidor chama o método Exit do mesmo manipulador [SWS_DM_01318]. O elemento demarca-se de métodos de escrita relacionados com DID, tal como definidos em [SWS_DM_00598] ou [SWS_DM_00637].
Este texto foi criado automaticamente. As afirmações técnicas são comprovadas por referências da especificação.
The first or subsequent file content chunk received from the UDS client to be written into the file. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
gemini-3.8-flash-low· 2026-10-13 · Original em alemão