DEENESPTFRRUARHIKOZHNL

clase ara::shwa::ShwaException

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (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.

[AP_SWS_SHWA_01302] texto aún no importado Upstream: RS_AP_00122, RS_AP_00127

class ShwaException : public ara::core::Exception {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/shwa_error_domain.h"
Scopenamespace ara::shwa

Guía del usuarioGENERADO POR IA

Encapsula códigos de error del módulo shwa como excepción de C++ para la señalización y el tratamiento de errores de forma segura para subprocesos.
GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: 1a4cf59da390 Procedencia Preguntas abiertas (2)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

Encapsula códigos de error del módulo shwa como excepción de C++ para la señalización y el tratamiento de errores de forma segura para subprocesos.

La clase ara::shwa::ShwaException deriva de ara::core::Exception y sirve en el módulo shwa para la señalización de situaciones de error a través del mecanismo de excepciones de C++. Durante la instanciación, el constructor explícito toma un ara::core::ErrorCode que encapsula la causa del error y lo pone a disposición en el bloque de captura con fines de diagnóstico [AP_SWS_SHWA_01303]. Conforme a [AP_SWS_SHWA_01303], la creación está especificada como noexcept, segura frente a excepciones y segura para subprocesos. Interpretación: Los llamadores deberían capturar la excepción de forma estructurada y evaluar el código de error para evitar interrupciones no controladas del proceso. Pregunta (abierta)

Contexto

La clase ara::shwa::ShwaException representa en el módulo shwa de la AUTOSAR Adaptive Platform la clase de excepción especializada para la señalización de situaciones de error específicas del módulo. Según la sintaxis de la clase, el tipo deriva públicamente de ara::core::Exception y se integra de este modo en la jerarquía uniforme de excepciones de la Adaptive Platform. En la arquitectura del sistema, la clase funciona como puente entre los componentes internos del módulo shwa y las capas de aplicación llamadoras. Su propósito primordial es el transporte de un ara::core::ErrorCode a través del mecanismo de excepciones de C++, tal como acredita la declaración del constructor conforme a [AP_SWS_SHWA_01303]. Es de esperar que el código de aplicación emplee la clase como tipo de captura para diferenciar de manera orientada los errores procedentes del módulo shwa respecto a las excepciones genéricas de la plataforma. Pregunta Q-c74c928a939e73ad (abierta)

Ciclo de vida

El ciclo de vida de una instancia de ara::shwa::ShwaException comienza con su creación en el contexto de una detección de errores. Conforme a [AP_SWS_SHWA_01303], la creación se lleva a cabo mediante el constructor explicit ShwaException(ara::core::ErrorCode errorCode) noexcept. La inicialización vincula directamente el código de error transferido al objeto de excepción. La especificación garantiza para esta declaración total seguridad frente a excepciones (exception safe), así como seguridad para subprocesos (thread-safe) [AP_SWS_SHWA_01303]. Dado que el constructor está declarado como noexcept, la creación del objeto en sí misma garantiza no desencadenar excepciones secundarias.

Tras su creación, el objeto se transfiere al sistema de tiempo de ejecución de C++ mediante una sentencia throw. El sistema de tiempo de ejecución asume la gestión durante el desenrollado de pila (stack unwinding) hasta que el objeto queda vinculado en un bloque catch compatible. Al salir del bloque de excepción finaliza el tiempo de vida y el objeto se destruye automáticamente. Dado que la creación se especifica como segura para subprocesos [AP_SWS_SHWA_01303], varios hilos de ejecución pueden crear y lanzar instancias de manera independiente entre sí.

Ruta de uso

Una ruta de uso típica se inicia con la invocación de una función del módulo shwa por parte de una aplicación. Si la operación falla y la semántica específica del módulo contempla una excepción, el componente ejecutor instancia ara::shwa::ShwaException transfiriendo el ara::core::ErrorCode correspondiente [AP_SWS_SHWA_01303]. A continuación, se desencadena la excepción.

El código de aplicación llamador captura la excepción bien como ara::shwa::ShwaException o a través de la clase base ara::core::Exception. En el bloque de captura puede leerse el código de error encapsulado para analizar la causa, redactar entradas de registro o iniciar medidas de recuperación. La siguiente secuencia ilustra esta ruta.

Tratamiento de excepciones con ShwaExceptionAplicaciónSHWA-ModulShwaExceptionModuloperation anfordernoptFehlerzustand eingetretenShwaException(errorCode)throw ShwaExceptioncatch (ShwaException const& ex) / Auswertung

Diagrama de secuencia: Flujo típico de creación y tratamiento de excepciones en llamadas a funciones dentro del módulo shwa. Fuentes: [AP_SWS_SHWA_01303]

Escenarios de error

Como clase de excepción, la propia ara::shwa::ShwaException sirve para la señalización de escenarios de error. Su construcción exige como única precondición la transferencia de un ara::core::ErrorCode [AP_SWS_SHWA_01303]. Al marcar el constructor con explicit, se evitan conversiones de tipo implícitas involuntarias en tiempo de compilación.

Quedan excluidos los estados de error durante la construcción de la excepción, ya que el constructor está declarado con noexcept según [AP_SWS_SHWA_01303]. Por tanto, la instanciación es robusta y no provoca fallos de asignación ni cancelaciones en tiempo de ejecución. Un escenario de fallo crítico surge a nivel de sistema únicamente cuando el contexto llamador no captura una excepción lanzada: esto conduce a una llamada a std::terminate mediante el mecanismo estándar de C++. Interpretación: Los llamadores deberían proteger el bloque de excepciones y tratar el código de error para garantizar la estabilidad del proceso. Pregunta Q-0b08103bdf1368b7 (abierta)

Esta guía se basa exclusivamente en la especificación de interfaz del módulo shwa en AUTOSAR Adaptive Release R25-11.

Constructores y destructor

ShwaException función

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

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

Detalles

función ShwaException [AP_SWS_SHWA_01303] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00135, RS_AP_00159

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

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::ShwaException
Thread Safetythread-safe
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01303
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01303@rel:R25-11#03451011
Content hash
03451011
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01303
Status: valid/unmigrated Version: rel:R25-11#560c643e Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01303@rel:R25-11#560c643e
Point-in-Time History:
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