Mapper instances are used to build routes. The object passed to the draw block in config/routes.rb is a Mapper instance.

Mapper instances have relatively few instance methods, in order to avoid clashes with named routes.

Methods
Included Modules
Public Instance methods
connect(path, options = {})

Create an unnamed route with the provided path and options. See ActionController::Routing for an introduction to routes.

    # File actionpack/lib/action_controller/routing/route_set.rb, line 18
18:         def connect(path, options = {})
19:           @set.add_route(path, options)
20:         end
namespace(name, options = {}, &block)

Enables the use of resources in a module by setting the name_prefix, path_prefix, and namespace for the model. Example:

  map.namespace(:admin) do |admin|
    admin.resources :products,
      :has_many => [ :tags, :images, :variants ]
  end

This will create admin_products_url pointing to "admin/products", which will look for an Admin::ProductsController. It‘ll also create admin_product_tags_url pointing to "admin/products/#{product_id}/tags", which will look for Admin::TagsController.

    # File actionpack/lib/action_controller/routing/route_set.rb, line 47
47:         def namespace(name, options = {}, &block)
48:           if options[:namespace]
49:             with_options({:path_prefix => "#{options.delete(:path_prefix)}/#{name}", :name_prefix => "#{options.delete(:name_prefix)}#{name}_", :namespace => "#{options.delete(:namespace)}#{name}/" }.merge(options), &block)
50:           else
51:             with_options({:path_prefix => name, :name_prefix => "#{name}_", :namespace => "#{name}/" }.merge(options), &block)
52:           end
53:         end
root(options = {})

Creates a named route called "root" for matching the root level request.

    # File actionpack/lib/action_controller/routing/route_set.rb, line 23
23:         def root(options = {})
24:           if options.is_a?(Symbol)
25:             if source_route = @set.named_routes.routes[options]
26:               options = source_route.defaults.merge({ :conditions => source_route.conditions })
27:             end
28:           end
29:           named_route("root", '', options)
30:         end