# File lib/action_dispatch/routing/mapper.rb, line 309 def default_url_options=(options) @set.default_url_options = options end
When you set up a regular route, you supply a series of symbols that Rails maps to parts of an incoming HTTP request.
match ':controller/:action/:id/:user_id'
Two of these symbols are special: :controller maps to the name of a controller in your application, and :action maps to the name of an action within that controller. Anything other than :controller or :action will be available to the action as part of params.
# File lib/action_dispatch/routing/mapper.rb, line 271 def match(path, options=nil) mapping = Mapping.new(@set, @scope, path, options || {}).to_route @set.add_route(*mapping) self end
Mount a Rack-based application to be used within the application.
mount SomeRackApp, :at => "some_route"
Alternatively:
mount(SomeRackApp => "some_route")
All mounted applications come with routing helpers to access them. These are named after the class specified, so for the above example the helper is either some_rack_app_path or some_rack_app_url. To customize this helper's name, use the :as option:
mount(SomeRackApp => "some_route", :as => "exciting")
This will generate the exciting_path and exciting_url helpers which can be used to navigate to this mounted app.
# File lib/action_dispatch/routing/mapper.rb, line 294 def mount(app, options = nil) if options path = options.delete(:at) else options = app app, path = options.find { |k, v| k.respond_to?(:call) } options.delete(app) if app end raise "A rack application must be specified" unless path match(path, options.merge(:to => app, :anchor => false, :format => false)) self end
You can specify what Rails should route "/" to with the root method:
root :to => 'pages#main'
For options, see the match method's documentation, as root uses it internally.
You should put the root route at the top of config/routes.rb, because this means it will be matched first. As this is the most popular route of most Rails applications, this is beneficial.
# File lib/action_dispatch/routing/mapper.rb, line 258 def root(options = {}) match '/', options.reverse_merge(:as => :root) end
Generated with the Darkfish Rdoc Generator 2.