klasse ara::diag::SovdServiceValidation

De klasse ara::diag::SovdServiceValidation dient voor de applicatiespecifieke controle van toegangsrechten en randvoorwaarden bij inkomende SOVD-serviceverzoeken ([SWS_DM_01822]). Na de port-instantiëring en expliciete activering via Offer() roept Diagnostic Management voor elke aangevraagde resource de asynchrone validatiemethode Validate() aan ([SWS_DM_01827]). Als de validatie zelfs maar voor één enkele deelresource een foutwaarde oplevert, breekt het systeem de gehele verwerking onmiddellijk af en wijst het het client-verzoek af. Terwijl de instantiëring thread-safe is, moeten methoden zoals Offer() en StopOffer() door de aanroeper worden gesynchroniseerd.

meer ›

Context

De klasse ara::diag::SovdServiceValidation dient in het Adaptive Platform om fabrikant- en leverancierspecifieke controles voor Service-Oriented Vehicle Diagnostics (SOVD) binnen een diagnostische applicatie beschikbaar te stellen ([SWS_DM_01822]). Terwijl gestandaardiseerde randvoorwaarden en omgevingscondities in het kader van het SOVD-protocol door Diagnostic Management (DM) vóór de methode-uitvoering worden geëvalueerd ([SWS_DM_01468]), verplaatst deze interface aangepaste validatielogica direct naar de adaptieve applicatie.

Bij de servicevalidatie zijn drie centrale partners betrokken:

• SOVD-client: initieert diagnostische verzoeken via HTTP-methoden naar het voertuigsysteem.
• Diagnostic Management (DM): ontvangt SOVD-verzoeken, controleert overkoepelende voorwaarden en delegeert de validatie naar de geconfigureerde port-mappings ([SWS_DM_01467], SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”).
• Validatie-handler: realiseert de applicatiespecifieke specialisatie van SovdServiceValidation en beslist over de toelaatbaarheid van de aangevraagde operatie ([SWS_DM_01822], [SWS_DM_01827]).

Contextdiagram: componenten en interfacerelaties bij de SOVD-servicevalidatie. Bronnen: [SWS_DM_01822], [SWS_DM_01823], SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”

Levenscyclus

De instantiëring van een validatie-handler vindt plaats via de constructor van SovdServiceValidation, die via een ara::core::InstanceSpecifier wordt gekoppeld aan een in het manifest gemodelleerde PortPrototype ([SWS_DM_01823]). De poort moet hierbij zijn getypeerd door een DiagnosticSovdServiceValidationInterface ([SWS_DM_01823]). Via de parameter ConcurrencyType definieert de applicatie bindend of haar implementatie is ontworpen voor gelijktijdige aanroepen (kConcurrent) dan wel niet-gelijktijdig moet worden bediend (kNotConcurrent) ([SWS_DM_01823]).

Na succesvolle constructie bevindt de instantie zich in de geïnitialiseerde toestand. Het doorsturen van verzoeken door het DM moet expliciet worden geactiveerd door het aanroepen van Offer() ([SWS_DM_01825]). Moet het doorsturen worden onderbroken of beëindigd, dan deactiveert de applicatie dit via StopOffer() ([SWS_DM_01826]). De virtuele destructor ~SovdServiceValidation() beëindigt de levenscyclus van de handler op correcte wijze ([SWS_DM_01824]). Terwijl de constructor zelf als thread-safe is gespecificeerd, zijn Offer(), StopOffer() en de destructor niet thread-safe en mogen ze niet gelijktijdig worden aangeroepen ([SWS_DM_01823], [SWS_DM_01824], [SWS_DM_01825], [SWS_DM_01826]).

Gebruikspad

Het typische verloop van de validatie is onderverdeeld in de volgende fasen:

1. Initialisatie en registratie: de applicatie instantieert de gespecialiseerde klasse en geeft de service middels Offer() vrij voor het DM ([SWS_DM_01823], [SWS_DM_01825]). Interpretatie: dit gebeurt typisch bij het starten van de diagnostische functionaliteit van de applicatie. Vraag (open)
2. Verzoekverwerking: arriveert een SOVD-bericht bij de Diagnostic Server, dan roept deze voor elke in DiagnosticServiceValidationConfiguration geconfigureerde port-mapping de methode Validate in de vastgelegde volgorde aan (SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”).
3. Resourcecontrole: betreft de aanroep een resourceverzameling (Resource Collection), dan roept het DM Validate meerdere keren aan: precies één keer voor de verzameling zelf en vervolgens telkens één keer voor elke in de verzameling opgenomen resource ([SWS_DM_01827]). Het pad van de momenteel gecontroleerde resource wordt telkens in ara::diag::MetaInfo doorgegeven (SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”).
4. Asynchroon resultaat: de methode levert een ara::core::Future<void> terug ([SWS_DM_01827]). Is de controle succesvol, dan wordt de future zonder foutwaarde voltooid en zet het DM de verwerking van het verzoek voort (SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”).
5. Servicedeactivering: vóór beëindiging of bij configuratiewijzigingen roept de applicatie StopOffer() aan ([SWS_DM_01826]).

Sequentiediagram: verloop van een SOVD-verzoekcontrole via Validate met resource-iteratie en foutverwerking. Bronnen: [SWS_DM_01827], SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”

Foutscenario's

Fouten kunnen in verschillende fasen van de initialisatie en uitvoering optreden:

• Constructieschendingen: kan de InstanceSpecifier in het model niet worden opgelost of verwijst deze niet naar een PortPrototype, dan wordt een InstanceSpecifierMappingIntegrityViolation gemeld ([SWS_DM_01823]). Een PortInterfaceMappingViolation ontstaat wanneer de poort niet overeenkomt met de interface DiagnosticSovdServiceValidationInterface ([SWS_DM_01823]). Bij een ontbrekende proces-mapping treedt ProcessMappingViolation op, en als dezelfde identifier meerdere keren wordt gebruikt, volgt een InstanceSpecifierAlreadyInUseViolation ([SWS_DM_01823]).
• Registratiefouten bij Offer: is de service al actief aangeboden, dan retourneert Offer() de fout DiagOfferErrc::kAlreadyOffered ([SWS_DM_01825]). Wijkt de configuratie af van de DEXT-modellering, dan resulteert de fout DiagOfferErrc::kConfigurationMismatch ([SWS_DM_01825]).
• Functionele validatiefouten: de methode Validate meldt ontoelaatbaarheden via foutcodes uit DiagSovdErrc ([SWS_DM_01827]). Daartoe behoren DiagSovdErrc::kInsufficientAccessRights bij ontoereikende rechten van de client, DiagSovdErrc::kPreconditionNotFulfilled bij niet-vervulde randvoorwaarden, DiagSovdErrc::kTemporarilyNotAvailable bij tijdelijke niet-beschikbaarheid (bijv. ontbrekende online-tokenvalidatie) of DiagSovdErrc::kSovdServerMisconfigured bij een foutieve configuratie ([SWS_DM_01827]).
• Onmiddellijke afbreking bij deelresource-fouten: mislukt de validatie ook maar voor één enkele opgenomen resource van een resourceverzameling, dan breekt het DM de verwerking van het totale verzoek onmiddellijk af en stuurt direct een foutmelding terug naar de client (SWS Diagnostics §7.3.3.2.3 “SOVD – Validation of Environmental Conditions”).