DEENESPTFRRUARHIKOZHNL

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

Diese Seite wurde vollständig KI-generiert auf Basis von SWS NetworkManagement (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

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

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

Обеспечивает контроль запрошенного и фактического сетевого статуса, а также стандартизированную обработку ошибок.

Пространство имен ara::nm с помощью NetworkHandle предоставляет интерфейсы для контролируемого доступа к запрошенному и фактическому состоянию сети AUTOSAR Adaptive Platform. Возможные ошибочные ситуации в процессе работы отображаются через стандартизированные коды ошибок перечисления NmErrc, такие как kServiceNotAvailable или kInvalidHandler [SWS_ANM_01111]. Для структурированной обработки ошибок MakeErrorCode потокобезопасно генерирует коды ошибок для домена ошибок NmErrorDomain, на который ссылается GetNmDomain [SWS_ANM_01109]. Перед вызовами приложения должны учитывать доступность службы Network Management, чтобы избежать сбоев при запросах статуса.

Контекст

Пространство имен ara::nm предоставляет на AUTOSAR Adaptive Platform основные интерфейсы для функционального Network Management. Первичным функциональным интерфейсом выступает класс NetworkHandle, который инкапсулирует контролируемый доступ как к запрошенному, так и к фактическому сетевому статусу. С помощью этого механизма абстракции функциональные приложения и сервисы платформы могут контролировать текущее рабочее состояние базовой сети связи и инициировать изменения статуса.

Для согласованной и надежной обработки ошибок ara::nm предоставляет стандартизированные типы и вспомогательные функции, интегрированные в архитектуру обработки ошибок AUTOSAR Adaptive. К ним относятся домен ошибок NmErrorDomain, класс исключений NmException, а также доменно-специфичное перечисление NmErrc [SWS_ANM_01111]. Кроме того, доступны потокобезопасные функции GetNmDomain [SWS_ANM_01109] и MakeErrorCode [SWS_ANM_01110], обеспечивающие корректную с точки зрения инстанцирования и типов обработку состояний ошибок.

diag_nm_kontext Anwendung Anwendung NetworkHandle NetworkHandle Anwendung->NetworkHandle использует NmErrorDomain NmErrorDomain Anwendung->NmErrorDomain проверяет NmException NmException Anwendung->NmException перехватывает NetworkHandle->NmErrorDomain ссылается на

Контекстная диаграмма: взаимодействие приложения, NetworkHandle и архитектуры ошибок в ara::nm. Источники: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

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

В типичном сценарии использования Adaptive Application взаимодействует с пространством имен ara::nm для контроля состояния сети и реагирования на события времени выполнения. Последовательность взаимодействия подразделяется на следующие шаги:

  • Инициирование доступа к статусу: приложение использует NetworkHandle для запроса требуемого или текущего фактического сетевого статуса.
  • Обнаружение ошибки: если сетевой запрос не может быть обслужен должным образом, интерфейс сигнализирует о соответствующем событии ошибки. Интерпретация: при сбоях базовых сетевых служб NetworkHandle, вероятно, внутренне генерирует коды ошибок на основе NmErrc. Вопрос Q-97b1567be5e28121 (открытый)
  • Генерация кода ошибки: вспомогательная функция MakeErrorCode [SWS_ANM_01110] принимает значение из NmErrc [SWS_ANM_01111], а также специфичные для приложения дополнительные данные (ara::core::ErrorDomain::SupportDataType) и генерирует на их основе полноценный ara::core::ErrorCode. Функция специфицирована как constexpr и noexcept и гарантирует полную потокобезопасность [SWS_ANM_01110].
  • Верификация домена ошибок: вызывающий компонент может через GetNmDomain [SWS_ANM_01109] получить потокобезопасную ссылку на глобальный NmErrorDomain, чтобы проверить домен ошибки возвращенного кода и разрешить доменно-специфичные описания ошибок.
Процесс взаимодействия со статусом сети и обработка ошибокПриложениеNetworkHandleNmErrorDomainNetzstatus anfordernaltСервис недоступенMakeErrorCode(NmErrc::kServiceNotAvailable, ...)[SWS_ANM_01110]ara::core::ErrorCodeВернуть код ошибки [SWS_ANM_01111]GetNmDomain() для валидации [SWS_ANM_01109]const ara::core::ErrorDomain&NormalbetriebEffektiven Netzstatus liefern

Диаграмма последовательности: процесс запроса сетевого статуса и разрешения ошибок через ara::nm. Источники: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

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

Стандартизированные коды ошибок модуля сгруппированы в перечислении NmErrc, основанном на ara::core::ErrorDomain::CodeType [SWS_ANM_01111]. Модуль различает следующие случаи ошибок:

  • NmErrc::kServiceNotAvailable (код 1): эта ошибка указывает на то, что необходимая для управления сетью служба во время выполнения недоступна или не готова к работе [SWS_ANM_01111]. В этом случае вызывающие компоненты должны отреагировать повторными попытками или резервными стратегиями.
  • NmErrc::kInvalidHandler (код 2): возникает, если при операции был передан или сослан недействительный или незарегистрированный обработчик [SWS_ANM_01111]. Обычно это указывает на ошибку конфигурации или инициализации в вызывающем компоненте.

Предусловиями для надежных вызовов являются инициализированная инфраструктура служб, а также действительные параметры при доступе к NetworkHandle для предотвращения NmErrc::kServiceNotAvailable или NmErrc::kInvalidHandler [SWS_ANM_01111]. Все основные функции обработки ошибок, такие как MakeErrorCode [SWS_ANM_01110] и GetNmDomain [SWS_ANM_01109], сами не генерируют исключений (noexcept). Интерпретация: для приложений, предпочитающих структуру управления на основе исключений, класс исключений NmException, вероятно, служит носителем для структурированного распространения состояний ошибок по стеку вызовов. Вопрос Q-67a17c37021e8beb (открытый)

Настоящее руководство было создано ИИ на основе спецификации AUTOSAR Adaptive (релиз R25-11).

Карта тем

Классы

3
NetworkHandleNmErrorDomainNmException

Функции

2
GetNmDomainMakeErrorCode

Типы и константы

1
NmErrc

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

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

Классы

NetworkHandle класс

Zugang zu angefordertem und effektivem Netzstatus.

NmErrorDomain класс

Fehlerdomäne für ara::nm.

NmException класс

Exception-Typ für ara::nm.

Функции

GetNmDomain функция
constexpr const ara::core::ErrorDomain& GetNmDomain() noexcept;
MakeErrorCode функция
constexpr ara::core::ErrorCode MakeErrorCode(NmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

Типы и константы

NmErrc перечисление
enum class NmErrc : ara::core::ErrorDomain::CodeType { kServiceNotAvailable = 1, kInvalidHandler = 2 };

Перечисления

перечисление NmErrc [SWS_ANM_01111]

enum class NmErrc : ara::core::ErrorDomain::CodeType { kServiceNotAvailable = 1, kInvalidHandler = 2 };
Headerara/nm/nm_error_domain.h
Upstream-AnforderungRS_AP_00122, RS_AP_00125, RS_AP_00127, RS_AP_00149

Standardisierte Network-Management-Fehlercodes.

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

Перечисление [SWS_ANM_01111] определяет стандартизированные коды ошибок Network Management (NM) в заголовочном файле ara/nm/nm_error_domain.h. Оно также предоставляется через псевдоним типа Errc [SWS_ANM_01103] и вместе с потокобезопасной фабричной функцией MakeErrorCode [SWS_ANM_01110] служит для инкапсуляции состояний ошибок в возвращаемых значениях ara::core::Result.

Определенные значения ошибок охватывают специфические случаи ошибок на интерфейсе NM:

  • kServiceNotAvailable (значение 1): возникает при синхронных запросах и требованиях состояния сети, если базовый сервис NM недоступен. Это касается считывания эффективного состояния сети через GetNetworkState [SWS_ANM_01007], запроса запрошенного состояния через GetNetworkRequestedState [SWS_ANM_01008], а также запроса или освобождения сетей через SetNetworkRequestedState [SWS_ANM_01009].
  • kInvalidHandler (значение 2): возвращается функциями регистрации обработчиков уведомлений, а именно RegisterNetworkStateChangeNotifier [SWS_ANM_01010], [SWS_ANM_01015] и RegisterNetworkRequestedStateChangeNotifier [SWS_ANM_01012], [SWS_ANM_01014]. Поскольку на каждый интерфейс разрешено регистрировать не более одного нотификатора, эта ошибка, вероятно, возникает, если передан пустой обратный вызов или регистрация уже существует (интерпретация). Вопрос Q-59365b2b5b2e664c (открытый)

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

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

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

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

Record
AUTOSAR/AP/record/SWS_ANM_01111
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_ANM_01111@rel:R25-11#583bc69a
Content hash
583bc69a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01111
Status: valid/unmigrated Version: rel:R25-11#31e88722 Versionshistorie & Revisions (1 transition, 4 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_ANM_01111@rel:R25-11#31e88722
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#3bd1d10b2026-09-30
  • R23-11rel:R23-11#b1db0f132026-10-14
  • R24-11rel:R24-11#74d33b0b2026-10-14
  • R25-11rel:R25-11#31e887222026-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

Документация свободных функций

функция GetNmDomain [SWS_ANM_01109]

constexpr const ara::core::ErrorDomain& GetNmDomain() noexcept;
Headerara/nm/nm_error_domain.h
Upstream-AnforderungRS_AP_00119, RS_AP_00120, RS_AP_00159
Thread Safetythread-safe
Rückgabeconst ara::core::ErrorDomain&

Gibt eine Referenz auf NmErrorDomain zurück.

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

Record
AUTOSAR/AP/record/SWS_ANM_01109
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_ANM_01109@rel:R25-11#26491b3a
Content hash
26491b3a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01109
Status: valid/unmigrated Version: rel:R25-11#f3783a2f Versionshistorie & Revisions (1 transition, 4 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_ANM_01109@rel:R25-11#f3783a2f
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#43e9e8262026-09-30
  • R23-11rel:R23-11#0c322a072026-10-14
  • R24-11rel:R24-11#f3783a2f2026-10-14
  • R25-11rel:R25-11#f3783a2f2026-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_ANM_01110]

constexpr ara::core::ErrorCode MakeErrorCode(NmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;
Headerara/nm/nm_error_domain.h
Upstream-AnforderungRS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00159, RS_AP_00135
Thread Safetythread-safe
Rückgabeara::core::ErrorCode

Erzeugt einen ara::core::ErrorCode für NmErrc.

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

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

Функция MakeErrorCode служит в модуле anm для создания стандартизированного ara::core::ErrorCode для ошибок Network Management [SWS_ANM_01110]. Функция определена в заголовке ara/nm/nm_error_domain.h и синхронно инкапсулирует специфический код ошибки code типа перечисления NmErrc вместе с зависящими от производителя дополнительными данными data типа ara::core::ErrorDomain::SupportDataType в соответствующий объект ошибки [SWS_ANM_01110]. Вызывающие стороны передают соответствующее состояние ошибки, а также контекстные данные, чтобы получить унифицированный объект ошибки для дальнейшей обработки ошибок [SWS_ANM_01110].

Обработка ошибок и параллелизм

Поскольку MakeErrorCode объявлена со спецификатором noexcept, функция гарантированно не генерирует исключений при своем выполнении [SWS_ANM_01110]. С точки зрения конкурентного поведения функция классифицирована как thread-safe; следовательно, ее можно безопасно вызывать из параллельных потоков без дополнительных внешних мер синхронизации [SWS_ANM_01110]. Благодаря квалификации в качестве constexpr конструирование объекта ошибки при передаче константных аргументов, вероятно, может быть полностью выполнено компилятором еще во время компиляции [SWS_ANM_01110]. Вопрос Q-a04f5f6a2218370e (открытый)

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

Являясь центральной функцией создания кодов ошибок Network Management, MakeErrorCode подключает модуль к общей концепции обработки ошибок платформы AUTOSAR Adaptive [SWS_ANM_01110]. При этом она напрямую адресует вышестоящие восходящие требования RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00159, а также RS_AP_00135 [SWS_ANM_01110].

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

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

Record
AUTOSAR/AP/record/SWS_ANM_01110
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_ANM_01110@rel:R25-11#3f53e193
Content hash
3f53e193
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01110
Status: valid/unmigrated Version: rel:R25-11#2b6b1c06 Versionshistorie & Revisions (1 transition, 4 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_ANM_01110@rel:R25-11#2b6b1c06
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#428b741c2026-09-30
  • R23-11rel:R23-11#1edc012e2026-10-14
  • R24-11rel:R24-11#2b6b1c062026-10-14
  • R25-11rel:R25-11#2b6b1c062026-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