Class: ActionDispatch::Journey::Formatter

Inherits:
Object
  • Object
show all
Defined in:
lib/action_dispatch/journey/formatter.rb

Overview

The Formatter class is used for formatting URLs. For example, parameters passed to url_for in Rails will eventually call Formatter#generate.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(routes) ⇒ Formatter

Returns a new instance of Formatter.



11
12
13
14
 
# File 'lib/action_dispatch/journey/formatter.rb', line 11

def initialize(routes)
  @routes = routes
  @cache  = nil
end

Instance Attribute Details

#routes ⇒ Object (readonly)

:nodoc:



9
10
11
 
# File 'lib/action_dispatch/journey/formatter.rb', line 9

def routes
  @routes
end

Instance Method Details

#clear ⇒ Object 



49
50
51
 
# File 'lib/action_dispatch/journey/formatter.rb', line 49

def clear
  @cache = nil
end

#generate(name, options, path_parameters, parameterize = nil) ⇒ Object

Raises:



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/action_dispatch/journey/formatter.rb', line 16

def generate(name, options, path_parameters, parameterize = nil)
  constraints = path_parameters.merge(options)
  missing_keys = []

  match_route(name, constraints) do |route|
    parameterized_parts = extract_parameterized_parts(route, options, path_parameters, parameterize)

    # Skip this route unless a name has been provided or it is a
    # standard Rails route since we can't determine whether an options
    # hash passed to url_for matches a Rack application or a redirect.
    next unless name || route.dispatcher?

    missing_keys = missing_keys(route, parameterized_parts)
    next unless missing_keys.empty?
    params = options.dup.delete_if do |key, _|
      parameterized_parts.key?(key) || route.defaults.key?(key)
    end

    defaults       = route.defaults
    required_parts = route.required_parts
    parameterized_parts.delete_if do |key, value|
      value.to_s == defaults[key].to_s && !required_parts.include?(key)
    end

    return [route.format(parameterized_parts), params]
  end

  message = "No route matches #{Hash[constraints.sort_by{|k,v| k.to_s}].inspect}"
  message << " missing required keys: #{missing_keys.sort.inspect}" unless missing_keys.empty?

  raise ActionController::UrlGenerationError, message
end