Позволяет считывать полные файлы или каталоги через разделяемые области памяти при диагностических запросах.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 4c654c39d186ПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Позволяет считывать полные файлы или каталоги через разделяемые области памяти при диагностических запросах.
Класс ara::diag::DataTransferReadSharedDataHandler служит для обработки диагностических передач данных чтения для содержимого файлов и каталогов через разделяемую память ([SWS_DM_01497]). После запуска сеанса реализация приложения предоставляет все данные в виде Shared Data View с помощью Read() и удерживает выделенный буфер вплоть до сообщения об освобождении от ReleaseHandler ([SWS_DM_01504]). Перед уничтожением объекта обработчика сессия передачи обязательно должна быть завершена через ExitRead(). Объект предназначен исключительно для одной сессии передачи и поэтому может перемещаться, но не копироваться.
Контекст
Класс ara::diag::DataTransferReadSharedDataHandler относится к диагностической области AUTOSAR Adaptive Platform в модуле diag (AUTOSAR_AP_SWS_Diagnostics §8.10.5 «Class: DataTransferReadSharedDataHandler»). Его основная задача заключается в обработке передач данных для содержимого файлов и каталогов, инициированных такими UDS-запросами, как RequestReadFile или RequestReadDirectory ([SWS_DM_01497]). Вместо отдельных шагов копирования для каждого блока передачи этот обработчик позволяет зависимой от приложения реализации предоставлять все данные в виде непрерывной разделяемой области памяти.
В общем рабочем процессе системы взаимодействуют три основных участника: внешний UDS-клиент отправляет запрос на чтение в блок управления. Диагностическая среда выполнения AraDiag принимает запрос и направляет выполнение конкретной реализации DataTransferReadSharedDataHandler ([SWS_DM_01497], [SWS_DM_01504]). Третий участник, ReleaseHandler, сигнализирует приложению, как только разделяемые ресурсы памяти перестают требоваться платформе и могут быть освобождены ([SWS_DM_01504]).
Контекстная диаграмма: взаимодействие между UDS-клиентом, средой выполнения AraDiag и реализацией обработчика со стороны приложения. Источники: [SWS_DM_01497], [SWS_DM_01504], [SWS_DM_01505]
Для уничтожения объекта действует строгое предусловие: экземпляр этого класса ни в коем случае не должен уничтожаться до того, как сессия передачи будет формально завершена вызовом ExitRead() ([SWS_DM_01499], AUTOSAR_AP_SWS_Diagnostics §8.10.5.1.1.3 «Destructor»). Только после выполнения этой заключительной обработки разрешается выполнение виртуального деструктора ([SWS_DM_01499]).
В отношении многопоточности основные методы Read() и ExitRead() указаны как потоконебезопасные (not thread-safe), в то время как все функции интерфейса гарантируют безопасность исключений (exception safe) ([SWS_DM_01498], [SWS_DM_01504], [SWS_DM_01505]).
Путь использования
Типичная последовательность вызовов передачи данных с разделяемыми областями памяти включает несколько шагов:
Предоставление Shared Data:AraDiag вызывает чисто виртуальный метод Read() и передает ReleaseHandler, MetaInfo, а также CancellationHandler ([SWS_DM_01504]). Приложение выделяет память под все содержимое файла или каталога и возвращает разделяемое представление на него в виде ara::core::Span<ara::core::Byte> через ara::core::Future обратно в AraDiag ([SWS_DM_01504]).
Удержание и освобождение памяти: приложение обязательно должно сохранять целостность выделенной памяти до тех пор, пока ReleaseHandler не просигнализирует о том, что область памяти может быть безопасно освобождена ([SWS_DM_01504]). Для этого приложение может зарегистрировать функцию уведомления (notifier) в ReleaseHandler или активно опрашивать его статус ([SWS_DM_01504]). Интерпретация: сигнализация через ReleaseHandler, предположительно, выполняется асинхронно компонентом AraDiag, как только блоки данных успешно переданы UDS-клиенту. Вопрос Q-0fbc1c5e667c9a68 (открытый)
Завершение сеанса: для завершения передачи AraDiag вызывает метод ExitRead() ([SWS_DM_01505], AUTOSAR_AP_SWS_Diagnostics §8.10.5.1.3.1 «ExitRead»). Наряду с причиной завершения (DataTransferExitType) передаются специфичные для автопроизводителя параметры запроса, время жизни которых гарантируется до выполнения promise с результатом ([SWS_DM_01505]). Приложение возвращает данные ответа через ara::core::Future<ara::core::Vector<ara::core::Byte>> ([SWS_DM_01505]).
Уничтожение объекта: только после успешного вызова ExitRead() экземпляр обработчика разрешается освобождать и уничтожать ([SWS_DM_01499]).
Диаграмма последовательности: пошаговая последовательность от предоставления данных через Read() и освобождения памяти до завершения через ExitRead(). Источники: [SWS_DM_01499], [SWS_DM_01504], [SWS_DM_01505]
Сценарии ошибок
Если при предоставлении данных или при завершении передачи возникают ошибки, о них сообщается через соответствующий ara::core::Future с ara::core::ErrorCode из домена DiagUdsNrcErrc согласно ISO 14229-1 ([SWS_DM_01504], [SWS_DM_01505]).
Еще один сценарий представляет собой прерывание текущей диагностической коммуникации. Оба метода получают CancellationHandler ([SWS_DM_01504], [SWS_DM_01505]). Приложение может синхронно проверять статус отмены через cancellation_handler.IsCanceled() или задать функцию уведомления через cancellation_handler.SetNotifier(), чтобы незамедлительно отреагировать при преждевременной отмене ([SWS_DM_01504], [SWS_DM_01505]).
Нарушение предусловия относительно деструктора — если объект уничтожается до вызова ExitRead() — противоречит требованию [SWS_DM_01499] и приводит к ошибочным состояниям программы.
Это руководство по классам основано на спецификации AUTOSAR Adaptive Platform Release R25-11.
Provides the whole data to be read out from the application in form of a shared data view. The whole file/directory info content to be sent back to the UDS client will be allocated by the application and its shared ownership (view over the memory location) is passed as a result to AraDiag. The allocated memory must be kept until the ReleaseHandler’s notifier is invoked or the status polled, signalling that the memory, addressed by the Span now can safely be released.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 8bcba929adb6Происхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Интерфейс ExitRead класса ara::diag::DataTransferReadSharedDataHandler ([SWS_DM_01505]; заголовочный файл ara/diag/data_transfer.h) завершает текущую сессию передачи данных.
exit_type (DataTransferExitType): указывает причину завершения сессии.
transfer_request_parameter_record (ara::core::Span<const ara::core::Byte>): содержит специфичные для производителя параметры для поддержки передачи. Данные остаются действительными до тех пор, пока не будет выполнено соответствующее Promise или обработка не будет отменена.
meta_info (MetaInfo const&): содержит дополнительную метаинформацию диагностического запроса.
cancellation_handler (CancellationHandler): позволяет проверять статус отмены с помощью cancellation_handler.IsCanceled(), а также регистрировать функцию уведомления через cancellation_handler.SetNotifier(), которая вызывается при отмене сеанса взаимодействия (conversation).
Обработка ошибок и возвращаемые значения
При успешном завершении Future предоставляет выходные данные (transferResponseParameterRecord), которые размещаются в положительном ответе после SID [SWS_DM_01505]. В случае ошибки Future выполняется с кодом ошибки из DiagUdsNrcErrc (соответствующий NRC согласно ISO 14229-1) [SWS_DM_01505].
Параллелизм и жизненный цикл
Метод объявлен как noexcept (exception safe), однако явно специфицирован как not thread-safe[SWS_DM_01505]. В отношении жизненного цикла объекта действует предписание, что экземпляр DataTransferReadSharedDataHandler ни в коем случае не должен уничтожаться до того, как был вызван ExitRead() ([SWS_DM_01499]). Аналогичные функции завершения и требования к деструкторам существуют для родственных классов DataTransferReadByPullHandler ([SWS_DM_01514]) и DataTransferReadByPushHandler ([SWS_DM_01523]).
Данное указание по использованию было создано ИИ и основано на спецификациях AUTOSAR Adaptive Platform.
Руководство разработчика реализации в подготовке (сложность I2)
This parameter record contains parameter(s), which are required
parameter_record
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.
meta_info
contains additional meta information of the request.
cancellation_handler
This parameter is used to • Query the current cancellation status by calling cancellation_ handler.IsCanceled(). Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellation_handler.Set Notifier(). 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.
Provides the whole data to be read out from the application in form of a shared data view. The whole file/directory info content to be sent back to the UDS client will be allocated by the application and its shared ownership (view over the memory location) is passed as a result to AraDiag. The allocated memory must be kept until the ReleaseHandler’s notifier is invoked or the status polled, signalling that the memory, addressed by the Span now can safely be released.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: cba844c9db1eПроисхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Метод Read интерфейса ara::diag::DataTransferReadSharedDataHandler предоставляет считываемые данные файлов или каталогов для UDS-клиента через разделяемое представление памяти ([SWS_DM_01504]). Вызов выполняется асинхронно и возвращает ara::core::Future с ara::core::Span<ara::core::Byte> ([SWS_DM_01504]).
Использование и жизненный цикл
Реализующее приложение выделяет всё содержимое самостоятельно и передаёт представление в AraDiag. Базовая область памяти обязательно должна сохраняться в неизменном виде до тех пор, пока освобождение не будет просигнализировано через переданный ReleaseHandler его нотификатором или запрошено путём проверки состояния ([SWS_DM_01504]). ReleaseHandler должен сохраняться для того же UDS-клиента на основе MetaInfo ([SWS_DM_01504]). Через CancellationHandler можно отслеживать текущую передачу с помощью IsCanceled() или зарегистрировать нотификатор отмены через SetNotifier() ([SWS_DM_01504]).
Обработка ошибок и параллелизм
В случае успеха данные отправляются как transferResponseParameterRecord после blockSequenceCounter ([SWS_DM_01504]). Если считывание завершается неудачно, Future необходимо завершить с подходящим кодом ошибки из DiagUdsNrcErrc согласно ISO 14229-1 ([SWS_DM_01504]). Если интерфейс приложения ещё не был или больше не предоставляется через offer(), сервер сообщает NRC 0x94 (ResourceTemporarilyNotAvailable) ([SWS_DM_01257]). Функция специфицирована как noexcept и исключебно-безопасная, однако считается непотокобезопасной (not thread-safe) ([SWS_DM_01504]).
демаркация
В отличие от DataTransferReadByPullHandler::Read, при котором блоки данных копируются в заданный буфер ([SWS_DM_01513]), или DataTransferReadByPushHandler::Read, который возвращает векторы с передачей владения ([SWS_DM_01522]), этот обработчик передаёт всё содержимое без копирования буфера через разделяемую память ([SWS_DM_01504]).
Это указание по использованию было сгенерировано автоматически на основе стандарта AUTOSAR.
Руководство разработчика реализации в подготовке (сложность I1)
The release shared resource handler to be stored and used by the application until a new one is passed for the same meta_info (UDS client).
meta_info
Contains additional meta information.
cancellation_handler
This parameter is used to • Query the current cancellation status by calling cancellation_ handler.IsCanceled(). Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellation_handler.Set Notifier(). The registered notifier is called if the current conversation is cancelled.
Returns a Future, which either gets readied to ReadSharedOutput (transferResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message). Data in ReleaseSharedHandler.responseData will be placed after the blockSequenceCounter 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.
gemini-3.8-flash-low· 2026-10-13 · Немецкий оригинал