구조체 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]). 순수 값 객체로서, 호출자가 실패한 정리 작업을 구체적으로 식별하고 원인을 분석하는 데 사용됩니다.

자세히 ›

컨텍스트

데이터 구조체 [SWS_DM_01844]는 AUTOSAR Adaptive의 SOVD(Service-Oriented Vehicle Diagnostics) 프레임워크 내에서 대량 데이터(Bulk Data) 삭제 프로세스 중에 발생하는 개별 오류를 설명합니다(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 자체는 예외를 발생시키지 않으며 자체 오류 코드를 보고하지 않고, 이전 삭제 작업의 실패를 캡슐화하기 위한 정보 전달자로만 작동합니다. 핵심 오류 의미론은 ara::core::ErrorCode 타입의 변수 error를 통해 제공됩니다([SWS_DM_01846]). 이 코드는 item가 참조하는 대량 데이터 객체 [SWS_DM_01845]를 삭제할 수 없었던 이유(예: 접근 거부, 잠긴 리소스 또는 파일 시스템 오류)를 자세히 명시합니다.

의미 있는 평가를 위한 사전 조건으로서, 변수 item 및 error은 이를 생성하는 SovdBulkData 런타임 환경에 의해 유효한 컨텍스트 데이터로 채워져 있어야 합니다. 검사가 완료된 후 개발자가 구조체에 대해 수행해야 하는 정리 작업은 없습니다.