структура ara::diag::SovdBulkData::DeletionError

Структура [SWS_DM_01844] представляет результат сбоя при неудачной операции удаления отдельного объекта массивных данных в диагностическом модуле SOVD (AUTOSAR_AP_SWS_Diagnostics §8.53.4 «Struct: DeletionError»). Она связывает метаданные неудавшегося элемента данных item с возникшим кодом ошибки error [SWS_DM_01845], [SWS_DM_01846]. Будучи чистым объектом-значением (Value Object), она служит вызывающей стороне для точечной идентификации и анализа причин неудачных операций очистки.

больше ›

Контекст

Структура данных [SWS_DM_01844] описывает отдельную ошибку, возникающую в процессе удаления массивных данных (Bulk Data) в рамках фреймворка SOVD (Service-Oriented Vehicle Diagnostics) платформы AUTOSAR Adaptive (AUTOSAR_AP_SWS_Diagnostics §8.53.4 «Struct: DeletionError»). Являясь компонентом интерфейса ara::diag::SovdBulkData, структура служит для установления точного соответствия между затронутым элементом данных и причиной ошибки в случае сбоя операций очистки или удаления. При этом она связывает дескриптор метаданных неудаляемого файла со стандартизированным кодом ошибки AUTOSAR.

Взаимодействие происходит главным образом между диагностическим сервером или компонентом ara::diag::SovdBulkData, выполняющим удаление, и вызывающей диагностической либо прикладной логикой. Последняя запрашивает очистку массовых данных и в случае ошибки принимает обратную связь, чтобы определить, какие конкретно записи данных не удалось удалить и почему. Взаимодействие участвующих компонентов и возврат объекта ошибки при попытке удаления представлены на следующей диаграмме последовательности.

Диаграмма последовательности: типовой ход неудачного удаления массовых данных с возвратом DeletionError. Источники: [SWS_DM_01844], [SWS_DM_01845], [SWS_DM_01846], AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 «Public Member Variables»

Жизненный цикл

Структура [SWS_DM_01844] спроектирована как чистый объект-значение (Plain Old Data / тип-значение). Ее инстанцирование происходит на стороне диагностической инфраструктуры именно тогда, когда при обработке задания на удаление для определенного элемента массовых данных обнаруживается ошибка. При этом поле item инициализируется соответствующим BulkDataMetaDataDescriptor [SWS_DM_01845], а поле error — специфическим кодом ошибки ara::core::ErrorCode [SWS_DM_01846].

Что касается отношений владения, то экземпляр (или коллекция таких экземпляров) обычно переходит во владение вызывающей стороны в качестве возвращаемого значения или внутри контейнера ошибок. Интерпретация: структура не владеет собственными долгоживущими ресурсами или активными потоками; ее жизненный цикл напрямую привязан к области видимости (scope) вызывающего блока обработки ошибок или контейнера результатов. Вопрос Q-60f135b9e36d7083 (открытый) После анализа приложением структура вместе со своими переменными-членами стандартно уничтожается в стеке или в куче. Поскольку речь идет о пассивном пакете данных, внутри структуры не происходит внутренних переходов состояний или параллельных требований к синхронизации.

Путь использования

В обычном сценарии использования диагностический компонент или SOVD-клиент инициирует удаление одного или нескольких объектов массовых данных через интерфейс SovdBulkData. Если удаление хотя бы одного элемента завершается неудачно, платформа создает экземпляр DeletionError [SWS_DM_01844].

Вызывающая сторона принимает объект ошибки и анализирует обе открытые переменные (AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 «Public Member Variables»):

• item: по BulkDataMetaDataDescriptor приложение идентифицирует конкретный элемент данных, удаление которого завершилось сбоем [SWS_DM_01845].
• error: на основе ara::core::ErrorCode приложение определяет точную причину сбоя операции удаления [SWS_DM_01846].

На основе этой информации вызывающая логика может реагировать дифференцированно, например регистрировать ошибку в журнале, выбирать альтернативную стратегию очистки или передавать подробную причину ошибки вышестоящему SOVD-клиенту.

Сценарии ошибок

Структура DeletionError сама не генерирует исключений и не сообщает о собственных кодах ошибок, а служит исключительно носителем информации для инкапсуляции сбоев предшествующих операций удаления. Центральная семантика ошибок предоставляется через переменную error типа ara::core::ErrorCode [SWS_DM_01846]. Этот код детально определяет, по какой причине объект массовых данных [SWS_DM_01845], на который ссылается item, не удалось удалить (например, отказ в доступе, заблокированные ресурсы или ошибки файловой системы).

Предварительным условием для целесообразного анализа является то, что переменные item и error были заполнены действительными контекстными данными создающей средой выполнения SovdBulkData. После завершения инспекции структура не требует от разработчика никаких действий по очистке.