服务接口 StateMachineService

服务接口StateMachineService由 State Management 为每个配置的状态机提供，以便SMControlApplication可以通过方法RequestTransition有针对性地请求状态切换[SWS_SM_00600]，[SWS_SM_91107]。该服务在状态机的启动步骤成功处理后立即被提供，并且在确认请求时不采用 Fire-and-Forget 语义。但是，如果传入的值无效、从当前状态的转换不被允许，或者更新/恢复会话同时处于活动状态，请求将被拒绝并返回特定错误[SWS_SM_91107]。

更多 ›

服务接口的角色与系统上下文

服务接口StateMachineService由 Functional Cluster State Management (SM) 通过标准化服务端口提供[SWS_SM_91021]。根据形式化接口定义[SWS_SM_91022]，State Management 为StateMachine的每个已配置实例实例化并提供此基于ara::com的服务[SWS_SM_00600]。

作为此接口的主要消费者，SMControlApplication通过该服务直接与状态机进行交互，以请求状态切换SWS StateManagement §9.2.2 “StateMachine service”。虽然向常规自适应应用程序通知已发生的状态主要是通过独立的服务接口StateMachineNotification进行的[SWS_SM_00665]，但StateMachineService构成了用于发起转换的主动控制接口。

方法与调用语义

该接口定义了方法RequestTransition，必须由SMControlApplication调用该方法以在引用的StateMachine中引起状态更改[SWS_SM_91107]。该方法需要类型为TransitionRequestType的输入参数TransitionRequest，该参数表示基础TransitionRequestTable内所需的转换值[SWS_SM_91107]，SWS StateManagement §7.x “TransitionRequestTable”。

对于RequestTransition，属性 Fire & Forget 被设置为false[SWS_SM_91107]。因此，调用应用程序会收到该请求的确定性确认。Interpretation：在ara::com代理-骨架模式内，反馈通常可能通过ara::core::Future或相应的结果对象提供，其在成功时解析，或在失败时传输特定的错误状态。 问题 Q-41fa67738672c735 (未决)

生命周期与状态依赖性

一旦成功处理ActionListItem“StartStateMachine”，为待启动的StateMachine配置的每个ara::com服务（包括StateMachineService）都必须可用并被提供（Offer）[SWS_SM_00618]。这允许SMControlApplication在成功创建状态机后立即请求转换，即使状态机此时仍在处理初始ActionListSWS StateManagement §7.x “StateMachine service interfaces - Offer”。

一旦进行用于停止相应状态机的处理，服务的提供即告终止（StopOffer）[SWS_SM_00619]。调用还受制于功能性前提条件：如果系统中当前正在运行更新会话，则原则上不允许发起状态切换[SWS_SM_91107]。

错误处理与 Application Errors

在执行RequestTransition时可能会发生特定的 Application Errors，State Management 会将其返回给调用方[SWS_SM_91107]：

• kInvalidValue：传入的值在TransitionRequestTable中未分配给任何转换[SWS_SM_91107]。
• kTransitionNotAllowed：从StateMachine的当前状态出发，不允许进行所请求的状态转换[SWS_SM_91107]。
• kRecoveryTransitionOngoing：由于当前正在执行故障恢复（Recovery），请求被丢弃[SWS_SM_91107]。
• kTransitionFailed：在执行到目标状态的转换期间发生错误[SWS_SM_91107]。
• kOperationCanceled：请求已被中止，因为它已被更新的请求所取代[SWS_SM_91107]。
• kUpdateInProgress：该操作被禁止，因为当前更新会话处于活动状态[SWS_SM_91107]。

时序图：通过 StateMachineService 发出转换请求的流程，包括服务提供、成功确认和错误处理。来源：[SWS_SM_91107]，[SWS_SM_00618]，SWS StateManagement §7.x “StateMachine service interfaces - Offer”。

StateMachineService 是状态管理功能集群为每个配置的状态机实例提供的服务接口，供控制应用程序通过 RequestTransition 方法请求状态机执行状态切换（[SWS_SM_91021]、[SWS_SM_00600]）。该服务采用非即发即弃语义，在状态机启动成功后对外发布，并借助 TransitionRequestTable 校验目标状态（[SWS_SM_00618]、[SWS_SM_91107]）。当遇到无效键值、当前状态冲突、正在执行故障恢复或系统处于更新会话时，服务将返回明确的应用错误予以拦截（[SWS_SM_91107]）。

更多 ›

1. 服务接口的角色与系统上下文

StateMachineService 是 AUTOSAR Adaptive Platform 状态管理（State Management, SM）功能集群提供的基于 ara::com 的核心服务接口，其服务端口由 SM 集群统一定义并提供（[SWS_SM_91021]）。该服务接口专用于控制应用（SMControlApplication）与状态管理内部的状态机（StateMachine）进行交互，以便外部实体能够请求状态机执行状态变更操作（SWS StateManagement §9.2.2 „StateMachine service“、[SWS_SM_91022]）。

在系统架构拓扑中，状态管理功能集群扮演服务提供方（Provider/Skeleton），而作为客户端的 SMControlApplication 则扮演服务消费方（Consumer/Proxy）。对于系统中配置的每一个 StateMachine 实例，状态管理都必须为其提供独立的 StateMachineService 服务实例（[SWS_SM_00600]）。与之相对，用于向自适应应用程序广播状态事件的 StateMachineNotification 接口属于可选配置（[SWS_SM_00665]），这表明 StateMachineService 专注于直接的状态切换控制通道（SWS StateManagement §7.8 „TransitionRequestTable“）。

2. 方法与调用语义

StateMachineService 服务接口定义了一个关键方法 RequestTransition（版本 1.0），该方法由 SMControlApplication 调用以向目标状态机请求状态迁移（[SWS_SM_91107]）。该方法包含一个输入参数：

• TransitionRequest（输入类型：TransitionRequestType）：指定要执行的目标迁移请求值，该值必须在配置的转换请求表（TransitionRequestTable）中具有明确映射（[SWS_SM_91107]、SWS StateManagement §7.8 „TransitionRequestTable“）。

在调用语义上，RequestTransition 明确配置为非即发即弃模式（Fire & Forget false），属于具备应答确认的远程调用机制（[SWS_SM_91107]）。客户端发起调用后，服务端将评估请求并执行对应的动作列表（ActionList），在转换成功或触发异常时向调用方返回结果（SWS StateManagement §7 „StateMachine service interfaces - Offer“）。

时序图: SMControlApplication 调用 RequestTransition 请求状态机转换及响应流程。来源: [SWS_SM_91107], [SWS_SM_00618]

3. 生命周期与会话依赖

每个配置好的 StateMachineService 实例具备严格的服务发布与终止生命周期：当与该状态机启动相关的动作列表项 ActionListItem "StartStateMachine" 执行成功时，状态管理必须对外提供（Offer）该服务（[SWS_SM_00618]）。规范特别指出，一旦状态机创建成功并发布服务，即便状态机仍处于初始 ActionList 的执行阶段，SMControlApplication 也被允许立即发起新的状态迁移请求（SWS StateManagement §7 „StateMachine service interfaces - Offer“）。

在服务生命周期的终结阶段，推测当状态机被停止或处理去激活相关的动作列表项时，对应的 StateMachineService 接口将不再可用并撤回提供（StopOffer）（[SWS_SM_00619]）。 问题 (未决)此外，当系统处于软件更新会话时，状态机的常规迁移受限，任何在此期间发起的操作都会因更新保护而被拦截（[SWS_SM_91107]）。

4. 错误处理与应用错误（Application Errors）

针对调用失败与异常场景，RequestTransition 方法在其服务接口中定义了完备的应用错误集合（Application Errors），调用方必须对以下错误进行针对性处理（[SWS_SM_91107]）：

通过这些标准化的错误定义，客户端能够明确判断请求被拒绝是由于静态配置不匹配（如 kInvalidValue）、当前运行状态冲突（如 kTransitionNotAllowed、kRecoveryTransitionOngoing）、被新指令取代（kOperationCanceled）还是由于正在进行平台级系统升级（kUpdateInProgress）（[SWS_SM_91107]）。