clase <SI-Namespace>::proxy::triggers::<Trigger>

usar

La función SetReceiveHandler se invoca en el ámbito de la clase trigger de un proxy de servicio (<SI-Namespace>::proxy::triggers::<Trigger>) y se incluye a través del encabezado <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h [SWS_CM_00250]. Los triggers constituyen, junto con los eventos, métodos y campos, uno de los cuatro mecanismos de comunicación en ara::com EXP_ARAComAPI §4.2 «Means of Communication».

El parámetro handler de tipo ara::com::TriggerReceiveHandler recibe un objeto invocable que Communication Management invoca al llegar un trigger. El manejador en sí no tiene parámetros; para consultar el valor actual del contador de triggers, debe llamarse dentro de la función de callback al método GetNewTriggers de la clase trigger específica [SWS_CM_00250].

Tratamiento de errores y seguridad frente a excepciones

El registro no devuelve ningún valor de retorno (void) y está definido como noexcept, así como exception safe [SWS_CM_00250]. Se produce una vulneración de la convención de llamada en forma de InvalidHandlerViolation si el callable transferido no existe o es null [SWS_CM_00250].

Interacción y variantes

Para escenarios en los que el manejador de triggers deba procesarse en un contexto de ejecución definido, existe la sobrecarga de plantilla con ExecutorT [SWS_CM_00352]. Métodos de registro comparables para callbacks están disponibles a nivel de proxy también para eventos ([SWS_CM_00181], [SWS_CM_11356]), así como para campos ([SWS_CM_11605], [SWS_CM_11611]) EXP_ARAComAPI §5.3.1 «Proxy Class API’s».

usar

La función de plantilla SetSubscriptionStateChangeHandler en el ámbito <SI-Namespace>::proxy::triggers::<Trigger> registra un callback para la notificación sobre cambios en el estado de suscripción ([SWS_CM_01106]). Se declara mediante el archivo de cabecera <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h y acepta dos parámetros:

• handler: La entidad invocable de tipo ara::com::SubscriptionStateChangeHandler que se debe ejecutar ante un cambio de estado ([SWS_CM_01107]).
• executor: Un contexto de ejecución de tipo ExecutorT ([SWS_CM_11360]) en el que debe realizarse la ejecución del manejador.

El registro en sí se comporta de manera síncrona y no tiene valor de retorno (void). El callback registrado se ejecuta ante cambios de estado en el contexto de ejecución indicado.

Tratamiento de errores y seguridad frente a excepciones

El método está declarado como noexcept y especificado como exception safe ([SWS_CM_01106]). Si la instancia invocable pasada no existe o es nula, se produce una InvalidHandlerViolation ([SWS_CM_01106]). Dado que no se lanzan excepciones, es probable que un manejador no válido conduzca a una ruta de error específica de la plataforma (interpretación). Pregunta Q-cbb90bfbfa10338d (abierta)

Concurrencia e interacción

Al pasar el ejecutor ([SWS_CM_11360]), la aplicación controla por sí misma el contexto de ejecución de los callbacks de estado. Es de suponer que esto evite que las invocaciones prolongadas del manejador bloqueen el procesamiento interno de eventos de la gestión de comunicaciones (interpretación). Pregunta (abierta) La función amplía la variante sin contexto [SWS_CM_01107] y constituye el equivalente de disparador para las interfaces basadas en ejecutores para eventos de proxy ([SWS_CM_11354]), campos de proxy ([SWS_CM_11608]) y disparadores de skeleton ([SWS_CM_11111]).

Con la función [SWS_CM_01107] se registra, en el ámbito de proxy de un disparador (<SI-Namespace>::proxy::triggers::<Trigger>), un manejador de devolución de llamada al que Communication Management llama ante cada cambio del estado de la suscripción (ara::com::SubscriptionState). La función no posee valor de retorno y está especificada como segura frente a excepciones (noexcept).

Dado que la suscripción debe tratarse fundamentalmente como un proceso asíncrono, la aplicación solo puede asumir una suscripción exitosa cuando el manejador registrado mediante [SWS_CM_01107] o la función de consulta GetSubscriptionState() notifique el estado kSubscribed [SWS_CM_12006]. En caso de retrasos temporales o si el servidor no está disponible temporalmente debido a un reinicio o a un problema de red, Communication Management activa el manejador con el estado kSubscriptionPending [SWS_CM_00313].

Para el tratamiento de errores y la integración se aplican las siguientes condiciones límite:

• Tratamiento de errores: La transferencia de un invocable inexistente o vacío (null) no está permitida y genera una InvalidHandlerViolation [SWS_CM_01107].
• Contexto de ejecución: Si el manejador no debe ejecutarse en el contexto estándar, sino dentro de un contexto de ejecución específico, está disponible la sobrecarga de plantilla con ExecutorT&& [SWS_CM_01106].
• Interacción: Para eventos de servicio existe la interfaz análoga [SWS_CM_00333] en el marco de las API generales de clases proxy ARAComAPI §5.3.1 «Proxy Class API’s».

La función SetTransportFaultConditionHandler sirve en una instancia de proxy::triggers::<Trigger> para registrar una función de retrollamada del tipo ara::com::e2e::TransportFaultConditionHandler ([SWS_CM_00106]). Acepta el parámetro handler, no posee valor de retorno y está especificada como noexcept y exception safe ([SWS_CM_00106]).

A través del manejador registrado, la capa de comunicación señaliza los errores detectados en la capa de transmisión. En el enlace de red DDS, el manejador notifica eventos de la entidad DataReader subyacente como TransportFaultCondition ([SWS_CM_00212]):

• TransportFaultCondition::kSampleRejected en caso de muestras descartadas (por ejemplo, debido a escasez de memoria o corrupción de datos),
• TransportFaultCondition::kDeadlineMissed en caso de incumplimiento de plazos de recepción (REQUESTED_DEADLINE_MISSED),
• TransportFaultCondition::kSampleLost en caso de pérdida de muestras de datos detectadas ([SWS_CM_00212]).

Si en lugar de un invocable válido se pasa un manejador no existente o vacío, el entorno de ejecución notifica una InvalidHandlerViolation ([SWS_CM_00106]). Dado que la firma de la función está declarada como noexcept, es probable que esta infracción conduzca a un tratamiento de errores por parte de la plataforma en lugar de a una excepción de C++. Pregunta Q-ebaf44b8f7b198e8 (abierta)

El registro se realiza de forma síncrona en el contexto del llamador; en esta sobrecarga, la ejecución del manejador no se delega a un despachador específico. Si la retrollamada debe ejecutarse en un contexto de ejecución definido, se encuentra disponible la variante de plantilla sobrecargada con ExecutorT&& adicional ([SWS_CM_00107]). Por lo general, es de suponer que la vinculación se realice antes del procesamiento propiamente dicho del disparador para capturar errores desde el principio. Pregunta (abierta)

Existen opciones de registro correspondientes para TransportFaultConditionHandler de forma análoga para eventos de proxy ([SWS_CM_00099]), campos de proxy ([SWS_CM_00109]), así como métodos de esqueleto ([SWS_CM_00093]) y campos de esqueleto ([SWS_CM_00096]).

La función [SWS_CM_00107] sirve para registrar una rutina de callback para errores de transporte de un trigger de proxy en el espacio de nombres <SI-Namespace>::proxy::triggers::<Trigger>. Como sobrecarga con contexto de ejecución, recibe, además del manejador de tipo ara::com::e2e::TransportFaultConditionHandler, un objeto executor executor en el cual se ejecutan los cálculos asíncronos desencadenados.

Para el uso y el tratamiento de errores se aplican las siguientes disposiciones:

• Parámetros y valor de retorno: El parámetro handler transfiere el callable que se desea establecer, mientras que executor define el contexto de ejecución para tareas asíncronas [SWS_CM_00107]. La función no devuelve ningún valor de retorno y está declarada como noexcept (seguridad frente a excepciones: exception safe).
• Casos de error y vulneraciones: Si se pasa un manejador inexistente o no válido (null), el entorno de ejecución notifica una InvalidHandlerViolation [SWS_CM_00107].
• Estados de error notificados: El manejador registrado recibe los errores de transporte detectados de conformidad con [SWS_CM_00212]. Entre ellos se incluyen TransportFaultCondition::kSampleRejected (por ejemplo, en caso de corrupción de datos o falta de recursos), TransportFaultCondition::kDeadlineMissed (en caso de plazos incumplidos), así como TransportFaultCondition::kSampleLost (en caso de samples perdidos).

En comparación con la función base sin executor [SWS_CM_00106], esta variante permite el control específico del contexto de concurrencia para el procesamiento de errores del trigger. En la gestión de comunicación existen sobrecargas análogas con contexto de ejecución para eventos de proxy [SWS_CM_00100], campos de proxy [SWS_CM_00110], así como en el nivel de skeleton para métodos [SWS_CM_00094] y campos [SWS_CM_00097].

El método Subscribe sirve para la suscripción del lado del cliente a un disparador de servicio a través de una instancia de proxy en el espacio de nombres <SI-Namespace>::proxy::triggers::<Trigger> [SWS_CM_00723]. Antes de su uso, la instancia de servicio debe haberse proporcionado en el lado del servidor a través de OfferService() y haber sido encontrada por el cliente mediante mecanismos de Service Discovery AUTOSAR_AP_EXP_ARAComAPI §4.2 «Means of Communication».

En comparación con las suscripciones a eventos ([SWS_CM_00141]) y campos ([SWS_CM_11601]), Subscribe presenta propiedades específicas para disparadores:

• Parámetros y caché: la función no acepta parámetros (void Subscribe() noexcept) [SWS_CM_00723]. Dado que los disparadores transmiten meras notificaciones sin muestras de datos, se prescinde de la reserva de una caché local de muestras habitual en los eventos mediante maxSampleCount [SWS_CM_00141].
• Valor de retorno: no se devuelve ningún ara::core::Result, sino void [SWS_CM_00723].
• Asincronía: la llamada inicia la suscripción; el establecimiento efectivo de la conexión con la instancia de servicio debería producirse de forma asíncrona en el Communication Management de manera análoga a las suscripciones a eventos AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2 «Monitoring Event Subscription». Pregunta Q-92ae3f442b45f3cc (abierta)

Para el ciclo de vida y el tratamiento de errores se aplican las siguientes condiciones:

• Comprobación de estado e idempotencia: si en el momento de la llamada el disparador ya se encuentra en el estado kSubscribed o kSubscriptionPending, el método regresa de inmediato sin ninguna otra acción [SWS_CM_00723].
• Seguridad frente a excepciones: la función está especificada como noexcept y exception safe [SWS_CM_00723].
• Control de acceso: en caso de permisos insuficientes, la aplicación de concesiones (grant enforcement) deniega la ejecución con una InsufficientPermissionsViolation [SWS_CM_00723].

usar

La función síncrona UnsetReceiveHandler en el espacio de nombres <SI-Namespace>::proxy::triggers::<Trigger> sirve para desactivar el manejador de recepción registrado previamente para un disparador de servicio en el lado del proxy [SWS_CM_11614]. La función requiere la inclusión del archivo de cabecera #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h", no recibe parámetros de entrada y no posee valor de retorno.

Mediante la llamada se anula el registro de la retrollamada específica de la aplicación. Esto permite que la aplicación cambie de manera flexible entre una recepción controlada por eventos y un modelo basado en sondeo (polling) (AUTOSAR_AP_EXP_ARAComAPI p. 46, AUTOSAR_AP_SWS_CommunicationManagement §7.5.18.1).

Tratamiento de errores y seguridad frente a excepciones

A diferencia de las funciones análogas para eventos de servicio [SWS_CM_00183] y campos de servicio [SWS_CM_11606], las cuales están especificadas explícitamente como noexcept y seguras frente a excepciones, UnsetReceiveHandler está declarada para disparadores como no segura frente a excepciones (not exception safe) [SWS_CM_11614]. Interpretación: Las entidades llamadoras deberían contemplar la posibilidad de que se lancen excepciones ante errores internos de la infraestructura de comunicación, si bien en el estándar no se detallan tipos específicos de excepción ni códigos de error. Pregunta Q-92e16243a7ddee35 (abierta)

Interacción y vinculaciones

El método forma parte de las clases de disparador en el espacio de nombres del proxy (AUTOSAR_AP_EXP_ARAComAPI §5.3.1). Al utilizar una vinculación DDS, la llamada al método se mapea según [SWS_CM_11141] a través del DataReader asignado conforme a las prescripciones establecidas en [SWS_CM_11026].

La función UnsetSubscriptionStateChangeHandler sirve en el lado del cliente para eliminar un callback registrado previamente para cambios de estado de la suscripción (ara::com::SubscriptionState) de un disparador [SWS_CM_01108]. Está declarada en el ámbito <SI-Namespace>::proxy::triggers::<Trigger> y debe incluirse a través de la cabecera #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" [SWS_CM_01108].

Uso y contexto de llamada

El método cuenta con la firma void UnsetSubscriptionStateChangeHandler () noexcept;, no acepta parámetros y no devuelve ningún valor [SWS_CM_01108]. Se invoca de forma síncrona sobre la instancia del disparador respectivo de una clase proxy para cancelar las notificaciones ante cambios en el estado de suscripción AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s». Interpretación: tras la ejecución de la llamada, es previsible que no se entreguen más cambios de estado al manejador anterior. Pregunta Q-d08dc975aacba85c (abierta)

Tratamiento de errores y concurrencia

La interfaz está declarada como noexcept y especificada explícitamente como segura frente a excepciones (exception safe) [SWS_CM_01108]. Por lo tanto, queda descartado que la llamada falle o que se lancen excepciones, y no existen valores de retorno de error.

Interacción

La función se integra en el esquema uniforme de las interfaces de proxy. Métodos de baja de registro análogos están disponibles en el contexto del proxy para eventos según [SWS_CM_00334] AUTOSAR_AP_SWS_CommunicationManagement §8.3.2.2.4.5 «UnsetSubscriptionStateChangeHandler», así como para campos según [SWS_CM_11609] AUTOSAR_AP_SWS_CommunicationManagement §8.3.3.2.4.5 «UnsetSubscriptionStateChangeHandler». En el lado del servidor o skeleton existen equivalentes correspondientes para disparadores [SWS_CM_01112] y eventos [SWS_CM_12010].

La función UnsetTransportFaultConditionHandler sirve para dar de baja nuevamente un ara::com::e2e::TransportFaultConditionHandler registrado previamente para un determinado activador de proxy ([SWS_CM_00108], documentado en AUTOSAR_AP_SWS_CommunicationManagement §8.3.7.1.1.3 «UnsetTransportFaultConditionHandler»). Se ubica en el espacio de nombres <SI-Namespace>::proxy::triggers::<Trigger> y se debe incluir a través del archivo de cabecera #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ([SWS_CM_00108]).

La firma es void UnsetTransportFaultConditionHandler() noexcept;. La llamada no acepta parámetros y no devuelve ningún valor ([SWS_CM_00108]). Gracias a la declaración noexcept y a la clasificación como exception safe, la función no lanza excepciones en funcionamiento regular ([SWS_CM_00108]). La especificación no contempla códigos de error específicos, canales de error ni valores de reserva.

En cuanto al flujo de ejecución, la función anula de forma síncrona la vinculación con la rutina de tratamiento de errores; por consiguiente, tras una ejecución exitosa, no deberían entregarse más notificaciones sobre errores de transporte E2E para el activador afectado al manejador anterior (interpretación). Pregunta Q-ae8477bc6530e352 (abierta)

En el marco del sistema global, el elemento constituye la contraparte de las funciones análogas de baja para otros patrones de comunicación en AUTOSAR_AP_SWS_CommunicationManagement §8.3/8.4:

• Eventos de proxy: UnsetTransportFaultConditionHandler a nivel de evento ([SWS_CM_00105]).
• Campos de proxy: baja para notificadores de campo ([SWS_CM_00126]).
• Nivel de Skeleton: baja para Get/Set de campos ([SWS_CM_00098]), así como para todos los métodos de un Skeleton ([SWS_CM_00095]).