구조체 ara::tsync::UserData

구조체 ara::tsync::UserData은(는) 동기화된 시간 기준의 맥락에서 컴팩트한 애플리케이션별 페이로드를 전송하는 데 사용됩니다. 이 구조체는 kMaxUserDataSize을(를) 통해 정의된 변경할 수 없는 상한인 3바이트를 갖는 정적 버퍼를 관리합니다 [SWS_TS_14231]. 애플리케이션은 배열에 페이로드를 쓰고 필드 size [SWS_TS_14232]을(를) 통해 실제 유효한 바이트 수를 표시합니다. 핵심 경계 조건으로서 애플리케이션 프로그램 로직은 size이(가) 지정된 최대 용량을 절대 초과하지 않도록 보장하고 초기화되지 않은 버퍼 영역에 대한 접근을 방지해야 합니다.

자세히 ›

컨텍스트

데이터 구조체 ara::tsync::UserData은(는) 동기화된 시간 기준의 맥락에서 애플리케이션별 페이로드를 캡슐화하기 위해 AUTOSAR Adaptive Platform의 시간 동기화(tsync) 기능 클러스터 내에서 사용됩니다. 구조체는 헤더 파일 ara/tsync/synchronized_time_base_status.h에 선언되어 있습니다. 이 구조체의 기본 책임은 시간 정보와 함께 전송되거나 평가되는 애플리케이션 부가 데이터를 위해 컴팩트하고 정적으로 크기가 지정된 메모리 영역을 제공하는 것입니다. 이러한 페이로드의 최대 크기는 정적 상수 kMaxUserDataSize에 의해 정확히 3바이트로 정의되어 있습니다 [SWS_TS_14231]. 실제 페이로드 바이트를 버퍼링하기 위해 타입 ara::core::Array<ara::core::Byte, kMaxUserDataSize>의 배열 data이(가) 사용됩니다 [SWS_TS_14233]. 이 버퍼는 버퍼 내 실제 유효한 페이로드 바이트 수를 나타내는 필드 size에 의해 보완됩니다 [SWS_TS_14232]. 해석: 헤더 ara/tsync/synchronized_time_base_status.h의 정의 위치로 미루어 볼 때 UserData은(는) 주로 제어 플래그나 카운터와 같은 작은 애플리케이션 관련 추가 정보를 전송하기 위한 상태 필드 역할을 할 것으로 추정됩니다. 상호작용 파트너로는 일반적으로 동기화된 시간 기준의 상태를 쿼리하거나 전달하는 시간 제공 서비스와 수신 애플리케이션이 나타납니다. 질문 Q-a0fb20686141f042 (열림)

수명 주기

일반적인 C++ 구조체(Value Object)로서 UserData은(는) 복잡한 내부 라이프사이클을 갖지 않으며 동적 메모리 할당을 전혀 사용하지 않습니다. 인스턴스는 대개 스택에 생성되거나 상위 상태 구조체의 임베디드 데이터 요소로 생성됩니다. 초기화는 멤버 초기화 또는 표준 C++ 대입을 통해 직접 수행됩니다. 소유권과 관련하여 구조체는 값 시맨틱을 따릅니다. 생성 컴포넌트는 로컬 인스턴스를 완전히 소유하며 복사 또는 참조를 통해 인터페이스에 전달합니다. UserData은(는) 내부 동기화 메커니즘이나 뮤텍스 락을 구현하지 않으므로, 여러 스레드에서 동일한 인스턴스에 대한 동시 읽기 및 쓰기 접근은 스레드 안전하지 않습니다. 애플리케이션은 외부 동기화 조치를 통해 동시 접근을 보호해야 하는 반면, 서로 독립적인 인스턴스는 동시성 컨텍스트에서 위험 없이 사용될 수 있습니다. 포함된 데이터 필드 data [SWS_TS_14233]이(가) 정적으로 예약되어 있으므로 소멸 시 리소스의 명시적인 정리가 필요하지 않습니다.

사용 경로

전형적인 사용 경로는 데이터 버퍼의 채우기, 전달 및 평가로 구성됩니다. 먼저 송신 또는 상태 제공 컴포넌트가 UserData의 인스턴스를 생성합니다. 이어서 페이로드가 배열 data로 복사되며, 이때 최대 kMaxUserDataSize바이트까지 점유될 수 있습니다 [SWS_TS_14231], [SWS_TS_14233]. 직후에 해당 컴포넌트는 필드 size를 실제로 기록된 바이트 수로 설정합니다 [SWS_TS_14232]. 수신측에서는 처리 애플리케이션이 먼저 size의 값을 검사합니다 [SWS_TS_14232]. size이 0보다 크면, 애플리케이션은 버퍼 data [SWS_TS_14233]에서 정확히 이 유효한 접두사를 읽어냅니다. 정의되지 않았거나 오래된 잔여 데이터를 포함할 수 있으므로, 이 범위를 벗어나는 값, 즉 인덱스 size부터 kMaxUserDataSize - 1까지의 값은 무시됩니다.

오류 시나리오

UserData에서 오류 상황은 주로 크기 지정과 버퍼 용량 간의 불일치로 인해 발생합니다. 필드 size이 정의된 최대 크기 kMaxUserDataSize인 3바이트를 초과하는 값을 가질 경우 [SWS_TS_14231], 명세 한계 위반이 발생합니다. 이러한 경우 data [SWS_TS_14233]를 반복적으로 읽어올 때 버퍼 오버플로 또는 정의된 배열 범위를 벗어난 접근이 발생할 위험이 있습니다. 또 다른 위험은 size이 0일 때 data을 잘못 읽어내는 데서 발생하는데 [SWS_TS_14232], 이 상태에서는 유효한 페이로드가 존재하지 않기 때문입니다. 오류 코드나 예외는 구조체 자체에서 생성되지 않으므로, 사전 조건(특히 size <= kMaxUserDataSize)의 유효성 검증은 전적으로 사용하는 프로그램 로직의 책임입니다.