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.
(Not documented)
# File lib/rack/urlmap.rb, line 36
36: def call(env)
37: path = env["PATH_INFO"].to_s.squeeze("/")
38: script_name = env['SCRIPT_NAME']
39: hHost, sName, sPort = env.values_at('HTTP_HOST','SERVER_NAME','SERVER_PORT')
40: @mapping.each { |host, location, app|
41: next unless (hHost == host || sName == host \
42: || (host.nil? && (hHost == sName || hHost == sName+':'+sPort)))
43: next unless location == path[0, location.size]
44: next unless path[location.size] == nil || path[location.size] == ?/
45:
46: return app.call(
47: env.merge(
48: 'SCRIPT_NAME' => (script_name + location),
49: 'PATH_INFO' => path[location.size..-1]))
50: }
51: [404, {"Content-Type" => "text/plain"}, ["Not Found: #{path}"]]
52: end
(Not documented)
# File lib/rack/urlmap.rb, line 19
19: def remap(map)
20: @mapping = map.map { |location, app|
21: if location =~ %r{\Ahttps?://(.*?)(/.*)}
22: host, location = $1, $2
23: else
24: host = nil
25: end
26:
27: unless location[0] == ?/
28: raise ArgumentError, "paths need to start with /"
29: end
30: location = location.chomp('/')
31:
32: [host, location, app]
33: }.sort_by { |(h, l, a)| [h ? -h.size : (-1.0 / 0.0), -l.size] } # Longest path first
34: end
Disabled; run with --debug to generate this.
Generated with the Darkfish Rdoc Generator 1.1.6.