Class: Rack::URLMap

Inherits:
Object
  • Object
show all
Defined in:
rack/rack/urlmap.rb

Overview

Rack::URLMap takes a hash mapping urls or paths to apps, and dispatches accordingly. Support for HTTP/1.1 host names exists if the URLs start with http:// or https://.

URLMap modifies the SCRIPT_NAME and PATH_INFO such that the part relevant for dispatch is in the SCRIPT_NAME, and the rest in the PATH_INFO. This should be taken care of when you need to reconstruct the URL in order to create links.

URLMap dispatches in such a way that the longest paths are tried first, since they are most specific.

Constant Summary

NEGATIVE_INFINITY = 
-1.0 / 0.0
INFINITY = 
1.0 / 0.0

Instance Method Summary (collapse)

Constructor Details

- (URLMap) initialize(map = {})

Returns a new instance of URLMap



18
19
20
 
# File 'rack/rack/urlmap.rb', line 18

def initialize(map = {})
  remap(map)
end

Instance Method Details

- (void) call(env) 



43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'rack/rack/urlmap.rb', line 43

def call(env)
  path = env["PATH_INFO"]
  script_name = env['SCRIPT_NAME']
  hHost = env['HTTP_HOST']
  sName = env['SERVER_NAME']
  sPort = env['SERVER_PORT']

  @mapping.each do |host, location, match, app|
    unless hHost == host         \
|| sName == host         \
|| (!host && (hHost == sName || hHost == sName+':'+sPort))
      next
    end

    next unless m = match.match(path.to_s)

    rest = m[1]
    next unless !rest || rest.empty? || rest[0] == ?/

    env['SCRIPT_NAME'] = (script_name + location)
    env['PATH_INFO'] = rest

    return app.call(env)
  end

  [404, {"Content-Type" => "text/plain", "X-Cascade" => "pass"}, ["Not Found: #{path}"]]

ensure
  env['PATH_INFO'] = path
  env['SCRIPT_NAME'] = script_name
end

- (void) remap(map) 



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'rack/rack/urlmap.rb', line 22

def remap(map)
  @mapping = map.map { |location, app|
    if location =~ %r{\Ahttps?://(.*?)(/.*)}
      host, location = $1, $2
    else
      host = nil
    end

    unless location[0] == ?/
      raise ArgumentError, "paths need to start with /"
    end

    location = location.chomp('/')
    match = Regexp.new("^#{Regexp.quote(location).gsub('/', '/+')}(.*)", nil, 'n')

    [host, location, match, app]
  }.sort_by do |(host, location, _, _)|
    [host ? -host.size : INFINITY, -location.size]
  end
end