Module: ActionController::ImplicitRender
- Includes:
- BasicImplicitRender
- Defined in:
- lib/action_controller/metal/implicit_render.rb
Overview
Action Controller Implicit Render
Handles implicit rendering for a controller action that does not explicitly respond with render
, respond_to
, redirect
, or head
.
For API controllers, the implicit response is always 204 No Content
.
For all other controllers, we use these heuristics to decide whether to render a template, raise an error for a missing template, or respond with 204 No Content
:
First, if we DO find a template, it’s rendered. Template lookup accounts for the action name, locales, format, variant, template handlers, and more (see render
for details).
Second, if we DON’T find a template but the controller action does have templates for other formats, variants, etc., then we trust that you meant to provide a template for this response, too, and we raise ActionController::UnknownFormat with an explanation.
Third, if we DON’T find a template AND the request is a page load in a web browser (technically, a non-XHR GET request for an HTML response) where you reasonably expect to have rendered a template, then we raise ActionController::MissingExactTemplate with an explanation.
Finally, if we DON’T find a template AND the request isn’t a browser page load, then we implicitly respond with 204 No Content
.
Instance Method Summary collapse
Methods included from BasicImplicitRender
Instance Method Details
#default_render ⇒ Object
35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 |
# File 'lib/action_controller/metal/implicit_render.rb', line 35 def default_render if template_exists?(action_name.to_s, _prefixes, variants: request.variant) render elsif any_templates?(action_name.to_s, _prefixes) = "#{self.class.name}\##{action_name} is missing a template " \ "for this request format and variant.\n" \ "\nrequest.formats: #{request.formats.map(&:to_s).inspect}" \ "\nrequest.variant: #{request.variant.inspect}" raise ActionController::UnknownFormat, elsif interactive_browser_request? = "#{self.class.name}\##{action_name} is missing a template for request formats: #{request.formats.map(&:to_s).join(',')}" raise ActionController::MissingExactTemplate.new(, self.class, action_name) else logger.info "No template found for #{self.class.name}\##{action_name}, rendering head :no_content" if logger super end end |
#method_for_action(action_name) ⇒ Object
54 55 56 57 58 |
# File 'lib/action_controller/metal/implicit_render.rb', line 54 def method_for_action(action_name) super || if template_exists?(action_name.to_s, _prefixes) "default_render" end end |