DEENESPTFRRUARHIKOZHNL

класс <SI-Namespace>::proxy::events::<Event>

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

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

Позволяет клиентским приложениям подписываться на сервисные события и принимать типизированные новые выборки данных.

Интерфейсный класс <SI-Namespace>::proxy::events::<Event> позволяет клиентским приложениям в AUTOSAR Adaptive Platform принимать сервисные события на стороне потребителя через модуль com. Типичная последовательность включает запрос подписки через Subscribe [SWS_CM_00141], реактивное оповещение через зарегистрированные обработчики, а также синхронную выборку данных с помощью GetNewSamples [SWS_CM_00701]. При этом нельзя одновременно удерживать больше указателей на выборки, чем было зарезервировано при подписке, а перед отменой подписки через Unsubscribe все ссылки должны быть освобождены.

Контекст

C++-класс <SI-Namespace>::proxy::events::<Event> представляет собой интерфейс на стороне потребителя для сервисного события в модуле com платформы AUTOSAR Adaptive Platform (релиз R25-11). В рамках сервисно-ориентированного шаблона связи этот сгенерированный класс выступает в качестве локального представителя события, предоставляемого скелетоном сервера. Клиентские приложения используют экземпляры этого класса для подписки на данные событий, приема входящих выборок (samples) из коммуникационной сети и управления их жизненным циклом на стороне потребителя AUTOSAR_AP_EXP_ARAComAPI с. 10.

Основными партнерами по взаимодействию для данного класса являются:

  • Приложение (Subscriber): Инициирует регистрацию подписки на событие через Subscribe [SWS_CM_00141], сохраняет процедуры обратного вызова для приема данных и изменения состояния, а также запрашивает новые выборки через GetNewSamples [SWS_CM_00701].
  • Communication Management: Координирует передачу данных событий через нижележащее промежуточное ПО (middleware), управляет состоянием сети и выполняет зарегистрированные обработчики оповещений при поступлении новых событий или изменении состояния [SWS_CM_00181], [SWS_CM_00333].
  • Контекст выполнения (Executor): При использовании перегруженных методов регистрации асинхронные обработчики выполняются внутри явно переданного контекста ExecutorT [SWS_CM_11354], [SWS_CM_11356], [SWS_CM_00100].
EventKontext Anwendung Приложение ProxyEvent Proxy-Event Anwendung->ProxyEvent Subscribe / GetNewSamples ProxyEvent->Anwendung Handler-Aufruf CommunicationManagement Communication Management CommunicationManagement->ProxyEvent Ereignisdaten / Status

Контекстная диаграмма: отношения взаимодействия между приложением, прокси-событием и Communication Management. Источники: [SWS_CM_00141], [SWS_CM_00181], AUTOSAR_AP_EXP_ARAComAPI с. 10

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

Инстанцирование и уничтожение <SI-Namespace>::proxy::events::<Event> в качестве члена вышестоящего прокси-класса, по всей вероятности, жестко привязаны к сроку службы сервисного прокси. Вопрос Q-6c591ea580278c12 (открытый) После создания событие изначально находится в неподписанном состоянии. Текущий статус подписки можно в любое время запросить через GetSubscriptionState, которая возвращает состояние как ara::com::SubscriptionState [SWS_CM_00316].

Переход в активное состояние подписки инициируется через Subscribe, при этом максимальное количество одновременно доступных слотов кэша задается через maxSampleCount [SWS_CM_00141]. Если в момент вызова событие уже находится в состояниях kSubscribed или kSubscriptionPending и переданное значение совпадает с текущим, вызов не производит действия [SWS_CM_00141]. Об изменениях состояния подписки Communication Management сообщает через обработчик, который регистрируется с помощью SetSubscriptionStateChangeHandler [SWS_CM_00333] или с контекстом выполнения через SetSubscriptionStateChangeHandler [SWS_CM_11354]. Эту регистрацию можно отменить через UnsetSubscriptionStateChangeHandler [SWS_CM_00334] AUTOSAR_AP_EXP_ARAComAPI с. 10.

Кроме того, класс управляет состоянием сквозной защиты (E2E). Через GetE2EStateMachineState определяется состояние ara::com::e2e::SMState конечного автомата E2E, зафиксированное при последнем внутреннем вызове E2E_Check() во время GetNewSamples() [SWS_CM_11554]. Некорректные условия передачи могут отслеживаться обработчиками, которые устанавливаются через SetTransportFaultConditionHandler [SWS_CM_00099] или [SWS_CM_00100] и удаляются через UnsetTransportFaultConditionHandler [SWS_CM_00105].

Прекращение подписки выполняется через Unsubscribe [SWS_CM_00151] AUTOSAR_AP_EXP_ARAComAPI с. 10. Если событие в этот момент не подписано, метод возвращает управление без выполнения каких-либо действий [SWS_CM_00151]. Все функции-члены объявлены как noexcept и обеспечивают полную безопасность относительно исключений.

Путь использования

Типичный процесс использования прокси-события подразделяется на следующие последовательные фазы:

  1. Инициация подписки: Приложение вызывает Subscribe(maxSampleCount) [SWS_CM_00141], чтобы зарезервировать размер буфера для входящих выборок.
  2. Настройка оповещения: Через SetReceiveHandler [SWS_CM_00181] (или с контекстом выполнения через [SWS_CM_11356]) регистрируется обратный вызов без параметров, вызываемый Communication Management при поступлении новых событий.
  3. Выборка и обработка данных: В функции обратного вызова приложение вызывает GetNewSamples [SWS_CM_00701]. Переданный вызываемый объект (callable) f с сигнатурой void(ara::com::SamplePtr<SampleType const>) последовательно обрабатывает каждую выборку. При этом SampleType соответствует специализированному типу полезных данных события [SWS_CM_11401]. Возвращаемое значение предоставляет в виде ara::core::Result<std::size_t> точное количество выборок, переданных в f [SWS_CM_00701].
  4. Мониторинг кэша: С помощью GetFreeSampleCount [SWS_CM_00705] приложение может проверить количество неиспользуемых мест в локальном кэше, чтобы заблаговременно обнаружить дефицит буфера.
  5. Разыменование и отмена регистрации: После завершения обработки данных триггер приема отключается с помощью UnsetReceiveHandler [SWS_CM_00183], а подписка завершается через Unsubscribe [SWS_CM_00151].
Подписка на событие и обработка сэмпловПриложениеProxy-EventCommunication ManagementSubscribe(maxSampleCount)Abonnement anfordernSetReceiveHandler(handler)handler()GetNewSamples(f, maxNumberOfSamples)ara::core::Result<std::size_t>Unsubscribe()

Диаграмма последовательности: типичная последовательность оформления подписки, оповещения, обработки выборок и отмены подписки. Источники: [SWS_CM_00141], [SWS_CM_00181], [SWS_CM_00701], [SWS_CM_00151]

Сценарии ошибок

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

  • Ошибка конфигурации при повторной подписке: Если Subscribe вызывается, когда событие уже подписано, и новое maxSampleCount отличается от текущего значения, вызов завершается с кодом ошибки ComErrc::kMaxSampleCountNotRealizable [SWS_CM_00141]. При отсутствии полномочий система отклоняет выполнение с InsufficientPermissionsViolation [SWS_CM_00141].
  • Превышение границ буфера: Если приложение удерживает больше экземпляров ara::com::SamplePtr, чем было гарантировано в предыдущем вызове Subscribe, GetNewSamples возвращает код ошибки ComErrc::kMaxSamplesExceeded; в этом случае выборки данных могли быть отброшены [SWS_CM_00701].
  • Передача недопустимого обработчика: Если в SetReceiveHandler, SetSubscriptionStateChangeHandler или SetTransportFaultConditionHandler передается недопустимый или пустой (null) вызываемый объект, генерируется InvalidHandlerViolation ([SWS_CM_00181], [SWS_CM_11356], [SWS_CM_00333], [SWS_CM_11354], [SWS_CM_00099], [SWS_CM_00100]).
  • Оставшиеся выборки при отмене подписки: Если перед вызовом Unsubscribe не были освобождены все удерживаемые ara::com::SamplePtr, это приводит к DanglingSamplesViolation [SWS_CM_00151].

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

Карта членов

Диаграмма классов

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G n_SI_Namespace___proxy__events___Event_711 <Event> + SetTransportFaultConditionHandler() + UnsetTransportFaultConditionHandler() + GetE2EStateMachineState() + GetFreeSampleCount() + GetNewSamples() + GetSubscriptionState() + SetSubscriptionStateChangeHandler() + Subscribe() + UnsetSubscriptionStateChangeHandler() + Unsubscribe() + SetReceiveHandler() + UnsetReceiveHandler()

Подробный вид

Выберите элемент в оглавлении.

Методы

Returns the state of the specific event class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()

ara::com::e2e::SMState GetE2EStateMachineState () const noexcept;
GetFreeSampleCount функция

Query Free Sample Slots

std::size_t GetFreeSampleCount () const noexcept;
GetNewSamples функция

Method to update the event cache.

template <typename F> ara::core::Result< std::size_t > GetNewSamples (F &&f, std::size_t max NumberOfSamples=std::numeric_limits< std::size_t >::max()) noexcept;
GetSubscriptionState функция

Query ara::com::SubscriptionState, as per [SWS_CM_00310].

ara::com::SubscriptionState GetSubscriptionState () const noexcept;
SetReceiveHandler функция 2

Set/Register the event receive handler

Перегрузки SetReceiveHandler 2
void SetReceiveHandler (ara::com::EventReceiveHandler handler) noexcept; SWS_CM_00181
template <typename ExecutorT> void SetReceiveHandler (ara::com::EventReceiveHandler handler, ExecutorT &&executor) noexcept; SWS_CM_11356

Set ara::com::SubscriptionState change handler

Перегрузки SetSubscriptionStateChangeHandler 2
void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept; SWS_CM_00333
template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept; SWS_CM_11354

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Proxy Event.

Перегрузки SetTransportFaultConditionHandler 2
void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept; SWS_CM_00099
template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept; SWS_CM_00100
Subscribe функция

Method to subscribe to a service event. If the Event is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSampleCount value is the same as for the current subscription, the method shall return without action.

ara::core::Result< void > Subscribe (std::size_t maxSampleCount) noexcept;
UnsetReceiveHandler функция

Disable service event trigger

void UnsetReceiveHandler () noexcept;

Unset ara::com::SubscriptionState change handler

void UnsetSubscriptionStateChangeHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Event.

void UnsetTransportFaultConditionHandler () noexcept;
Unsubscribe функция

Method to unsubscribe from a service event. If the Event is not subscribed to at the time of the call, the method shall return without action.

void Unsubscribe () noexcept;

Псевдонимы типов

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

As per [SWS_CM_11400]

using SampleType = <PSampleCppidt>;

Документация методов

функция GetE2EStateMachineState [SWS_CM_11554] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineState () const noexcept;

Returns the state of the specific event class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::e2e::SMStateState of the specific event class
Siehe auch: [SWS_CM_90417]

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

Record
AUTOSAR/AP/record/SWS_CM_11554
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11554@rel:R25-11#ea09477e
Content hash
ea09477e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11554
Status: valid/unmigrated Version: rel:R25-11#4c81e570 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_11554@rel:R25-11#4c81e570
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#f9e478182026-09-30
  • R24-11rel:R24-11#5c2922c82026-10-14
  • R25-11rel:R25-11#4c81e5702026-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

функция GetFreeSampleCount [SWS_CM_00705] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00139

std::size_t GetFreeSampleCount () const noexcept;

Query Free Sample Slots

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
std::size_tThe number of free/unused slots for event sample data in the local cache

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

Record
AUTOSAR/AP/record/SWS_CM_00705
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00705@rel:R25-11#e7fecce9
Content hash
e7fecce9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00705
Status: valid/unmigrated Version: rel:R25-11#f96adb34 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_00705@rel:R25-11#f96adb34
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2f7ed5962026-09-30
  • R19-11rel:R19-11#008f5d482026-10-14
  • R20-11rel:R20-11#e5d3f0782026-10-14
  • R21-11rel:R21-11#c65b737d2026-10-14
  • R22-11rel:R22-11#c65b737d2026-10-14
  • R23-11rel:R23-11#c65b737d2026-10-14
  • R24-11rel:R24-11#61ce58d62026-10-14
  • R25-11rel:R25-11#f96adb342026-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

функция GetNewSamples [SWS_CM_00701] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139

template <typename F> ara::core::Result< std::size_t > GetNewSamples (F &&f, std::size_t max NumberOfSamples=std::numeric_limits< std::size_t >::max()) noexcept;

Method to update the event cache.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Template-Parameter

ParameterBeschreibung
FFunctor which shall process the received samples

Parameter (in)

ParameterBeschreibung
fCallable ([[func.wrap]]) f with signature void(ara::com:: SamplePtr<SampleType const>)
maxNumberOfSamplesMaximum number of received data samples being processed in the function call.

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >• If successful: an ara::core::Result containing a ara:: core::Result::value_type i.e. a std::size_t the total number of data samples passed to f • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kMaxSamplesExceededno_rollback_semantics Application holds more ara::com::SamplePtrs than commited in Subscribe() Samples were possibly skipped.

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

Record
AUTOSAR/AP/record/SWS_CM_00701
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00701@rel:R25-11#9d089c9c
Content hash
9d089c9c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00701
Status: valid/unmigrated Version: rel:R25-11#7a1e5108 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_00701@rel:R25-11#7a1e5108
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#35572f2e2026-09-30
  • R19-11rel:R19-11#a5b2b06e2026-10-14
  • R20-11rel:R20-11#d77236b02026-10-14
  • R21-11rel:R21-11#687f003e2026-10-14
  • R22-11rel:R22-11#687f003e2026-10-14
  • R23-11rel:R23-11#687f003e2026-10-14
  • R24-11rel:R24-11#a6b509202026-10-14
  • R25-11rel:R25-11#7a1e51082026-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

функция GetSubscriptionState [SWS_CM_00316] Upstream: RS_CM_00106

ara::com::SubscriptionState GetSubscriptionState () const noexcept;
Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::SubscriptionStateThe state of the subscription.

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

Record
AUTOSAR/AP/record/SWS_CM_00316
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00316@rel:R25-11#f81d1469
Content hash
f81d1469
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00316
Status: valid/unmigrated Version: rel:R25-11#755da336 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_00316@rel:R25-11#755da336
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#6bf8f8882026-09-30
  • R19-11rel:R19-11#cabe62962026-10-14
  • R20-11rel:R20-11#cabe62962026-10-14
  • R21-11rel:R21-11#cabe62962026-10-14
  • R22-11rel:R22-11#cabe62962026-10-14
  • R23-11rel:R23-11#4857a81f2026-10-14
  • R24-11rel:R24-11#3c50d0a12026-10-14
  • R25-11rel:R25-11#755da3362026-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

функция SetReceiveHandler [SWS_CM_00181] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120, RS_AP_00121

void SetReceiveHandler (ara::com::EventReceiveHandler handler) noexcept;

Set/Register the event receive handler

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

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

Функция SetReceiveHandler служит на стороне клиента в области видимости <SI-Namespace>::proxy::events::<Event> для регистрации обработчика обратного вызова для поступающих событий [SWS_CM_00181]. В качестве параметра передается ara::com::EventReceiveHandler, который определен как функция без параметров и вызывается Communication Management при поступлении события [SWS_CM_00181]. Функция не имеет возвращаемого значения (void) [SWS_CM_00181].

Обработка ошибок и поведение при исключениях

Операция специфицирована как noexcept и безопасная относительно исключений (exception safe) [SWS_CM_00181]. Если переданный вызываемый объект не существует или равен null, это расценивается как InvalidHandlerViolation [SWS_CM_00181].

Контекст выполнения и взаимодействие

В рамках интерфейсов прокси SetReceiveHandler относится к базовым механизмам наряду с такими вызовами, как UnsetReceiveHandler() и GetNewSamples() ARAComAPI §5.3.1 «Proxy Class API’s». Если обработчик должен выполняться в заданном контексте, доступна шаблонная перегрузка с ExecutorT [SWS_CM_11356] (ARAComAPI с. 10).

Тот же подход к уведомлениям используется и для триггеров через [SWS_CM_00250] (с контекстом: [SWS_CM_00352]), а также для полей через [SWS_CM_11605] (с контекстом: [SWS_CM_11611]) ARAComAPI §4.2 «Means of Communication».

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

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerThe handler that shall be called by Communication Management upon event arrival. The EventReceiveHandler constitutes a function without parameters and has to use the f method of the specific Event class to access the retrieved event data. See [SWS_CM_00309] for its definition.

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00181
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00181@rel:R25-11#98e39421
Content hash
98e39421
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00181
Status: valid/unmigrated Version: rel:R25-11#bc1861fe 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_00181@rel:R25-11#bc1861fe
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#20b3d9582026-09-30
  • R19-11rel:R19-11#7d8bf15d2026-10-14
  • R20-11rel:R20-11#60f2a7dc2026-10-14
  • R21-11rel:R21-11#240b5a672026-10-14
  • R22-11rel:R22-11#ab46c35e2026-10-14
  • R23-11rel:R23-11#345270f22026-10-14
  • R24-11rel:R24-11#0dc195ca2026-10-14
  • R25-11rel:R25-11#bc1861fe2026-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

функция SetReceiveHandler [SWS_CM_11356] Upstream: RS_CM_00211, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetReceiveHandler (ara::com::EventReceiveHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_00181] but the method shall execute in a provided context

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00181]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11356
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11356@rel:R25-11#b0ff1c20
Content hash
b0ff1c20
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11356
Status: valid/unmigrated Version: rel:R25-11#e20529b7 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_11356@rel:R25-11#e20529b7
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#5d1f03342026-09-30
  • R20-11rel:R20-11#fec7d2902026-10-14
  • R21-11rel:R21-11#386272552026-10-14
  • R22-11rel:R22-11#386272552026-10-14
  • R23-11rel:R23-11#a1cf75c52026-10-14
  • R24-11rel:R24-11#0f9051a22026-10-14
  • R25-11rel:R25-11#e20529b72026-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

функция SetSubscriptionStateChangeHandler [SWS_CM_00333] Upstream: RS_CM_00106

void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept;

Set ara::com::SubscriptionState change handler

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

Метод SetSubscriptionStateChangeHandler в пространстве имен proxy::events::<Event> регистрирует функцию обратного вызова, которую вызывает Communication Management при изменении состояния ara::com::SubscriptionState события ([SWS_CM_00333]). Функция объявлена как noexcept и считается исключениебезопасной ([SWS_CM_00333]).

Использование и асинхронная семантика

Вызовы Subscribe() в принципе работают асинхронно; успешная подписка может считаться завершенной только тогда, когда зарегистрированный обработчик или GetSubscriptionState() сообщает состояние kSubscribed ([SWS_CM_12006]). Обработчик вызывается с kSubscriptionPending, если подписка не вступает в силу немедленно (например, из-за задержек протокола шины) или если экземпляр сервера недоступен из-за перезапусков или сетевых сбоев ([SWS_CM_00313]). Отмена регистрации обработчика осуществляется через UnsetSubscriptionStateChangeHandler() (EXP ARAComAPI §5.3.1 «Proxy Class API’s»).

Обработка ошибок и граничные условия

Если действительный объект обратного вызова не передан или равен null, возникает ошибочная ситуация InvalidHandlerViolation ([SWS_CM_00333]). Что касается порядка вызовов, обработчик целесообразно зарегистрировать до Subscribe(), чтобы надежно отслеживать ранние переходы состояний. Вопрос Q-3b9c25c6aa2d0a0f (открытый)

Взаимодействие и варианты

Для выполнения обработчика в заданном контексте потока или контексте выполнения доступен перегруженный шаблонный вариант с параметром ExecutorT ([SWS_CM_11354]). Параллельные интерфейсы существуют для триггеров Proxy ([SWS_CM_01107]), полей Proxy ([SWS_CM_11607]), а также на уровне Skeleton ([SWS_CM_12008]).

Сгенерированное ИИ указание по использованию на основе AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerThe handler that shall be called by Communication Management when the ara::com::SubscriptionState of the event has changed.

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00333
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00333@rel:R25-11#eb54147f
Content hash
eb54147f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00333
Status: valid/unmigrated Version: rel:R25-11#dcf32e4c 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_00333@rel:R25-11#dcf32e4c
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#7e30b3f52026-09-30
  • R19-11rel:R19-11#ae3e84222026-10-14
  • R20-11rel:R20-11#32090fe52026-10-14
  • R21-11rel:R21-11#0c6444642026-10-14
  • R22-11rel:R22-11#b8f5d2782026-10-14
  • R23-11rel:R23-11#a0c415c22026-10-14
  • R24-11rel:R24-11#2a72383b2026-10-14
  • R25-11rel:R25-11#dcf32e4c2026-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

функция SetSubscriptionStateChangeHandler [SWS_CM_11354] Upstream: RS_CM_00211, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_00333] but the method shall execute in a provided context

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

Шаблонная функция-член SetSubscriptionStateChangeHandler служит в области видимости proxy::events::<Event> для регистрации функции обратного вызова для изменений состояния подписки (ara::com::SubscriptionState) ([SWS_CM_11354], AP EXP ARAComAPI §5.3.1 «Proxy Class API’s»). В отличие от базовой функции [SWS_CM_00333], обработчик выполняется не во внутреннем контексте Communication Management, а передается через параметр шаблона ExecutorT в предоставленный контекст выполнения executor ([SWS_CM_11360], AP EXP ARAComAPI §1.0 «SetSubscriptionState with ExecutorT»).

Параметры и возвращаемые значения

  • handler: вызываемый callable-объект, который получает уведомление при изменении ara::com::SubscriptionState события ([SWS_CM_00333]).
  • executor: контекст выполнения согласно [SWS_CM_11360], в котором должен отрабатывать обработчик.
  • Возвращаемое значение: функция не имеет возвращаемого значения (void).

Обработка ошибок и выполнение

Функция объявлена как noexcept и специфицирована как исключениебезопасная (exception safe). Если переданный вызываемый объект handler не существует или равен null, генерируется InvalidHandlerViolation ([SWS_CM_11354]).

Взаимодействие

Шаблон мониторинга состояния с привязкой к контексту с помощью ExecutorT существует аналогично для триггеров Proxy ([SWS_CM_01106]), а также полей Proxy ([SWS_CM_11608]). Если вынос в специальный контекст не требуется, доступен вариант [SWS_CM_00333].

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

Руководство разработчика реализации в подготовке (сложность I3)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00333]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11354
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11354@rel:R25-11#8bb9d52c
Content hash
8bb9d52c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11354
Status: valid/unmigrated Version: rel:R25-11#a42e5998 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_11354@rel:R25-11#a42e5998
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#98929d192026-09-30
  • R20-11rel:R20-11#17b3a5402026-10-14
  • R21-11rel:R21-11#f500c0cd2026-10-14
  • R22-11rel:R22-11#f500c0cd2026-10-14
  • R23-11rel:R23-11#7e227a6e2026-10-14
  • R24-11rel:R24-11#65eecdd42026-10-14
  • R25-11rel:R25-11#a42e59982026-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

функция SetTransportFaultConditionHandler [SWS_CM_00099] Upstream: RS_CM_00224, RS_E2E_08534

void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept;

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Proxy Event.

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

Функция-член SetTransportFaultConditionHandler служит для регистрации функции обратного вызова типа ara::com::e2e::TransportFaultConditionHandler на событии Proxy ([SWS_CM_00099]). Через этот обработчик сообщается об ошибках передачи, обнаруженных на транспортном уровне коммуникационного биндинга ([SWS_CM_00211]).

Использование и семантика:

  • Вызов и параметры: функция принимает вызываемый объект обработчика handler и не возвращает значения ([SWS_CM_00099]). Сигнатура метода объявлена как noexcept ([SWS_CM_00099]).
  • Передаваемые состояния ошибок: зарегистрированный обработчик в случае ошибки сообщает значения перечисления ara::com::e2e::TransportFaultCondition, такие как, например, kSampleRejected при отброшенных сэмплах базового транспортного канала ([SWS_CM_00211]).
  • Контекст выполнения: для асинхронного выполнения доступна шаблонная перегрузка с дополнительным объектом Executor ExecutorT&& executor ([SWS_CM_00100]).

Обработка ошибок и граничные условия:

  • Безопасность исключений: функция считается исключениебезопасной (exception safe) ([SWS_CM_00099]).
  • Нарушения: если переданный вызываемый объект не существует или равен null, имеет место InvalidHandlerViolation ([SWS_CM_00099]).
  • Взаимодействие: эквивалентные интерфейсы для регистрации TransportFaultConditionHandler существуют также для триггеров ([SWS_CM_00106]), нотификаторов полей ([SWS_CM_00109]) и методов Skeleton ([SWS_CM_00093]).

Это указание по использованию было создано автоматически на основе спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerHandler of type ara::com::e2e:: TransportFaultConditionHandler to be set

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00099
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00099@rel:R25-11#14c00b4d
Content hash
14c00b4d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00099
Status: valid/unmigrated Version: rel:R25-11#e31b701b 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_00099@rel:R25-11#e31b701b
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#019ce7992026-09-30
  • R24-11rel:R24-11#585ff7702026-10-14
  • R25-11rel:R25-11#e31b701b2026-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

функция SetTransportFaultConditionHandler [SWS_CM_00100] Upstream: RS_CM_00224, RS_E2E_08534

template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept;

Execution Context overload for hierarchicalnamespacelistlowerproxy::proxy:: events::eventname::SetTransportFaultConditionHandler for a given Proxy Event.

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

Шаблонная функция SetTransportFaultConditionHandler регистрирует на событии Proxy специфичный для приложения обработчик типа ara::com::e2e::TransportFaultConditionHandler вместе с пользовательским Executor ([SWS_CM_00100]). Она представляет собой перегрузку базовой функции с контекстом выполнения и меньшим числом параметров ([SWS_CM_00099]).

Использование и параметры: метод вызывается на экземплярах <SI-Namespace>::proxy::events::<Event> и не возвращает значения (void) ([SWS_CM_00100]). Он принимает вызываемый обработчик (handler) и принимает объект Executor (executor как универсальную ссылку ExecutorT&&), в контексте которого инициируется любое асинхронное выполнение обработчика ([SWS_CM_00100]). Сигнатура функции объявлена с noexcept ([SWS_CM_00100]).

Обработка ошибок: операция специфицирована как exception safe ([SWS_CM_00100]). Если передан недействительный или несуществующий вызываемый объект (null), имеет место нарушение в форме InvalidHandlerViolation ([SWS_CM_00100]). Через зарегистрированный обработчик сообщается об обнаруженных транспортных ошибках, таких как TransportFaultCondition::kSampleRejected при сбросе входящих выборок данных базовой транспортной сущностью ([SWS_CM_00211]).

Взаимодействие: в то время как [SWS_CM_00099] выполняет регистрацию без явного Executor, эта перегрузка делает возможным выполнение в желаемом контексте потока или задачи ([SWS_CM_00100]). Аналогичные перегрузки с Executor доступны для методов Skeleton ([SWS_CM_00094]) и полей Skeleton ([SWS_CM_00097]), а также на стороне Proxy для триггеров ([SWS_CM_00107]) и нотификаторов полей ([SWS_CM_00110]).

Это указание по использованию было сгенерировано автоматически на основе спецификации.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerHandler of type ara::com::e2e:: TransportFaultConditionHandler to be set
executorExecutor object in which any asynchronous computation spawn shall be invoked

Rückgabewert

TypBeschreibung
None
Siehe auch: [SWS_CM_00099]

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

Record
AUTOSAR/AP/record/SWS_CM_00100
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00100@rel:R25-11#4a7f5146
Content hash
4a7f5146
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00100
Status: valid/unmigrated Version: rel:R25-11#8df441ab 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_00100@rel:R25-11#8df441ab
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#bf7821ea2026-09-30
  • R24-11rel:R24-11#bf203b682026-10-14
  • R25-11rel:R25-11#8df441ab2026-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

функция Subscribe [SWS_CM_00141] Upstream: RS_CM_00103

ara::core::Result< void > Subscribe (std::size_t maxSampleCount) noexcept;

Method to subscribe to a service event. If the Event is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSampleCount value is the same as for the current subscription, the method shall return without action.

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

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

Метод Subscribe регистрирует элемент прокси для приема событий сервиса согласно [SWS_CM_00141]. Вызов имеет асинхронную природу: возврат функции лишь подтверждает, что Communication Management приняло запрос на регистрацию (AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2 «Monitoring Event Subscription»). С помощью обязательного параметра maxSampleCount приложение однозначно сообщает, какое максимальное количество сэмплов событий оно будет удерживать одновременно, инициализируя тем самым локальный буфер приема (AUTOSAR_AP_EXP_ARAComAPI с. 40).

Обработка ошибок и граничные условия

Если при вызове событие уже находится в состоянии kSubscribed или kSubscriptionPending и переданное значение maxSampleCount совпадает с активной подпиской, метод успешно завершается без выполнения каких-либо действий ([SWS_CM_00141]). Если же размер кэша при повторной подписке отличается, вызов завершается сбоем и возвращает в ara::core::Result код ошибки ComErrc::kMaxSampleCountNotRealizable ([SWS_CM_00141]). При отсутствии прав доступа вызов отклоняется (InsufficientPermissionsViolation согласно [SWS_CM_00141]). Сигнатура объявлена как noexcept и считается безопасной относительно исключений.

Взаимодействие

Зарезервированная емкость кэша ограничивает последующий прием данных через GetNewSamples ([SWS_CM_00701]); если приложение удерживает больше смарт-указателей, чем указано, генерируется ошибка ComErrc::kMaxSamplesExceeded ([SWS_CM_10432]). В то время как события полей подписываются аналогично через maxSampleCount ([SWS_CM_11601]), чистые триггерные события не требуют указания размера буфера ([SWS_CM_00723]).

Этот текст был сгенерирован автоматически на основе спецификаций и руководств по проектированию.

Руководство разработчика реализации в подготовке (сложность I3)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
maxSampleCountThe cacheSize of the subscription.

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a void • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kMaxSampleCountNotRealizablerollback_semantics Provided maxSampleCount for event re-subscription does not match the maxSampleCount for the current subscription

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

Record
AUTOSAR/AP/record/SWS_CM_00141
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00141@rel:R25-11#0cbe944f
Content hash
0cbe944f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00141
Status: valid/unmigrated Version: rel:R25-11#fab10569 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_00141@rel:R25-11#fab10569
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#639e01622026-09-30
  • R19-11rel:R19-11#19cbb2e62026-10-14
  • R20-11rel:R20-11#42b50f0e2026-10-14
  • R21-11rel:R21-11#7783d2a22026-10-14
  • R22-11rel:R22-11#8604fb982026-10-14
  • R23-11rel:R23-11#c0e97b762026-10-14
  • R24-11rel:R24-11#9932adce2026-10-14
  • R25-11rel:R25-11#fab105692026-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

функция UnsetReceiveHandler [SWS_CM_00183] Upstream: RS_CM_00203

void UnsetReceiveHandler () noexcept;

Disable service event trigger

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

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

Функция UnsetReceiveHandler является частью обертки события в области видимости <SI-Namespace>::proxy::events::<Event> и подключается через заголовочный файл #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ([SWS_CM_00183]). Она не принимает входных параметров и не имеет возвращаемого значения (void). Вызов удаляет ранее зарегистрированный с помощью SetReceiveHandler специфичный для приложения обработчик приема события сервиса (EXP ARAComAPI §5.3.2 «RadarService Proxy Class Example»). Благодаря этому принимающее приложение может в любой момент переключаться между приемом по событиям («event-driven») и активным опросом («polling style») с помощью GetNewSamples() (EXP ARAComAPI §5.3.2 «RadarService Proxy Class Example»).

Обработка ошибок

Метод объявлен с noexcept и обладает свойством exception safe ([SWS_CM_00183]). Во время выполнения он не генерирует исключений и не возвращает специфических кодов ошибок.

Параллелизм и привязка

В то время как для зарегистрированного обработчика обратного вызова действует правило, что он не обязан быть реентерабельным, поскольку Communication Management сериализует вызовы (EXP ARAComAPI §5.3.2 «RadarService Proxy Class Example»), UnsetReceiveHandler деактивирует триггер события для приема дальнейших уведомлений ([SWS_CM_00183]). В контексте привязки DDS метод UnsetReceiveHandler() согласно [SWS_CM_11141] отображается в соответствии с требованием [SWS_CM_11026] на соответствующий DataReader.

Взаимодействие

Функция является прямым аналогом регистрации через SetReceiveHandler ([SWS_CM_11140], EXP ARAComAPI §5.3.1 «Proxy Class API’s»). Родственные функции можно найти в других интерфейсах прокси:

  • Для полей существует функция с идентичным именем UnsetReceiveHandler в области видимости <SI-Namespace>::proxy::fields::<Field>, которая также определена как noexcept и exception safe ([SWS_CM_11606]).
  • Для триггеров в области видимости <SI-Namespace>::proxy::triggers::<Trigger> доступна функция UnsetReceiveHandler, однако в отличие от них она объявлена как not exception safe ([SWS_CM_11614]).

Это указание по использованию было создано автоматически на основе спецификаций AUTOSAR для релиза R25-11.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00183
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00183@rel:R25-11#b51a1d14
Content hash
b51a1d14
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00183
Status: valid/unmigrated Version: rel:R25-11#e2575812 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_00183@rel:R25-11#e2575812
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#25a6b80b2026-09-30
  • R19-11rel:R19-11#fd0581df2026-10-14
  • R20-11rel:R20-11#3f0ce8552026-10-14
  • R21-11rel:R21-11#28b9e8462026-10-14
  • R22-11rel:R22-11#28b9e8462026-10-14
  • R23-11rel:R23-11#668a18f72026-10-14
  • R24-11rel:R24-11#2c9f36f32026-10-14
  • R25-11rel:R25-11#e25758122026-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

функция UnsetSubscriptionStateChangeHandler [SWS_CM_00334] Upstream: RS_CM_00106, RS_AP_00114, RS_AP_00120

void UnsetSubscriptionStateChangeHandler () noexcept;

Unset ara::com::SubscriptionState change handler

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

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

Функция-член UnsetSubscriptionStateChangeHandler служит для сброса и отмены регистрации ранее установленного callback-обработчика для изменений статуса подписки (ara::com::SubscriptionState) на стороне прокси ([SWS_CM_00334], EXP ARAComAPI §1.0). Функция является частью интерфейса событий и находится в прикладном пространстве имен под proxy::events ([SWS_CM_00334], SWS CommunicationManagement §8.3.2.2.4.5 «UnsetSubscriptionStateChangeHandler»). Для использования подключается сгенерированный заголовочный файл прокси <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h ([SWS_CM_00334]). Вызов выполняется синхронно, не принимает параметров и не возвращает значения ([SWS_CM_00334]).

Обработка ошибок

Согласно спецификации, функция объявлена с идентификатором noexcept и классифицирована как безопасная относительно исключений («exception safe») ([SWS_CM_00334]). В случае ошибки она не вызывает исключений C++ и не возвращает кодов ошибок ([SWS_CM_00334]).

Параллелизм и взаимодействие

Функция работает в связке с другими API прокси для поиска сервисов и управления событиями, такими как Subscribe(), Unsubscribe(), GetSubscriptionState() и SetSubscriptionStateChangeHandler() (EXP ARAComAPI §5.3.1 «Proxy Class API’s»). В качестве интерпретации: после вызова дальнейшие уведомления через дерегистрированный обработчик вызываться не должны. Вопрос Q-6173c01e6ca93876 (открытый) Симметричные аналоги для сброса обработчиков изменений статуса определены в спецификации для полей (fields) прокси ([SWS_CM_11609], SWS CommunicationManagement §8.3.3.2.4.5 «UnsetSubscriptionStateChangeHandler») и триггеров ([SWS_CM_01108]), а также на стороне поставщика сервиса (скелетона) для событий ([SWS_CM_12010]) и триггеров ([SWS_CM_01112]).

Данное указание по использованию было создано автоматически и основано на спецификации AUTOSAR Adaptive релиза R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00334
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00334@rel:R25-11#a612e496
Content hash
a612e496
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00334
Status: valid/unmigrated Version: rel:R25-11#d651d646 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_00334@rel:R25-11#d651d646
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b959e8182026-09-30
  • R19-11rel:R19-11#39ef71622026-10-14
  • R20-11rel:R20-11#39ef71622026-10-14
  • R21-11rel:R21-11#39ef71622026-10-14
  • R22-11rel:R22-11#b7b5edfa2026-10-14
  • R23-11rel:R23-11#45ddf5232026-10-14
  • R24-11rel:R24-11#a6b5c2732026-10-14
  • R25-11rel:R25-11#d651d6462026-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

функция UnsetTransportFaultConditionHandler [SWS_CM_00105] Upstream: RS_CM_00224, RS_E2E_08534

void UnsetTransportFaultConditionHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Event.

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

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

Функция UnsetTransportFaultConditionHandler в пространстве имён <SI-Namespace>::proxy::events::<Event> служит для отмены регистрации ранее зарегистрированного ara::com::e2e::TransportFaultConditionHandler для конкретного события прокси [SWS_CM_00105]. Объявление функции предоставляется через заголовочный файл <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h AUTOSAR_AP_SWS_CommunicationManagement §8.3.2.2.1.3 «UnsetTransportFaultConditionHandler». Вызов не принимает параметров и не возвращает значения (void).

Обработка ошибок и безопасность исключений

Функция объявлена с идентификатором noexcept и специфицирована как исключение-безопасная (exception safe) [SWS_CM_00105]. Ни специфические коды ошибок, ни уведомления подсистем ошибок или диагностики в стандарте не определены.

Ход выполнения и граничные условия

Вызов, вероятно, выполняется синхронно, чтобы немедленно отключить обработку ошибок E2E на уровне событий, например, если мониторинг события больше не требуется или перед освобождением соответствующего объекта прокси (Интерпретация). Вопрос Q-ff00695fff5407fe (открытый) После выполнения коммуникационный уровень больше не обрабатывает транспортные ошибки E2E через ранее сохранённый обратный вызов этого события.

Взаимодействие

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

  • Для уведомителей полей на уровне прокси служит функция [SWS_CM_00126].
  • Для триггеров прокси обработчик дерегистрируется через [SWS_CM_00108].
  • На стороне скелетона доступны аналогичные интерфейсы для всех методов сервисного интерфейса ([SWS_CM_00095]), а также для геттеров/сеттеров полей ([SWS_CM_00098]).

Это указание по использованию было сгенерировано ИИ на основе спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00105
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00105@rel:R25-11#d0fe1330
Content hash
d0fe1330
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00105
Status: valid/unmigrated Version: rel:R25-11#5d00ece2 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_00105@rel:R25-11#5d00ece2
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#cbff526c2026-09-30
  • R24-11rel:R24-11#0a8243012026-10-14
  • R25-11rel:R25-11#5d00ece22026-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

функция Unsubscribe [SWS_CM_00151] Upstream: RS_CM_00104

void Unsubscribe () noexcept;

Method to unsubscribe from a service event. If the Event is not subscribed to at the time of the call, the method shall return without action.

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

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

Метод Unsubscribe() завершает активную подписку на событие сервиса на стороне прокси ([SWS_CM_00151], EXP_ARAComAPI §5.5). Он определен в области видимости <SI-Namespace>::proxy::events::<Event> и подключается через заголовочный файл #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ([SWS_CM_00151]). Функция не принимает входных параметров и не возвращает значения (void). Если событие на момент вызова не было подписано, метод возвращает управление без выполнения каких-либо действий ([SWS_CM_00151]).

Обработка ошибок и безопасность исключений

Операция объявлена с идентификатором noexcept и специфицирована как исключебно-безопасная ([SWS_CM_00151]). В качестве нарушения (Violation) предусмотрено DanglingSamplesViolation, если перед вызовом метода было нарушено предварительное условие согласно [SWS_CM_00085] ([SWS_CM_00151]).

Взаимодействие и связанные интерфейсы

На сетевом уровне завершение подписки инициирует отправку сообщений SOME/IP типа StopSubscribeEventgroup ([SWS_CM_10378], SWS_CommunicationManagement §7.2.1.2.6). Внутри интерфейсов прокси Unsubscribe() относится к группе методов управления подписками (EXP_ARAComAPI §5.3.1). Идентичная семантика отмены подписки доступна также для триггеров сервиса ([SWS_CM_00810], EXP_ARAComAPI §4) и для уведомлений полей ([SWS_CM_11602]).

Это указание по использованию было сгенерировано автоматически. Все технические положения основаны на указанных спецификациях AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
Exception-Sicherheitexception safe
Verletzungen (Violations)DanglingSamplesVi- Precondition [SWS_CM_00085] has been violated. olation

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00151
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00151@rel:R25-11#17d6c33e
Content hash
17d6c33e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00151
Status: valid/unmigrated Version: rel:R25-11#4a3ec37b 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_00151@rel:R25-11#4a3ec37b
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#e72177162026-09-30
  • R19-11rel:R19-11#aeb6a3702026-10-14
  • R20-11rel:R20-11#4ea795962026-10-14
  • R21-11rel:R21-11#4ea795962026-10-14
  • R22-11rel:R22-11#4ea795962026-10-14
  • R23-11rel:R23-11#8175f92c2026-10-14
  • R24-11rel:R24-11#3ccefaa42026-10-14
  • R25-11rel:R25-11#4a3ec37b2026-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

Документация псевдонимов типов

псевдоним типа SampleType [SWS_CM_11401] Upstream: RS_CM_00103

using SampleType = <PSampleCppidt>;
Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::events::<Event>
SymbolSampleType

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

Record
AUTOSAR/AP/record/SWS_CM_11401
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11401@rel:R25-11#7e48d50e
Content hash
7e48d50e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11401
Status: valid/unmigrated Version: rel:R25-11#5ce42900 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_11401@rel:R25-11#5ce42900
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#9606a74c2026-09-30
  • R22-11rel:R22-11#076d95632026-10-14
  • R23-11rel:R23-11#076d95632026-10-14
  • R24-11rel:R24-11#99e1a61e2026-10-14
  • R25-11rel:R25-11#5ce429002026-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