技术文档：Acts As State Machine 使用指南

1. 安装指南

Acts As State Machine 是一个为 Active Record 模型提供有限状态机（FSM）功能的插件。以下是安装步骤：

1. 使用 Subversion 获取插件源码：

   svn checkout http://elitists.textdriven.com/svn/plugins/acts_as_state_machine/trunk
   

2. 如果在获取过程中需要认证，使用用户名/密码 anonymous/anonymous。

3. 将下载的插件文件集成到你的 Rails 项目中。

2. 项目的使用说明

Acts As State Machine 允许你的 Active Record 模型表现得像一个有限状态机。以下是如何在模型中使用它的示例：

class Order < ActiveRecord::Base
  acts_as_state_machine :initial => :opened

  state :opened
  state :closed, :enter => Proc.new { |o| Mailer.send_notice(o) }
  state :returned

  event :close do
    transitions :to => :closed, :from => :opened
  end

  event :return do
    transitions :to => :returned, :from => :closed
  end
end

在上面的例子中，Order 类通过 acts_as_state_machine 方法定义了一个初始状态 :opened。然后定义了三个状态：:opened、:closed 和 :returned。acts_as_state_machine 还允许定义状态事件和转换，例如 close 和 return 事件。

• :closed 状态在进入时触发 Mailer.send_notice(o) 方法，发送通知。
• close 事件定义了从 :opened 状态到 :closed 状态的转换。
• return 事件定义了从 :closed 状态到 :returned 状态的转换。

创建 Order 对象后，可以使用 close! 和 return! 方法触发相应的事件。

3. 项目API使用文档

以下是 Acts As State Machine 提供的主要API：

• acts_as_state_machine：在 Active Record 模型中声明状态机，需要指定初始状态。
• state：定义一个状态。
• event：定义一个事件，可以包含状态转换。
• transitions：定义状态转换，包括源状态和目标状态。

4. 项目安装方式

项目的安装方式已在安装指南中详细说明。以下是简要步骤：

• 使用 Subversion 从指定的地址检出插件代码。
• 将插件代码集成到 Rails 项目中。

通过以上步骤，您可以将 Acts As State Machine 添加到您的 Rails 项目中，并开始使用它来管理模型的状态转换。