DEENESPTFRRUARHIKOZHNL

пространство имён ara::com

Руководство пользователяСОЗДАНО ИИ

Предоставляет базовые типы, домены ошибок и интерфейсы для сервис-ориентированной коммуникации в AUTOSAR Adaptive.
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 9676f1a12dfa Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Предоставляет базовые типы, домены ошибок и интерфейсы для сервис-ориентированной коммуникации в AUTOSAR Adaptive.

Пространство имен предоставляет основные строительные блоки для сервис-ориентированной коммуникации, подключая потребителей сервисов через прокси, а поставщиков сервисов — через скелетоны (ARAComAPI §7.6 «meta-model to Implementation»). Взаимодействие включает асинхронный поиск сервисов, вызовы методов с возвратом через фьючерсы, а также подписки на события через определенные состояния ([SWS_CM_00310]). К ключевым обязанностям относятся корректное разрешение идентификаторов экземпляров, а также соблюдение настроенных квот выборок и интервалов отправки ([SWS_CM_10432]).

Контекст

Пространство имен ara::com предоставляет центральные типы и механизмы для сервис-ориентированной коммуникации (Communication Management) внутри AUTOSAR Adaptive Platform. Архитектурная модель строго разделяет потребителей и поставщиков сервисов: на стороне потребителя (R-Port) клиентские приложения действуют через сгенерированные экземпляры прокси (ARAComAPI §7.6 «meta-model to Implementation»), в то время как поставщики сервисов на стороне сервера предоставляют свою функциональность через реализации скелетонов (ARAComAPI §6.2 «Definition of BatteryState»).

Посредником между прокси и скелетоном выступает технический промежуточный слой (биндинг). Для идентификации и различения отдельных экземпляров сервисов служит 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

Контекстная диаграмма: взаимодействие между прокси, биндингом промежуточного слоя и скелетоном при коммуникации сервисов. Источники: ARAComAPI §7.6 «meta-model to Implementation», ARAComAPI §6.6 «InstanceIdentifier Resolution», [SWS_CM_10432].

Жизненный цикл

Сервисы и коммуникационные соединения подчиняются в ara::com четко определенным моделям состояний. Общая доступность сервиса представлена через перечисление ServiceState со значениями kAvailable и kNotAvailable ([SWS_CM_01071]). Изменения состояния можно отслеживать с помощью зарегистрированных ServiceStateHandler ([SWS_CM_01072]).

Для событий (Events) и полей 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 weiterleitenВернуть ara::com::FutureErgebnis 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»).
  • Ограничения ресурсов и подписки: если приложение удерживает больше экземпляров SamplePtr, чем согласовано при Subscribe(), возникает 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 Release R25-11.

Карта тем

Fehlerbehandlung

5
ComErrorDomainComExceptionGetComErrorDomainMakeErrorCodeComErrc

Dienstidentität

4
InstanceIdentifierServiceIdentifierTypeServiceVersionTypeInstanceIdentifierContainer

Dienstsuche

3
FindServiceHandleFindServiceHandlerServiceHandleContainer

Datenempfang

7
SamplePtrSubscriptionStateEventReceiveHandlerFieldReceiveHandlerSampleAllocateePtrSubscriptionStateChangeHandlerTriggerReceiveHandler

Dienstzustand

3
MethodCallProcessingModeServiceStateServiceStateHandler

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

GetComErrorDomain функция

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

constexpr const ara::core::ErrorDomain & GetComErrorDomain () noexcept;
MakeErrorCode функция

Creates an instance of ara::core::ErrorCode

constexpr ara::core::ErrorCode MakeErrorCode (ara::com::ComErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;
ComErrc перечисление

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

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

Dienstidentität

InstanceIdentifier класс

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

ServiceIdentifierType класс

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

ServiceVersionType класс

Specifies a Service Version

InstanceIdentifierContainer псевдоним типа

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

FindServiceHandle класс

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)>;
ServiceHandleContainer псевдоним типа

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

SubscriptionState перечисление

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>;
SubscriptionStateChangeHandler псевдоним типа

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

MethodCallProcessingMode перечисление

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.
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 67f5508c5e1b Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Перечисление ComErrc определяет согласно [SWS_CM_10432] стандартизированные коды ошибок ara::com::ComErrorDomain для устранимых ошибок (Recoverable Errors) в соответствии с EXP ARAComAPI §2 «Recoverable Errors». Оно передаётся в возвращаемых типах, таких как ara::core::Result или ara::core::Future, синхронных и асинхронных API Communication Management для точной сигнализации о функциональных причинах ошибок в контексте клиента или сервера.

Элементы перечисления охватывают специфические случаи ошибок на протяжении жизненного цикла сервиса и передачи данных:

  • Жизненный цикл сервиса и привязка: 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 (открытый) Фактическая проверка ошибок возлагается на приложение после анализа соответствующего объекта результата.

Этот текст был создан и подготовлен с помощью ИИ.

Руководство разработчика реализации в подготовке (сложность 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#e3b0605d
Content hash
e3b0605d
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
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ef6d7e9a36c3 Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Перечисление ara::com::MethodCallProcessingMode определяет режимы обработки для входящих вызовов методов на экземпляре сервиса [SWS_CM_00301]. Оно передается в качестве параметра в конструкторы классов скелетов, при этом по умолчанию задано значение 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: управляемый событиями последовательный режим для одиночного выполнения вызовов методов.

Обработка ошибок и ограничения:

  • Если в конструктор скелета передается недопустимый режим, возникает нарушение WrongMethodCallProcessingModeViolation [SWS_CM_00130], [SWS_CM_00153].
  • Вызов ProcessNextMethodCall() на скелете, сконструированном с kEvent, также приводит к WrongMethodCallProcessingModeViolation [SWS_CM_00199] (интерпретация: это должно также относиться к kEventSingleThread, поскольку метод предусмотрен только для kPoll). Вопрос 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#80145e26
Content hash
80145e26
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#a3985834
Content hash
a3985834
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
СОЗДАНО ИИ не проверено Модель: 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: подписка активна.

Для синхронного опроса служит метод GetSubscriptionState(), предоставляемый для прокси-событий [SWS_CM_00316], прокси-полей [SWS_CM_11604] и триггеров [SWS_CM_01105], а также триггеров скелетона [SWS_CM_01109]. Все эти функции опроса объявлены как 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, Communication Management прозрачно обновляет соединение; после этого GetSubscriptionState() снова автоматически возвращает kSubscribed AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2. Повторное создание прокси вручную или повторная подписка при этом не требуются.

Этот текст был сгенерирован ИИ и служит ориентировочным дополнением к спецификации 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#8740ea88
Content hash
8740ea88
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#b0808253
Content hash
b0808253
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#5dd6629b
Content hash
5dd6629b
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#bc04fbd3
Content hash
bc04fbd3
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#4c1e3638
Content hash
4c1e3638
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#94a57d14
Content hash
94a57d14
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#5d031bda
Content hash
5d031bda
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#71101a6a
Content hash
71101a6a
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
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: e8a7f7be42ec Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Псевдоним типа SubscriptionStateChangeHandler в пространстве имен ara::com объявлен как std::function<void(SubscriptionState)> в заголовочном файле ara/com/types.h ([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»), с помощью которого разработчики приложений могут синхронно проверять возможные ошибки при регистрации. Адресное удаление зарегистрированного обратного вызова происходит через вызов UnsetSubscriptionStateChangeHandler() согласно [SWS_CM_00334] (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»).

Этот текст был создан ИИ; он не заменяет ознакомления со спецификацией.

Руководство разработчика реализации в подготовке (сложность 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#b05f2276
Content hash
b05f2276
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#fb01083a
Content hash
fb01083a
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

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 0c734de51692 Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Глобальная функция GetComErrorDomain в пространстве имён ara::com предоставляет ссылку на объект домена ошибок 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 функция, вероятно, является невисящей от состояния, свободной от побочных эффектов, а также неограниченно реентерабельной и потокобезопасной; предположительно, её также можно выполнять во время компиляции. Вопрос Q-21aafe1fdcb5997b (открытый) Предоставленный домен ошибок служит в системе в целом в качестве эталонного экземпляра для проверки кодов ошибок из операций Communication Management на основе их принадлежности к домену и их разграничения от других источников ошибок [SWS_CM_11334].

Данное указание по использованию было сгенерировано ИИ на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность 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#2dd0bf46
Content hash
2dd0bf46
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

СОЗДАНО ИИ не проверено Модель: 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»). Она объявляется через заголовочный файл #include "ara/com/com_error_domain.h" в пространстве имен ara::com. В качестве входных параметров она принимает номер ошибки code типа ara::com::ComErrc, а также специфические для производителя дополнительные данные data типа ara::core::ErrorDomain::SupportDataType и синхронно возвращает соответствующий объект ошибки.

Что касается безопасности выполнения, функция специфицирована как 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»).

Этот текст был сгенерирован ИИ и служит в качестве ориентировочного руководства.

Руководство разработчика реализации в подготовке (сложность 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#3d61e549
Content hash
3d61e549
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