Catches ActionController::RoutingError which does not work with Rails 3 out of the box. It basically catches the exception on Rack-level and re-raises it on application-level.
This gem is part of the open source service-oriented video framework Vidibus.
Since Rails 3 is based on Rack, catching a 404 error in your Application controller does not work as expected. The underlying problem is discussed here.
An easy but insufficient fix for this issue is to define a catch-all route at the end of your routes.rb:
match "*path" => "application#rescue_404"
But beware of the major drawback! If your application relies on engines that extend your app with their own routes, things will break because those routes will never get fired.
With this gem, all your routing problems should be gone.
Add the dependency to the Gemfile of your application:
Then call bundle install on your console.
With this gem installed, you are able to handle errors like in past versions of Rails:
class ApplicationController < ActionController::Base rescue_from ActionController::RoutingError, :with => :rescue_404 def rescue_404 # do something # IMPORTANT: If you modify this method, you have to restart the server. end end
Keep in mind that you have to restart your server when changing the rescue-method!
This gem implants the middleware Vidibus::RoutingError::Rack into your Rails stack right after ActionDispatch::ShowExceptions which returns a 404 response if no matching route was found for the current request.
Vidibus::RoutingError::Rack catches the 404 status and redirects internally to the route “/routing_error” which is provided by this gem.
Through this route the method RoutingErrorController#rescue gets called which then raises a ActionController::RoutingError on application level so you can rescue this error.
Custom controller for error handling
If you want to handle the error in a specific controller, you can also route the path “/routing_error” in routes.rb:
match "routing_error" => "my_controller#rescue_404"
The failing URI will be available in the environment variable:
If your application has a catch-route, this gem won't work, because routes provided by engines will be added after any existing routes. If you don't need a catch-all route for other purposes than rescuing from routing errors, you can savely remove it.
Depending on the structure of your application, you might get an error in development like this:
TypeError (User can't be referred)
This error is caused by some caching-reloading madness: The middleware implanted by this gem is cached. But in development, your classes usually aren't. Thus some classes may not be available under certain circumstances, e.g. if you are using before filters for user authentication provided by some engine. You should be able to get rid of the error above by turning on class caching. Try it (and restart the server afterwards):
# development.rb config.cache_classes = true
If the error is gone, you're lucky as I am. But since it is not feasible to cache classes in development, turn off class caching again and explicitly require the class that couldn't be referred. In my case, it's the user class:
# top of development.rb require "app/models/user"
Copyright © 2010 Andre Pankratz. See LICENSE for details.
The development of this gem was sponsored by Käuferportal: www.kaeuferportal.de