DEENESPTFRRUARHIKOZHNL

clase 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

Guía del usuarioGENERADO POR IA

Sirve como excepción específica de C++ para señalar errores procedentes de interfaces de extremo a extremo junto con el código de error.
GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: 385c2dd6528b Procedencia Preguntas abiertas (2)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

Sirve como excepción específica de C++ para señalar errores procedentes de interfaces de extremo a extremo junto con el código de error.

La clase ara::com::e2e::ComE2EException sirve como excepción estandarizada de C++ para notificar errores procedentes de las API E2E de la gestión de comunicación ([SWS_CM_12501]). Deriva de ara::core::Exception y encapsula un ara::core::ErrorCode específico, el cual se transfiere durante la instanciación a través de un constructor noexcept seguro frente a excepciones ([SWS_CM_12502]). Si las excepciones de C++ están desactivadas en la cadena de herramientas del compilador, la función emisora no participa en la resolución de sobrecargas según la especificación, de modo que esta ruta de error presupone la compatibilidad activa con excepciones.

Contexto

La clase ara::com::e2e::ComE2EException sirve como clase de excepción estandarizada de C++ que es lanzada por las API de extremo a extremo (E2E) en la gestión de comunicación para señalar condiciones de error producidas ([SWS_CM_12501], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). La clase está declarada como final y deriva públicamente de ara::core::Exception (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). Se proporciona a través del archivo de encabezado ara/com/e2e/e2e_error_domain.h ([SWS_CM_12502]).

Dentro de la arquitectura funcional de AUTOSAR Adaptive, ComE2EException actúa como puente de comunicación entre las rutinas de supervisión E2E de la plataforma y el software de aplicación invocador. Si una función E2E detecta un estado de error durante la comprobación o el procesamiento de datos, este error se transmite al flujo de control superior mediante el lanzamiento de esta excepción (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»).

Ciclo de vida

La instanciación de un objeto de ComE2EException se realiza explícitamente mediante la transferencia de un código de error al constructor explicit ComE2EException(ara::core::ErrorCode errorCode) noexcept ([SWS_CM_12502], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4.1.1.1 «ComE2EException»). El constructor está especificado como noexcept y seguro frente a excepciones (exception safe) ([SWS_CM_12502]). De este modo, se garantiza que durante la propia construcción de la excepción no puedan lanzarse más excepciones, lo que asegura la robustez en la ruta de error.

En relación con la propiedad, la excepción es generada por la interfaz E2E causante y se lanza por valor (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). En el lado de la aplicación, el objeto se captura típicamente como referencia constante. Tan pronto como se abandona el bloque de tratamiento correspondiente, se produce la destrucción automática en el marco del desenrollado regular de la pila en C++. Dado que la clase está definida como final, no se contemplan subclases.

Ruta de uso

El flujo típico durante el uso de la excepción se divide en las siguientes fases:

  • El software de aplicación invoca una función protegida por E2E de la gestión de comunicación.
  • La lógica E2E detecta un error durante el procesamiento o la comprobación de datos, instancia un ejemplar de ara::com::e2e::ComE2EException con el errorCode específico y lo lanza (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»).
  • La aplicación captura la excepción en un bloque try-catch. En este contexto, es de suponer (interpretación) que las entidades invocadoras accedan a los métodos base heredados de ara::core::Exception para evaluar el ara::core::ErrorCode contenido a efectos del diagnóstico de fallos. Pregunta Q-8dfac2428f223afe (abierta)
Flujo del tratamiento de excepciones en caso de errores E2EAplicaciónara::com E2E-APIComE2EExceptionInvocar operación con comprobación E2EUse Case: Caso de error en la comprobación E2EoptC++ Exceptions aktiviertComE2EException(errorCode) instanziierenthrow ComE2EExceptionCapturar la excepción y evaluar el código de error

Diagrama de secuencia: flujo del tratamiento de errores al presentarse fallos de E2E mediante ComE2EException. Fuentes: [SWS_CM_12501], [SWS_CM_12502], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException».

Escenarios de error

Para el uso de ComE2EException se aplica una condición previa esencial en relación con la toolchain: según [SWS_CORE_10304], la función que crea y lanza la instancia no participa en la resolución de sobrecarga (overload resolution) si las excepciones de C++ están desactivadas en el compilador (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). Por lo tanto, en entornos de tiempo de ejecución sin soporte para excepciones de C++, esta vía de señalización no existe; en tal caso, los fallos probablemente se transmitan (interpretación) a través de mecanismos de fallo alternativos de la plataforma no basados en excepciones. Pregunta Q-e1b3f4f1dfc191ef (abierta)

Siempre que las excepciones estén activas, cada ComE2EException transporta de manera vinculante un código de error ([SWS_CM_12502]). Como condición previa para la instanciación, debe haber disponible un ara::core::ErrorCode válido ([SWS_CM_12502]). Dado que el constructor está declarado como seguro frente a excepciones ([SWS_CM_12502]), la propia creación del objeto no puede fallar incluso en caso de error.

Esta guía se basa en la especificación AUTOSAR R25-11 y ha sido comisariada de forma automática.

Diagrama de clases UML

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

Constructores y destructor

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

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

Documentación de los métodos

función 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#a439e103
Content hash
a439e103
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