klasse ara::tsync::ProviderTimeBaseValidationNotification

De abstracte klasse ara::tsync::ProviderTimeBaseValidationNotification dient als callback-interface om geregistreerde tijdbasis-meetgegevens beschikbaar te stellen aan een validator-applicatie. Implementaties ontvangen via SetMasterTimingData meetblokken van de Time Master [SWS_TS_00421] en via SetPdelayResponderData meetgegevens van de Pdelay Responder [SWS_TS_00423]. De methoden zijn gespecificeerd als noexcept, maar zijn niet thread-safe, waardoor gelijktijdige aanroepen op dezelfde instantie moeten worden vermeden.

meer ›

Context

De klasse ara::tsync::ProviderTimeBaseValidationNotification fungeert als abstracte callback-interface voor de validatie van tijdbases binnen de synchronisatiemodule. Via deze interface wordt een ontvangende validator-applicatie geïnformeerd zodra er voor een bewaakte tijdbasis nieuwe geregistreerde meetdatablokken aanwezig zijn. De interface definieert overdrachtspunten voor specifieke meetgegevens van de tijdgever (Time Master) conform [SWS_TS_00421] evenals voor meetgegevens van het vertragingsresponsmechanisme (Pdelay Responder) conform [SWS_TS_00423]. Interactiepartners zijn hierbij typisch het interne provider-mechanisme van de tijdsynchronisatiestack als databron en een validatie-instantie aan de applicatiezijde die de geregistreerde tijdgegevens analyseert.

Levenscyclus en concurrency

Als abstracte interface wordt ara::tsync::ProviderTimeBaseValidationNotification afgeleid en geïmplementeerd door de concrete validatie-applicatie. De levensduur van de geïnstantieerde implementatie valt onder de verantwoordelijkheid van de applicatie. De klasse beschikt over een virtuele standaarddestructor die als uitzonderingsveilig (noexcept) is gedeclareerd [SWS_TS_01301]. Hierdoor wordt gewaarborgd dat instanties van afgeleide klassen bij de ontmanteling polymorf en resourceveilig kunnen worden vernietigd. Wat betreft concurrency zijn de notificatiemethoden expliciet geclassificeerd als niet-thread-safe (non_threadsafe) [SWS_TS_00421], [SWS_TS_00423]. Dit betekent dat aanroepen van SetMasterTimingData en SetPdelayResponderData voor dezelfde instantie niet onbeschermd vanuit concurrerende threads mogen plaatsvinden; de aanroepende tijdbasisprovider dient deze aanroepen vermoedelijk sequentieel uit te voeren of de applicatie moet voor synchronisatie zorgen. Vraag Q-8f59bb65825ead66 (open)

Gebruikspad

Het typische verloop begint met het beschikbaar stellen van een van ara::tsync::ProviderTimeBaseValidationNotification afgeleide klasse door de validator-applicatie. De instantie wordt vermoedelijk geregistreerd bij de tijdbasisprovider om zich te abonneren op de desbetreffende meetgegevens. Vraag Q-0ddb9ee8a3e8f381 (open) Zodra de tijdstack nieuwe meetcycli van de tijdbasis heeft voltooid, levert deze de geregistreerde blokken via de pure virtual methoden van de interface af. Voor de analyse van de Time Master vindt de aanroep van SetMasterTimingData met de parameter measurementData van het type TimeMasterMeasurementType plaats [SWS_TS_00421]. Als er voor de tijdbasis meetgegevens voor signaallooptijdmeting beschikbaar zijn, verzendt de provider deze via SetPdelayResponderData met de parameter measurementData van het type PdelayResponderMeasurementType [SWS_TS_00423]. Na beëindiging van het bewakingsproces vernietigt de applicatie de instantie op geordende wijze via de virtuele destructor [SWS_TS_01301].

Sequentiediagram: typische notificatie van een validator-applicatie over nieuwe tijdbasis-meetdatablokken. Bronnen: [SWS_TS_00421], [SWS_TS_00423], [SWS_TS_01301]

Foutscenario's en randvoorwaarden

Zowel SetMasterTimingData als SetPdelayResponderData zijn gespecificeerd als noexcept en bezitten de classificatie exception safe [SWS_TS_00421], [SWS_TS_00423]. Implementaties van deze interface mogen daarom geen excepties doorgeven aan de aanroepende synchronisatieprovider. De methoden leveren geen retourwaarde op (void); een terugkoppeling over foutieve of ongeloofwaardige meetgegevens vindt dus niet direct via de methode-aanroep plaats. Omdat de interface is gedeclareerd als non_threadsafe, leidt een gelijktijdige aanroep zonder externe synchronisatie tot ongedefinieerd gedrag. Een randvoorwaarde voor het ontvangen van de gegevens is een intact object, waarvan de levensduur gedurende de gehele periode van de callback-beschikbaarstelling tot aan de vernietiging via de destructor behouden moet blijven [SWS_TS_01301].