classe ara::diag::SovdConfiguration

usar

O método Offer da classe ara::diag::SovdConfiguration serve para ativar o encaminhamento de requisições de diagnóstico pelo Diagnostic Management (DM) para o handler configurado [SWS_DM_01872]. A chamada ocorre de forma síncrona, não aceita parâmetros e reporta o resultado por meio de ara::core::Result<void> [SWS_DM_01872]. Enquanto um handler não tiver sido disponibilizado via Offer, o DM não encaminha nenhuma requisição de entrada, o que corresponde ao padrão fundamental de disponibilização de interfaces de diagnóstico (cf. [SWS_DM_01525], [SWS_DM_00809]).

Tratamento de erros

Em caso de falha, é retornado um ara::core::Result com um código de erro da enumeração DiagOfferErrc, aplicando-se uma semântica de rollback [SWS_DM_01872]:

• DiagOfferErrc::kAlreadyOffered: É reportado se o serviço já tiver sido oferecido anteriormente [SWS_DM_01872].
• DiagOfferErrc::kConfigurationMismatch: Ocorre se a configuração não corresponder aos dados de descrição DEXT [SWS_DM_01872].

Simultaneidade e restrições

A operação é declarada como noexcept e segura contra exceções (exception safe), mas é especificada como não segura para threads (not thread-safe) [SWS_DM_01872]. Chamadas simultâneas à mesma instância a partir de múltiplas threads devem ser evitadas pela aplicação chamadora. Uma nova chamada após o serviço já ter sido oferecido presumivelmente deverá ser confirmada com um erro, sem alteração de estado. Pergunta Q-f9b1a995dbb002ef (aberta)

usar

O método virtual puro RequestGetConfiguration da classe ara::diag::SovdConfiguration é chamado pela Diagnostic Server Instance quando o método SOVD “Read Configuration” é executado para uma configuração SOVD explicitamente modelada ([SWS_DM_01787], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 «Configuration – Explicit Configurations»). São passados como parâmetros o ID de configuração da instância a ser lida (configurationId), as metainformações da requisição (metaInfo), bem como um cancellationHandler que informa sobre um eventual cancelamento da conversação em andamento ([SWS_DM_01870]).

A função trabalha de forma assíncrona e retorna um ara::core::Future, que disponibiliza uma tupla composta por uma sessão de leitura de arquivo (DataTransferReadSession) e metainformações de configuração correspondentes (SovdConfigurationMetaInfo) ([SWS_DM_01870]). A interface é declarada como noexcept e especificada como segura quanto a exceções ([SWS_DM_01870]).

Tratamento de erros e simultaneidade

Se ocorrer um erro durante o processamento, nenhum erro em C++ é lançado, mas sim retornado via Future um código de erro SOVD aplicável de acordo com a ISO 17978-3 ou ASAM SOVD 1.1 ([SWS_DM_01870]).

Em relação à segurança de threads, aplica-se a especificação “conditional”: se a implementação concreta da função deve ser projetada como segura para threads ou não segura para threads, é decidido pelo ConcurrencyType passado ao construtor ([SWS_DM_01870]).

O método de API ara::diag::SovdConfiguration::RequestPutConfiguration é chamado pelo Diagnostic Server quando o método “Write Configuration” deve ser executado por meio da interface SOVD para uma configuração explicitamente modelada [SWS_DM_01788], [SWS_DM_01871].

Chamada e parâmetros

A declaração encontra-se no cabeçalho ara/diag/sovd_configuration.h. A chamada passa os seguintes parâmetros de entrada [SWS_DM_01871]:

• configurationId: ID da instância de configuração a ser escrita como ara::core::String.
• metaInfo: metainformações sobre a requisição recebida (MetaInfo const &).
• cancellationHandler: monitora o procedimento atual e sinaliza caso a comunicação tenha sido cancelada.

O método possui uma semântica assíncrona e retorna um ara::core::Future, que disponibiliza em caso de sucesso uma tupla composta por uma sessão de escrita (DataTransferWriteSession) bem como metadados associados (SovdConfigurationMetaInfo) [SWS_DM_01871].

Tratamento de erros e simultaneidade

Em caso de falha, o Future é resolvido com um código de erro SOVD adequado de acordo com a ISO 17978-3 ou ASAM SOVD 1.1 [SWS_DM_01871]. A função é declarada como noexcept e é segura contra exceções (exception safe). A segurança de threads é condicional (conditional): se a implementação concreta deve ser projetada para ser thread-safe é determinado pelo ConcurrencyType especificado no construtor [SWS_DM_01871].

Interação

A função constitui a contraparte de escrita para RequestGetConfiguration, que é utilizada para o método SOVD “Read Configuration” [SWS_DM_01787] (AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 «Configuration – Explicit Configurations»).

O método StopOffer() da classe ara::diag::SovdConfiguration serve para desativar o encaminhamento de requisições (Request Messages) pelo daemon do Diagnostic Management (DM) para a instância de serviço [SWS_DM_01930]. Ele constitui a contraparte da disponibilização do serviço e segue o padrão uniforme de ciclo de vida de interfaces de diagnóstico no AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Uso e assinatura: A chamada ocorre de forma síncrona e sem parâmetros através do cabeçalho ara/diag/sovd_configuration.h [SWS_DM_01930]. Como o método não retorna nenhum valor (void) e é declarado como noexcept, ele é considerado seguro contra exceções (exception safe) [SWS_DM_01930]. Não são transmitidos códigos de erro nem exceções ao chamador.

Concorrência e restrições: A função é explicitamente especificada como não segura para threads (not thread-safe) [SWS_DM_01930]. Se instâncias de ara::diag::SovdConfiguration forem usadas em ambientes multithreading, acessos simultâneos ou mudanças no estado de disponibilização devem ser sincronizados pela Adaptive Application.

Interação: O comportamento corresponde à semântica de desativação de outros serviços do DM, tais como ara::diag::CommunicationControl [SWS_DM_00810] ou ara::diag::GenericRoutine [SWS_DM_00558]. Interpretação: após a chamada de StopOffer(), as requisições de diagnóstico recebidas pelo DM presumivelmente deverão ser descartadas ou respondidas negativamente, até que a configuração seja ativada novamente por meio de um método correspondente de oferta. Pergunta Q-4c6212980015c119 (aberta)