2
Christopher Haupt
Rails’ routing infrastructure supports the concept of conditional routes: preconditions that must be satisfied before a particular route will trigger. Rails 2.1 supports one built-in condition, <span class="caps">HTTP</span> method checking, which is of some use but rather limited. What I needed was to be able to limit certain routes to only trigger when a particular host-name was used to access the application. I show one implementation in this article.
<p>Rails’ routing infrastructure supports the concept of conditional routes: preconditions that must be satisfied before a particular route will trigger. Rails 2.1 supports one built-in condition, <span class="caps">HTTP</span> method checking, which is of some use but rather limited. What I needed was to be able to limit certain routes to only trigger when a particular host-name was used to access the application.</p>
<p>I thought I’d have to write messy additional logic until a little comment tucked away in ActionController::Routing::RouteSet and ActionController::Routing::Routing caught my eye. Here I briefly show you how to leverage this functionality for your own purposes.</p>
<h2>The Goal — Conditional Routes in routes.rb</h2>
<p>Let’s work backwards and see the result I was aiming for. I wanted to expand the existing capabilities of the routing engine and be able to restrict routes to specific hosts. The conditional routing option works by adding a parameter to your route specifications. Here are some examples:</p>
<pre>
map.with_options(:controller => 'feeds', :conditions => {:hosts => MY_HOSTS}) do |feed|
feed.feeds_articles '/feeds/articles', :action => 'articles'
feed.feeds_podcast '/feeds/podcast', :action => 'podcast'
end
</pre>
<p>or</p>
<pre>
map.resources :podcasts, :conditions => {:hosts => MY_HOSTS},
:member => {:show_notes => :get, :transcript => :get},
:collection => {:admin => :get} do |podcast|
podcast.resources :comments, :member => {:report_as_ham => :get, :report_as_spam => :get}
end
</pre>
<p>or even</p>
<pre>
map.connect ':controller/:action/:id', :conditions => {:hosts => MY_HOSTS}
</pre>
<p>In Rails 2.1, however, no such option <code>:hosts</code> exists, only an option to check the <span class="caps">HTTP</span> method via <code>:method</code>.</p>
<h2>The Implementation</h2>
<p>I haven’t really ever needed to use the conditional routing support before, and didn’t really think about it due to it only supporting the <span class="caps">HTTP</span> method check. For that reason, I originally thought I’d have to write my own logic, either patching existing Routing routines (nearly right!) or by writing new stuff that could get messy (bad idea).</p>
<p>During a last scan through the code for the keyword “conditions”, I saw this comment:</p>
<pre>
# Plugins may override this method to add other conditions, like checks on
# host, subdomain, and so forth. Note that changes here only affect route
# recognition, not generation.
</pre>
<p>Good, a place to start afterall! The solution is elegant as it only requires overriding two simple routines. You can do this in your own app by writing code that gets loaded at startup. Here is one implementation in its entirety:</p>
<pre>
require 'action_controller'
module ActionController
module Routing
class RouteSet
def extract_request_environment(request)
{ :method => request.method, :host => request.host }
end
end
class Route
def recognition_conditions
result = ["(match = #{Regexp.new(recognition_pattern).inspect}.match(path))"]
result << "conditions[:method] === env[:method]" if conditions[:method]
result << "conditions[:hosts].include?(env[:host])" if conditions[:hosts]
result
end
end
end
end
</pre>
<p>My code is very simplistic and tuned for my needs, but gives you an example of where to patch in. Here, I simply supply a list of host names I care about, and check the incoming host against that list.</p>
<p>Use <code>extract_request_environment</code> to parse out and store any data you will want to use in your conditional checks. This data will be available in the <code>env</code> hash later on.</p>
<p><code>recognition_conditions</code> generates an Array of String objects that contain the Ruby code that will be used to build dynamic conditional test methods when the routing engine compiles the routes data in <code>routes.rb</code>.</p>
<p>I drop the source file into my project’s pre-existing <code>lib/plugins/action_controller_extensions/lib</code> directory as <code>action_controller_extensions.rb</code> and include an <code>init.rb</code> loader stub in my <code>lib/plugins/action_controller_extensions</code> directory:</p>
<pre>
require 'action_controller_extensions'
</pre>
<p>My app deals with loading up such “plugins” at startup. You may have a different set-up. You can get the same effect by putting a <code>require</code> for the main source file in your startup code.</p>
<p>It would be great to see other generally useful conditionals contributed by the community.</p>
2008-08-27T13:21:08-07:00
1
7082
5019
3
Enhancing Conditional Routing in Rails
2008-08-26T17:00:00-07:00
4
0
0
0
2009-03-23T22:59:58-07:00
2
2
4