class ActionDispatch::PublicExceptions - actionpack-4.2.4 Documentation

# class ActionDispatch::PublicExceptions

When called, this middleware renders an error page. By default if an HTML response is expected it will render static error pages from the `/public` directory. For example when this middleware receives a 500 response it will render the template found in `/public/500.html`. If an internationalized locale is set, this middleware will attempt to render the template in `/public/500.<locale>.html`. If an internationalized template is not found it will fall back on `/public/500.html`.

When a request with a content type other than HTML is made, this middleware will attempt to convert error information into the appropriate response type.

### Attributes

public_path[RW]

### Public Class Methods

new(public_path) click to toggle source

    # File lib/action_dispatch/middleware/public_exceptions.rb, line 15
    def initialize(public_path)
      @public_path = public_path
    end

### Public Instance Methods

call(env) click to toggle source

    # File lib/action_dispatch/middleware/public_exceptions.rb, line 19
    def call(env)
      status       = env["PATH_INFO"][1..-1]
      request      = ActionDispatch::Request.new(env)
      content_type = request.formats.first
      body         = { :status => status, :error => Rack::Utils::HTTP_STATUS_CODES.fetch(status.to_i, Rack::Utils::HTTP_STATUS_CODES[500]) }

      render(status, content_type, body)
    end

### Private Instance Methods

render(status, content_type, body) click to toggle source

    # File lib/action_dispatch/middleware/public_exceptions.rb, line 30
    def render(status, content_type, body)
      format = "to_#{content_type.to_sym}" if content_type
      if format && body.respond_to?(format)
        render_format(status, content_type, body.public_send(format))
      else
        render_html(status)
      end
    end

render_format(status, content_type, body) click to toggle source

    # File lib/action_dispatch/middleware/public_exceptions.rb, line 39
    def render_format(status, content_type, body)
      [status, {'Content-Type' => "#{content_type}; charset=#{ActionDispatch::Response.default_charset}",
                'Content-Length' => body.bytesize.to_s}, [body]]
    end

render_html(status) click to toggle source

    # File lib/action_dispatch/middleware/public_exceptions.rb, line 44
    def render_html(status)
      path = "#{public_path}/#{status}.#{I18n.locale}.html"
      path = "#{public_path}/#{status}.html" unless (found = File.exist?(path))

      if found || File.exist?(path)
        render_format(status, 'text/html', File.read(path))
      else
        [404, { "X-Cascade" => "pass" }, []]
      end
    end