DEENESPTFRRUARHIKOZHNL

네임스페이스 ara::com

사용자 가이드AI 생성

AUTOSAR Adaptive의 서비스 지향 통신을 위한 기본 타입, 오류 도메인 및 인터페이스를 제공합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 9676f1a12dfa 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

AUTOSAR Adaptive의 서비스 지향 통신을 위한 기본 타입, 오류 도메인 및 인터페이스를 제공합니다.

이 네임스페이스는 Proxy를 통해 서비스 소비자를 연결하고 Skeleton을 통해 서비스 제공자를 연결하여 서비스 지향 통신을 위한 핵심 빌딩 블록을 제공합니다(ARAComAPI §7.6 “meta-model to Implementation”). 상호작용에는 비동기 서비스 검색, Future를 통한 반환을 포함하는 메서드 호출 및 정의된 상태를 통한 이벤트 구독이 포함됩니다([SWS_CM_00310]). 주요 필수 요구사항에는 인스턴스 식별자의 올바른 확인과 구성된 샘플 할당량 및 전송 주기 준수가 포함됩니다([SWS_CM_10432]).

컨텍스트

네임스페이스 ara::com는 AUTOSAR Adaptive Platform 내에서 서비스 지향 통신(Communication Management)을 위한 핵심 타입과 메커니즘을 제공합니다. 아키텍처 모델은 서비스 소비자와 서비스 제공자를 엄격하게 구분합니다. 소비자 측(R-Port)에서 클라이언트 애플리케이션은 생성된 Proxy 인스턴스(ARAComAPI §7.6 “meta-model to Implementation”)를 통해 동작하며, 서버 측의 서비스 제공자는 Skeleton 구현(ARAComAPI §6.2 “Definition of BatteryState”)을 통해 해당 기능을 노출합니다.

Proxy와 Skeleton 사이를 기술 미들웨어(Binding)가 중재합니다. 개별 서비스 인스턴스를 식별하고 구분하기 위해 InstanceIdentifier가 사용되며, InstanceIdentifierContainer를 통해 구체적인 인스턴스의 컬렉션이 관리됩니다([SWS_CM_00319]). 플랫폼은 추상 모델 식별자가 기술 바인딩 및 인스턴스 목록으로 확인되는 멀티 바인딩 시나리오를 지원합니다(ARAComAPI §6.6 “InstanceIdentifier Resolution”).

client Client (ara::com Proxy) binding Communication Management (Binding / Middleware) client->binding Dienstsuche / Methodenaufruf / Event-Abonnement binding->client Future 충족 / 이벤트 전달 skeleton Server (ara::com Skeleton) binding->skeleton Dispatch / Methodenaufruf skeleton->binding Methodenantwort / Event-Bereitstellung

컨텍스트 다이어그램: 서비스 통신 시 Proxy, 미들웨어 Binding 및 Skeleton 간의 상호작용. 출처: ARAComAPI §7.6 “meta-model to Implementation”, ARAComAPI §6.6 “InstanceIdentifier Resolution”, [SWS_CM_10432].

수명 주기

서비스 및 통신 연결은 ara::com에서 명확하게 정의된 상태 모델의 적용을 받습니다. 일반적인 서비스 가용성은 kAvailable 및 kNotAvailable 값을 갖는 열거형 ServiceState을 통해 표현됩니다([SWS_CM_01071]). 상태 변경은 등록된 ServiceStateHandler를 통해 모니터링할 수 있습니다([SWS_CM_01072]).

이벤트(Event) 및 필드의 경우, SubscriptionState은 kNotSubscribed, kSubscriptionPending 및 kSubscribed 상태를 갖는 구독의 라이프사이클을 제어합니다([SWS_CM_00310]). 상태 변경은 SubscriptionStateChangeHandler에 비동기식으로 보고됩니다([SWS_CM_00311]). kNotSubscribed에서 kSubscriptionPending(으)로의 전이는 기본 트랜스포트 바인딩으로 구독 요청을 전송함으로써 즉시 수행되는 것으로 추정됩니다. 질문 Q-60f7ecdf5768217a (열림)

서비스 구현 측면에서 MethodCallProcessingMode은 수신되는 메서드 호출의 동시성을 제어합니다: 수동 폴링을 위한 kPoll, 동시 이벤트 구동 처리를 위한 kEvent, 단일 스레드에서의 순차 처리를 위한 kEventSingleThread([SWS_CM_00301]). 샘플 관리(Samples)는 할당 최적화(예: 공유 메모리를 통한 제로 카피 방식)를 위해 송신자 측에서는 SampleAllocateePtr을(를)([SWS_CM_00308], ARAComAPI §6.18 “Event Allocate/Send sample Binding implementer hint”), 수신자 측에서는 SamplePtr을(를) 사용합니다([SWS_CM_10432]).

사용 경로

서비스 사용을 위한 전형적인 흐름은 다음 단계들을 거쳐 진행됩니다:

  1. 서비스 검색: 컨슈머가 호환 가능한 서비스 인스턴스 검색을 시작합니다. 사용 가능 시 미들웨어는 FindServiceHandler을(를) 통해 검색된 핸들이 포함된 ServiceHandleContainer과 진행 중인 검색을 종료할 수 있는 FindServiceHandle을(를) 전달합니다([SWS_CM_00383], [SWS_CM_00304]).
  2. 프록시 인스턴스화: 적절한 핸들을 사용하여 클라이언트 로컬에 프록시 인스턴스가 생성됩니다(ARAComAPI §6.3 “Handling of optional data elements on Skeleton side”).
  3. 메서드 호출: 메서드 호출은 메서드 래퍼 클래스의 괄호 연산자를 오버로드합니다. 입력 매개변수가 전달되고, 호출은 출력 매개변수를 캡슐화하는 ara::com::Future을(를) 반환합니다(ARAComAPI §6.10 “Adjust Method Class”, ARAComAPI §6.12 “Adjust Method Class”).
  4. 결과 처리: 클라이언트는 결과를 동기 또는 비동기 방식(예: get()을(를) 통해)으로 가져오고, 액세스 전에 선택적 필드 요소의 존재 여부를 확인합니다(ARAComAPI §6.3 “Handling of optional data elements on Skeleton side”).
  5. 이벤트 수신: 구독된 이벤트, 필드 또는 트리거에 대해 도달하는 데이터는 EventReceiveHandler([SWS_CM_00309]), FieldReceiveHandler([SWS_CM_11615]) 또는 TriggerReceiveHandler([SWS_CM_00351])와 같은 등록된 콜백을 통해 처리됩니다.
Service-Interaktion von Dienstsuche bis ErgebnisabfrageAnwendung (Client)ProxySkeleton (Server)Use Case: 서비스 검색 및 인스턴스화FindServiceHandler registrierenServiceHandleContainer liefernProxy(handle) erzeugenUse Case: 메서드 호출 및 FutureMethodenaufruf()Service-Aufruf weiterleitenara::com::Future 반환Ergebnis bereitstellenFuture::get() aufrufenErgebnisdaten liefern

시퀀스 다이어그램: 서비스 검색부터 Future를 사용한 메서드 호출 및 결과 조회까지의 호출 순서. 출처: [SWS_CM_00383], [SWS_CM_00304], ARAComAPI §6.3 “Handling of optional data elements on Skeleton side”, ARAComAPI §6.10 “Adjust Method Class”.

오류 시나리오

통신 서브시스템의 오류 조건은 ComErrorDomain 및 ComErrc의 오류 코드를 통해 매핑됩니다([SWS_CM_10432]). 도메인에 대한 액세스는 GetComErrorDomain()을(를) 통해 수행되며([SWS_CM_11334]), 구체적인 오류는 MakeErrorCode()([SWS_CM_11335])을(를) 통해 인스턴스화됩니다. 예외적인 경우에는 ComException이(가) 발생합니다.

전형적인 오류 시나리오는 다음과 같습니다:

  • 서비스 가용성: 제공되지 않는 서비스에 대한 호출은 ComErrc::kServiceNotOffered 또는 ComErrc::kServiceNotAvailable(으)로 이어집니다([SWS_CM_10432]).
  • 구성 및 인스턴스 확인 오류: 식별자를 InstanceIdentifier에 매핑할 수 없는 경우, 시스템은 ComErrc::kInstanceIDNotResolvable을(를) 보고합니다([SWS_CM_10432], ARAComAPI §6.6 “InstanceIdentifier Resolution”).
  • 리소스 및 구독 한도: 애플리케이션이 Subscribe()에서 합의된 것보다 많은 SamplePtr 인스턴스를 유지하는 경우 ComErrc::kMaxSamplesExceeded이(가) 발생합니다([SWS_CM_10432]). 재구독 시 최대 샘플 수가 일치하지 않으면 ComErrc::kMaxSampleCountNotRealizable의 결과가 발생합니다([SWS_CM_10432]).
  • 프로토콜 및 시간 조건: 네트워크 오류 또는 보안 통신 오류 시 ComErrc::kCommunicationFailure이(가) 보고됩니다. 전송 간격이 미달되는 경우 ComErrc::kMinimumSendIntervalViolationError 오류와 함께 전송이 실패합니다([SWS_CM_10432]).
  • 필드 처리: 초기화되지 않은 필드 값은 ComErrc::kFieldValueNotInitialized(으)로 이어지며, 설정 핸들러가 누락된 경우 ComErrc::kFieldSetHandlerNotSet(으)로 이어집니다([SWS_CM_10432]).

이 가이드는 AUTOSAR Adaptive Platform 릴리스 R25-11의 명세를 기반으로 한다.

주제 맵

KI-gestützte Gruppierung auf Basis der Records und Spezifikationsauszüge; keine Gliederung aus der AUTOSAR-Spezifikation.

클래스 다이어그램

Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.

G cluster_ns ara::com nara__com__ComErrorDomain ComErrorDomain next_ara__core__ErrorDomain ara::core::ErrorDomain nara__com__ComErrorDomain->next_ara__core__ErrorDomain nara__com__ComException ComException next_ara__core__Exception ara::core::Exception nara__com__ComException->next_ara__core__Exception nara__com__FindServiceHandle «struct» FindServiceHandle nara__com__InstanceIdentifier InstanceIdentifier nara__com__SamplePtr SamplePtr nara__com__ServiceIdentifierType ServiceIdentifierType nara__com__ServiceVersionType ServiceVersionType

상세 보기

개요에서 항목을 선택하세요.

Fehlerbehandlung

ComErrorDomain 클래스

Defines a class representing the Communication error domain.

상속 대상 ara::core::ErrorDomain

ComException 클래스

Defines a class for exceptions to be thrown by the API.

상속 대상 ara::core::Exception

Returns a reference to the ara::com::ComErrorDomain object

constexpr const ara::core::ErrorDomain & GetComErrorDomain () noexcept;

Creates an instance of ara::core::ErrorCode

ComErrc 열거형

Defines the error codes for the ara::com::ComErrorDomain

enum class ComErrc : ara::core::ErrorDomain::CodeType {...};

Dienstidentität

Unique identifier of a specific AdaptivePlatformServiceInstance, to distinguish different instances of exactly the same service

Specifies a Service Identifier The exact type may be overridden by the Communication Management software provider

Specifies a Service Version

Holds a list of ara::com::InstanceIdentifiers. The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30] A ara::core::Vector ([SWS_CORE_01301]) for example fulfills these requirements.

using InstanceIdentifierContainer = ara::core::Vector<Instance Identifier>;

Dienstsuche

The exact definition of ara::com::FindServiceHandle is Communication Management implementation specific

FindServiceHandler 타입 별칭

Callback function invoked if service availability changes. It takes as input parameter a handle container containing handles for all matching service instances and a ara::com:: FindServiceHandle which can be used to invoke StopFindService() from within the ara::com::FindServiceHandler.

using FindServiceHandler = std::function<void(ServiceHandle Container<T>, FindServiceHandle)>;

Holds a list of service handles and is used as a return value of any of the FindService() methods) • [SWS_CM_00122] • [SWS_CM_00622] . The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30]. A ara::core::Vector ([SWS_CORE_ 01301]) for example fulfills these requirements.

using ServiceHandleContainer = ara::core::Vector<T>;

Datenempfang

SamplePtr 클래스

Emulates a std::unique_ptr to an event sample. The ara::com::SamplePtr behaves as a std::unique_ptr as long as the event/ field is subscrib ≙ std::unique_ptr

The subscription state of an event.

enum class SubscriptionState : std::uint8_t {...};
EventReceiveHandler 타입 별칭

Callback function invoked if new event data arrives for an event. The event receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory. ≙ std::function

using EventReceiveHandler = std::function<void()>;
FieldReceiveHandler 타입 별칭

Callback function invoked if a new notification arrives for a field. The field receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory. ≙ std::function

using FieldReceiveHandler = std::function<void()>;
SampleAllocateePtr 타입 별칭

Pointer to an allocated (by Communication Management) data sample. The implementation is allowed to be changed by the Communication Management software provider.

using SampleAllocateePtr = std::unique_ptr<T>;

Callback function invoked if ara::com::SubscriptionState of an event has changed.

using SubscriptionStateChangeHandler = std::function<void(Subscription State)>;
TriggerReceiveHandler 타입 별칭

A function wrapper for the handler function that gets called in case a new trigger arrives for an event. The trigger receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory. ≙ std::function

using TriggerReceiveHandler = std::function<void()>;

Dienstzustand

Processing modes for the service implementation.

enum class MethodCallProcessingMode : std::uint8_t {...};
ServiceState 열거형

The state of the service from GetServiceState()

enum class ServiceState : std::uint8_t {...};
ServiceStateHandler 타입 별칭

Functor used as input arguments for any of the SetServiceStateChangeHandler() methods: • [SWS_CM_01074] • [SWS_CM_01076]

using ServiceStateHandler = std::function<void(ServiceState)>;

열거형

열거형 ComErrc [SWS_CM_10432] Upstream: RS_AP_00130, RS_AP_00122, RS_AP_00127

enum class ComErrc :         ara::core::ErrorDomain::CodeType {...};

Defines the error codes for the ara::com::ComErrorDomain

Header-Datei#include "ara/com/com_error_domain.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolComErrc
Basistypara::core::ErrorDomain::CodeType

Werte

EnumeratorBeschreibung
kServiceNotAvailable=1 Service is not available after being previously offered via Offer
Service()
kMaxSamplesExceeded=2 Application holds more ara::com::SamplePtrs than commited in Subscribe() Samples were possibly skipped.
kCommunicationFailure=3 The network binding reported a recoverable communications error or a secure communication failure
kFieldValueNotInitialized=6 Field value has yet not been initialized via Update() (see [SWS_CM_00128]
kFieldSetHandlerNotSet=7 Field SetHandler has not been registered via RegisterSet Handler()
kServiceNotOffered= 11 Service has not yet been offered via OfferService()
kInstanceIDNotResolvable= 15 The ara::core::InstanceSpecifier is valid but could not be resolved/mapped to an existing ara::com:: InstanceIdentifier
kMaxSampleCountNotRealizable= 16 Provided maxSampleCount for event re-subscription does not match the maxSampleCount for the current subscription
kUnknownApplicationError= 22 A remote service returned an unconfigured application error.
kMinimumSendIntervalViolationError= 23 Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 67f5508c5e1b 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

열거형 ComErrc은(는) [SWS_CM_10432]에 따라 EXP ARAComAPI §2 “Recoverable Errors”에 따른 복구 가능한 오류(Recoverable Errors)에 대한 ara::com::ComErrorDomain의 표준화된 오류 코드를 정의합니다. 이는 클라이언트 또는 서버 컨텍스트에서 기능적 오류 원인을 정확하게 알리기 위해 통신 관리의 동기 및 비동기 API의 ara::core::Result 또는 ara::core::Future와(과) 같은 반환 타입으로 전달됩니다.

열거자들은 서비스 수명 주기 및 데이터 전송 전반에 걸친 특정 오류 사례를 다룹니다:

  • 서비스 수명 주기 및 바인딩: kServiceNotOffered은(는) 서비스가 아직 OfferService()을(를) 통해 제공되지 않았음을 나타내며([SWS_CM_00101]), kServiceNotAvailable은(는) 중간에 손실되었음을 알립니다. kInstanceIDNotResolvable은(는) InstanceSpecifier을(를) 확인할 수 없을 때 발생합니다([SWS_CM_00118]).
  • 이벤트 및 샘플 구독: kMaxSamplesExceeded은(는) 약정된 SamplePtr 할당량 초과에 대해 경고하고, kMaxSampleCountNotRealizable은(는) [SWS_CM_00141]을(를) 통한 재등록 시 부적절한 값을 보고합니다.
  • 필드 및 전송: kFieldValueNotInitialized은(는) Update() 이전의 초기화 누락을 나타내고([SWS_CM_00119]), kFieldSetHandlerNotSet은(는) 세터 핸들러 누락을 나타냅니다. [SWS_CM_00721]을(를) 통한 트리거 전송 시와 같은 로컬 네트워크 문제는 kCommunicationFailure(으)로 이어집니다([SWS_CM_10517]). 또한 kMinimumSendIntervalViolationError은(는) 클록 속도 위반을 처벌하고 kUnknownApplicationError은(는) 예기치 않은 서버 오류를 처리합니다([SWS_CM_10432]).

순수 열거형 타입인 ComErrc은(는) 자체 상태를 갖지 않으므로, 오류 값에 대한 읽기 및 비교 작업은 호출 스레드에서 동시성에 안전할 것으로 보입니다. 질문 Q-013822ee5711df2b (열림) 실제 오류 확인은 각 결과 객체를 평가한 후 애플리케이션의 몫입니다.

이 텍스트는 AI에 의해 작성되고 큐레이션되었습니다.

구현자 가이드 준비 중 (복잡도 I3)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_10432
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_10432@rel:R25-11#f858db5b
Content hash
f858db5b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_10432
Status: valid/unmigrated Version: rel:R25-11#a1bb25ac Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_10432@rel:R25-11#a1bb25ac
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0540727f2026-09-30
  • R19-11rel:R19-11#e85687322026-10-14
  • R20-11rel:R20-11#d76a076f2026-10-14
  • R21-11rel:R21-11#bba466f32026-10-14
  • R22-11rel:R22-11#defb05652026-10-14
  • R23-11rel:R23-11#6109561d2026-10-14
  • R24-11rel:R24-11#75455b1d2026-10-14
  • R25-11rel:R25-11#a1bb25ac2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

열거형 MethodCallProcessingMode [SWS_CM_00301] Upstream: RS_CM_00211

enum class MethodCallProcessingMode :               std::uint8_t {...};

Processing modes for the service implementation.

Header-Datei#include "ara/com/types.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolMethodCallProcessingMode
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
kPollPolling mode
kEventEvent driven and concurrent mode
kEventSingleThreadEvent driven, sequential mode
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: ef6d7e9a36c3 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

열거형 ara::com::MethodCallProcessingMode은(는) 서비스 인스턴스에서 들어오는 메서드 호출에 대한 처리 모드를 정의합니다 [SWS_CM_00301]. 이는 Skeleton 클래스의 생성자에 매개변수로 전달되며 기본값 ara::com::MethodCallProcessingMode::kEvent이(가) 미리 정의되어 있습니다 [SWS_CM_00130], [SWS_CM_00152], [SWS_CM_00153].

열거자들은 서비스 메서드의 동시성 및 실행 컨텍스트를 제어합니다 [SWS_CM_00301]:

  • kPoll: 폴링 모드. 서비스 컨슈머로부터 들어오는 호출은 자동으로 실행되지 않습니다. 서비스 구현은 ProcessNextMethodCall() [SWS_CM_00199]의 호출을 통해 실행을 능동적으로 제어합니다. 보류 중인 메서드는 이 호출 컨텍스트에서 동기식으로 처리됩니다. 이는 서비스 측에서 스레드 및 컨텍스트 전환에 대한 완전한 제어를 보장합니다 ARAComAPI §6.3.3 “Event Buffering Approaches”.
  • kEvent: 들어오는 호출을 병렬로 처리하기 위한 이벤트 기반 및 동시 모드.
  • kEventSingleThread: 메서드 호출을 개별적으로 실행하기 위한 이벤트 기반 순차 모드.

오류 처리 및 제한 사항:

  • 허용되지 않는 모드가 Skeleton 생성자에 전달되면 위반 WrongMethodCallProcessingModeViolation이(가) 발생합니다 [SWS_CM_00130], [SWS_CM_00153].
  • kEvent(으)로 생성된 Skeleton에서 ProcessNextMethodCall()을(를) 호출하는 경우에도 WrongMethodCallProcessingModeViolation이(가) 발생합니다 [SWS_CM_00199](해석: 이 메서드는 kPoll에 대해서만 제공되므로 kEventSingleThread에도 마찬가지로 적용될 것으로 추정됩니다). 질문 Q-bcd9f07119db44fb (열림)

이 사용 지침은 AUTOSAR 사양을 기반으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I2)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00301
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00301@rel:R25-11#4ddcc3e1
Content hash
4ddcc3e1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00301
Status: valid/unmigrated Version: rel:R25-11#80be2356 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00301@rel:R25-11#80be2356
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0d3dccbc2026-09-30
  • R19-11rel:R19-11#25b194492026-10-14
  • R20-11rel:R20-11#25b194492026-10-14
  • R21-11rel:R21-11#0ad7b7102026-10-14
  • R22-11rel:R22-11#0ad7b7102026-10-14
  • R23-11rel:R23-11#6f47e07b2026-10-14
  • R24-11rel:R24-11#80be23562026-10-14
  • R25-11rel:R25-11#80be23562026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

열거형 ServiceState [SWS_CM_01071]

enum class ServiceState :            std::uint8_t {...};

The state of the service from GetServiceState()

Header-Datei#include "ara/com/types.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolServiceState
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
kNotAvailable=0 Service is not available
kAvailable=1 Service is available

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01071
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01071@rel:R25-11#c5fc256c
Content hash
c5fc256c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01071
Status: valid/unmigrated Version: rel:R25-11#b7ec2dcd Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01071@rel:R25-11#b7ec2dcd
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#8a4f13912026-09-30
  • R22-11rel:R22-11#e2b5988f2026-10-14
  • R23-11rel:R23-11#e2b5988f2026-10-14
  • R24-11rel:R24-11#e3fd192b2026-10-14
  • R25-11rel:R25-11#b7ec2dcd2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

열거형 SubscriptionState [SWS_CM_00310] Upstream: RS_CM_00103, RS_CM_00104, RS_CM_00106

enum class SubscriptionState :              std::uint8_t {...};

The subscription state of an event.

Header-Datei#include "ara/com/types.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolSubscriptionState
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
kSubscribedSubscription is active
kNotSubscribedSubscription is not active
kSubscriptionPendingSubscription is pending
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: c356f26fdfb2 출처
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

열거형 SubscriptionState [SWS_CM_00310]은 네임스페이스 ara::com에서 타입 std::uint8_t을 기반으로 구독의 현재 상태를 나타냅니다. 이는 세 가지 서로 다른 상태를 정의합니다:

  • kNotSubscribed: 구독이 비활성 상태입니다.
  • kSubscriptionPending: 구독이 아직 보류 중이거나 장애 발생 후 연결이 복구되는 중입니다.
  • kSubscribed: 구독이 활성 상태입니다.

동기 쿼리에는 프록시 이벤트 [SWS_CM_00316], 프록시 필드 [SWS_CM_11604], 트리거 [SWS_CM_01105] 및 스켈레톤 트리거 [SWS_CM_01109]에 제공되는 메서드 GetSubscriptionState()이 사용됩니다. 이러한 모든 쿼리 함수는 noexcept(으)로 선언되어 완벽한 예외 안전성을 보장합니다.

상태 변경에 비동기적으로 반응하기 위해 애플리케이션은 SetSubscriptionStateChangeHandler()을(를) 통해 타입 SubscriptionStateChangeHandler의 콜백을 등록할 수 있습니다 [SWS_CM_00311] [SWS_CM_00333]. 유효하지 않거나 비어 있는 핸들러가 전달되면 위반 InvalidHandlerViolation이(가) 발생합니다 [SWS_CM_00333]. 등록 해제는 UnsetSubscriptionStateChangeHandler()을(를) 통해 수행됩니다 [SWS_CM_00334]. 또한 ExecutorT을(를) 사용하는 템플릿 오버로드를 통해 콜백의 실행 컨텍스트를 지정할 수 있습니다 [SWS_CM_11354].

프록시 인스턴스의 라이프사이클에서 SubscriptionState은(는) 자동 업데이트와 밀접하게 연동됩니다. 서비스 인스턴스에 장애가 발생하면 메서드 호출이 실패하고, GetSubscriptionState()은(는) 이전에 구독한 이벤트에 대해 kSubscriptionPending을(를) 반환합니다 ARAComAPI §6.1 “Auto Updating of Proxy Instance”. 서비스 인스턴스가 Service Discovery를 통해 다시 연결 가능해지면 통신 관리가 연결을 투명하게 업데이트하며, 이에 따라 GetSubscriptionState()은(는) 자동으로 다시 kSubscribed을(를) 반환합니다 AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2. 이 과정에서 프록시를 수동으로 다시 생성하거나 다시 구독할 필요는 없습니다.

이 텍스트는 AI에 의해 생성되었으며 AUTOSAR 명세에 대한 참고용 보완 자료로 사용됩니다.

구현자 가이드 준비 중 (복잡도 I3)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00310
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00310@rel:R25-11#c9428b3d
Content hash
c9428b3d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00310
Status: valid/unmigrated Version: rel:R25-11#7680ddc8 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00310@rel:R25-11#7680ddc8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#316fa4842026-09-30
  • R19-11rel:R19-11#783a62a12026-10-14
  • R20-11rel:R20-11#783a62a12026-10-14
  • R21-11rel:R21-11#149257f62026-10-14
  • R22-11rel:R22-11#149257f62026-10-14
  • R23-11rel:R23-11#27673e7a2026-10-14
  • R24-11rel:R24-11#7680ddc82026-10-14
  • R25-11rel:R25-11#7680ddc82026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭

타입 별칭 EventReceiveHandler [SWS_CM_00309] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120

using EventReceiveHandler = std::function<void()>;

Callback function invoked if new event data arrives for an event. The event receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolEventReceiveHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00309
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00309@rel:R25-11#205b2f65
Content hash
205b2f65
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00309
Status: valid/unmigrated Version: rel:R25-11#223e8e61 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00309@rel:R25-11#223e8e61
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#7b6d05552026-09-30
  • R19-11rel:R19-11#395af5f02026-10-14
  • R20-11rel:R20-11#395af5f02026-10-14
  • R21-11rel:R21-11#db7e05e52026-10-14
  • R22-11rel:R22-11#395af5f02026-10-14
  • R23-11rel:R23-11#2779dae62026-10-14
  • R24-11rel:R24-11#dcc5017d2026-10-14
  • R25-11rel:R25-11#223e8e612026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 FieldReceiveHandler [SWS_CM_11615] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120

using FieldReceiveHandler = std::function<void()>;

Callback function invoked if a new notification arrives for a field. The field receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolFieldReceiveHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11615
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11615@rel:R25-11#2be89cbd
Content hash
2be89cbd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11615
Status: valid/unmigrated Version: rel:R25-11#799baa76 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11615@rel:R25-11#799baa76
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#cfafcfd52026-09-30
  • R24-11rel:R24-11#fae206d62026-10-14
  • R25-11rel:R25-11#799baa762026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 FindServiceHandler [SWS_CM_00383] Upstream: RS_CM_00102

using FindServiceHandler = std::function<void(ServiceHandle Container<T>, FindServiceHandle)>;

Callback function invoked if service availability changes. It takes as input parameter a handle container containing handles for all matching service instances and a ara::com:: FindServiceHandle which can be used to invoke StopFindService() from within the ara::com::FindServiceHandler.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolFindServiceHandler

Template-Parameter

ParameterBeschreibung
TData type of data sample
Siehe auch: [SWS_CM_00125]

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00383
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00383@rel:R25-11#89f43e84
Content hash
89f43e84
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00383
Status: valid/unmigrated Version: rel:R25-11#4bb13392 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00383@rel:R25-11#4bb13392
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5bc754b22026-09-30
  • R19-11rel:R19-11#e9374da52026-10-14
  • R20-11rel:R20-11#e9374da52026-10-14
  • R21-11rel:R21-11#e9374da52026-10-14
  • R22-11rel:R22-11#10a374092026-10-14
  • R23-11rel:R23-11#40b111b32026-10-14
  • R24-11rel:R24-11#29b459892026-10-14
  • R25-11rel:R25-11#4bb133922026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 InstanceIdentifierContainer [SWS_CM_00319] Upstream: RS_CM_00101, RS_CM_00102, RS_AP_00114, RS_AP_00122

using InstanceIdentifierContainer = ara::core::Vector<Instance Identifier>;

Holds a list of ara::com::InstanceIdentifiers. The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30] A ara::core::Vector ([SWS_CORE_01301]) for example fulfills these requirements.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolInstanceIdentifierContainer

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00319
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00319@rel:R25-11#0729cb17
Content hash
0729cb17
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00319
Status: valid/unmigrated Version: rel:R25-11#fa8d6921 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00319@rel:R25-11#fa8d6921
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#ef7a629e2026-09-30
  • R19-11rel:R19-11#a868f3472026-10-14
  • R20-11rel:R20-11#92724e662026-10-14
  • R21-11rel:R21-11#431357ea2026-10-14
  • R22-11rel:R22-11#2ac28cb72026-10-14
  • R23-11rel:R23-11#bc0629c32026-10-14
  • R24-11rel:R24-11#e851c8ff2026-10-14
  • R25-11rel:R25-11#fa8d69212026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 SampleAllocateePtr [SWS_CM_00308] Upstream: RS_CM_00201

using SampleAllocateePtr = std::unique_ptr<T>;

Pointer to an allocated (by Communication Management) data sample. The implementation is allowed to be changed by the Communication Management software provider.

The precondition defined in [SWS_CM_00086] must be fulfilled. Otherwise it is considered a violation.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolSampleAllocateePtr

Template-Parameter

ParameterBeschreibung
TData type of data sample

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00308
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00308@rel:R25-11#6c59c00e
Content hash
6c59c00e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00308
Status: valid/unmigrated Version: rel:R25-11#039f8d79 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00308@rel:R25-11#039f8d79
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#adf0f02d2026-09-30
  • R19-11rel:R19-11#5ad593f62026-10-14
  • R20-11rel:R20-11#5ad593f62026-10-14
  • R21-11rel:R21-11#5ad593f62026-10-14
  • R22-11rel:R22-11#5ad593f62026-10-14
  • R23-11rel:R23-11#2153a31d2026-10-14
  • R24-11rel:R24-11#039f8d792026-10-14
  • R25-11rel:R25-11#039f8d792026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 ServiceHandleContainer [SWS_CM_00304] Upstream: RS_CM_00102

using ServiceHandleContainer = ara::core::Vector<T>;

Holds a list of service handles and is used as a return value of any of the FindService() methods) • [SWS_CM_00122] • [SWS_CM_00622] . The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30]. A ara::core::Vector ([SWS_CORE_ 01301]) for example fulfills these requirements.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolServiceHandleContainer

Template-Parameter

ParameterBeschreibung
Tservice handle

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00304
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00304@rel:R25-11#b6dc6331
Content hash
b6dc6331
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00304
Status: valid/unmigrated Version: rel:R25-11#6d2b7cf6 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00304@rel:R25-11#6d2b7cf6
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#7afe7d372026-09-30
  • R19-11rel:R19-11#5e4ae44f2026-10-14
  • R20-11rel:R20-11#f25f37592026-10-14
  • R21-11rel:R21-11#be1867dc2026-10-14
  • R22-11rel:R22-11#5d1adbf22026-10-14
  • R23-11rel:R23-11#156ff0142026-10-14
  • R24-11rel:R24-11#19b088802026-10-14
  • R25-11rel:R25-11#6d2b7cf62026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 ServiceStateHandler [SWS_CM_01072]

using ServiceStateHandler = std::function<void(ServiceState)>;

Functor used as input arguments for any of the SetServiceStateChangeHandler() methods: • [SWS_CM_01074] • [SWS_CM_01076]

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolServiceStateHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01072
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01072@rel:R25-11#369fafab
Content hash
369fafab
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01072
Status: valid/unmigrated Version: rel:R25-11#6c72f419 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01072@rel:R25-11#6c72f419
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#c869ffc22026-09-30
  • R22-11rel:R22-11#152adeba2026-10-14
  • R23-11rel:R23-11#152adeba2026-10-14
  • R24-11rel:R24-11#720d0f2a2026-10-14
  • R25-11rel:R25-11#6c72f4192026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 SubscriptionStateChangeHandler [SWS_CM_00311] Upstream: RS_CM_00103, RS_CM_00104, RS_CM_00106

using SubscriptionStateChangeHandler = std::function<void(Subscription State)>;

Callback function invoked if ara::com::SubscriptionState of an event has changed.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolSubscriptionStateChangeHandler
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: e8a7f7be42ec 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

네임스페이스 ara::com의 유형 별칭 SubscriptionStateChangeHandler은 헤더 파일 ara/com/types.h에서 std::function<void(SubscriptionState)>로 선언되어 있습니다([SWS_CM_00311]). 이는 구독된 프록시 이벤트의 ara::com::SubscriptionState가 변경되는 즉시 트리거되는 애플리케이션 고유 콜백에 대한 함수 시그니처를 지정합니다([SWS_CM_00311], EXP_ARAComAPI §5.3 “Proxy Class API’s”). 호출 시 새로운 구독 상태가 매개변수로 직접 전달되며, 반환값은 제공되지 않습니다([SWS_CM_00311]).

핸들러 등록은 각 프록시 클래스의 메서드 SetSubscriptionStateChangeHandler()을 통해 수행됩니다(EXP_ARAComAPI §5.3.1 “Proxy Class API’s”, EXP_ARAComAPI §5.3 “Proxy Class API’s”). 이 작업은 ara::core::Result<void>을 반환하므로(EXP_ARAComAPI §5.3 “Proxy Class API’s”) 애플리케이션 개발자는 등록 시 발생할 수 있는 오류를 동기식으로 확인할 수 있습니다. 등록된 콜백의 선택적 제거는 [SWS_CM_00334]에 따른 UnsetSubscriptionStateChangeHandler()의 호출을 통해 수행됩니다(EXP_ARAComAPI §1 “Introduction”, EXP_ARAComAPI §5.3.1 “Proxy Class API’s”).

진행 흐름 및 동시성과 관련하여 상태 알림은 비동기식으로 수행됩니다. 핸들러 호출은 아마도 통신 인프라의 스레드 컨텍스트에서 발생할 것으로 추정됩니다(해석). 질문 Q-8dda0cd4de0070bf (열림) 따라서 콜백 구현은 신속하게 반환되어야 하며 재진입 가능하거나 스레드 안전하게 구성되어야 합니다. 핸들러의 상호 작용은 이벤트 구독의 수명 주기, 특히 Subscribe(), Unsubscribe() 및 GetSubscriptionState()와의 조합에 밀접하게 연결됩니다(EXP_ARAComAPI §5.3.1 “Proxy Class API’s”).

본 텍스트는 AI에 의해 작성되었으며 사양서 정독을 대체하지 않습니다.

구현자 가이드 준비 중 (복잡도 I2)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00311
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00311@rel:R25-11#ad0c6801
Content hash
ad0c6801
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00311
Status: valid/unmigrated Version: rel:R25-11#21ac17ff Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00311@rel:R25-11#21ac17ff
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#ee97a2592026-09-30
  • R19-11rel:R19-11#e22ba4e32026-10-14
  • R20-11rel:R20-11#e22ba4e32026-10-14
  • R21-11rel:R21-11#e22ba4e32026-10-14
  • R22-11rel:R22-11#e22ba4e32026-10-14
  • R23-11rel:R23-11#5878c7452026-10-14
  • R24-11rel:R24-11#287ce5e32026-10-14
  • R25-11rel:R25-11#21ac17ff2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

타입 별칭 TriggerReceiveHandler [SWS_CM_00351] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120

using TriggerReceiveHandler = std::function<void()>;

A function wrapper for the handler function that gets called in case a new trigger arrives for an event. The trigger receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolTriggerReceiveHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00351
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00351@rel:R25-11#c71010d5
Content hash
c71010d5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00351
Status: valid/unmigrated Version: rel:R25-11#fc6a9105 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00351@rel:R25-11#fc6a9105
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#7e62cd342026-09-30
  • R21-11rel:R21-11#4d5accb82026-10-14
  • R22-11rel:R22-11#7e2a7c042026-10-14
  • R23-11rel:R23-11#9b69b1902026-10-14
  • R24-11rel:R24-11#f8c62c622026-10-14
  • R25-11rel:R25-11#fc6a91052026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

자유 함수 문서

함수 GetComErrorDomain [SWS_CM_11334] Upstream: RS_AP_00120, RS_AP_00130

constexpr const ara::core::ErrorDomain & GetComErrorDomain () noexcept;

Returns a reference to the ara::com::ComErrorDomain object

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 0c734de51692 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

네임스페이스 ara::com의 전역 함수 GetComErrorDomain은 오류 도메인 객체 ara::com::ComErrorDomain에 대한 참조를 제공합니다 [SWS_CM_11334]. 선언은 헤더 ara/com/com_error_domain.h를 통해 포함되며, 동기식 매개변수 없는 호출로 이루어집니다 SWS CommunicationManagement §8.12.3.1.1 “GetComErrorDomain”. 반환값으로 이 함수는 시스템의 통신 오류 도메인을 나타내는 const ara::core::ErrorDomain& 타입의 상수 참조를 반환합니다.

오류 처리 및 예외 안전성

이 인터페이스는 명시적으로 noexcept(으)로 선언되어 있으며 예외 안전(exception safe)으로 간주됩니다 [SWS_CM_11334]. 함수 호출은 항상 성공하므로 런타임 오류가 발생하지 않습니다. 따라서 호출자는 함수 호출 자체에 대한 오류 처리를 준비할 필요가 없습니다. 특정 오류 코드, 피드백 채널 또는 DET 또는 DEM에 대한 알림은 이 조회에 대해 사양에 정의되어 있지 않습니다.

동시성 및 상호 작용

constexpr 및 noexcept 선언 덕분에 이 함수는 상태 비저장(stateless), 부작용 없음(side-effect free)이며 제한 없는 재진입 및 스레드 안전성을 가질 것으로 보이며, 아마도 컴파일 시점에도 실행될 수 있습니다. 질문 Q-21aafe1fdcb5997b (열림) 제공되는 오류 도메인은 전체 시스템에서 참조 인스턴스 역할을 하여 Communication Management 작업의 오류 코드를 해당 도메인 소속에 따라 검증하고 다른 오류 소스와 구분합니다 [SWS_CM_11334].

이 사용 지침은 AUTOSAR R25-11 명세를 바탕으로 AI에 의해 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei#include "ara/com/com_error_domain.h"
Scopenamespace ara::com
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
const ara::core::ErrorDomain &Reference to the ara::com::ComErrorDomain object

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11334
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11334@rel:R25-11#c19c661d
Content hash
c19c661d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11334
Status: valid/unmigrated Version: rel:R25-11#540ecd6a Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11334@rel:R25-11#540ecd6a
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#84138e222026-09-30
  • R20-11rel:R20-11#6ab718532026-10-14
  • R21-11rel:R21-11#86c8bf622026-10-14
  • R22-11rel:R22-11#d0609f3d2026-10-14
  • R23-11rel:R23-11#93b5f2792026-10-14
  • R24-11rel:R24-11#8fd9abb62026-10-14
  • R25-11rel:R25-11#540ecd6a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

함수 MakeErrorCode [SWS_CM_11335] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

constexpr ara::core::ErrorCode MakeErrorCode (ara::com::ComErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

Creates an instance of ara::core::ErrorCode

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 43b1024d6785 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

도우미 함수 ara::com::MakeErrorCode은 ara::core::ErrorCode의 인스턴스를 생성하는 데 사용됩니다([SWS_CM_11335], SWS CommunicationManagement §8.12.3.1.2 “MakeErrorCode”). 이는 네임스페이스 ara::com의 헤더 파일 #include "ara/com/com_error_domain.h"를 통해 선언됩니다. 입력 매개변수로 ara::com::ComErrc 유형의 오류 번호 code과 ara::core::ErrorDomain::SupportDataType 유형의 제조업체별 추가 데이터 data을 수신하고 해당 오류 객체를 동기식으로 반환합니다.

실행 안전성과 관련하여 이 함수는 noexcept으로 지정되었으며 명시적으로 예외 안전(\"exception safe\")으로 분류되어 있습니다([SWS_CM_11335]). 이 도우미 함수는 오류 객체 생성에만 전적으로 사용되므로 DET 또는 DEM을 통한 런타임 메시지는 제공되지 않습니다. constexpr 및 noexcept 선언으로 인해 이 함수는 부작용이 없고 재진입 가능할 것으로 추정되며, 이에 따라 컴파일 시점 및 동시성 컨텍스트에서의 호출도 허용됩니다. 질문 Q-43f118920f402d86 (열림)

아키텍처 패턴은 Adaptive AUTOSAR의 플랫폼 전반 오류 모델을 따르며 인접한 기능 도메인에 유사하게 제공됩니다. 종단 간(End-to-End) 보호를 위해 함수 ara::com::e2e::MakeErrorCode이 존재하며([SWS_CM_12511], SWS CommunicationManagement §8.15.2.1.2 “MakeErrorCode”), 보안 기능의 경우 apext::com::secoc::MakeErrorCode을 사용할 수 있습니다([SWS_CM_12522], SWS CommunicationManagement §C.2.2.1.2 “MakeErrorCode”).

이 텍스트는 AI에 의해 생성되었으며 가이드 역할을 합니다.

구현자 가이드 준비 중 (복잡도 I2)

Header-Datei#include "ara/com/com_error_domain.h"
Scopenamespace ara::com
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
codeError code number.
dataVendor defined data associated with the error

Rückgabewert

TypBeschreibung
ara::core::ErrorCodeAn ara::core::ErrorCode object.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11335
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11335@rel:R25-11#17b4fc54
Content hash
17b4fc54
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11335
Status: valid/unmigrated Version: rel:R25-11#ed0a7b5c Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11335@rel:R25-11#ed0a7b5c
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#e57005e72026-09-30
  • R20-11rel:R20-11#3105d5f82026-10-14
  • R21-11rel:R21-11#14964c692026-10-14
  • R22-11rel:R22-11#d4a3decc2026-10-14
  • R23-11rel:R23-11#abab96942026-10-14
  • R24-11rel:R24-11#555364d52026-10-14
  • R25-11rel:R25-11#ed0a7b5c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill