clase ara::diag::DynamicAccessListDiagServiceBuilder

usar

El método síncrono Add de la clase ara::diag::DynamicAccessListDiagServiceBuilder sirve para añadir un solo byte (Byte value) a un DynamicAccessListPattern [SWS_DM_01175]. El valor de byte transferido se comprueba para verificar una coincidencia exacta durante la evaluación de los derechos de acceso para servicios de diagnóstico [SWS_DM_01175]. Al devolver una referencia a la instancia del mismo objeto (DynamicAccessListDiagServiceBuilder&), la función admite la llamada como Fluent API [SWS_DM_01175].

Tratamiento de errores y seguridad frente a excepciones

La operación está declarada como noexcept y especificada como segura frente a excepciones (exception safe) [SWS_DM_01175]. No se devuelven códigos de error ni valores de retorno de tipo ara::core::Result; no se indican mensajes específicos de DET o DEM en el payload para esta función.

Concurrencia y restricciones

El método está especificado como no seguro para hilos (not thread-safe) [SWS_DM_01175]. Interpretación: Por tanto, las llamadas en la misma instancia de builder suelen realizarse típicamente de forma secuencial dentro de un único hilo antes de que el patrón de acceso creado se evalúe en el servidor de diagnóstico. Pregunta Q-69d895fc6bf90cb4 (abierta)

Interacción

Dentro de la interfaz DynamicAccessListDiagServiceBuilder, este método complementa las sobrecargas afines de Add con las que se pueden añadir secuencias de bytes mediante ByteString [SWS_DM_01176] o rangos de valores mediante ByteRange [SWS_DM_01177] a un DynamicAccessListPattern.

La función miembro Add de la clase ara::diag::DynamicAccessListDiagServiceBuilder sirve para añadir una secuencia de bytes a un DynamicAccessListPattern [SWS_DM_01176]. Mediante el parámetro de entrada values de tipo ByteString se transfiere una secuencia de bytes que se comprueba para verificar una coincidencia exacta durante la posterior evaluación de los derechos de acceso para servicios de diagnóstico [SWS_DM_01176]. Como valor de retorno, el método proporciona una referencia a la misma instancia de builder (DynamicAccessListDiagServiceBuilder&), lo que permite un uso fluido de la interfaz (Fluent API) encadenando múltiples llamadas [SWS_DM_01176].

En lo que respecta al tratamiento de errores, la función está declarada como noexcept y especificada como segura frente a excepciones (exception safe) [SWS_DM_01176]. No se reportan códigos de error ni excepciones de C++.

En cuanto a la concurrencia, el método está definido como no seguro para hilos (not thread-safe) [SWS_DM_01176]. Si varios hilos acceden en paralelo a la misma instancia de builder, las llamadas deben sincronizarse en la aplicación. Interpretación: Es probable que la llamada se realice de forma síncrona en el contexto de ejecución del hilo de la aplicación configuradora, ya que no se especifican mecanismos asíncronos. Pregunta Q-d93498e82292a88e (abierta)

En la interacción de Diagnostic Management, este método complementa las funciones de builder afines para definir patrones de acceso dinámico: mientras que con esta función se registran secuencias de bytes completas, alternativamente se pueden añadir al patrón bytes individuales ([SWS_DM_01175]) o rangos de valores ([SWS_DM_01177]) mediante funciones Add sobrecargadas.

La función Add de la clase ara::diag::DynamicAccessListDiagServiceBuilder sirve a las aplicaciones para añadir un rango de valores de bytes a un DynamicAccessListPattern [SWS_DM_01177]. El parámetro transferido range de tipo ByteRange define un intervalo de valores cuya coincidencia se comprueba durante la evaluación de permisos de acceso para servicios de diagnóstico [SWS_DM_01177].

Para la llamada y la integración en el Diagnostic Management se aplican las siguientes propiedades:

• Contexto de llamada y semántica: La llamada se realiza de forma síncrona. Como valor de retorno, la función proporciona una referencia de objeto a la misma instancia del builder (DynamicAccessListDiagServiceBuilder&) para admitir un uso fluido de la interfaz (Fluent API) mediante el encadenamiento de métodos [SWS_DM_01177].
• Tratamiento de errores: La operación está declarada como noexcept y posee la propiedad de especificación exception safe [SWS_DM_01177]. No se devuelven códigos de error específicos y no se lanzan excepciones.
• Concurrencia: La función está especificada explícitamente como not thread-safe [SWS_DM_01177]. Interpretación: Si varios hilos de ejecución acceden a la misma instancia del builder, la aplicación llamadora debe sincronizar el acceso externamente. Pregunta Q-c51760a8fe29bd5f (abierta)
• Interacción: El método complementa funciones afines de la clase builder para añadir valores en bytes individuales mediante [SWS_DM_01175], así como para definir secuencias de bytes mediante [SWS_DM_01176], a fin de configurar patrones de acceso flexibles.

usar

El método ara::diag::DynamicAccessListDiagServiceBuilder::Any sirve para que el software de aplicación defina comodines en un patrón de acceso ([SWS_DM_01178]). La llamada síncrona se realiza en una instancia del constructor (builder). Mediante el parámetro numberOfBytesToIgnore se define cuántos bytes consecutivos se incluyen ciertamente en el patrón de acceso pero se ignoran durante la posterior coincidencia de patrones (pattern matching) frente a peticiones de diagnóstico entrantes ([SWS_DM_01220]). Al devolver una referencia de objeto al mismo builder, se habilita un estilo de llamada a la API fluido (AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.4 «Any»).

Tratamiento de errores y comportamiento ante excepciones

La función está especificada como noexcept y segura frente a excepciones (exception safe) ([SWS_DM_01178]). No se prevén códigos de error ni notificaciones a DET o DEM. Interpretación: al transferir el valor 0 para numberOfBytesToIgnore, la llamada debería regresar sin error y no registrar ningún byte comodín en el patrón. Pregunta Q-e372cda9f8840893 (abierta)

Concurrencia y restricciones

La interfaz está designada explícitamente como no segura para subprocesos (not thread-safe) ([SWS_DM_01178]). Por lo tanto, varias llamadas al builder en la misma instancia de DynamicAccessListDiagServiceBuilder deben ejecutarse obligatoriamente de forma secuencial o ser sincronizadas por el llamador.

Interacción

Las definiciones de comodines mediante Any se combinan típicamente con patrones como EndsWith ([SWS_DM_01221]). Una vez ensamblados todos los componentes del patrón, la configuración debe finalizarse con el método Build ([SWS_DM_01222]) antes de que la lista de acceso resultante esté disponible para verificaciones (AUTOSAR_AP_SWS_Diagnostics §7.3.2 «Adding wildcards to a DynamicAccessList»).

usar

El método síncrono Build de la clase ara::diag::DynamicAccessListDiagServiceBuilder ([SWS_DM_01166]) concluye la creación de una lista de acceso dinámico ([SWS_DM_01181]). La función no toma parámetros de entrada y no posee valor de retorno ([SWS_DM_01181]). Mediante la llamada, la instancia correspondiente del Diagnostic Server asume las reglas de acceso compiladas ([SWS_DM_01222]).

Manejo de errores

La operación está declarada como noexcept y especificada como segura frente a excepciones (exception safe) ([SWS_DM_01181]). No se devuelven códigos de error ni se lanzan excepciones.

Concurrencia y restricciones

El método está clasificado como no seguro para subprocesos (not thread-safe) ([SWS_DM_01181]). Por lo tanto, los accesos simultáneos al mismo objeto builder desde múltiples contextos de ejecución deben protegerse externamente. Además, existe una estricta condición de orden: Build debe llamarse obligatoriamente antes de que se destruya el objeto builder de servicio ([SWS_DM_01181]). Interpretación: si esta llamada no se realiza antes del final de la vida útil del objeto, es probable que los patrones previamente configurados expiren y no entren en vigor para la autorización. Pregunta Q-445ea33ece339d42 (abierta)

Interacción

En el marco de la creación de la lista, se definen previamente patrones de servicio y de solicitud, por ejemplo mediante comodines a través de Any ([SWS_DM_01220]) o patrones finales a través de EndsWith ([SWS_DM_01221]), tal como se describe en SWS Diagnostics §7.3.2.3.4 «DynamicAccessList Creation and Update». Build finaliza este proceso de construcción y entrega la lista al servidor ([SWS_DM_01222]).

El método síncrono EndsWith de la clase ara::diag::DynamicAccessListDiagServiceBuilder sirve para que las aplicaciones establezcan un único byte (Byte value) como patrón de terminación de una lista de acceso dinámica [SWS_DM_01179]. Al ser invocada, la instancia de Diagnostic Server asigna este patrón al final de la DynamicAccessList para comprobar la coincidencia exacta durante la evaluación de los permisos de servicio de diagnóstico [SWS_DM_01221]. La función no proporciona valor de retorno.

En lo referente al tratamiento de errores, la función está especificada como segura frente a excepciones (exception safe) y declarada con noexcept [SWS_DM_01179]. En el alcance de la especificación no están previstos códigos de error específicos ni mensajes a DET o DEM para esta invocación de método.

Respecto a la concurrencia, el método está indicado como no seguro para hilos (not thread-safe) [SWS_DM_01179]. En caso de acceso concurrente a la misma instancia de builder, se requiere una sincronización externa por parte de la aplicación. Interpretación: El establecimiento del patrón de terminación probablemente deba realizarse antes de la llamada a Build [SWS_DM_01222], ya que el Diagnostic Server finaliza la DynamicAccessList con Build. Pregunta Q-a0afa7deaafa306b (abierta)

En interacción con requisitos afines, además de esta variante de valor individual existe una sobrecarga EndsWith(ByteRange range) [SWS_DM_01180], la cual permite especificar un rango cerrado de valores de byte como patrón de terminación SWS Diagnostics §8.15.1.2.3.6 «EndsWith(ByteRange)». Ambas variantes configuran el patrón final de la misma lista de acceso antes de su utilización [SWS_DM_01221].

usar

El método EndsWith de la clase ara::diag::DynamicAccessListDiagServiceBuilder sirve para definir un intervalo cerrado de bytes (ByteRange range) al final del patrón de búsqueda de una lista de acceso dinámico (DynamicAccessList) [SWS_DM_01180]. Al llamar al método, la instancia del Diagnostic Server añade el patrón especificado al final de la DynamicAccessList [SWS_DM_01221]. A continuación, este rango de valores se utiliza en la evaluación de los derechos de acceso para servicios de diagnóstico AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.6 «EndsWith(ByteRange)». La llamada se realiza de forma síncrona y no devuelve ningún valor de retorno (void) [SWS_DM_01180].

Tratamiento de errores y concurrencia

La operación está declarada como noexcept y especificada como segura frente a excepciones (exception safe); no existen códigos de error ni tratamientos de excepciones específicos [SWS_DM_01180]. En cuanto a la concurrencia, el método está clasificado como no seguro para hilos (not thread-safe) [SWS_DM_01180]. El acceso paralelo a la misma instancia de builder a través de múltiples hilos no está permitido sin sincronización externa.

Zusammenspiel y ciclo de vida

En el marco de la creación de patrones, además de esta variante para rangos de valores, existe una sobrecarga alternativa de EndsWith que define un solo byte (Byte value) para la coincidencia exacta de patrones al final [SWS_DM_01179]. Tras la configuración del patrón, la lista debe finalizarse llamando a Build [SWS_DM_01222] antes de que la aplicación pueda utilizar la DynamicAccessList generada para comprobaciones de autorización AUTOSAR_AP_SWS_Diagnostics §7.3.2 «End patterns of a DynamicAccessList».