类 ara::tsync::ConsumerTimeBaseValidationNotification

接口 ara::tsync::ConsumerTimeBaseValidationNotification 向 Consumer 应用程序通知时间基准的新可用测量数据块。通过回调方法 SetSlaveTimingData [SWS_TS_00420] 和 SetPdelayInitiatorData [SWS_TS_00422]，系统为 Time Slave 以及 pDelay 发起方传递详细的时序与验证数据。应用程序开发人员从该类派生，实现数据处理，并必须确保不抛出异常，因为所有方法均被指定为 noexcept 且具备异常安全性。此外，被归类为 non_threadsafe 要求在并发访问时进行应用端同步。

更多 ›

上下文

类 ara::tsync::ConsumerTimeBaseValidationNotification 代表 AUTOSAR Adaptive Platform 的 tsync 模块中的回调接口。其目的在于，一旦受监视的时间基准有新的已记录数据块可用，就通知 Consumer 应用程序。

基本上有三个组件参与此交互：

• tsync 模块的时间基准：持续采集通信网络中的时间和同步测量值。
• 接口 ConsumerTimeBaseValidationNotification：通过方法 SetSlaveTimingData [SWS_TS_00420] 和 SetPdelayInitiatorData [SWS_TS_00422] 定义已记录测量数据块的传递点。
• Consumer 应用程序：实现回调方法，接收提供的测量值并对时间基准执行专业验证。

通过这种结构，特定于应用程序的验证逻辑与平台内部的时间数据记录清晰解耦。

生命周期

作为包含纯虚方法的抽象接口类，ara::tsync::ConsumerTimeBaseValidationNotification 无法直接实例化。Consumer 应用程序派生出一个具体类并实现所需的方法。

创建和所有权完全由 Consumer 应用程序负责。推测应用程序在其初始化阶段创建回调对象，并将其与 tsync 服务的相应时间基准相关联。 问题 Q-a423ce4cbd4eeaaa (未决)

为了进行销毁，该类提供了一个虚析构函数：virtual ~ConsumerTimeBaseValidationNotification() noexcept = default; [SWS_TS_01300]。声明为虚析构函数可确保派生类的实例可以通过基类指针进行类型安全且无资源泄漏的释放。

在并发性方面，通知方法 SetSlaveTimingData [SWS_TS_00420] 和 SetPdelayInitiatorData [SWS_TS_00422] 被指定为 non_threadsafe。如果平台服务的调用推测发生在后台线程的上下文中，则应用端实现自身负责保护对共享应用资源的访问。 问题 Q-1b857df043504eec (未决)

使用路径

使用验证通知的典型流程包括以下步骤：

1. 实现：Consumer 应用程序实现一个派生自 ara::tsync::ConsumerTimeBaseValidationNotification 的类。
2. 接收 Time Slave 测量数据：一旦为时间基准的 Time Slave 记录了新的测量数据块，时间服务就会调用方法 SetSlaveTimingData [SWS_TS_00420]，并通过 TimeSlaveMeasurementType 类型的参数 measurementData 传递详细的验证数据。
3. 接收 pDelay 发起方测量数据：如果有新的测量数据可用于 pDelay 发起方，则会使用 PdelayInitiatorMeasurementType 中的详细时序数据调用 SetPdelayInitiatorData [SWS_TS_00422]。
4. 处理：Consumer 应用程序评估传输的数据块，以检测同步错误或运行时偏差。
5. 对象释放：在监视结束时，通过虚析构函数销毁实例 [SWS_TS_01300]。

时序图：将为 Time Slave 和 pDelay 发起方采集的测量数据块传输到 Consumer 实现。来源：[SWS_TS_00420]、[SWS_TS_00422]。

错误场景

接口方法设计为具有最大的稳健性和确定性调用：

• 异常安全性：所有成员函数——SetSlaveTimingData [SWS_TS_00420]、SetPdelayInitiatorData [SWS_TS_00422] 和析构函数 [SWS_TS_01300]——均使用 noexcept 声明，并指定为具备异常安全性（exception safe）。Consumer 应用程序中的重写方法不得向外部传播异常，因为这会导致程序立即终止。
• 缺乏反馈通道：由于回调方法的返回类型为 void，因此应用程序逻辑内部的处理错误无法报告回 tsync 模块。应用程序必须在内部独立处理并记录可能出现的错误状态。
• 并发风险：基于属性 non_threadsafe（[SWS_TS_00420]、[SWS_TS_00422]），必须防止在没有应用端锁定的情况下并行处理多个数据块。解释：回调对象还必须在时间基准的整个注册期间保持有效，以防止对已释放内存发生致命访问。 问题 Q-934e451f6a0099c1 (未决)