classe <SI-Namespace>::skeleton::triggers::<Trigger>

O método Send transmite um trigger sem dados úteis a todas as aplicações subscritoras ([SWS_CM_00721]). Pertence à classe skeleton <SI-Namespace>::skeleton::triggers::<Trigger> e é disponibilizado através do ficheiro de cabeçalho #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h" ([SWS_CM_00721]).

A função está definida como noexcept, é considerada segura contra exceções e não espera parâmetros de transferência ([SWS_CM_00721]). Como tipo de retorno serve ara::core::Result<void> ([SWS_CM_00721]):

• Caso de sucesso: O resultado contém um valor vazio (void) e sinaliza o desencadeamento bem-sucedido da transmissão ([SWS_CM_00721]).
• Caso de erro: O resultado encapsula um código de erro do domínio ara::com::ComErrc ([SWS_CM_10432]). Erros possíveis com semântica de rollback são:
  • ComErrc::kServiceNotOffered: O serviço ainda não foi previamente oferecido por meio de OfferService() ([SWS_CM_00721]).
  • ComErrc::kMinimumSendIntervalViolationError: Um pedido de transmissão ocorreu antes de decorrido o intervalo mínimo de envio configurado ServiceInterfaceDeploymentElement.minimumSendInterval ([SWS_CM_00721]).

Relativamente à concorrência e reentrância, as fontes são omissas; presumivelmente, chamadas simultâneas na mesma instância têm de ser sincronizadas do lado da aplicação. Ao contrário da transmissão de dados baseada em eventos através de Event::Send ([SWS_CM_00162], [SWS_CM_90437], AUTOSAR_AP_EXP_ARAComAPI p. 10) ou atualizações de campos via Update ([SWS_CM_00119]), Trigger::Send segundo [SWS_CM_00721] (AUTOSAR_AP_EXP_ARAComAPI p. 10) não transmite quaisquer dados úteis, servindo antes como puro impulso de disparo. Pergunta Q-ff3beeb7bad5dd32 (aberta)

A função SetSubscriptionStateChangeHandler serve, no lado do skeleton, para registrar uma função de callback para monitoramento de alterações de subscrição em um trigger [SWS_CM_01110]. O método pertence ao namespace <SI-Namespace>::skeleton::triggers::<Trigger> e é disponibilizado através do arquivo de cabeçalho <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h [SWS_CM_01110].

Como parâmetro é passado um objeto de função chamável do tipo SubscriptionStateChangeHandler [SWS_CM_00311] [SWS_CM_01110]. A chamada é declarada como noexcept, não retorna nenhum valor e é especificada como segura contra exceções (exception safe) [SWS_CM_01110]. Se o callable de tratador passado não existir ou for nulo, o sistema relata uma InvalidHandlerViolation [SWS_CM_01110].

O Communication Management chama a função de callback registrada assim que o status de subscrição do trigger muda [SWS_CM_01101]:

• com o valor de status kSubscribed, assim que a quantidade de subscrições ativas para este trigger se torna maior que 0 [SWS_CM_01102],
• com o valor de status kNotSubscribed no lado do skeleton, quando não houver mais assinaturas ativas [SWS_CM_01103].

O tratador registrado pode ser sobrescrito em tempo de execução [SWS_CM_01101]. Se a execução do tratador tiver que ocorrer em um contexto de execução definido, está alternativamente disponível a variante de template sobrecarregada com um parâmetro ExecutorT&& [SWS_CM_01111].

A função de template SetSubscriptionStateChangeHandler registra, no nível do skeleton para triggers ([SWS_CM_01111]), um tratador de callback para alterações do status de subscrição (ara::com::SubscriptionState). Além do parâmetro chamável handler, o método recebe um contexto de execução executor do tipo ExecutorT ([SWS_CM_01111]). A função não possui valor de retorno e é definida no escopo <SI-Namespace>::skeleton::triggers::<Trigger> ([SWS_CM_01111]).

Em contraste com a função básica sem executor ([SWS_CM_01110]), esta assinatura garante que o callback seja executado em um contexto definido pelo usuário ([SWS_CM_01111]). Como na variante baseada em eventos conforme [SWS_CM_12008], a execução é presumivelmente delegada ao objeto executor fornecido, para controlar especificamente o threading dentro da aplicação skeleton. Pergunta Q-ba14993b00a7d972 (aberta)

A interface é especificada como noexcept e segura contra exceções ([SWS_CM_01111]). Caso o chamável fornecido seja inválido ou nulo, há uma InvalidHandlerViolation de acordo com a especificação ([SWS_CM_01111]).

Funcionalmente, o método corresponde às sobrecargas análogas de executor para eventos de skeleton ([SWS_CM_12009]), bem como às correspondências do lado do cliente da interface de proxy ([SWS_CM_01106], [SWS_CM_11354]).

A função UnsetSubscriptionStateChangeHandler serve no lado do skeleton para remover um callback previamente registrado para alterações do status de assinatura (SubscriptionState) em um service trigger ([SWS_CM_01112]). Ela é definida no namespace <SI-Namespace>::skeleton::triggers::<Trigger> por meio do cabeçalho <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h ([SWS_CM_01112]).

Uso e semântica: A interface possui a assinatura void UnsetSubscriptionStateChangeHandler() noexcept, não espera parâmetros de entrada e não possui valor de retorno ([SWS_CM_01112]). De acordo com a especificação, ela é classificada como segura contra exceções (exception safe) ([SWS_CM_01112]). Códigos de erro ou mecanismos específicos de relatório (DET/DEM) não estão previstos para esta chamada.

Interação e ciclo de vida: O callback removido por meio de [SWS_CM_01112] é chamado pelo Communication Management assim que o status de assinatura do respectivo trigger é alterado ([SWS_CM_01101], AUTOSAR_AP_SWS_CommunicationManagement §7.5.15 «Query Service Trigger Subscription State on Skeleton side»). Isso ocorre, por exemplo, com o status kSubscribed quando o número de assinaturas ativas se torna maior que zero ([SWS_CM_01102]), ou com kNotSubscribed ([SWS_CM_01103]). O manipulador pode ser sobrescrito em tempo de execução ([SWS_CM_01101]); a chamada de UnsetSubscriptionStateChangeHandler cancela novamente o registro.

Concorrência e interfaces relacionadas: Em relação à concorrência, presume-se que o cancelamento de registro ocorra de forma síncrona, de modo que nenhuma notificação de estado adicional seja entregue ao manipulador registrado anteriormente após o retorno da chamada de função. Funções análogas de cancelamento de registro são especificadas no lado do skeleton para events ([SWS_CM_12010]), bem como no lado do proxy para events ([SWS_CM_00334]), triggers ([SWS_CM_01108]) e campos ([SWS_CM_11609], AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s»). Pergunta Q-e005c4818e02e52f (aberta)