Module: AbstractController::Rendering

Extended by:
ActiveSupport::Concern
Includes:
ActionView::ViewPaths
Defined in:
lib/abstract_controller/rendering.rb

Constant Summary collapse

DEFAULT_PROTECTED_INSTANCE_VARIABLES = 
Set.new %i(
  @_action_name @_response_body @_formats @_prefixes
)

Instance Method Summary collapse

Instance Method Details

#_normalize_args(action = nil, options = {}) ⇒ Object

Normalize args by converting render "foo" to render :action => "foo" and render "foo/bar" to render :file => "foo/bar". :api: plugin



81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/abstract_controller/rendering.rb', line 81

def _normalize_args(action = nil, options = {})
  if action.respond_to?(:permitted?)
    if action.permitted?
      action
    else
      raise ArgumentError, "render parameters are not permitted"
    end
  elsif action.is_a?(Hash)
    action
  else
    options
  end
end

#_normalize_options(options) ⇒ Object

Normalize options. :api: plugin



97
98
99
 
# File 'lib/abstract_controller/rendering.rb', line 97

def _normalize_options(options)
  options
end

#_normalize_render(*args, &block) ⇒ Object

Normalize args and options. :api: private



123
124
125
126
127
128
 
# File 'lib/abstract_controller/rendering.rb', line 123

def _normalize_render(*args, &block)
  options = _normalize_args(*args, &block)
  _process_variant(options)
  _normalize_options(options)
  options
end

#_process_format(format) ⇒ Object

Process the rendered format. :api: private



109
110
 
# File 'lib/abstract_controller/rendering.rb', line 109

def _process_format(format)
end

#_process_options(options) ⇒ Object

Process extra options. :api: plugin



103
104
105
 
# File 'lib/abstract_controller/rendering.rb', line 103

def _process_options(options)
  options
end

#_process_variant(options) ⇒ Object 



112
113
 
# File 'lib/abstract_controller/rendering.rb', line 112

def _process_variant(options)
end

#_protected_ivars ⇒ Object

:nodoc:



130
131
132
 
# File 'lib/abstract_controller/rendering.rb', line 130

def _protected_ivars # :nodoc:
  DEFAULT_PROTECTED_INSTANCE_VARIABLES
end

#_set_html_content_type ⇒ Object

:nodoc:



115
116
 
# File 'lib/abstract_controller/rendering.rb', line 115

def _set_html_content_type # :nodoc:
end

#_set_rendered_content_type(format) ⇒ Object

:nodoc:



118
119
 
# File 'lib/abstract_controller/rendering.rb', line 118

def _set_rendered_content_type(format) # :nodoc:
end

#render(*args, &block) ⇒ Object

Normalizes arguments, options and then delegates render_to_body and sticks the result in self.response_body. :api: public



22
23
24
25
26
27
28
29
30
31
 
# File 'lib/abstract_controller/rendering.rb', line 22

def render(*args, &block)
  options = _normalize_render(*args, &block)
  rendered_body = render_to_body(options)
  if options[:html]
    _set_html_content_type
  else
    _set_rendered_content_type rendered_format
  end
  self.response_body = rendered_body
end

#render_to_body(options = {}) ⇒ Object

Performs the actual template rendering. :api: public



51
52
 
# File 'lib/abstract_controller/rendering.rb', line 51

def render_to_body(options = {})
end

#render_to_string(*args, &block) ⇒ Object

Raw rendering of a template to a string.

It is similar to render, except that it does not set the response_body and it should be guaranteed to always return a string.

If a component extends the semantics of response_body (as ActionController extends it to be anything that responds to the method each), this method needs to be overridden in order to still return a string. :api: plugin



44
45
46
47
 
# File 'lib/abstract_controller/rendering.rb', line 44

def render_to_string(*args, &block)
  options = _normalize_render(*args, &block)
  render_to_body(options)
end

#rendered_format ⇒ Object

Returns Content-Type of rendered content :api: public



56
57
58
 
# File 'lib/abstract_controller/rendering.rb', line 56

def rendered_format
  Mime[:text]
end

#view_assigns ⇒ Object

This method should return a hash with assigns. You can overwrite this configuration per controller. :api: public



67
68
69
70
71
72
73
74
75
 
# File 'lib/abstract_controller/rendering.rb', line 67

def view_assigns
  protected_vars = _protected_ivars
  variables      = instance_variables

  variables.reject! { |s| protected_vars.include? s }
  variables.each_with_object({}) { |name, hash|
    hash[name.slice(1, name.length)] = instance_variable_get(name)
  }
end