clase <DataIdentifier-Namespace>::<DataIdentifierInterface>

usar

La función constructora <DataIdentifierInterface> sirve para instanciar un identificador de datos a partir de un ara::core::InstanceSpecifier [SWS_DM_00585]. La declaración se realiza dentro del espacio de nombres <DataIdentifier-Namespace> a través del archivo de cabecera #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" [SWS_DM_00585]. La llamada síncrona está especificada como noexcept y posee las propiedades «exception safe» y «thread-safe» [SWS_DM_00585].

La función acepta los siguientes parámetros de entrada [SWS_DM_00585]:

• instanceSpec (ara::core::InstanceSpecifier): Identificador de la instancia concreta de un servicio [SWS_DM_00585].
• concurrencyType (ara::diag::ConcurrencyType): Determina si la interfaz se opera de forma segura para subprocesos con kConcurrent o no segura para subprocesos con kNotConcurrent [SWS_DM_00585].

Tratamiento de errores y reglas de modelado

La función no devuelve ningún valor y no lanza excepciones. En su lugar, los errores en la configuración o el modelado conducen a violaciones definidas [SWS_DM_00585]:

• InstanceSpecifierMappingIntegrityViolation: El instanceSpec no se puede resolver en el contexto del ejecutable o no hace referencia a un PortPrototype [SWS_DM_00585].
• PortInterfaceMappingViolation: Un PortPrototype tipificado mediante DiagnosticDataIdentifierInterface no es referenciado por un DiagnosticDataPortMapping [SWS_DM_00585].
• ProcessMappingViolation: No existe ningún proceso modelado adecuado para la referencia de instancia respecto al proceso de ejecución actual [SWS_DM_00585].
• InstanceSpecifierAlreadyInUseViolation: El constructor se invocó con un instanceSpec que ya está en uso en el proceso actual [SWS_DM_00585].

Interpretación: Dado que la función está declarada como noexcept, es de suponer que las violaciones detectadas se traten internamente en el framework como errores críticos de inicialización. Pregunta Q-8616025446bf33f2 (abierta)

concurrencia

La propia función constructora se ejecuta de forma segura para subprocesos [SWS_DM_00585]. Mediante el argumento concurrencyType se controla si las llamadas posteriores a la interfaz de la instancia pueden realizarse de manera concurrente [SWS_DM_00585].

Uso y contexto de llamada

El método síncrono Offer() permite al Diagnostic Management (DM) reenviar solicitudes de diagnóstico entrantes a la respectiva instancia de <DataIdentifierInterface> ([SWS_DM_00599]). La función no recibe parámetros de transferencia y está especificada como noexcept ([SWS_DM_00599]). Interpretación: la llamada se produciría típicamente durante la fase de inicialización de la aplicación, ya que el DM no puede entregar solicitudes antes de la puesta a disposición. Pregunta Q-4ba81ff234a09f46 (abierta)

Tratamiento de errores y valores de retorno

Como valor de retorno se utiliza ara::core::Result<void> ([SWS_DM_00599]). Si el registro fue correcto, el resultado no contiene ningún valor. Si el manejador ya se había puesto a disposición previamente, la llamada falla y devuelve el código de error DiagOfferErrc::kAlreadyOffered con semántica de reversión (rollback) ([SWS_DM_00599]; cf. [SWS_DM_00514]).

Concurrencia y restricciones

La función garantiza seguridad frente a excepciones (exception safe), pero está especificada expresamente como no segura para subprocesos (not thread-safe) ([SWS_DM_00599]). Las llamadas paralelas en la misma instancia deben ser sincronizadas por la aplicación.

Interacción

El patrón de puesta a disposición se corresponde con el enfoque de activación uniforme en el DM: existen métodos Offer() análogos para identificadores genéricos ([SWS_DM_00638]), elementos de datos ([SWS_DM_00597]), rutinas ([SWS_DM_00557], [SWS_DM_00594]) y servicios DoIP ([SWS_DM_00725], [SWS_DM_00735]). Mientras no se haya ejecutado Offer(), el DM no reenvía peticiones al manejador y responde con valores predeterminados en el caso de servicios DoIP ([SWS_DM_01525], [SWS_DM_01527]).

usar

El método Read sirve para proporcionar datos de un identificador de datos de diagnóstico (DataIdentifier) en el rol de lectura de un DiagnosticDataIdentifierInterface [SWS_DM_00640]. La llamada la realiza de forma asíncrona el Diagnostic Manager (DM) en caso de solicitudes de diagnóstico externas AUTOSAR_AP_SWS_Diagnostics p. 143 §7.3.2.6.1 «NRCs created by application». Como parámetros se pasan metaInfo para evaluar las propiedades de la solicitud, así como un cancellationHandler [SWS_DM_00640]. La aplicación de procesamiento puede consultar el estado de cancelación mediante cancellationHandler.IsCanceled() o registrar una callback mediante cancellationHandler.SetNotifier() para el caso de que la sesión se interrumpa prematuramente [SWS_DM_00640]. El resultado se devuelve de forma asíncrona como ara::core::Future con un objeto ReadOutput [SWS_DM_00640], [SWS_DM_00579].

Manejo de errores

La función está especificada como exception safe y no debe propagar excepciones hacia el exterior [SWS_DM_00640]. Si se produce un error durante la obtención de datos, la aplicación devuelve en el ara::core::Future un valor de retorno negativo en forma de un código de error de UDS adecuado (NRC según ISO 14229-1 a través de DiagUdsNrcErrc) o de un ApApplicationError [SWS_DM_00640], AUTOSAR_AP_SWS_Diagnostics p. 143 §7.3.2.6.1 «NRCs created by application».

Concurrencia e interacción

La función de la interfaz es, por defecto, not thread-safe [SWS_DM_00640]. La ejecución concurrente de los accesos de lectura y escritura por parte del Diagnostic Manager se regula mediante el tipo ara::diag::DataIdentifierConcurrencyType::readWrite, que está predeterminado por defecto en kNotConcurrent [SWS_DM_00939]. Existen operaciones de lectura afines para elementos de datos individuales a través de DiagnosticDataElementInterface [SWS_DM_00596], así como para identificadores genéricos [SWS_DM_00636].

El método StopOffer desinstala el reenvío de solicitudes de diagnóstico entrantes de Diagnostic Management (DM) a la instancia de interfaz concreta [SWS_DM_00600]. Mediante la llamada, la aplicación adaptativa señala que deja de estar disponible, de forma temporal o permanente, para procesar solicitudes correspondientes a este DataIdentifier.

Uso y semántica

La llamada se realiza de forma síncrona, no tiene parámetros y no devuelve ningún valor devuelto [SWS_DM_00600]. Como encabezado debe incluirse el archivo de interfaz generado #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" [SWS_DM_00600]. La nomenclatura sigue el patrón conocido de ara::com, pero representa una interfaz independiente del dominio de diagnóstico AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Tratamiento de errores y concurrencia

• Seguridad frente a excepciones: La función está declarada con noexcept y garantiza una seguridad total frente a excepciones (exception safe) [SWS_DM_00600]. No se lanzan excepciones.
• Seguridad de hilos: La operación está especificada como not thread-safe [SWS_DM_00600]. La llamada debe realizarse de forma sincronizada, de modo que no se produzca ningún acceso paralelo a la misma instancia de interfaz.

Interacción

El comportamiento corresponde al patrón de desactivación uniforme de Diagnostic Management, tal como se define análogamente también para interfaces afines, como rutinas [SWS_DM_00558], elementos de datos genéricos [SWS_DM_00639] o servicios de descarga [SWS_DM_00793]. Las solicitudes entrantes de DM dirigidas a este DataIdentifier ya no se reenvían al manejador de la aplicación tras una desactivación correcta [SWS_DM_00600]; previsiblemente, DM generará a continuación los correspondientes códigos de respuesta negativos. Pregunta Q-d301740d097f9946 (abierta)

La función de interfaz sirve para la provisión con seguridad de tipos de un DataIdentifier (DID) de escritura en el rol Write [SWS_DM_00598]. La instancia del Diagnostic Server la invoca cuando se reciben solicitudes de diagnóstico del servicio UDS 0x2E (WriteDataByIdentifier) [SWS_DM_00186], siempre que el DID esté admitido en el sistema y se hayan superado con éxito las comprobaciones de la sesión de diagnóstico activa, así como del nivel de seguridad [SWS_DM_00415] [SWS_DM_00416] [SWS_DM_00417]. A diferencia de la variante genérica con span de bytes sin procesar [SWS_DM_00637], el método vincula parámetros de entrada tipificados específicos del modelo a [SWS_DM_00598].

• Parámetros: además de los argumentos de entrada generados, el método recibe metainformación sobre la solicitud a través de metaInfo, así como un cancellationHandler [SWS_DM_00598]. A través del manejador de cancelación, la aplicación puede comprobar mediante IsCanceled si la conversación se canceló, o registrar con SetNotifier una notificación para el caso de cancelación [SWS_DM_00598].
• Valor de retorno y tratamiento de errores: la ejecución se realiza de forma asíncrona a través de ara::core::Future<void> [SWS_DM_00598]. En caso de éxito, el future proporciona el tipo void. En caso de error, debe devolverse un NRC de UDS aplicable según la norma ISO 14229-1 mediante ara::diag::DiagUdsNrcErrc o un ApplicationError correspondiente [SWS_DM_00598]. La función está declarada como segura frente a excepciones (exception safe) [SWS_DM_00598].
• Concurrencia: el método está clasificado como no seguro para subprocesos (not thread-safe) [SWS_DM_00598]. Si el Diagnostic Management puede invocar en paralelo los accesos de lectura y escritura se controla mediante el elemento de configuración readWrite en DataIdentifierConcurrencyType [SWS_DM_00939].