classe ara::diag::SovdServiceValidation

A classe ara::diag::SovdServiceValidation destina-se à verificação específica da aplicação de direitos de acesso e pré-condições em requisições de serviço SOVD recebidas ([SWS_DM_01822]). Após a instanciação da porta e a ativação explícita via Offer(), o Diagnostic Management chama o método assíncrono de validação Validate() para cada recurso solicitado ([SWS_DM_01827]). Se a validação retornar um valor de erro para sequer um único sub-recurso, o sistema interrompe imediatamente todo o processamento e rejeita a requisição do cliente. Enquanto a instanciação é thread-safe, métodos como Offer() e StopOffer() devem ser sincronizados pelo chamador.

mais ›

Contexto

A classe ara::diag::SovdServiceValidation serve, na Adaptive Platform, para disponibilizar verificações específicas de fabricantes e fornecedores para Service-Oriented Vehicle Diagnostics (SOVD) dentro de uma aplicação de diagnóstico ([SWS_DM_01822]). Enquanto pré-condições padronizadas e condições ambientais no âmbito do protocolo SOVD são avaliadas pelo Diagnostic Management (DM) antes da execução do método ([SWS_DM_01468]), esta interface transfere lógicas de validação personalizadas diretamente para a aplicação adaptativa.

Três parceiros centrais participam da validação do serviço:

• Cliente SOVD: Inicia requisições de diagnóstico através de métodos HTTP para o sistema do veículo.
• Diagnostic Management (DM): Recebe requisições SOVD, verifica condições de nível superior e delega a validação aos mapeamentos de portas configurados ([SWS_DM_01467], SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
• Handler de validação: Implementa a especialização específica da aplicação de SovdServiceValidation e decide sobre a admissibilidade da operação solicitada ([SWS_DM_01822], [SWS_DM_01827]).

Diagrama de contexto: Componentes e relações de interface na validação de serviços SOVD. Fontes: [SWS_DM_01822], [SWS_DM_01823], SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»

Ciclo de vida

A instanciação de um handler de validação ocorre através do construtor de SovdServiceValidation, que é vinculado por meio de um ara::core::InstanceSpecifier a um PortPrototype modelado no manifesto ([SWS_DM_01823]). A porta deve ser tipada por um DiagnosticSovdServiceValidationInterface ([SWS_DM_01823]). Por meio do parâmetro ConcurrencyType, a aplicação define de forma vinculativa se sua implementação foi projetada para chamadas concorrentes (kConcurrent) ou se deve ser atendida de forma não concorrente (kNotConcurrent) ([SWS_DM_01823]).

Após a construção bem-sucedida, a instância encontra-se no estado inicializado. O encaminhamento de requisições pelo DM deve ser ativado explicitamente pela chamada de Offer() ([SWS_DM_01825]). Caso o encaminhamento deva ser interrompido ou encerrado, a aplicação o desativa via StopOffer() ([SWS_DM_01826]). O destrutor virtual ~SovdServiceValidation() encerra de forma limpa o ciclo de vida do handler ([SWS_DM_01824]). Enquanto o construtor em si é especificado como thread-safe, Offer(), StopOffer() e o destrutor não são thread-safe e não podem ser chamados concorrentemente ([SWS_DM_01823], [SWS_DM_01824], [SWS_DM_01825], [SWS_DM_01826]).

Caminho de utilização

O fluxo típico de validação é dividido nas seguintes fases:

1. Inicialização e registro: A aplicação instancia a classe especializada e habilita o serviço para o DM por meio de Offer() ([SWS_DM_01823], [SWS_DM_01825]). Interpretação: isso normalmente ocorre na inicialização da funcionalidade de diagnóstico da aplicação. Pergunta (aberta)
2. Processamento da requisição: Quando uma mensagem SOVD chega ao servidor de diagnóstico, este chama o método Validate na ordem definida para cada mapeamento de porta configurado em DiagnosticServiceValidationConfiguration (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
3. Verificação de recursos: Se a chamada disser respeito a uma coleção de recursos (Resource Collection), o DM chama Validate múltiplas vezes: exatamente uma vez para a coleção em si e, em seguida, uma vez para cada recurso contido na coleção ([SWS_DM_01827]). O caminho do recurso atualmente verificado é passado em ara::diag::MetaInfo em cada caso (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
4. Resultado assíncrono: O método retorna um ara::core::Future<void> ([SWS_DM_01827]). Se a verificação for bem-sucedida, o future é resolvido sem valor de erro e o DM prossegue com o processamento da requisição (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).
5. Desativação do serviço: Antes do encerramento ou em caso de alterações de configuração, a aplicação chama StopOffer() ([SWS_DM_01826]).

Diagrama de sequência: Fluxo de uma verificação de requisição SOVD via Validate com iteração de recursos e tratamento de erros. Fontes: [SWS_DM_01827], SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»

Cenários de erro

Erros podem ocorrer em diferentes fases da inicialização e da execução:

• Violações de construção: Se o InstanceSpecifier não puder ser resolvido no modelo ou não apontar para um PortPrototype, um InstanceSpecifierMappingIntegrityViolation é reportado ([SWS_DM_01823]). Um PortInterfaceMappingViolation ocorre se a porta não corresponder à interface DiagnosticSovdServiceValidationInterface ([SWS_DM_01823]). Em caso de ausência de mapeamento de processo, ocorre ProcessMappingViolation, e se o mesmo identificador for usado várias vezes, segue-se um InstanceSpecifierAlreadyInUseViolation ([SWS_DM_01823]).
• Erros de registro no Offer: Se o serviço já tiver sido oferecido ativamente, Offer() retorna o erro DiagOfferErrc::kAlreadyOffered ([SWS_DM_01825]). Se a configuração divergir da modelagem DEXT, resulta o erro DiagOfferErrc::kConfigurationMismatch ([SWS_DM_01825]).
• Erros de validação funcionais: O método Validate reporta inadmissibilidades através de códigos de erro de DiagSovdErrc ([SWS_DM_01827]). Isso inclui DiagSovdErrc::kInsufficientAccessRights em caso de permissões insuficientes do cliente, DiagSovdErrc::kPreconditionNotFulfilled em caso de pré-condições não atendidas, DiagSovdErrc::kTemporarilyNotAvailable em caso de indisponibilidade temporária (por exemplo, validação de token online ausente) ou DiagSovdErrc::kSovdServerMisconfigured em caso de configuração incorreta ([SWS_DM_01827]).
• Interrupção imediata em caso de erros em sub-recursos: Se a validação falhar para sequer um único recurso contido de uma coleção de recursos, o DM interrompe imediatamente o processamento de toda a requisição e retorna diretamente uma mensagem de erro ao cliente (SWS Diagnostics §7.3.3.2.3 «SOVD – Validation of Environmental Conditions»).