类 ara::tsync::ProviderTimeBaseValidationNotification

抽象类 ara::tsync::ProviderTimeBaseValidationNotification 用作向验证器应用程序提供已记录的时间基准测量数据的回调接口。实现通过 SetMasterTimingData 接收 Time Master 的测量块 [SWS_TS_00421]，并通过 SetPdelayResponderData 接收 Pdelay Responder 的测量数据 [SWS_TS_00423]。这些方法被指定为 noexcept，但不是线程安全的，因此必须避免对同一实例的并发调用。

更多 ›

上下文

类 ara::tsync::ProviderTimeBaseValidationNotification 用作同步模块内时基验证的抽象回调接口。一旦受监控的时基有新的记录测量数据块可用，就会通过该接口通知接收验证器应用程序。该接口根据 [SWS_TS_00421] 定义了时钟源（Time Master）特定测量数据的传递点，并根据 [SWS_TS_00423] 定义了延迟响应机制（Pdelay Responder）测量数据的传递点。此处的交互伙伴通常是作为数据源的时间同步栈内部 Provider 机制，以及评估所采集时间数据的应用程序端验证实例。

生命周期和并发

作为抽象接口，ara::tsync::ProviderTimeBaseValidationNotification 由具体验证应用程序继承并实现。实例化实现的生命周期由应用程序负责。该类具有一个声明为异常安全（noexcept）的虚默认析构函数 [SWS_TS_01301]。这确保了派生类实例在析构时能够以多态且资源安全的方式销毁。在并发性方面，通知方法被明确归类为非线程安全（non_threadsafe）[SWS_TS_00421], [SWS_TS_00423]。这意味着不允许在不受保护的情况下从竞争线程对同一实例调用 SetMasterTimingData 和 SetPdelayResponderData；调用方时基 Provider 可以按序发出这些调用，或者应用程序必须确保同步。 问题 Q-8f59bb65825ead66 (未决)

使用路径

典型流程始于验证器应用程序提供一个继承自 ara::tsync::ProviderTimeBaseValidationNotification 的类。该实例可能注册到时基 Provider，以订阅相应的测量数据。 问题 Q-0ddb9ee8a3e8f381 (未决)一旦时间栈完成时基的新测量周期，便会通过接口的纯虚方法传递采集到的数据块。若要分析 Time Master，则调用 SetMasterTimingData，并传入 TimeMasterMeasurementType 类型的参数 measurementData [SWS_TS_00421]。如果时基有可用的信号传播时间测量数据，Provider 将通过 SetPdelayResponderData 传递这些数据，并传入 PdelayResponderMeasurementType 类型的参数 measurementData [SWS_TS_00423]。在监控运行结束后，应用程序通过虚析构函数 [SWS_TS_01301] 有序销毁该实例。

时序图：向验证器应用程序通知新时基测量数据块的典型流程。来源：[SWS_TS_00421]、[SWS_TS_00423]、[SWS_TS_01301]

错误场景与边界条件

SetMasterTimingData 和 SetPdelayResponderData 均指定为 noexcept，并具有 exception safe 分类 [SWS_TS_00421], [SWS_TS_00423]。因此，该接口的实现不得将异常传递给调用方同步 Provider。这些方法不返回任何值（void）；因此不会直接通过方法调用反馈有关错误或不合理测量数据的信息。由于该接口被声明为 non_threadsafe，没有外部同步的并发调用将导致未定义行为。接收数据的前提条件是一个完好的对象，其生命周期必须在提供回调的整个期间内维持，直至通过析构函数销毁 [SWS_TS_01301]。