클래스 ara::com::ServiceVersionType

클래스 ara::com::ServiceVersionType은 AUTOSAR Adaptive Platform([SWS_CM_11515])에서 서비스 버전의 표준화된 표현 및 관리에 사용됩니다. 애플리케이션은 동등성 및 순서 비교를 통한 호환성 검사, 컨테이너 내 저장, ToString()([SWS_CM_11519])를 통한 로깅에 인스턴스를 활용합니다. 정확한 타입은 Communication Management 제공업체에 의해 오버라이드될 수 있으나, 기본적인 C++ 비교 및 할당 요구사항을 충족해야 합니다. 사용 시 클래스의 모든 멤버 함수가 명세상 예외 안전하지 않은 것으로 분류되어 있다는 점에 유의해야 합니다.

자세히 ›

컨텍스트

클래스 ara::com::ServiceVersionType은 헤더 ara/com/service/service_version.h(AUTOSAR_AP_SWS_CommunicationManagement §8.11 “Header: ara/com/service/service_version.h”)에서 통신 서비스의 버전([SWS_CM_11515])을 정의합니다. 기본 책임은 응용 소프트웨어가 서비스 버전을 다룰 수 있도록 하여, 이러한 버전 정보를 저장, 관리, 비교 및 로깅할 수 있게 하는 것입니다([SWS_CM_11515]).

아키텍처적 특성은 플랫폼의 유연성에 있습니다. [SWS_CM_11515]에 따라 구체적인 데이터 타입은 Communication Management의 소프트웨어 제공업체에 의해 오버라이드되거나 확장될 수 있습니다. 그럼에도 불구하고 이식 가능한 애플리케이션에서 일관된 처리를 보장하기 위해, 명세에서는 이 타입이 ISO/IEC 14882:2014에 따른 C++ 표준 개념인 [equalitycomparable]([SWS_CM_11516]), [lessthancomparable]([SWS_CM_11517]) 및 [copyassignable]([SWS_CM_11518])을 최소한 충족할 것을 요구합니다.

상호작용 파트너에는 Communication Management Software Provider 외에도 버전을 정적 상수 serviceVersion으로 제공하는 서비스 인터페이스(AUTOSAR_AP_SWS_CommunicationManagement 320쪽) 및 버전 비교를 수행하는 응용 소프트웨어가 포함됩니다.

컨텍스트 다이어그램: Software Provider, 서비스 인터페이스 및 애플리케이션 사이의 ara::com::ServiceVersionType 임베딩. 출처: [SWS_CM_11515], AUTOSAR_AP_SWS_CommunicationManagement 320쪽, AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 “Class: ServiceVersionType”.

수명 주기

ara::com::ServiceVersionType의 인스턴스는 정규 값 타입(Value Types)으로 설계되었습니다. 생성 및 값 인수는 복사 및 할당을 통해 이루어집니다. 할당 연산자 operator=을 통해 [copyassignable] 요구사항이 충족되어([SWS_CM_11518]), 인스턴스가 새로운 값을 인수할 수 있습니다.

소유권 관계 측면에서 ara::com::ServiceVersionType은 해당 호출자의 스코프에 종속되거나 서비스 정의의 상수로 유지됩니다(AUTOSAR_AP_SWS_CommunicationManagement 320쪽). 이 타입은 복잡한 내부 상태 머신을 갖지 않고 개별 버전 값을 캡슐화합니다. 파괴는 스코프를 벗어날 때 자동으로 수행됩니다.

동시성과 관련하여 읽기 연산인 operator==([SWS_CM_11516]), operator<([SWS_CM_11517]) 및 ToString([SWS_CM_11519])는 const로 선언되어 있습니다. 해석: 여러 스레드에서 동일한 인스턴스에 대한 동시 읽기 접근은 동기화 없이도 안전할 것으로 추정되는 반면, 병렬 쓰기 및 할당 작업은 외부에서 보호되어야 합니다. 질문 Q-9582ce9a82b9b833 (열림)

사용 경로

애플리케이션에서 ara::com::ServiceVersionType을 사용하는 일반적인 절차는 다음 단계로 구성됩니다:

1. 버전 조회: 애플리케이션은 예를 들어 인터페이스의 정적 상수 serviceVersion을 통해 서비스의 버전 정보에 접근합니다(AUTOSAR_AP_SWS_CommunicationManagement 320쪽).
2. 호환성 검사: 애플리케이션은 operator==([SWS_CM_11516])을 통해 버전을 기대 버전과 비교합니다. 순서 검사나 정렬된 표준 컨테이너에 저장하기 위해 operator<가 사용됩니다([SWS_CM_11517]).
3. 관리 및 저장: 버전 상태의 전달 또는 로컬 저장을 위해 애플리케이션은 할당 연산자 operator=([SWS_CM_11518])을 사용합니다.
4. 로깅: 진단 메시지 또는 로그 출력을 위해 애플리케이션은 메서드 ToString()을 통해 ara::core::StringView 형태의 텍스트 표현을 생성합니다([SWS_CM_11519], AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 “ToString”).

오류 시나리오

인터페이스 사용 시 특정 제약 조건을 준수해야 합니다:

• 예외 안전성: 명세된 모든 함수(operator=([SWS_CM_11518]), operator==([SWS_CM_11516]), operator<([SWS_CM_11517]), ToString([SWS_CM_11519]))는 명세에서 명시적으로 not exception safe로 선언되어 있습니다. 애플리케이션은 오류 발생 시(예: 공급업체별 구현에서의 메모리 할당 시) 자동 복구 보장에 의존해서는 안 됩니다.
• StringView 유효성: 메서드 ToString()은 ara::core::StringView을 반환합니다([SWS_CM_11519]). 해석: StringView는 자체 메모리를 관리하지 않으므로, 참조된 문자열의 수명은 기본 인스턴스 또는 정적 메모리에 연결되어 있을 것으로 추정되며, 데이터 소스의 유효성을 벗어난 사용은 정의되지 않은 동작으로 이어집니다. 질문 Q-fdb6e821db46af00 (열림)