类 <SI-Namespace>::skeleton::fields::<Field>

使用

方法 RegisterGetHandler 在服务器端于 Skeleton 的字段对象上调用（[SWS_CM_00114]）。仅当在相关字段的接口描述中配置了 Getter 时，它才会存在于生成的代码中（Field.hasGetter == TRUE）（EXP ARAComAPI §5.4.8.1 “Registering Getters”）。传入类型为 std::function<ara::core::Future<FieldType>()> 的回调 handler，当收到代理的 Get() 请求时，绑定实现将调用该回调。

注册此类 Handler 完全是可选的（EXP ARAComAPI §5.4.8.1 “Registering Getters”）。通常，服务实现不需要 Getter Handler，因为 Communication Management 会缓存最近通过 Update() 设置的值并自主响应代理请求。只有当确定字段值非常耗时或计算量很大，因此应在实际需要时才通过 Promise/Future 模式异步进行时，Handler 才尤为有意义。

错误处理与边界条件

该函数没有返回值，声明为 noexcept 并且是异常安全的（exception safe）（[SWS_CM_00114]）。如果传入的 Callable 不存在或为 null，则存在错误 InvalidHandlerViolation（[SWS_CM_00114]）。

相互作用

与 RegisterSetHandler（在存在 Setter 时必须调用 EXP ARAComAPI §5.4.8.2 “Registering Setters”）相反，RegisterGetHandler 完全是可选的。如果 Handler 要在特定执行上下文中异步处理，还可以使用带有 ExecutorT 的重载模板函数（[SWS_CM_11360]）。

使用

命名空间 <SI-Namespace>::skeleton::fields::<Field> 中的方法 RegisterGetHandler 注册一个应用程序端回调（handler），当代理发起传入的 Get() 调用时，通信绑定将调用该回调（[SWS_CM_11360]、EXP ARAComAPI §5.4.8.1 “Registering Getters”）。与无参数的基本重载 [SWS_CM_00114] 不同，该方法接收类型为 ExecutorT 的执行上下文 executor，回调将在其中异步执行（[SWS_CM_11360]）。作为执行器，可以使用标准化的 ara::core::Executor 或具有相同接口的用户特定类型（[SWS_CM_11360]）。

注册的处理器返回 ara::core::Future<FieldType>，从而通过 Promise/Future 模式将字段值的计算解耦（[SWS_CM_11360]、EXP ARAComAPI §5.4.8.1 “Registering Getters”）。该注册完全是可选的：如果未注册处理器，Communication Management 将使用最后通过 Update() 设置的值自主响应请求（EXP ARAComAPI §5.4.8.1 “Registering Getters”）。Getter 处理器主要适用于按需确定繁重或耗时的字段值（EXP ARAComAPI §5.4.8.1 “Registering Getters”）。

限制与错误处理

仅当在 IDL 中为该字段配置了 Getter 时，该方法才会存在于 Skeleton 中（Field.hasGetter == TRUE、[SWS_CM_00114]、EXP ARAComAPI §5.4.8.1 “Registering Getters”）。RegisterGetHandler 被声明为 noexcept；然而，如果传入了无效或可调用的空对象，则构成 InvalidHandlerViolation（[SWS_CM_11360]）。理解：传入的执行器在处理器的整个使用期限内应该都必须保持有效，因为传入的请求会被异步调度到其上下文中。 问题 Q-c58eb22b06a8c27c (未决)

使用

方法RegisterSetHandler在服务端（骨架）用于注册一个回调函数，当客户端针对某个字段的Set()请求到达时，该回调函数将被调用[SWS_CM_00116]。仅当所提供的字段配置了 Setter 支持时（Field.hasSetter == TRUE），该方法才存在[SWS_CM_00116]。与 Getter 注册不同，调用RegisterSetHandler是强制性的，因为服务端实现必须预先验证匿名客户端的新字段值或已更新字段值EXP ARAComAPI §5.4.8.2 “Registering Setters”。

注册的处理程序接收新值作为参数，并返回包含生效的（可能经过修正的）值的ara::core::Future<FieldType>[SWS_CM_00116]，EXP ARAComAPI §5.4.8.2 “Registering Setters”。该生效值由通信管理系统隐式采用并发布给客户端；因此在处理程序内部无需显式调用Update()EXP ARAComAPI §5.4.8.2 “Registering Setters”。

错误处理与边界条件

该函数被定义为noexcept并且是异常安全的[SWS_CM_00116]。如果传递了不存在或无效的（null）Callable，则构成形式为InvalidHandlerViolation的规范违规[SWS_CM_00116]。解释：可能必须在通过OfferService()提供服务之前完成注册，以便从一开始就能够接收传入的客户端请求。 问题 Q-d45be0a899ddb6dd (未决)

相互作用

除了基本方法之外，还存在一个模板重载[SWS_CM_11362]，通过它可以将处理程序的执行绑定到特定的执行上下文（符合[SWS_CM_11360]的ExecutorT）EXP ARAComAPI。

模板函数 RegisterSetHandler 在Field的服务器层或Skeleton层注册一个回调函数，一旦客户端发送 Set() 请求，该回调函数就会被调用（[SWS_CM_11362]，[SWS_CM_00116]）。仅当配置的服务Field提供Setter支持（Field.hasSetter == TRUE）时，该接口才存在（[SWS_CM_00116]）。与Get注册不同，注册Set处理程序是强制性的，因为服务器实现必须始终验证来自匿名客户端的新Field值（EXP ARAComAPI §5.4.8.2 “Registering Setters”）。

与符合 [SWS_CM_00116] 的标准注册相比，此重载额外接受一个类型为 ExecutorT&& 的执行上下文 executor（[SWS_CM_11362]，[SWS_CM_11360]）。Interpretation：executor 推测控制回调在哪个线程上下文或任务调度器上下文中执行。 问题 Q-6dec4c0005c388dd (未决)传入的处理程序具有签名 std::function<ara::core::Future<FieldType>(<SFieldDerivedType> value)>；它接收由客户端设置的值，并通过 ara::core::Future 异步返回有效的（可能经过验证或校正的）值（[SWS_CM_11362]，EXP ARAComAPI §5.4.8.2 “Registering Setters”）。

Communication Management隐式采用处理程序返回的有效值，就好像服务器应用程序本身调用了 Update() 一样；因此在处理程序内部手动调用 Update() 是多余的（EXP ARAComAPI §5.4.8.2 “Registering Setters”，EXP ARAComAPI §4.6 “Data Type Abstractions”）。

错误处理与并发性：

• 异常安全性：该函数被声明为 noexcept，并被指定为异常安全（exception safe）（[SWS_CM_11362]）。
• 违规：如果传入的可调用对象 setHandler 不存在或是 nullptr，则属于违规 InvalidHandlerViolation（[SWS_CM_11362]）。
• 上下文：该方法确保处理程序的执行在 executor 所提供的上下文中进行（[SWS_CM_11362]）。

函数 SetTransportFaultConditionHandler 用于在命名空间 <SI-Namespace>::skeleton::fields::<Field> [SWS_CM_00096] 中的 Skeleton 层级上，为字段的 Get 和 Set 请求注册类型为 ara::com::e2e::TransportFaultConditionHandler 的错误处理器。该调用同步执行，没有返回值（void），并通过规范为 noexcept 保证异常安全 [SWS_CM_00096]。对于需要将 Handler 执行委托给显式执行上下文的场景，提供了带有 Executor 对象 ExecutorT&& executor 的模板重载 [SWS_CM_00097]。

错误条件定义为违背 InvalidHandlerViolation；当传入的 Callable handler 不存在或为 null 时发生 [SWS_CM_00096]。虽然客户端的方法和字段请求错误通过各个 ara::core::Future 实例中的 ComErrc::kCommunicationFailure 进行报告 [SWS_CM_00090]，但该函数允许服务器实例在传入 Get 和 Set 调用时接收传输错误 [SWS_CM_00096]。

该概念对应于 Skeleton 服务实例的所有方法的相关注册机制 [SWS_CM_00093]，以及事件 [SWS_CM_00099]、触发器 [SWS_CM_00106] 和字段通知器 [SWS_CM_00109] 的代理端 Handler。Interpretation：Handler 的注册适宜在提供 Skeleton 之前的初始化阶段进行，以便能够无缝捕获初始字段访问时的错误。 问题 Q-627229896b666532 (未决)

命名空间 <SI-Namespace>::skeleton::fields::<Field> 中的函数 SetTransportFaultConditionHandler 注册一个错误处理程序，用于处理 Skeleton 级别字段的 Get 和 Set 请求时的传输故障 [SWS_CM_00097]。它通过头文件 <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h 包含 [SWS_CM_00097]。

用法与参数

该调用同步进行且没有返回值（void）[SWS_CM_00097]。类型为 ara::com::e2e::TransportFaultConditionHandler 的可调用错误回调 handler 以及泛型类型 ExecutorT&& 的转发引用 executor 作为参数传递 [SWS_CM_00097]。参数 executor 表示执行对象，任何异步计算都在该对象的上下文中执行 [SWS_CM_00097]。

错误处理与并发

该方法被声明为 noexcept 并保证完全的异常安全性（exception safe）[SWS_CM_00097]。如果传入的 handler 可调用对象不存在或为 null，则会引发 InvalidHandlerViolation [SWS_CM_00097]。解释：通过传入的 executor 对象，推测将确定在哪个线程或任务上下文中处理传输错误时的异步通知。 问题 Q-4101faaa8d6a3130 (未决)

相互作用

该方法通过为 Skeleton 字段提供专用执行上下文扩展了标准注册 [SWS_CM_00096] [SWS_CM_00097]。对于 Skeleton 方法（[SWS_CM_00094]）以及在客户端或 Proxy 端针对事件（[SWS_CM_00100]）和字段通知器（[SWS_CM_00110]），也存在带有执行器的相应重载。

在服务接口的 Skeleton 端，函数 UnsetTransportFaultConditionHandler 用于取消先前为字段的 Get 和 Set 请求注册的 ara::com::e2e::TransportFaultConditionHandler（[SWS_CM_00098]）。它在命名空间 <SI-Namespace>::skeleton::fields::<Field> 中定义并通过头文件 <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h 包含（AUTOSAR_AP_SWS_CommunicationManagement §8.4.3.2.1.3 “UnsetTransportFaultConditionHandler”）。该调用同步进行，不接受输入参数且不返回返回值（void）。

通过注销，针对字段请求时传输错误状态的应用程序专用回调将被停用（AUTOSAR_AP_SWS_CommunicationManagement §7.4.1 “End-to-end communication protection for SOMEIP”）。该接口被声明为noexcept，并保证异常安全性（exception safe）（[SWS_CM_00098]）。未通过 DET 或 DEM 指定错误代码或特定错误消息；该操作被设计为无差错完成。

关于并发性和可重入性，该规范未包含单独规定。因此，注销最好在去初始化阶段或在并发 Get/Set 处理之外执行，以避免正在进行的通信过程中出现不一致。 问题 Q-06bc8d90f1891904 (未决)

该操作是服务实例端到端通信保护的一部分（AUTOSAR_AP_SWS_CommunicationManagement §7.4.1 “End-to-end communication protection for SOMEIP”）。它是[SWS_CM_00095]在字段层面的对应项，后者用于注销骨架（Skeleton）所有方法的处理程序。在代理（Proxy）端，它对应于针对事件（[SWS_CM_00105]）、触发器（[SWS_CM_00108]）以及字段通知器（[SWS_CM_00126]）的相应注销操作。

方法 Update() 在服务器端的作用域 <SI-Namespace>::skeleton::fields::<Field> 中调用，以更新字段的内部值并启动向已订阅客户端传输新数据（[SWS_CM_00119]，AUTOSAR_AP_EXP_ARAComAPI §4.6 “Data Type Abstractions”）。当为字段配置了 hasNotifier == TRUE 时，会向订阅者发送通知（[SWS_CM_00119]，[SWS_CM_00120]，[SWS_CM_00162]）。参数 value 通过引用传递；绑定实现将在调用期间创建通常已序列化的副本，以便应用程序数据在调用方返回后可以被修改或释放（AUTOSAR_EXP_ARAComAPI “UpdateRate Class”）。

该函数定义为 noexcept 以及 exception safe，并同步返回一个 ara::core::Result<void>（[SWS_CM_00119]）。如果发生错误，结果将包含来自 ara::com::ComErrc 的错误代码（[SWS_CM_00119]，[SWS_CM_10432]）。具体而言，如果发送请求的发生速度快于所配置的最小发送间隔 ServiceInterfaceDeploymentElement.minimumSendInterval 所规定的速度，则会返回具有回滚语义的 ComErrc::kMinimumSendIntervalViolationError（[SWS_CM_00119]）。

在服务生命周期中，在提供服务之前需要初始调用 Update()：如果在初始化字段值之前调用了 OfferService()，则提供将失败并返回 ComErrc::kFieldValueNotInitialized（[SWS_CM_00101]，[SWS_CM_00128]）。由于标准中缺乏显式的可重入性保证，同一字段实例上的并发调用应当在应用程序端进行同步。 问题 Q-67b174ef05867989 (未决)