命名空间 ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>}

此命名空间在Platform Health Management中为受监控实体的检查点提供强类型枚举[SWS_PHM_00424]。每个受监控实体都获得一个以std::uint32_t为基础类型的独立作用域枚举，其声明的枚举项作为检查点上报给接口ara::phm::PhmSupervisedEntityInterface [SWS_PHM_00424]、[SWS_PHM_00425]。通过在类型安全的命名空间中进行静态提供，可在编译时可靠地防止混淆不同实体的检查点。

更多 ›

上下文

C++命名空间namespace ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>}在AUTOSAR Adaptive Platform的Platform Health Management（PHM）中用作受监控功能单元（Supervised Entities）的类型安全检查点（Checkpoints）的专用区域。根据[SWS_PHM_00424]，该命名空间包含格式为enum class {<phmssi-sn>} : std::uint32_t的作用域枚举，用于为接口ara::phm::PhmSupervisedEntityInterface定义离散检查点。针对检查点列表中配置的每个元素，都存在一个唯一的C++枚举项声明[SWS_PHM_00425]。该交互将三个功能核心组件结合在一起：受监控的应用软件（Supervised Entity）、由该命名空间建模的类型化检查点，以及用于将监控事件转发给PHM服务的平台接口ara::phm::PhmSupervisedEntityInterface。

上下文图：受监控应用软件、类型化检查点枚举与平台接口之间的交互。来源：[SWS_PHM_00424]、[SWS_PHM_00425]

生命周期

命名空间内部的类型和常量具有静态编译期特性。它们无需通过堆上的分配或释放来经历动态运行时生命周期，而是作为基础类型为std::uint32_t的类型化C++11作用域枚举提供[SWS_PHM_00424]。解读：这些定义通常在构建过程中根据AUTOSAR服务描述自动生成，因为路径和标识符取决于接口的模型参数。 问题 (未决)对于包含，标准在#include "ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h"下为每个受监控单元提供一个单独的头文件，而常规类型声明可以通过转发头文件#include "ara/phm/phm_fwd.h"进行前向声明[SWS_PHM_00424]。因此，在整个进程生命周期中，枚举项常量不可变地可供应用程序使用[SWS_PHM_00425]。

使用路径

充当Supervised Entity的软件组件的典型使用路径分为三个递进步骤：

• 包含头文件：应用程序通过文件路径ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h或中心转发头文件ara/phm/phm_fwd.h包含受监控单元的已生成头文件[SWS_PHM_00424]。
• 接口初始化：应用程序实例化或绑定声明了枚举检查点的接口ara::phm::PhmSupervisedEntityInterface [SWS_PHM_00424]。
• 检查点信号通知：当运行至算法中的相关检查位置时，应用程序从命名空间中选择对应的枚举项{<symbol-phm-checkpoint>} [SWS_PHM_00425]，并将其上报给ara::phm::PhmSupervisedEntityInterface的实例[SWS_PHM_00424]。

通过与基础类型std::uint32_t [SWS_PHM_00424]绑定并为每个检查点显式赋值[SWS_PHM_00425]，保证了在运行时对各程序步骤进行类型安全且无混淆的识别。

错误场景

错误使用此命名空间主要源于与模型和类型相关的错误配置。由于它是enum class [SWS_PHM_00424]，C++类型系统会阻止隐式类型转换；因此，使用错误的数据类型或其他Supervised Entity的枚举项在编译时就会被拦截。如果模型描述中的配置与枚举项列表不完全一致，则可能导致运行时错误：根据[SWS_PHM_00425]，必须为每个检查点声明相应的枚举项。解读：如果应用程序通过非法的类型转换或过期的头文件将未在模型中配置的std::uint32_t值传递给ara::phm::PhmSupervisedEntityInterface，PHM服务可能无法识别该检查点，并将其视为违背监控的行为。 问题 Q-b8fb7472f6ea8d10 (未决)