Class: ActionDispatch::Routing::RouteSet::NamedRouteCollection

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
actionpack/lib/action_dispatch/routing/route_set.rb

Overview

A NamedRouteCollection instance is a collection of named routes, and also maintains an anonymous module that can be used to install helpers for the named routes.

Defined Under Namespace

Classes: UrlHelper

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Enumerable

#as_json, #exclude?, #index_by, #many?, #pluck, #sum, #without

Constructor Details

#initialize ⇒ NamedRouteCollection

Returns a new instance of NamedRouteCollection.



74
75
76
77
78
79
80
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 74

def initialize
  @routes = {}
  @path_helpers = Set.new
  @url_helpers = Set.new
  @url_helpers_module  = Module.new
  @path_helpers_module = Module.new
end

Instance Attribute Details

#path_helpers_module ⇒ Object (readonly)

Returns the value of attribute path_helpers_module.



71
72
73
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 71

def path_helpers_module
  @path_helpers_module
end

#url_helpers_module ⇒ Object (readonly)

Returns the value of attribute url_helpers_module.



71
72
73
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 71

def url_helpers_module
  @url_helpers_module
end

Instance Method Details

#add(name, route) ⇒ Object Also known as: []= 



105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 105

def add(name, route)
  key       = name.to_sym
  path_name = :"#{name}_path"
  url_name  = :"#{name}_url"

  if routes.key? key
    @path_helpers_module.send :undef_method, path_name
    @url_helpers_module.send  :undef_method, url_name
  end
  routes[key] = route
  define_url_helper @path_helpers_module, route, path_name, route.defaults, name, PATH
  define_url_helper @url_helpers_module,  route, url_name,  route.defaults, name, UNKNOWN

  @path_helpers << path_name
  @url_helpers << url_name
end

#add_url_helper(name, defaults, &block) ⇒ Object

Given a name, defines name_path and name_url helpers. Used by ‘direct’, ‘resolve’, and ‘polymorphic’ route helpers.



150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 150

def add_url_helper(name, defaults, &block)
  helper = CustomUrlHelper.new(name, defaults, &block)
  path_name = :"#{name}_path"
  url_name = :"#{name}_url"

  @path_helpers_module.module_eval do
    define_method(path_name) do |*args|
      helper.call(self, args, true)
    end
  end

  @url_helpers_module.module_eval do
    define_method(url_name) do |*args|
      helper.call(self, args, false)
    end
  end

  @path_helpers << path_name
  @url_helpers << url_name

  self
end

#clear! ⇒ Object Also known as: clear 



91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 91

def clear!
  @path_helpers.each do |helper|
    @path_helpers_module.send :remove_method, helper
  end

  @url_helpers.each do |helper|
    @url_helpers_module.send  :remove_method, helper
  end

  @routes.clear
  @path_helpers.clear
  @url_helpers.clear
end

#each ⇒ Object 



135
136
137
138
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 135

def each
  routes.each { |name, route| yield name, route }
  self
end

#get(name) ⇒ Object Also known as: [] 



122
123
124
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 122

def get(name)
  routes[name.to_sym]
end

#helper_names ⇒ Object 



87
88
89
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 87

def helper_names
  @path_helpers.map(&:to_s) + @url_helpers.map(&:to_s)
end

#key?(name) ⇒ Boolean

Returns:

  • (Boolean) 


126
127
128
129
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 126

def key?(name)
  return unless name
  routes.key? name.to_sym
end

#length ⇒ Object 



144
145
146
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 144

def length
  routes.length
end

#names ⇒ Object 



140
141
142
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 140

def names
  routes.keys
end

#route_defined?(name) ⇒ Boolean

Returns:

  • (Boolean) 


82
83
84
85
 
# File 'actionpack/lib/action_dispatch/routing/route_set.rb', line 82

def route_defined?(name)
  key = name.to_sym
  @path_helpers.include?(key) || @url_helpers.include?(key)
end