클래스 <SI-Namespace>::skeleton:: events::<Event>

메서드 Allocate은(는) Communication Management(ara::com)가 데이터 관리를 담당할 때 이벤트 데이터 전송을 위한 메모리를 할당하기 위해 이벤트에 대한 Skeleton 레벨에서 호출됩니다 ([SWS_CM_90438]; AUTOSAR_AP_EXP_ARAComAPI §5.4.1 “Skeleton Class API’s”; [SWS_CM_90438]). 이 메서드는 ara::com::SampleAllocateePtr<SampleType> 타입의 인스턴스를 반환합니다 ([SWS_CM_90438]). 이 포인터 타입은 개념적으로 std::unique_ptr<T>처럼 동작하므로 어느 시점에서든 하나의 주체만 포인터를 소유합니다 (ARAComAPI §6 “Event Allocate/Send sample Binding implementer hint”).

오류 처리 및 예외 안전성과 관련하여 Allocate은(는) not exception safe로 명시되어 있습니다 ([SWS_CM_90438]). 사양에는 두 가지 가능한 위반 사항(Violations)이 정의되어 있습니다:

• SampleAllocationViolation: 데이터를 할당하기에 충분한 메모리 리소스가 없습니다 ([SWS_CM_90438]).
• AllocateUsageViolation: 사용자 정의 할당자를 통해 잘못 할당되었습니다 ([SWS_CM_90438]).

Allocate 이면의 개념은 주로 판독기와 기록기 간의 엄격한 동기화를 전제로 하는 공유 메모리 기반 IPC 전송을 중심으로 Zero-Copy 메커니즘을 지원하는 것을 목표로 합니다 (ARAComAPI §6 “Event Allocate/Send sample Binding implementer hint”). 구현자는 배포 시 데이터 타입이 바이너리 호환되도록 구성되지 않았거나 감지 로직에 의해 배제되는 경우 직렬화 요구사항으로 인해 Zero-Copy가 무효화될 수 있음을 유의해야 합니다 (ARAComAPI §6 “Event Allocate/Send sample Binding implementer hint”).

이벤트 전송과의 상호 작용에서 Allocate을(를) 통해 얻은 메모리 포인터는 Send(ara::com::SampleAllocateePtr<SampleType> data)에 전달됩니다 ([SWS_CM_90437]). Send 호출 후에는 Communication Management가 구독 중인 모든 애플리케이션에 데이터를 전송하면 서비스 애플리케이션은 더 이상 데이터에 접근해서는 안 됩니다 ([SWS_CM_90437]).

[SWS_CM_00162] 함수는 서비스 제공자 측 <SI-Namespace>::skeleton::events::<Event> 내에서 모든 구독 애플리케이션으로 이벤트 데이터를 전송하는 데 사용됩니다. 이 변형에서는 데이터 할당에 대한 책임이 전적으로 사용하는 애플리케이션에 남아 있습니다. 매개변수 data을(를) 통해 데이터 객체가 전달되며, 이에 따라 바인딩 구현은 호출 중에 내부 복사본을 생성합니다(ARAComAPI, Figure 6.17 “BrakeEvent Class”). 동기식 메서드 호출이 반환된 후 애플리케이션은 원래 메모리 영역을 즉시 수정하거나 해제할 수 있습니다.

해당 메서드는 noexcept(으)로 선언되어 있으며 예외에 안전한 것으로 명시되어 있습니다. 성공 시 void를 포함하고 오류 시 [SWS_CM_10432]의 오류 코드를 보고하는 ara::core::Result<void>을(를) 반환합니다([SWS_CM_00162]):

• ComErrc::kServiceNotOffered: 서비스 인스턴스가 아직 OfferService()을(를) 통해 제공되지 않은 경우 발생합니다.
• ComErrc::kMinimumSendIntervalViolationError: 전송 요청이 구성된 최소 전송 간격(ServiceInterfaceDeploymentElement.minimumSendInterval)보다 빠르게 발행된 경우 발생합니다.

Allocate()을(를) 통해 획득한 ara::com::SampleAllocateePtr 타입의 포인터를 필요로 하는 제로 카피 대안 [SWS_CM_90437]과 달리, 이 호출은 프레임워크에 대한 메모리 바인딩을 필요로 하지 않습니다. [SWS_CM_00119]에 따라 동일한 전송 동작 및 동일한 오류 조건이 필드의 업데이트 메서드 Update에도 적용됩니다.

사용법 및 호출 컨텍스트

Send 메서드는 서비스 스켈레톤(<SI-Namespace>::skeleton::events::<Event>)의 이벤트 인스턴스에서 호출됩니다([SWS_CM_90437]). 메모리 관리를 Communication Management가 담당하는 이벤트 데이터를 전송합니다. ara::com::SampleAllocateePtr<SampleType> 타입의 매개변수 data은(는) 이전에 Allocate()을(를) 통해 획득된 것이어야 합니다([SWS_CM_90437]). 이 포인터 타입은 의미상 std::unique_ptr처럼 동작하여 호출 시 데이터 소유권이 통신 계층으로 이전됩니다(ARAComAPI §6.17 “BrakeEvent Class”). 전달 후 송신 애플리케이션의 데이터에 대한 추가 접근은 모두 금지됩니다([SWS_CM_90437]).

오류 처리 및 제약 조건

해당 함수는 noexcept(으)로 선언되어 있으며 ara::core::Result<void>을(를) 반환합니다([SWS_CM_90437]). 전송이 실패하면 결과에 ara::com::ComErrc의 오류 코드가 포함됩니다([SWS_CM_10432]):

• ComErrc::kServiceNotOffered: 관련 서비스가 사전에 OfferService()(으)로 아직 제공되지 않았습니다([SWS_CM_90437]).
• ComErrc::kMinimumSendIntervalViolationError: 서비스 요소에 대해 구성된 최소 전송 간격(minimumSendInterval)이 마지막 전송 이후 아직 경과하지 않았습니다([SWS_CM_90437]).

두 오류 사례 모두 롤백 시맨틱을 갖습니다([SWS_CM_90437]). 따라서 호출 전 서비스가 반드시 제공되어 있어야 하며, 연속적인 전송 호출은 구성된 최소 간격을 준수해야 합니다.

상호 작용 및 최적화

애플리케이션 관리 데이터가 전달되고 Communication Management에 의해 복사되는 [SWS_CM_00162] 시그니처와 비교하여, 이 변형은 공유 메모리를 통한 제로 카피 통신을 목표로 합니다(ARAComAPI §6.18 “Event Allocate/Send sample”). 이 경우 작성자와 판독자 간의 엄격한 동기화가 전제되며 통신 파트너 간의 가능한 직렬화 요구사항을 고려해야 합니다(ARAComAPI §6.18 “Event Allocate/Send sample”).

사용

함수 SetSubscriptionStateChangeHandler은 이벤트의 구독 상태를 모니터링하기 위한 콜백 핸들러를 Skeleton 스코프(skeleton::events)에 등록합니다 [SWS_CM_12008]. 매개변수 handler은 [SWS_CM_00311]에 따른 SubscriptionStateChangeHandler 유형의 호출 가능한 객체여야 합니다. 메서드는 반환값을 제공하지 않으며 noexcept으로 지정되어 있습니다 [SWS_CM_12008].

Communication Management는 이벤트의 구독 상태가 변경되는 즉시 등록된 핸들러를 호출합니다 [SWS_CM_12012]. Skeleton 측에서는 활성 구독 수가 0보다 커지는 즉시 kSubscribed 상태로 [SWS_CM_12013], 또는 활성 구독이 더 이상 없는 경우 kNotSubscribed 상태로 호출됩니다 [SWS_CM_12014] SWS CommunicationManagement §7.5.4 “Query Service Event Subscription State on Skeleton side”.

오류 처리 및 동시성

이 작업은 exception safe으로 분류되어 있습니다 [SWS_CM_12008]. 전달된 Callable이 유효하지 않거나 null인 경우 InvalidHandlerViolation가 존재합니다 [SWS_CM_12008]. 해석: 함수가 예외를 발생시키지도 않고 오류 코드를 반환하지도 않으므로 이 사양 위반은 플랫폼별 런타임 메커니즘을 통해 가로채질 것으로 추정됩니다. 질문 Q-a7b7b54f0d538b40 (열림)

핸들러는 런타임에 덮어쓸 수 있습니다 [SWS_CM_12012]. 전용 스레드 또는 작업 컨텍스트에서의 실행을 위해 템플릿 매개변수 executor을 갖는 오버로드가 존재합니다 [SWS_CM_12009]. 스켈레톤의 트리거 요소를 위한 유사한 등록이 [SWS_CM_01110]에 정의되어 있습니다.

템플릿 함수 SetSubscriptionStateChangeHandler은(는) 스켈레톤 레벨([SWS_CM_12009])의 이벤트 네임스페이스에서 수신되는 구독의 상태 변경을 위한 콜백을 등록하는 데 사용됩니다. Executor가 없는 기본 함수([SWS_CM_12008])와 비교하여, 등록된 핸들러가 실행될 실행 컨텍스트(executor)를 추가로 전달받습니다([SWS_CM_12009]). 이 함수는 반환값이 없으며, noexcept(으)로 선언되어 있고 예외 안전한 것으로 간주됩니다([SWS_CM_12009]).

오류 동작과 관련하여, 유효하지 않거나 null 값을 갖는 Callable을 전달하면 InvalidHandlerViolation이(가) 발생합니다([SWS_CM_12009]). 등록된 핸들러는 애플리케이션 런타임 중에 재호출을 통해 언제든지 덮어쓸 수 있습니다([SWS_CM_12012]).

Communication Management는 해당 이벤트에 대한 구독 상태가 변경되는 즉시 핸들러를 호출합니다(SWS CommunicationManagement §7.5.4 “Query Service Event Subscription State on Skeleton side”, [SWS_CM_12012]):

• 활성 구독 수가 0에서 0보다 큰 값으로 증가하면 상태 kSubscribed(으)로 호출이 수행됩니다([SWS_CM_12013]).
• 활성 구독자 수가 다시 0으로 감소하면 핸들러에 kNotSubscribed(으)로 통지됩니다([SWS_CM_12014]).

해석: executor을(를) 전달함으로써 스켈레톤 코드의 동시성 통지를 내부 통신 스레드와 깔끔하게 분리하기 위해 핸들러의 실행이 애플리케이션 자체의 스레드 또는 디스패칭 컨텍스트에 의도적으로 바인딩될 것으로 보입니다([SWS_CM_12009]). 질문 Q-b11f3bc97069f2ec (열림)

UnsetSubscriptionStateChangeHandler 함수는 네임스페이스 ::skeleton::events::{<event-name>}의 Skeleton 레벨에서 이벤트의 ara::com::SubscriptionState에 대해 이전에 등록된 상태 변경 핸들러의 등록을 취소하는 데 사용됩니다[SWS_CM_12010]. 함수는 전달 매개변수를 받지 않으며 반환값을 반환하지 않습니다(void)[SWS_CM_12010]. 포함은 헤더 #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h"을(를) 통해 이루어집니다[SWS_CM_12010].

예외 동작과 관련하여 해당 메서드는 noexcept(으)로 선언되어 있으며 예외 안전(exception safe)으로 명시되어 있습니다[SWS_CM_12010]. 특정 오류 코드가 반환되거나 C++ 예외가 발생하지 않습니다[SWS_CM_12010]. 해석: 시그니처에 오류 피드백이 제공되지 않으므로, 등록 취소 시의 발생 가능한 내부 오류 상태는 커뮤니케이션 관리에서 내부적으로 가로챌 것으로 보입니다. 질문 Q-7e986a15e552ca19 (열림)

관련 인터페이스와의 상호 작용에서 핸들러 등록 취소를 위한 유사한 함수가 존재합니다:

• Skeleton 레벨에서는 ::skeleton::triggers::{<trigger-name>}::UnsetSubscriptionStateChangeHandler이(가) 트리거를 위한 해당 등록 취소를 제공합니다[SWS_CM_01112].
• Proxy 레벨에서는 네임스페이스 proxy 내에서 이벤트 [SWS_CM_00334], 필드 [SWS_CM_11609] 및 트리거 [SWS_CM_01108]의 상태 변경 핸들러 등록 취소를 위한 동등한 메서드가 존재합니다AUTOSAR_AP_EXP_ARAComAPI §5.3.1 “Proxy Class API’s”.