我们的exception_handlergem 可用于 Ruby on Rails 自定义错误页面。
这个怎么运作
所有 Ruby on Rails 异常都使用config.exceptions_app. 这是在config/application.rborconfig/environments/*.rb文件中分配的 - 它需要是一个回调：
config.exceptions_app 设置异常发生时 ShowException 中间件调用的异常应用程序。默认为 ActionDispatch::PublicExceptions.new(Rails.public_path)。
每当 Ruby on Rails 遇到错误时，它都会调用ShowExceptions中间件。这会调用exception_app并将整个request（包括exception）发送到exceptions_app：
exceptions_app需要做出回应。如果没有，failsafe则加载：
# show_exceptions.rb#L38
def render_exception(env, exception)
wrapper = ExceptionWrapper.new(env, exception)
status = wrapper.status_code
env["action_dispatch.exception"] = wrapper.exception
env["PATH_INFO"] = "/#{status}"
response = @exceptions_app.call(request.env) # => exceptions_app callback
response[1]["X-Cascade"] == "pass" ? pass_response(status) : response
rescue Exception => failsafe_error # => raised if exceptions_app false
$stderr.puts "Error during failsafe response: #{failsafe_error}\n #{failsafe_error.backtrace * "\n "}"
FAILSAFE_RESPONSE
end
failsafe存储在的FAILSAFE_RESPONSE顶部ShowExceptions。
自定义错误页面
如果要创建自定义错误页面，则需要将自己的回调注入config.exceptions_app. 这可以在应用程序中完成，也可以使用 gem 完成：
注意该call方法是如何使用的——这就是回调的工作方式。env当收到来自 Internet 的请求时，将调用Ruby on Rails ( )；当引发异常时，env传递给exceptions_app.
异常处理的质量将取决于您的管理方式env。这个很重要; 引用self.routes不会使环境向前发展。
最好的方法是使用单独的控制器处理异常。这使您可以像处理另一个视图一样处理请求，授予对layout和其他组件 ( model/ email) 的访问权限。
有两种处理异常的方法：
- 覆盖
404/500路线
- 调用控制器
我们的 gem 是围绕我们的controller- 每次exception引发 an 时调用的。这可以完全控制异常过程，允许100% 品牌化布局。它在 Ruby on Rails 5 上 100% 运行。
管理 Ruby on Rails 的异常
如果您对 gem 不感兴趣，让我解释一下过程：
所有 Ruby on Rails 异常都由config.exceptions_app回调处理。这是在config/application.rborconfig/environments/*.rb文件中分配的 - 它需要是一个回调：
config.exceptions_app 设置异常发生时 ShowException 中间件调用的异常应用程序。默认为 ActionDispatch::PublicExceptions.new(Rails.public_path)。
每当您的应用程序引发异常时，ShowExceptions都会调用中间件。该中间件将异常构建到 中request并将其转发给config.exceptions_app回调。
默认情况下，config.exceptions_app指向路由。这就是 Rails 自带404.html,500.html和文件夹422.html的原因public。
如果要创建自定义异常页面，则需要覆盖config.exceptions_app回调 - 将错误请求传递给适当的处理程序，无论是 acontroller还是route：
[中间件]
有效管理此问题的两种方法是将错误请求发送到路由，或调用控制器。
最简单且最常见的方式是将请求转发到路由；不幸的是，这会忽略请求并阻止您正确详细说明异常。
最好的方法是调用一个单独的控制器。这将允许您传递整个请求，允许您保存、发送电子邮件或执行许多其他操作。
400 / 500 错误
Rails只能响应 HTTP 有效的错误。
虽然应用程序的异常可能不同，但返回的状态码应该是40x或50x。这符合 HTTP 规范并在此处进行了概述。
这意味着无论您使用/构建何种异常处理解决方案，Ruby on Rails都需要向浏览器返回其中一个40x或50x错误。
换句话说，自定义错误页面与异常类型几乎没有关系——更多的是您如何捕获和提供浏览器响应。
默认情况下，Ruby on Rails 使用404.html,422.html和500.html文件public夹中的文件执行此操作。如果您想自己处理异常流，则需要删除这些文件并将错误请求引导至您自己的exceptions_app回调。
这可以用routesor来完成controller（我现在将解释）：
1. 路线
最简单的方法是让路由处理它。
这种方法很臃肿，需要使用多个操作。管理响应也很困难。
这显示了如何exceptions_app直接用路由替换：
# config/application.rb
config.exceptions_app = self.routes
这是我的代码（Ruby 2.0.0 和 Ruby on Rails 4.0）：
应用程序配置
#config/application.rb
config.exceptions_app = self.routes
路线
#config/routes.rb
if Rails.env.production?
get '404', to: 'application#page_not_found'
get '422', to: 'application#server_error'
get '500', to: 'application#server_error'
end
应用控制器
#controllers/application_controller.rb
def page_not_found
respond_to do |format|
format.html { render template: 'errors/not_found_error', layout: 'layouts/application', status: 404 }
format.all { render nothing: true, status: 404 }
end
end
def server_error
respond_to do |format|
format.html { render template: 'errors/internal_server_error', layout: 'layouts/error', status: 500 }
format.all { render nothing: true, status: 500}
end
end
错误布局（完全静态——仅用于服务器错误）
#views/layouts/error.html.erb
<!DOCTYPE html>
<html>
<head>
<title><%= action_name.titleize %> :: <%= site_name %></title>
<%= csrf_meta_tags %>
<style>
body {
background: #fff;
font-family: Helvetica, Arial, Sans-Serif;
font-size: 14px;
}
.error_container {
display: block;
margin: auto;
margin: 10% auto 0 auto;
width: 40%;
}
.error_container .error {
display: block;
text-align: center;
}
.error_container .error img {
display: block;
margin: 0 auto 25px auto;
}
.error_container .message strong {
font-weight: bold;
color: #f00;
}
</style>
</head>
<body>
<div class="error_container">
<%= yield %>
</div>
</body>
</html>
错误视图
#views/errors/not_found_error.html.erb
<div class="error">
<h2>Sorry, this page has moved, or doesn't exist!</h2>
</div>
#views/errors/internal_server_error.html.erb
<div class="error">
<div class="message">
<strong>Error!</strong>
We're sorry, but our server is experiencing problems :(
</div>
</div>
虽然许多人更喜欢“路线”方法，因为它简单，但它既不高效也不模块化。事实上，如果您的应用程序有任何面向对象的外观，您很快就会将其视为 hack。
一个更响亮的方法是使用自定义控制器来捕获纯异常。这样，您可以根据应用程序的整体结构构建流程：
2.控制器
另一种选择是将所有请求路由到控制器。
这是无限强大的，因为它允许您接受请求（异常）并将其传递给视图，同时在后端进行管理。这将允许将其保存到数据库中。
这个要点显示了如何。
这意味着我们可以挂钩到中间件并将整个请求传递给控制器。
如果此控制器由模型和视图支持，我们可以将其提取到 gem 中（这就是我们所做的）。如果您想手动操作，方法如下：
配置
这种方法的美妙之处在于它直接挂钩到config.exceptions_app. 这意味着任何异常都可以本地处理，从而提高效率。为确保这有效，您需要将以下代码放入config/application.rb（exceptions_app仅适用于production-development显示错误）：
#config/application.rb
config.exceptions_app = ->(env) { ExceptionController.action(:show).call(env) }
要进行测试，您可以将“本地”请求设置为 false：
#config/environments/development.rb
config.consider_all_requests_local = false # true
控制器
下一步是添加exception控制器。虽然这可以在 中处理application_controller，但最好提取到它自己的中。注意来自application.rb--的调用ExceptionController.action(:show)：
#app/controllers/exception_controller.rb
class ExceptionController < ApplicationController
#Response
respond_to :html, :xml, :json
#Dependencies
before_action :status
#Layout
layout :layout_status
####################
# Action #
####################
#Show
def show
respond_with status: @status
end
####################
# Dependencies #
####################
protected
#Info
def status
@exception = env['action_dispatch.exception']
@status = ActionDispatch::ExceptionWrapper.new(env, @exception).status_code
@response = ActionDispatch::ExceptionWrapper.rescue_responses[@exception.class.name]
end
#Format
def details
@details ||= {}.tap do |h|
I18n.with_options scope: [:exception, :show, @response], exception_name: @exception.class.name, exception_message: @exception.message do |i18n|
h[:name] = i18n.t "#{@exception.class.name.underscore}.title", default: i18n.t(:title, default: @exception.class.name)
h[:message] = i18n.t "#{@exception.class.name.underscore}.description", default: i18n.t(:description, default: @exception.message)
end
end
end
helper_method :details
####################
# Layout #
####################
private
#Layout
def layout_status
@status.to_s == "404" ? "application" : "error"
end
end
意见
有两个视图要添加以使其正常工作。
第一个是exception/show视图，第二个是layouts/error. 第一个是给出exception_contoller#show一个视图，第二个是500内部服务器错误。
#app/views/exception/show.html.erb
<h1><%= details[:name] %></h1>
<p><%= details[:message] %></p>
#app/views/layouts/error.html.erb (for 500 internal server errors)
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Error</title>
<style>
html {
height: 100%;
background: #fff;
}
body {
font-family: Helvetica, Arial, Sans-Serif;
font-size: 14px;
}
.error_container {
display: block;
margin: auto;
margin: 10% auto 0 auto;
width: 40%;
}
.error_container .error {
display: block;
text-align: center;
}
.error_container .error img {
display: block;
margin: 0 auto 15px auto;
}
.error_container .message > * {
display: block;
}
.error_container .message strong {
font-weight: bold;
color: #f00;
}
</style>
</head>
<body>
<div class="error_container"><%= yield %></div>
</body>
</html>
结论
异常与错误代码无关紧要。
当 Ruby on Rails 引发异常时，它会分配上述 HTTP 响应代码之一。这些允许您的浏览器确定请求是否成功。
处理异常时，您需要确保能够处理40*错误（通常使用与应用程序其余部分相同的布局）和50*错误（需要自己的布局）。
在这两种情况下，您最好使用单独的exception控制器，这将允许您将其exception作为对象进行管理。