구조체 ara::diag::DiagnosticSovdContentData

구조체 ara::diag::DiagnosticSovdContentData은(는) AUTOSAR Adaptive([SWS_DM_02385])에서 SOVD 서비스를 위한 진단 콘텐츠를 캡슐화하는 표준화된 데이터 컨테이너 역할을 합니다. 이 구조체는 작업 및 상태 응답 시 Diagnostic Management가 SOVD 속성 parameters을(를) 생성하는 데 사용하는 콘텐츠 요소의 공개 벡터([SWS_DM_02386])에 페이로드를 유지합니다. 순수 값 전달 객체로서 이 구조체는 내부 스레드 동기화를 제공하지 않으므로, 동시 수정은 애플리케이션 내부에서 보호되어야 합니다.

자세히 ›

컨텍스트

데이터 구조체 ara::diag::DiagnosticSovdContentData은(는) AUTOSAR Adaptive Platform의 진단 모듈(diag)의 일부이며 헤더 ara/diag/diagnostic_sovd_content_data.h에 선언되어 있습니다 (AUTOSAR_AP_SWS_Diagnostics §8.59 “Header: ara/diag/diagnostic_sovd_content_data.h”, [SWS_DM_02385]). 이는 ASAM SOVD에 따른 서비스 지향 차량 진단에서 진단 콘텐츠를 캡슐화하기 위한 표준화된 데이터 캐리어 역할을 합니다.

플랫폼 내에서 이 구조체는 진단 서버(Diagnostic Management, DM)와 Adaptive Application의 서비스 제공자 사이를 중개합니다 ([SWS_DM_01396], [SWS_DM_02174]). 외부 SOVD 클라이언트에 의해 작업 또는 상태 쿼리가 트리거되면 DM은 구현 소프트웨어 컴포넌트로 호출을 위임합니다. 생성된 출력 데이터는 애플리케이션에 의해 DiagnosticSovdContentData의 인스턴스에 저장됩니다 ([SWS_DM_02386]). 그런 다음 DM은 이 콘텐츠를 SOVD 응답 본문, 구체적으로는 표준화된 속성 parameters(으)로 변환합니다 ([SWS_DM_02176], [SWS_DM_02181]).

컨텍스트 다이어그램: SOVD 클라이언트, Diagnostic Management 및 진단 서비스 제공자 간의 데이터 교환에서 DiagnosticSovdContentData의 임베딩. 출처: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02385], [SWS_DM_02386].

수명 주기

C++ struct(으)로서의 정의(AUTOSAR_AP_SWS_Diagnostics §8.59.1.1 “Public Member Variables”, [SWS_DM_02385])는 DiagnosticSovdContentData에 데이터 컨테이너의 역할을 부여합니다. 이 구조체는 개별 콘텐츠 요소가 동적으로 관리되는 ara::core::Vector<DiagnosticSovdContentElementData> 타입의 공개 멤버 변수 elements을(를) 갖습니다 ([SWS_DM_02386]).

인스턴스 생성은 일반적으로 응답을 위한 진단 데이터가 구성되는 즉시 서비스 제공자 메서드 내에서 로컬로 수행됩니다. Read(AUTOSAR_AP_SWS_Diagnostics §8.x “Read”)과 같은 비동기 인터페이스의 경우 객체는 ara::core::Future<DiagnosticSovdContentData> 내에 캡슐화됩니다. 해석: 이때 구조체는 값 전달 또는 이동 시맨틱을 통해 호출자의 소유로 넘어가며, 이에 따라 수명은 이를 처리하는 Future 객체에 바인딩될 것으로 추정됩니다. 질문 Q-564c59896de41f85 (열림)

동시성 측면에서 이 구조체는 내부 동기화 프리미티브를 포함하지 않습니다. 해석: 순수 값 전달 객체(Value Object)이므로 내부 스레드 보호가 존재하지 않을 것으로 보이며, 따라서 동일한 인스턴스에 대한 동시 접근은 호출하는 애플리케이션 로직에 의해 동기화되어야 합니다. 질문 (열림) 인스턴스 소멸은 관리 컨텍스트의 유효 범위를 벗어날 때 자동으로 이루어집니다.

사용 경로

DiagnosticSovdContentData의 기본 사용 경로는 동기식 작업 실행 및 SOVD 프레임워크의 상태 쿼리 시 페이로드를 제공하는 것입니다:

1. 외부 SOVD 클라이언트가 차량에 ASAM SOVD에 따른 작업 시작 요청을 전송합니다 ([SWS_DM_01396]).
2. 경계 조건을 검증한 후 Diagnostic Management는 ara::diag::GenericDiagnosticSovdOperation::StartExecution을(를) 통해 담당 작업으로 실행을 위임합니다 ([SWS_DM_02174]).
3. 서비스 애플리케이션은 진단 작업을 실행하고, DiagnosticSovdContentData을(를) 인스턴스화하며, 생성된 요소 데이터로 멤버 elements을(를) 채웁니다 ([SWS_DM_02386]).
4. 객체는 동기식 실행을 위한 반환값의 일부로 Diagnostic Management에 전달됩니다 ([SWS_DM_02176]).
5. Diagnostic Management는 DiagnosticSovdContentData에서 값을 읽어 SOVD 응답 본문의 속성 parameters에 전송하고 클라이언트에 응답을 전송합니다 ([SWS_DM_02176]).

SovdOperationExecution::GetStatus([SWS_DM_02180])을 통한 상태 쿼리에도 유사한 경로가 적용되며, 이때 속성 parameters 역시 전달된 DiagnosticSovdContentData에서 파생됩니다 ([SWS_DM_02181]). 마찬가지로 콘텐츠 제공자도 Read을(를) 통해 동일한 구조체를 반환 타입으로 사용합니다 (AUTOSAR_AP_SWS_Diagnostics §8.x “Read”).

시퀀스 다이어그램: 동기식 작업 실행 시 DiagnosticSovdContentData를 통한 페이로드 제공. 출처: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02386].