Example of an ActionFlow mapping

There are two main parts in an ActionFlow controller. Its mapping and it’s step implementations. Here’s an example mapping taken from the Demo Application. There are many more mapping instructions available and it’s up to you to read the API. Don’t be lazy and read it: it’s definitely worth it if you are going to use ActionFlow.

 
# Inherit from the ActionFlow::Base superclass to enable
# flow-like capabilities
class MySexyFlowController < ActionFlow::Base
 
  # Put your mapping in Ruby objects standard initialize method
  def initialize
 
    # Start the flow with the initialization view
    start_with :init
    
    # End the flow on the qui view
    end_with :quit
    
    # Redirect the invalid flows to the index of
    # the current controller so the flow initializes
    # correctly
    redirect_invalid_flows :action => :index
    
    
    # Rescue potential errors
    upon :StandardError => :quit_with_error
    
    
    
    # Map the init step
    view_step :init do
    
      # Map some events to steps
      on :next => :hello_world  
      on :raise_error => :raise_error
      on :quit => :quit
      
      # Handle potential errors
      upon :StandardError => :quit_with_error
      
    end
    
    
    # Map the hello world step
    view_step :hello_world do
    
      # Map some events to steps
      on :hello_you_too => :quit
      on :back => :init
    
      # Handle potential errors
      upon :StandardError => :quit_with_error
      
    end
    
    
    # Map the error raising step
    action_step :raise_error do
      # Nothing to map, we'll throw an error
      # but the controller will rescue it.
    end
    
    
    # Map the hello world step
    action_step :quit_with_error do
      
      # Use this method as a step implementation
      method :show_error_and_quit
      
      # Map an event
      on :quit => :quit
      
    end
    
    
    # Map the quit step
    view_step :quit
  
  end
 
end

~~DISCUSSION~~