clase ara::sm::SmErrorDomain

La función miembro ara::sm::SmErrorDomain::Message sirve para determinar de forma síncrona el mensaje de error textual asignado a un código de error determinado del dominio de error de State Management [SWS_SM_81249]. Está declarada en el archivo de cabecera ara/sm/sm_error_domain.h dentro del ámbito de la clase ara::sm::SmErrorDomain y cuenta en la especificación con el estado DRAFT AUTOSAR_AP_SWS_StateManagement §8.1.3.2.2.1 «Message».

La interfaz posee los siguientes parámetros y valores de retorno [SWS_SM_81249]:

• Parámetros: errorCode de tipo CodeType recibe el número de error numérico para el cual se solicita el mensaje de texto asociado.
• Valor de retorno: Un puntero de tipo const char * al mensaje de error asignado al código de error transmitido.

Para la ejecución se aplican estrictas garantías respecto a la concurrencia y al tratamiento de excepciones: la función está especificada como thread-safe y exception safe, así como declarada con el identificador noexcept [SWS_SM_81249]. Por tanto, puede invocarse de forma segura desde subprocesos arbitrarios sin bloqueos sincronizadores ni bloques try-catch.

En el marco de la gestión de errores de AUTOSAR Adaptive, el método sobrescribe la función virtual del dominio de error base. Interpretación: Dado que el valor de retorno está definido como const char * sin interfaz de asignación, es de suponer que el puntero haga referencia típicamente a literales de cadena estáticos que siguen siendo válidos durante todo el tiempo de ejecución del proceso. Pregunta Q-03fc170f18f910b4 (abierta)

El método de API Name de la clase de dominio de error ara::sm::SmErrorDomain sirve para obtener el nombre estandarizado del dominio de error de State Management ([SWS_SM_81248]). Según la especificación, la llamada síncrona devuelve siempre el valor de cadena constante "Sm" (SWS StateManagement §8.1.3.2.2.2 «Name»). Para su utilización debe incluirse el archivo de cabecera correspondiente ara/sm/sm_error_domain.h.

La función miembro no toma parámetros de transferencia y ofrece total seguridad frente a excepciones: está especificada como noexcept y exception safe ([SWS_SM_81248]), por lo que se garantiza que regresa sin lanzar excepciones y no genera códigos de error. Interpretación: Dado que como tipo de retorno se prescribe const char * con el valor fijo "Sm", es de suponer que la función haga referencia a un literal de cadena estático cuya vida útil es ilimitada. Pregunta Q-855d1837679010a7 (abierta)

En cuanto al contexto de llamada y a la concurrencia, el método está clasificado como thread-safe ([SWS_SM_81248]). Por lo tanto, puede ejecutarse en paralelo desde múltiples subprocesos sin sincronización manual. Para integradores y desarrolladores es además relevante que el requisito en la versión R25-11 cuenta con el estado DRAFT (SWS StateManagement §8.1.3.2.2.2 «Name»).

usar

El constructor predeterminado SmErrorDomain() crea de forma síncrona una instancia del dominio de errores ara::sm::SmErrorDomain ([SWS_SM_81247]). La declaración se encuentra en el archivo de cabecera ara/sm/sm_error_domain.h. La llamada no requiere parámetros de transferencia y devuelve directamente el objeto de dominio inicializado (SWS StateManagement §8.1.3.2.1.1 «Default Constructor»).

Manejo de errores

La función cuenta con el identificador noexcept y está clasificada como segura frente a excepciones (exception safe) ([SWS_SM_81247]). Durante la creación no se producen códigos de error y no se lanzan excepciones.

Concurrencia y restricciones

La creación está especificada como thread-safe ([SWS_SM_81247]). Por consiguiente, las instancias pueden crearse concurrentemente en entornos multihilo sin necesidad de mecanismos de sincronización adicionales. No existen condiciones especiales de orden.

Interacción

El objeto creado pertenece a la clase ara::sm::SmErrorDomain ([SWS_SM_81241]), la cual está especificada de conformidad con [SWS_CORE_90023]. Dentro del módulo State Management, el dominio de errores interactúa con los siguientes elementos:

• Errc ([SWS_SM_81245]) y Exception ([SWS_SM_81246]) como sinónimos de tipo para códigos de error (SmErrc) y tratamiento de excepciones (SmException).
• Name() ([SWS_SM_81248]) devuelve el nombre de dominio "Sm".
• Message() ([SWS_SM_81249]) traduce códigos de error en descripciones textuales.
• ThrowAsException() ([SWS_SM_81250]) lanza el código de error como excepción, siempre que las excepciones de C++ estén habilitadas ([SWS_CORE_10304]).
• GetSmDomain() ([SWS_SM_81251]) proporciona alternativamente una instancia global del dominio de errores.

La función ara::sm::SmErrorDomain::ThrowAsException sirve para lanzar un código de error del dominio de error de State Management directamente como una excepción de C++ [SWS_SM_81250]. Está declarada en el archivo de cabecera ara/sm/sm_error_domain.h y sobrescribe la correspondiente función base para dominios de error (SWS StateManagement §8.1.3.2.2.3 «ThrowAsException»).

Invocación y parámetros

El método se invoca de forma síncrona y toma como único parámetro de transferencia una referencia constante a errorCode (de tipo ara::core::ErrorCode) [SWS_SM_81250]. No proporciona ningún valor de retorno (void), ya que instancia y lanza la excepción perteneciente al código de error transmitido, con lo cual se interrumpe el flujo regular de control en el punto de llamada [SWS_SM_81250].

Concurrencia y condiciones de contorno

• Seguridad de subprocesos: La función está especificada explícitamente como segura para subprocesos (thread-safe) y, por lo tanto, puede invocarse sin problemas desde subprocesos concurrentes [SWS_SM_81250].
• Seguridad frente a excepciones: El comportamiento está documentado como not exception safe [SWS_SM_81250]; Interpretación: Es de suponer que esto se deba al hecho de que el lanzamiento de la excepción abandona el flujo regular de control y el método, por definición, falla o propaga una excepción. Pregunta Q-5afbb1be303b657b (abierta)
• Restricción del compilador: Según [SWS_CORE_10304], la función no participa en la resolución de sobrecarga (overload resolution) siempre que las excepciones de C++ estén desactivadas en la cadena de herramientas del compilador [SWS_SM_81250].