clase apext::tsync::TsyncFvmErrorDomain

La función miembro [SWS_TS_14210] pertenece a la clase apext::tsync::TsyncFvmErrorDomain y se incluye a través del archivo de cabecera apext/tsync/fvm_error_domain.h. Sirve para la determinación síncrona de la descripción textual de un código de error producido. Como parámetro de entrada, la función recibe el código de error numérico errorCode de tipo CodeType y devuelve el mensaje de error asociado a él como puntero a una cadena de caracteres constante (const char *).

En lo referente a la concurrencia y la tolerancia a fallos, la especificación asegura amplias garantías: el método está clasificado como thread-safe y, por lo tanto, puede invocarse desde hilos concurrentes sin medidas de sincronización adicionales [SWS_TS_14210]. Además, la función está catalogada como exception safe y provista del identificador noexcept, con lo que se descarta el lanzamiento de excepciones durante la ejecución.

En el módulo ts existe una estrecha relación con el elemento de especificación [SWS_TS_00907]. Este define la función análoga Message para el dominio de error ara::tsync::TsyncErrorDomain en la cabecera ara/tsync/tsync_error_domain.h. Ambas interfaces presentan la misma firma, así como compromisos idénticos en cuanto a seguridad de hilos y seguridad frente a excepciones, y garantizan una consulta uniforme de textos de error a través de distintos dominios.

La función miembro constante Name() de la clase apext::tsync::TsyncFvmErrorDomain devuelve un puntero a una cadena de caracteres inmutable (const char*) que representa el nombre del dominio de error para el Time-Synchronization-FVM [SWS_TS_14209]. La función sirve para consultar el identificador del dominio de error en tiempo de ejecución. La llamada se ejecuta de forma síncrona y sin parámetros, y requiere la inclusión del archivo de cabecera apext/tsync/fvm_error_domain.h [SWS_TS_14209].

En cuanto al comportamiento frente a errores, la interfaz está declarada como noexcept y se considera segura frente a excepciones (exception safe) [SWS_TS_14209]. Dado que únicamente hace referencia a una constante de cadena de caracteres almacenada de forma fija, no se devuelven códigos de error específicos y no se producen casos de error. Con respecto a la concurrencia, el método está clasificado expresamente como seguro para hilos (thread-safe) [SWS_TS_14209]. Por lo tanto, las llamadas paralelas desde múltiples hilos deberían ser admisibles en todo momento sin sincronización externa adicional ni mecanismos de protección. Pregunta Q-6664ffba9d211592 (abierta)

En la interacción arquitectónica, la función sobrescribe (override) la interfaz para la identificación de dominios de error y complementa la función análoga de [SWS_TS_00906]. Mientras que [SWS_TS_00906] proporciona a través de ara/tsync/tsync_error_domain.h el nombre del dominio de error ara::tsync::TsyncErrorDomain para la sincronización temporal básica, [SWS_TS_14209] sirve para la identificación del dominio de error especializado apext::tsync::TsyncFvmErrorDomain. Ambos métodos siguen así el modelo de errores uniforme de AUTOSAR Adaptive.

La función miembro ThrowAsException del dominio de error apext::tsync::TsyncFvmErrorDomain sirve para lanzar de forma síncrona una excepción de C++ basada en un código de error ([SWS_TS_14211]). La declaración está disponible a través de la cabecera apext/tsync/fvm_error_domain.h. El método toma el parámetro de entrada errorCode (const ara::core::ErrorCode &), instancia a partir de él una apext::tsync::TsyncFvmException específica y la lanza directamente ([SWS_TS_14211]). En consecuencia, la función especificada con noexcept(false) carece de valor de retorno.

Para el contexto de llamada, la función está especificada como segura para hilos (thread-safe), pero indicada como no segura frente a excepciones (not exception safe) ([SWS_TS_14211]). Interpretación: Esta clasificación como no segura frente a excepciones se debería a que el lanzamiento intencionado de una excepción finaliza el flujo de control regular. Pregunta Q-4d1dbde678635320 (abierta) Una restricción central del compilador la define [SWS_CORE_10304]: si las excepciones de C++ están desactivadas en la toolchain, la función no participa en la resolución de sobrecarga.

En el sistema global, la función complementa el tratamiento de errores de manera análoga a [SWS_TS_00908] de ara::tsync::TsyncErrorDomain. Mientras que allí se lanza una TsyncException, ThrowAsException permite en el dominio de error de FVM la transformación uniforme de un ara::core::ErrorCode en una excepción de C++ ([SWS_TS_14211]).

usar

El constructor por defecto sin parámetros TsyncFvmErrorDomain() crea de forma síncrona una nueva instancia del dominio de errores apext::tsync::TsyncFvmErrorDomain [SWS_TS_14208]. No espera parámetros de entrada y está declarado como constexpr así como noexcept. Para su integración debe incluirse el archivo de cabecera apext/tsync/fvm_error_domain.h [SWS_TS_14208].

Tratamiento de errores y concurrencia

Dado que el constructor está especificado como noexcept, no se producen excepciones durante la instanciación; la ejecución se considera segura para subprocesos y segura frente a excepciones [SWS_TS_14208]. El objeto creado gestiona y traduce códigos de error de la enumeración TsyncFvmErrc [SWS_TS_14202] (alias de tipo Errc [SWS_TS_14206]), la cual incluye los errores específicos kFVNotAvailable y kFVInitializeFailed [SWS_TS_14202].

Zusammenspiel y ciclo de vida

La instancia de dominio proporciona interfaces para la resolución de nombres y mensajes mediante Name() [SWS_TS_14209] y Message() [SWS_TS_14210], así como para lanzar excepciones de tipo específico mediante ThrowAsException() [SWS_TS_14211] utilizando Exception [SWS_TS_14207]. La destrucción se realiza a través del destructor virtual ~TsyncFvmErrorDomain() [SWS_TS_14201]. En el código de aplicación rara vez debería ser necesaria una construcción manual directa; es de suponer que en su lugar se obtenga la instancia singleton global a través de GetTsyncFvmErrorDomain() [SWS_TS_14212]. Pregunta Q-411a136f0129313a (abierta)