FSM - 一个简单的有限状态机（Golang）

FSM - 一个简单的有限状态机（Golang）

基础介绍

FSM 是一个为 Golang 编写的简单有限状态机（Finite State Machine，FSM）。它允许您定义状态和状态之间的转换，并可以并行运行任意数量的转换检查。FSM 已经进行了测试和性能基准测试，以确保其稳定性和效率。

主要编程语言

• Golang

新手常见问题及解决方案

问题一：如何初始化和设置状态机

问题描述：新手在使用 FSM 时，可能不清楚如何创建状态机实例并设置初始状态。

解决步骤：

1. 首先，您需要定义一个结构体，该结构体包含 FSM 状态和 FSM 实例。
2. 然后，创建结构体实例并设置初始状态。
3. 最后，创建 FSM 实例并将其与结构体实例关联。

package main

import (
    "fmt"
    "github.com/ryanfaerman/fsm"
)

type Thing struct {
    State    fsm.State
    Machine  *fsm.Machine
}

func main() {
    someThing := Thing{State: "pending"}
    someThing.Machine = &fsm.Machine{Subject: &someThing}
}

问题二：如何添加状态转换规则

问题描述：新手可能不知道如何定义和添加状态转换规则。

解决步骤：

1. 定义一个规则集（Ruleset）并添加转换规则。
2. 将规则集应用到状态机上。
3. 执行转换。

package main

import (
    "fmt"
    "log"
    "github.com/ryanfaerman/fsm"
)

func main() {
    someThing := Thing{State: "pending"}
    someThing.Machine = &fsm.Machine{Subject: &someThing}

    rules := fsm.Ruleset{}
    rules.AddTransition(fsm.T{"pending", "started"})
    rules.AddTransition(fsm.T{"started", "finished"})

    err := someThing.Apply(&rules).Transition("started")
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(someThing.State) // 输出：started
}

问题三：如何处理不允许的状态转换

问题描述：新手可能不清楚如何处理不允许的状态转换。

解决步骤：

1. 定义规则时，确保添加所有允许的状态转换。
2. 如果尝试执行不允许的转换，状态机将返回错误。
3. 捕获并处理这个错误。

package main

import (
    "fmt"
    "log"
    "github.com/ryanfaerman/fsm"
)

func main() {
    someThing := Thing{State: "started"}
    someThing.Machine = &fsm.Machine{Subject: &someThing}

    rules := fsm.Ruleset{}
    rules.AddTransition(fsm.T{"pending", "started"})
    rules.AddTransition(fsm.T{"started", "finished"})

    err := someThing.Apply(&rules).Transition("pending")
    if err != nil {
        log.Printf("转换不允许: %v", err)
    }

    fmt.Println(someThing.State) // 输出：started，转换未执行
}