구조체 ara::diag::SovdBulkData::BulkDataMetaDataDescriptor

구조체 ara::diag::SovdBulkData::BulkDataMetaDataDescriptor은(는) AUTOSAR Adaptive에서 SOVD 진단 통신을 위한 대용량 데이터를 설명하는 데이터 전송 객체 역할을 합니다([SWS_DM_01830]). 이 구조체는 id, file_name, mimetype과(와) 같은 식별, 로컬라이제이션 및 타입 정보뿐만 아니라 체크섬 및 선택적 크기 정보를 번들로 제공합니다(SWS Diagnostics §8.53.2 “Struct: BulkDataMetaDataDescriptor”). 인스턴스는 데이터를 제공하는 진단 애플리케이션에 의해 메타데이터로 채워진 후 SOVD 서브시스템으로 전달됩니다. 자체 동기화가 없는 패시브 C++ 구조체이므로 동시 쓰기 액세스는 호출 애플리케이션에 의해 외부적으로 보호되어야 합니다.

자세히 ›

컨텍스트

데이터 구조체 ara::diag::SovdBulkData::BulkDataMetaDataDescriptor은(는) AUTOSAR Adaptive Platform의 diag 모듈의 일부이며 헤더 #include "ara/diag/sovd_bulk_data.h"을(를) 통해 제공됩니다([SWS_DM_01830]). 이 구조체는 SOVD(Service-Oriented Vehicle Diagnostics) 프레임워크 내에서 전송되는 진단 대용량 데이터(Bulk Data)를 위한 메타데이터 디스크립터를 정의합니다(SWS Diagnostics §8.53.2 “Struct: BulkDataMetaDataDescriptor”). 대규모 로그 파일, 트레이스 버퍼 또는 업데이트 패키지 읽기와 같은 진단 시나리오에서 진단 클라이언트는 바이너리 데이터 스트림 외에도 구조화된 부가 정보가 필요합니다. 이 구조체는 고유한 식별, 해석 및 무결성 검증을 위해 이러한 메타데이터를 번들로 묶습니다.

진단 애플리케이션, 런타임 시스템 ara::diag 및 외부 진단 테스터 간의 상호 작용에서 이 구조체는 패시브 데이터 전송 객체(DTO) 역할을 합니다. id 필드는 대용량 데이터의 고유 식별자를 정의합니다([SWS_DM_01831]). 명명과 관련하여 파일 이름을 위한 file_name([SWS_DM_01836]), 논리적 명칭을 위한 name([SWS_DM_01833]), 로컬라이제이션 목적을 위한 translation_id([SWS_DM_01834])이 제공됩니다. 미디어 타입은 mimetype에 의해 선언됩니다([SWS_DM_01832]). 무결성 보장은 hash([SWS_DM_01839]) 및 hash_algorithm([SWS_DM_01840])이 담당하며, creation_date([SWS_DM_01837]) 및 last_modified([SWS_DM_01838])은 시간적 분류를 정의합니다(SWS Diagnostics §8.53.2.1 “Public Member Variables”).

수명 주기

C++ 구조체로서 BulkDataMetaDataDescriptor은(는) 자체 비즈니스 로직 생성자 없이 순수 퍼블릭 속성만 갖습니다([SWS_DM_01830]). 해석: 이 구조체는 주로 데이터를 제공하는 진단 애플리케이션에 의해 스택 또는 힙에서 값 객체로 인스턴스화되고 채워진 후 SOVD 서브시스템으로 전달될 것으로 보입니다. 수명 주기는 일반적인 C++ 객체 규칙을 따릅니다. 인스턴스가 소멸될 때 ara::core::String 타입의 포함된 멤버와 선택적 크기 필드 ara::core::Optional<std::uint64_t>이(가) 결정론적으로 해제됩니다([SWS_DM_01835]). 질문 Q-4a0434afda63d047 (열림)

구조체 자체에는 내부 상태나 상태 전이가 없습니다. 멀티스레딩 환경에서 인스턴스를 동시 읽기하는 것은 안전하지만, 내장된 보호 메커니즘이 존재하지 않으므로 공용 변수에 대한 쓰기 액세스는 호출 애플리케이션에서 외부적으로 동기화해야 합니다.

사용 경로

SOVD 대량 전송 프레임워크 내에서 메타데이터 디스크립터를 사용하기 위한 일반적인 호출 순서는 다음 단계로 구성됩니다:

1. 인스턴스화: 진단 애플리케이션이 BulkDataMetaDataDescriptor([SWS_DM_01830])의 인스턴스를 생성합니다.
2. 식별 및 이름 할당: 대량 데이터 객체는 id([SWS_DM_01831]), name([SWS_DM_01833]) 및 file_name([SWS_DM_01836])를 통해 기술됩니다. 필요한 경우 translation_id이 저장됩니다([SWS_DM_01834]).
3. MIME 유형 및 타임스탬프 채우기: 형식은 mimetype을 사용하여 정의됩니다([SWS_DM_01832]). 날짜 정보인 creation_date([SWS_DM_01837]) 및 last_modified([SWS_DM_01838])는 실제 적용 시 ISO-8601 규격의 타임스탬프 문자열로 포맷될 것으로 보입니다. 질문 Q-fa352dc221e9452a (열림)
4. 검사 값 및 바이트 크기 수집: 페이로드 생성 후 체크섬은 hash([SWS_DM_01839])에, 알고리즘은 hash_algorithm([SWS_DM_01840])에 입력됩니다. 바이트 수가 사전에 알려진 경우 size가 채워집니다([SWS_DM_01835]). 이 선택적 필드가 비어 있으면 제공 시점에 파일 크기가 아직 가변적임을 나타내는 것으로 추정됩니다. 질문 Q-03f717e53701c9c0 (열림)
5. SOVD 서브시스템으로 전달: 외부 SOVD 클라이언트가 메타데이터를 검색할 수 있도록 초기화된 디스크립터가 ara::diag으로 전달됩니다.

시퀀스 다이어그램: SOVD 진단 컨텍스트에서 BulkDataMetaDataDescriptor의 생성, 채우기 및 제공에 대한 일반적인 흐름. 출처: SWS Diagnostics §8.53.2 “Struct: BulkDataMetaDataDescriptor”, [SWS_DM_01830].

오류 시나리오

BulkDataMetaDataDescriptor은 수동 데이터 구조이므로 구조체에서 오류 코드가 직접 반환되지 않습니다. 오류는 ara::diag 또는 클라이언트에 의한 후속 처리 중에 나타납니다:

• 체크섬 불일치: hash([SWS_DM_01839])에 지정된 해시가 실제 콘텐츠와 일치하지 않거나 hash_algorithm([SWS_DM_01840])를 알 수 없는 경우 클라이언트 측 검증이 실패합니다.
• 바이트 크기 차이: 선택적 필드 size([SWS_DM_01835])이 설정되어 있고 실제로 수신된 바이트 수와 다른 경우 수신측에서 전송 오류를 보고합니다.
• 유효하지 않은 미디어 유형: mimetype([SWS_DM_01832])이 잘못되었거나 비어 있으면 클라이언트 툴에서 해석 오류가 발생합니다.
• 필수 식별자 누락: id([SWS_DM_01831]) 또는 file_name([SWS_DM_01836])이 지정되지 않은 경우 SOVD 프레임워크 내에서 데이터 레코드를 고유하게 지정할 수 없습니다.