Class: StateFu::Persistence::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/persistence/base.rb

Direct Known Subclasses

ActiveRecord, Attribute, RelaxDB

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(binding, field_name) ⇒ Base

Returns a new instance of Base.



32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
# File 'lib/persistence/base.rb', line 32

def initialize( binding, field_name )

  @binding       = binding
  @field_name    = field_name
  @current_state = find_current_state()

  if current_state.nil?
    Logger.warn("undefined state for binding #{binding} on #{object} with field_name #{field_name.inspect}")
    Logger.warn("Machine for #{object} has no states: #{machine}") if machine.states.empty?
  else
    persist!
    Logger.debug("#{object} resumes #{binding.method_name} at #{current_state.name}")
  end
end

Instance Attribute Details

#binding ⇒ Object (readonly)

Returns the value of attribute binding.



9
10
11
 
# File 'lib/persistence/base.rb', line 9

def binding
  @binding
end

#current_state ⇒ Object

Returns the value of attribute current_state.



9
10
11
 
# File 'lib/persistence/base.rb', line 9

def current_state
  @current_state
end

#field_name ⇒ Object (readonly)

Returns the value of attribute field_name.



9
10
11
 
# File 'lib/persistence/base.rb', line 9

def field_name
  @field_name
end

Class Method Details

.prepare_class(klass) ⇒ Object 



11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/persistence/base.rb', line 11

def self.prepare_class( klass )
  unless klass.instance_methods.include?( :method_missing_before_state_fu )
    alias_method :method_missing_before_state_fu, :method_missing
    klass.class_eval do
      def method_missing( method_name, *args, &block )
        state_fu!
        begin
          send( method_name, *args, &block )
        rescue NoMethodError => e
          method_missing_before_state_fu( method_name, *args, &block )
        end
      end
    end
  end
end

.prepare_field(klass, field_name) ⇒ Object

define this method in subclasses to do any preparation



28
29
30
 
# File 'lib/persistence/base.rb', line 28

def self.prepare_field( klass, field_name )
  Logger.warn("Abstract method in #{self}.prepare_field called. Override me!")
end

Instance Method Details

#find_current_state ⇒ Object 



47
48
49
50
51
52
53
54
55
 
# File 'lib/persistence/base.rb', line 47

def find_current_state
  string = read_attribute()
  if string.blank?
    machine.initial_state
  else
    state_name = string.to_sym
    state      = machine.states[ state_name ] || raise( StateFu::InvalidStateName, string )
  end
end

#klass ⇒ Object 



69
70
71
 
# File 'lib/persistence/base.rb', line 69

def klass
  binding.target
end

#machine ⇒ Object 



61
62
63
 
# File 'lib/persistence/base.rb', line 61

def machine
  binding.machine
end

#object ⇒ Object 



65
66
67
 
# File 'lib/persistence/base.rb', line 65

def object
  binding.object
end

#persist! ⇒ Object 



83
84
85
 
# File 'lib/persistence/base.rb', line 83

def persist!
  write_attribute( value() )
end

#reload ⇒ Object 



57
58
59
 
# File 'lib/persistence/base.rb', line 57

def reload
  @current_state = find_current_state()
end

#value ⇒ Object 



79
80
81
 
# File 'lib/persistence/base.rb', line 79

def value()
  @current_state && @current_state.name.to_s
end