DEENESPTFRRUARHIKOZHNL

klasse ara::com::e2e::ComE2EException

[SWS_CM_12501] Upstream: RS_AP_00122, RS_AP_00127, RS_AP_00130

class ComE2EException final :            public ara::core::Exception {...};

Defines a class for exceptions to be thrown by the E2E APIs

Header-Datei#include "ara/com/e2e/e2e_error_domain.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com::e2e
Basisklasse(n)ara::core::Exception

User GuideAI-GEGENEREERD

Dient als specifieke C++-exceptie voor het signaleren van fouten vanuit End-to-End-interfaces inclusief foutcode.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 385c2dd6528b Herkomst Open vragen (2)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Dient als specifieke C++-exceptie voor het signaleren van fouten vanuit End-to-End-interfaces inclusief foutcode.

De klasse ara::com::e2e::ComE2EException dient als gestandaardiseerde C++-exceptie voor het melden van fouten vanuit de E2E-API's van Communication Management ([SWS_CM_12501]). Deze leidt af van ara::core::Exception en kapselt een specifieke ara::core::ErrorCode in, die bij de instantiëring via een uitzonderingsveilige noexcept-constructor wordt meegegeven ([SWS_CM_12502]). Indien C++-excepties in de compiler-toolchain zijn uitgeschakeld, neemt de werpende functie volgens de specificatie niet deel aan de overbelastingsresolutie, zodat dit foutpad actieve ondersteuning van excepties vereist.

Context

De klasse ara::com::e2e::ComE2EException dient als gestandaardiseerde C++-exceptionklasse die door de end-to-end-API's (E2E) in het communicatiemanagement wordt gegenereerd om opgetreden foutcondities te signaleren ([SWS_CM_12501], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). De klasse is gedeclareerd als final en leidt publiek af van ara::core::Exception (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). Ze wordt beschikbaar gesteld via het headerbestand ara/com/e2e/e2e_error_domain.h ([SWS_CM_12502]).

Binnen de functionele architectuur van AUTOSAR Adaptive fungeert ComE2EException als communicatiebrug tussen de E2E-bewakingsroutines van het platform en de aanroepende applicatiesoftware. Als een E2E-functie bij de controle of verwerking van gegevens een fouttoestand detecteert, wordt deze fout via het werpen van deze exceptie doorgegeven aan de bovenliggende control flow (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”).

Levenscyclus

De instantiëring van een object van ComE2EException vindt expliciet plaats door overdracht van een foutcode aan de constructor explicit ComE2EException(ara::core::ErrorCode errorCode) noexcept ([SWS_CM_12502], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4.1.1.1 “ComE2EException”). De constructor is gespecificeerd als noexcept en uitzonderingsveilig (exception safe) ([SWS_CM_12502]). Hierdoor wordt gegarandeerd dat bij de constructie van de exceptie zelf geen verdere excepties kunnen worden geworpen, wat de robuustheid in het foutpad waarborgt.

Met betrekking tot de eigendomsverhoudingen wordt de exceptie door de initiërende E2E-interface gegenereerd en per waarde geworpen (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). Aan applicatiezijde wordt het object typisch als constante referentie opgevangen. Zodra het desbetreffende afhandelingsblok wordt verlaten, vindt de automatische vernietiging plaats in het kader van de reguliere C++-stack-unwinding. Aangezien de klasse als final is gedefinieerd, zijn er geen subklassen voorzien.

Gebruikspad

Het typische verloop bij het gebruik van de exceptie is onderverdeeld in de volgende fasen:

  • De applicatiesoftware roept een E2E-beveiligde functie van het communicatiemanagement aan.
  • De E2E-logica stelt bij de gegevensverwerking of -controle een fout vast, instantieert een exemplaar van ara::com::e2e::ComE2EException met de specifieke errorCode en werpt dit (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”).
  • De applicatie vangt de exceptie op in een try-catch-blok. Aanroepers benaderen hierbij vermoedelijk (interpretatie) de overgeërfde basismethoden van ara::core::Exception om de aanwezige ara::core::ErrorCode voor de foutdiagnose te evalueren. Vraag Q-8dfac2428f223afe (open)
Verloop van de exceptieafhandeling bij E2E-foutenAnwendungara::com E2E-APIComE2EExceptionE2E-gecontroleerde operatie aanroepenUse Case: Foutgeval E2E-controleoptC++ Exceptions aktiviertComE2EException(errorCode) instanziierenthrow ComE2EExceptionException vangen en foutcode evalueren

Sequentiediagram: verloop van de foutafhandeling bij het optreden van E2E-fouten via ComE2EException. Bronnen: [SWS_CM_12501], [SWS_CM_12502], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”.

Foutscenario's

Voor het gebruik van ComE2EException geldt een wezenlijke voorwaarde ten aanzien van de toolchain: conform [SWS_CORE_10304] neemt de functie die de instantie genereert en werpt niet deel aan overload resolution als C++-exceptions in de compiler zijn uitgeschakeld (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). In runtime-omgevingen zonder ondersteuning voor C++-exceptions bestaat dit signaalpad daarom niet; fouten worden in dat geval vermoedelijk (interpretatie) doorgegeven via alternatieve, niet op excepties gebaseerde foutmechanismen van het platform. Vraag Q-e1b3f4f1dfc191ef (open)

Voor zover excepties actief zijn, transporteert elke ComE2EException verplicht een foutcode ([SWS_CM_12502]). Als voorwaarde voor de instantiëring moet er een geldige ara::core::ErrorCode beschikbaar zijn ([SWS_CM_12502]). Aangezien de constructor als uitzonderingsveilig is gedeclareerd ([SWS_CM_12502]), kan het aanmaken van het object zelfs bij fouten niet mislukken.

Deze handleiding is gebaseerd op de AUTOSAR-specificatie R25-11 en is automatisch gecureerd.

UML-klassendiagram

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

G nara__com__e2e__ComE2EException703 ComE2EException + ComE2EException() nara__core__Exception792 Exception nara__com__e2e__ComE2EException703->nara__core__Exception792 nstd__exception10 std::exception nara__core__Exception792->nstd__exception10

Constructors en destructor

Constructs a new ara::com::e2e::ComE2EException object containing an error code

explicit ComE2EException (ara::core::ErrorCode errorCode) noexcept;

Documentatie van de methoden

functie ComE2EException [SWS_CM_12502] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

explicit ComE2EException (ara::core::ErrorCode errorCode) noexcept;

Constructs a new ara::com::e2e::ComE2EException object containing an error code

Header-Datei#include "ara/com/e2e/e2e_error_domain.h"
Scopeclass ara::com::e2e::ComE2EException
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
errorCodeThe error code.

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

Record
AUTOSAR/AP/record/SWS_CM_12502
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12502@rel:R25-11#99153cef
Content hash
99153cef
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12502
Status: valid/unmigrated Version: rel:R25-11#f55f1c7d 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_12502@rel:R25-11#f55f1c7d
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#e593e1602026-09-30
  • R22-11rel:R22-11#803783f82026-10-14
  • R23-11rel:R23-11#0ff65df22026-10-14
  • R24-11rel:R24-11#eaa1533d2026-10-14
  • R25-11rel:R25-11#f55f1c7d2026-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