Class: Praxis::RequestStages::RequestStage

Inherits:
Stage
  • Object
show all
Defined in:
lib/praxis/request_stages/request_stage.rb

Overview

Special Stage what will hijack the run and execute methods to: 1- Run specific controller callbacks (in addition to any normal callbacks) 2- Shortcut the controller callback chain if any returns a Response object

Instance Attribute Summary

Attributes inherited from Stage

#after_callbacks, #before_callbacks, #context, #name, #stages

Instance Method Summary collapse

Methods inherited from Stage

#after, #application, #before, #callback_args, #execute_callbacks, #initialize, #setup_deferred_callbacks!

Constructor Details

This class inherits a constructor from Praxis::Stage

Instance Method Details

#action ⇒ Object 



40
41
42
 
# File 'lib/praxis/request_stages/request_stage.rb', line 40

def action
  @context.action
end

#controller ⇒ Object 



36
37
38
 
# File 'lib/praxis/request_stages/request_stage.rb', line 36

def controller
  @context.controller
end

#execute ⇒ Object

Raises:

  • (NotImplementedError) 


107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/praxis/request_stages/request_stage.rb', line 107

def execute
  raise NotImplementedError, 'Subclass must implement Stage#execute' unless @stages.any?

  @stages.each do |stage|
    shortcut = stage.run
    if shortcut && shortcut.kind_of?(Praxis::Response)
      controller.response = shortcut
      return shortcut
    end
  end
  nil
end

#execute_controller_callbacks(callbacks) ⇒ Object 



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/praxis/request_stages/request_stage.rb', line 15

def execute_controller_callbacks(callbacks)
  if callbacks.key?(path)
    callbacks[path].each do |(conditions, block)|
      if conditions.key?(:actions)
        next unless conditions[:actions].include? action.name
      end
      result = block.call(controller)
      if result && result.kind_of?(Praxis::Response)
        controller.response = result
        return result
      end
    end
  end

  nil
end

#execute_with_around ⇒ Object 



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'lib/praxis/request_stages/request_stage.rb', line 80

def execute_with_around
  cb = controller.class.around_callbacks[ path ]
  if cb == nil || cb.empty?
    execute
  else
    inner_proc = proc { execute }

    applicable = cb.select do |(conditions, handler)|
      if conditions.has_key?(:actions)
        (conditions[:actions].include? action.name) ? true : false
      else
        true
      end
    end

    chain = applicable.reverse.inject(inner_proc) do |blk, (conditions, handler)|
      if blk
        proc{ handler.call(controller,blk) }
      else
        proc{ handler.call }
      end
    end
    chain.call
  end
end

#path ⇒ Object 



11
12
13
 
# File 'lib/praxis/request_stages/request_stage.rb', line 11

def path
  @the_path ||= [name].freeze
end

#request ⇒ Object 



44
45
46
 
# File 'lib/praxis/request_stages/request_stage.rb', line 44

def request
  @context.request
end

#run ⇒ Object 



52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
 
# File 'lib/praxis/request_stages/request_stage.rb', line 52

def run
  # stage-level callbacks (typically empty) will never shortcut
  execute_callbacks(self.before_callbacks)

  r = execute_controller_callbacks(controller.class.before_callbacks)
  # Shortcut lifecycle if filters return non-nil value
  # (which should only be a Response)
  return r if r

  result = execute_with_around
  # Shortcut lifecycle if filters return a response
  # (non-nil but non-response-class response is ignored)
  if result && result.kind_of?(Praxis::Response)
    controller.response = result
    return result
  end

  r = execute_controller_callbacks(controller.class.after_callbacks)
  # Shortcut lifecycle if filters return non-nil value
  # (which should only be a Response)
  return r if r

  # stage-level callbacks (typically empty) will never shortcut
  execute_callbacks(self.after_callbacks)

  result
end

#setup! ⇒ Object 



32
33
34
 
# File 'lib/praxis/request_stages/request_stage.rb', line 32

def setup!
  setup_deferred_callbacks!
end

#validation_handler ⇒ Object 



48
49
50
 
# File 'lib/praxis/request_stages/request_stage.rb', line 48

def validation_handler
  dispatcher.application.validation_handler
end