clase ara::tsync::TsyncErrorDomain

usar

El método Message de la clase ara::tsync::TsyncErrorDomain sirve para obtener de forma síncrona una descripción textual de error para un código de error transferido [SWS_TS_00907]. Se proporciona mediante el encabezado #include "ara/tsync/tsync_error_domain.h". Como parámetro de entrada, la función recibe errorCode del tipo CodeType y devuelve un puntero a cadena constante (const char *) al mensaje correspondiente [SWS_TS_00907].

Tratamiento de errores y concurrencia

La interfaz garantiza total seguridad frente a excepciones (exception safe) y está declarada como noexcept, por lo que se garantiza que la llamada se ejecute sin excepciones de C++ [SWS_TS_00907]. Además, la función está especificada como thread-safe y puede invocarse concurrentemente desde varios subprocesos sin inconvenientes [SWS_TS_00907]. Interpretación: El const char * devuelto debería apuntar a memoria estática e inmutable, por lo que a la parte llamante no le corresponde ninguna liberación manual de memoria. Pregunta Q-933f88e4fde03016 (abierta)

Interacción

Como método sobrescrito (override), la función se integra en el modelo uniforme de errores de AUTOSAR Adaptive [SWS_TS_00907]. De manera similar, apext::tsync::TsyncFvmErrorDomain del encabezado #include "apext/tsync/fvm_error_domain.h" también implementa una función Message homónima para resolver textos de error específicos del dominio bajo las mismas garantías relativas a la seguridad para subprocesos y frente a excepciones [SWS_TS_14210].

Uso y contexto de llamada

La función miembro Name() de la clase ara::tsync::TsyncErrorDomain devuelve un puntero a una cadena de caracteres constante que identifica el dominio de error [SWS_TS_00906]. La función requiere el archivo de encabezado ara/tsync/tsync_error_domain.h, se invoca de forma síncrona y no recibe parámetros [SWS_TS_00906]. Como valor de retorno se transfiere el tipo const char * [SWS_TS_00906]. Interpretación: Dado que el valor de retorno está definido como constante de cadena de caracteres, el área de memoria debería tener duración estática y la parte llamante no debe modificarla ni liberarla. Pregunta Q-f9cb9d4986d49755 (abierta)

Tratamiento de errores y concurrencia

El método está declarado como noexcept y especificado como seguro frente a excepciones («exception safe»), con lo que se garantiza que no se lancen excepciones [SWS_TS_00906]. No existen códigos de error específicos, mensajes DET o DEM para esta llamada. En cuanto al comportamiento de concurrencia, la función está clasificada como segura para subprocesos («thread-safe») [SWS_TS_00906]. Por consiguiente, la llamada puede realizarse en paralelo desde múltiples contextos de ejecución sin sincronización externa.

Interacción y requisitos relacionados

Con el distintivo override, la función sobrescribe la interfaz estandarizada para la designación de dominio en el módulo ts [SWS_TS_00906]. El mismo patrón de diseño es implementado por el dominio de error relacionado apext::tsync::TsyncFvmErrorDomain, cuya función Name() de apext/tsync/fvm_error_domain.h proporciona asimismo de manera síncrona, segura para subprocesos y segura frente a excepciones el identificador correspondiente [SWS_TS_14209].

usar

La función miembro ThrowAsException de la clase ara::tsync::TsyncErrorDomain genera de forma síncrona a partir del parámetro transferido errorCode una nueva instancia de TsyncException y la lanza como excepción de C++ ([SWS_TS_00908]). La función no tiene valor de retorno (void) y se proporciona mediante el encabezado ara/tsync/tsync_error_domain.h.

Tratamiento de errores y seguridad frente a excepciones

El método está declarado con noexcept(false) y especificado como not exception safe ([SWS_TS_00908]). Interpretación: Esta clasificación probablemente se deba a que la función, conforme a su diseño, genera una excepción y, por tanto, abandona el flujo de control regular. Pregunta Q-cde17219378516c1 (abierta) No se devuelven códigos de error específicos, sino que se transportan a través del objeto de excepción lanzado.

Concurrencia y restricciones

La función está clasificada como thread-safe ([SWS_TS_00908]) y, por lo tanto, puede invocarse de forma segura desde subprocesos concurrentes. Una restricción esencial concierne a la cadena de herramientas (toolchain): según [SWS_CORE_10304], ThrowAsException no participa en la resolución de sobrecarga (overload resolution) si las excepciones de C++ están desactivadas en la cadena de herramientas del compilador.

Interacción

El comportamiento se corresponde con el patrón uniforme para dominios de error en AUTOSAR Adaptive. Una contraparte directa se encuentra en apext::tsync::TsyncFvmErrorDomain ([SWS_TS_14211]), donde ThrowAsException lanza una apext::tsync::TsyncFvmException y también está sujeta a las disposiciones de [SWS_CORE_10304].

usar

El constructor predeterminado sin parámetros crea una nueva instancia del dominio de errores ara::tsync::TsyncErrorDomain [SWS_TS_00905]. La declaración se proporciona a través del encabezado #include "ara/tsync/tsync_error_domain.h" [SWS_TS_00905]. La ejecución se realiza de forma síncrona, no acepta parámetros de entrada y no lanza excepciones de C++ (noexcept) [SWS_TS_00905].

Interacción y tratamiento de errores

El dominio de errores generado sirve para encapsular e interpretar estados de error específicos de sincronización en el módulo Time Synchronization. Dentro del dominio están disponibles los alias de tipo Errc para la enumeración de códigos de error TsyncErrc [SWS_TS_01266] así como Exception para la clase base de excepciones TsyncException [SWS_TS_01267]. Las instancias de la clase devuelven mediante el método Name una cadena de nombre constante del dominio [SWS_TS_00906] y mediante Message la descripción textual del error para un código de error especificado [SWS_TS_00907]. Además, ThrowAsException permite crear y lanzar una TsyncException a partir de un ara::core::ErrorCode, siempre que las excepciones de C++ estén habilitadas en el compilador [SWS_TS_00908]. En escenarios de uso típicos, es probable que rara vez sea necesaria una instanciación propia mediante el constructor, ya que a través de GetTsyncErrorDomain ya se encuentra disponible una referencia al objeto de instancia global [SWS_TS_00909]. Pregunta Q-8ebaff4e52125b78 (abierta)

Concurrencia y restricciones

La llamada está especificada como segura contra excepciones (exception safe) y segura para subprocesos (thread-safe) [SWS_TS_00905]. Por lo tanto, la instanciación puede llevarse a cabo entre diferentes subprocesos sin medidas de sincronización adicionales.