clase ara::diag::ExternalAuthentication

El constructor explícito [SWS_DM_01193] inicializa una instancia de la clase de puerto ara::diag::ExternalAuthentication [SWS_DM_01191] para la autenticación de clientes de diagnóstico externos (SWS Diagnostics §8.17 «Header: ara/diag/external_authentication.h»). Como parámetro, la función espera un ara::core::InstanceSpecifier que debe hacer referencia a un PortPrototype modelado en el manifiesto de una instancia de servicio DiagnosticExternalAuthenticationInterface [SWS_DM_01193].

La llamada síncrona está declarada como noexcept y especificada tanto thread-safe como exception-safe [SWS_DM_01193]. Dado que no se lanzan excepciones, los errores de modelado y configuración conducen a violaciones definidas del framework [SWS_DM_01193]:

• InstanceSpecifierMappingIntegrityViolation: el identificador no puede resolverse en el contexto del ejecutable o hace referencia a un elemento de modelo distinto de un PortPrototype.
• PortInterfaceMappingViolation: el PortPrototype referenciado no está tipificado mediante un DiagnosticExternalAuthenticationInterface.
• ProcessMappingViolation: no existe ningún proceso de tiempo de ejecución modelado coincidente para la referencia.
• InstanceSpecifierAlreadyInUseViolation: el identificador ya está siendo utilizado por otra instancia en el proceso en ejecución.

Las operaciones de copia están explícitamente deshabilitadas para ExternalAuthentication [SWS_DM_01196] [SWS_DM_01197], mientras que las operaciones de movimiento están soportadas [SWS_DM_01194] [SWS_DM_01195]. A diferencia del constructor, el destructor correspondiente no es seguro para subprocesos [SWS_DM_01198]. Tras una instanciación exitosa, el objeto sirve para consultar instancias de autenticación de clientes asociadas a través de métodos como Get o GetAll [SWS_DM_01201] [SWS_DM_01202].

El método síncrono ara::diag::ExternalAuthentication::Get sirve para que una aplicación adaptativa obtenga la instancia de ara::diag::ClientAuthentication responsable de una solicitud de diagnóstico [SWS_DM_01199]. Como parámetro se transfiere una referencia a metaInfo (const ara::diag::MetaInfo&), la cual proporciona metainformación procedente del contexto de la solicitud de diagnóstico SWS Diagnostics §7.3.1.1 «MetaInfo class». El valor de retorno de tipo ara::core::Result<ClientAuthentication> encapsula el correspondiente objeto de autenticación para gestionar el estado de autenticación del cliente [SWS_DM_01202].

Si se produce un error, el Result devuelto contiene el código de error específico DiagErrc::kServiceNotAvailable [SWS_DM_01199]. Este señala, con semántica de rollback, que la invocación no puede ejecutarse porque funciones esenciales del Diagnostic Manager (DM) no están disponibles en el momento de la llamada [SWS_DM_01199].

En lo que respecta a la concurrencia, la función está especificada como thread-safe, así como exception safe, y declarada con noexcept [SWS_DM_01199]. Por lo tanto, puede invocarse de manera segura desde hilos paralelos sin mecanismos de bloqueo en la aplicación.

El método interactúa con la variante sobrecargada Get(Address sourceAddress) [SWS_DM_01200], la cual permite la misma obtención directamente mediante la dirección de origen del cliente [SWS_DM_01202]. El número de instancias disponibles viene determinado por los elementos de modelo DiagnosticExternalAuthenticationIdentification SWS Diagnostics «Get ClientAuthentication Instance». Interpretación: Es de prever que la función determine internamente la dirección de origen requerida para la asignación a partir de los datos de transporte encapsulados en metaInfo. Pregunta Q-50d416201ccb5825 (abierta)

El método síncrono Get de la clase ara::diag::ExternalAuthentication sirve para que una aplicación adaptativa obtenga la instancia de ClientAuthentication que gestiona el estado de autenticación del cliente de diagnóstico para la dirección de origen especificada [SWS_DM_01200]. En este proceso, el Diagnostic Manager resuelve el objeto de autenticación responsable a través de la dirección de origen transferida [SWS_DM_01202].

La utilización y las condiciones de contorno comprenden los siguientes aspectos:

• Invocación y parámetros: Como parámetro se transfiere sourceAddress de tipo Address [SWS_DM_01200]. La resolución se apoya en el modelo del sistema en elementos DiagnosticExternalAuthenticationIdentification configurados que definen direcciones de origen fijas o rangos de direcciones SWS Diagnostics p. 129 «ClientAuthentication». Además, existe una sobrecarga de Get que determina la instancia a través de un objeto MetaInfo [SWS_DM_01199], [SWS_DM_01202].
• Valor de retorno y tratamiento de errores: La función devuelve un ara::core::Result<ClientAuthentication> [SWS_DM_01200]. Si la ejecución no es posible porque funciones esenciales del Diagnostic Manager no están disponibles, se devuelve el error DiagErrc::kServiceNotAvailable con semántica de rollback [SWS_DM_01200].
• Concurrencia: La operación está especificada como thread-safe y exception safe, así como declarada con noexcept, por lo que las invocaciones desde hilos paralelos pueden llevarse a cabo de forma segura frente a excepciones [SWS_DM_01200].

usar

El método GetAll de la clase ara::diag::ExternalAuthentication (archivo de cabecera ara/diag/external_authentication.h) sirve para que las aplicaciones consulten de forma síncrona todas las instancias de ClientAuthentication gestionadas actualmente por el Diagnostic Manager [SWS_DM_01201], [SWS_DM_01203]. La invocación se realiza sin parámetros y devuelve un ara::core::Vector<ClientAuthentication> que contiene todos los objetos de autenticación asignados [SWS_DM_01201].

Tratamiento de errores y valores de retorno

La función está declarada como segura frente a excepciones (exception safe) y noexcept [SWS_DM_01201]. No existen códigos de error específicos ni notificaciones a DET o DEM para esta interfaz. En caso de que no haya objetos de autenticación disponibles, esto no se trata como un error, sino que el método devuelve un vector vacío [SWS_DM_01201].

Concurrencia y restricciones

La especificación cataloga GetAll como segura para hilos (thread-safe) [SWS_DM_01201]. Interpretación: Las invocaciones desde múltiples hilos paralelos de la aplicación deberían, por tanto, ser admisibles sin sincronización adicional por parte de la aplicación. Pregunta Q-9f26d94068ebd3fe (abierta)

Interacción

El conjunto de instancias consultables se corresponde con los elementos de modelo configurados de tipo DiagnosticExternalAuthenticationIdentification, los cuales definen direcciones de origen fijas o rangos de direcciones AUTOSAR_AP_SWS_Diagnostics p. 129. Mientras que GetAll proporciona la totalidad de las instancias [SWS_DM_01203], el método Get permite la consulta selectiva para una dirección de origen o metainformación determinada [SWS_DM_01202].

El destructor ~ExternalAuthentication() finaliza el ciclo de vida de una instancia de la clase ara::diag::ExternalAuthentication procedente del encabezado ara/diag/external_authentication.h [SWS_DM_01198]. Se ejecuta de forma síncrona al salir del ámbito de visibilidad o al liberar el objeto, no requiere parámetros de entrada y no posee valor de retorno AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 «Destructor».

Respecto al tratamiento de errores, la función cuenta con el especificador noexcept y está definida formalmente como segura frente a excepciones (exception safe) [SWS_DM_01198]. En consecuencia, la invocación garantiza que, en caso de fallo, ninguna excepción de C++ interrumpa el proceso de destrucción ni sea propagada al invocador.

En lo relativo a la concurrencia y restricciones, debe tenerse en cuenta que el destructor está especificado como no seguro para hilos (not thread-safe) [SWS_DM_01198]. Los componentes invocadores deben asegurarse, por tanto, de que durante la destrucción no se produzcan accesos simultáneos a través de hilos separados a la misma instancia de ara::diag::ExternalAuthentication. Presumiblemente, antes de la invocación todas las operaciones activas de diagnóstico y autenticación de esta instancia deberían haber concluido por completo para evitar accesos a memoria no coordinados. Pregunta Q-67c112ea87f722d2 (abierta)

En el contexto funcional, la interfaz materializa el requisito superior RS_Diag_04251 para Diagnostic Management (DM) AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 «Destructor». La designación tabular como destructor de una Dynamic-Access-List probablemente constituya una imprecisión editorial de la especificación, ya que el alcance y el espacio de nombres determinan la vinculación a ExternalAuthentication [SWS_DM_01198]. Pregunta Q-30744aac322624cb (abierta)