구조체 ara::diag::SovdBulkData::DeleteByCategoryResult

구조체 ara::diag::SovdBulkData::DeleteByCategoryResult은(는) SOVD 진단 모듈([SWS_DM_01926])에서 한 범주의 모든 대용량 데이터를 삭제할 때 집계된 결과를 제공합니다. 결과를 성공적으로 삭제된 항목(deleted_items)과 오류 원인을 포함한 실패한 인스턴스(failed_items)로 구분합니다([SWS_DM_01842], [SWS_DM_01843]). 부분적인 성공을 결정론적으로 처리하려면 호출자가 두 목록을 모두 평가해야 합니다.

자세히 ›

컨텍스트

구조체 ara::diag::SovdBulkData::DeleteByCategoryResult은(는) Service-Oriented Vehicle Diagnostics(SOVD) 대용량 데이터 관리([SWS_DM_01926], AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Struct: DeleteByCategoryResult”) 영역의 “Delete All Bulk Data Defined by Category” 메서드에 대한 표준화된 결과 형식 역할을 합니다. AUTOSAR Adaptive 진단 모듈(diag)에서는 로그 파일, 추적 기록 또는 측정 시리즈와 같은 대용량 데이터를 시맨틱 범주에 할당할 수 있습니다. 진단 클라이언트가 인터페이스 ara::diag::SovdBulkData을(를) 통해 특정 범주의 모든 인스턴스 삭제를 요청하면, 이 데이터 구조는 작업의 전체 상태를 요약합니다(AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Definition of API class ara::diag::SovdBulkData::DeleteByCategoryResult”).

상호작용 파트너로는 일반적으로 외부 SOVD 클라이언트 또는 진단 애플리케이션, 기능 진단 인터페이스 ara::diag::SovdBulkData 및 대용량 데이터를 위한 내부 영속성 하위 시스템이 등장합니다. 결과 객체는 영향을 받는 모든 데이터 객체의 상태를 집계하여 동기 또는 비동기 실행 단위와 이를 평가하는 클라이언트 간의 경계를 연결합니다.

수명 주기

헤더 #include "ara/diag/sovd_bulk_data.h"의 클래스 정의에 따르면 이는 자체적인 복잡한 상태 로직이 없는([SWS_DM_01842], [SWS_DM_01843]) 수동적인 데이터 구조(struct)입니다. 생성은 범주 관련 대용량 데이터 삭제가 완료된 직후 진단 런타임 환경에 의해 서버 측에서 수행됩니다. 이때 멤버 변수 deleted_items 및 failed_items은(는) 각각의 디스크립터 및 오류 객체로 채워집니다.

순수 데이터 전송 구조이므로 Adaptive Platform 컨텍스트에서 호출 측으로의 전달은 값(Value) 또는 이동 시맨틱(예: 비동기 결과 컨테이너에 패키징됨)을 통해 이루어질 것으로 보입니다. 질문 Q-bafa9fbd3ae683c1 (열림) 이때 소유권은 호출자에게 완전히 이전됩니다. 객체의 소멸 및 포함된 ara::core::Vector 인스턴스의 메모리 해제는 호출자의 유효 범위(Scope)를 벗어날 때 결정론적으로 발생합니다. 인스턴스 수준에서는 공유 동시성이 존재하지 않으며, 서로 다른 범주에 대한 병렬 삭제 요청은 서로 독립적인 인스턴스를 생성합니다.

사용 경로

일반적인 사용 흐름에는 삭제 시작, 진단 서비스에 의한 실행, 호출자에 의한 결과 객체의 분리 평가가 포함됩니다:

1. 진단 클라이언트가 범주별 삭제 메서드를 통해 연결된 모든 대용량 데이터의 삭제를 요청합니다.
2. 서버는 지정된 범주의 인스턴스를 반복하며 삭제 작업을 수행합니다.
3. 성공적으로 삭제된 항목은 목록 deleted_items에 기록됩니다([SWS_DM_01842]).
4. 실패한 인스턴스는 각 오류 이유와 함께 failed_items에 수집됩니다([SWS_DM_01843]).
5. 집계된 DeleteByCategoryResult이(가) 호출자에게 반환되며([SWS_DM_01926]), 호출자는 성공적인 삭제를 확인하고 발생 가능한 오류를 평가합니다.

시퀀스 다이어그램: 요청부터 집계 및 평가에 이르는 카테고리별 대량 데이터 삭제 흐름. 출처: [SWS_DM_01926], [SWS_DM_01842], [SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Struct: DeleteByCategoryResult”.

오류 시나리오

대량 데이터 삭제의 핵심적 특징은 부분적 성공 가능성입니다. 하나의 카테고리가 다수의 독립적인 레코드를 묶을 수 있으므로, 개별 오류가 발생하더라도 전체 작업이 반드시 실패하는 것은 아닙니다. 호출자 관점에서 두 개의 개별 벡터로 분할된다는 것은 아마도 원자적 롤백 없이 부분적인 처리가 수행됨을 의미합니다. 질문 Q-35307a7eccf0afa9 (열림)

개별 레코드의 삭제 오류는 ara::core::Vector<DeletionError> 형식으로 타입 정의된 failed_items 요소를 통해 전달됩니다([SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3.1.2 “failed_items”). 호출자는 완전한 성공 메시지를 위한 사전 조건으로 failed_items.empty()가 참인지 확인해야 합니다. 목록에 요소가 포함되어 있는 경우, 영향을 받는 각 대량 데이터 인스턴스에 대해 특정한 삭제 오류(예: 활성 읽기 접근으로 인한 잠금 또는 불충분한 권한)를 분석할 수 있습니다. 동시에 deleted_items는 개별 오류가 존재함에도 불구하고 삭제할 수 있었던 모든 레코드를 안정적으로 문서화합니다([SWS_DM_01842]).