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.
# File lib/rack/urlmap.rb, line 42 def call(env) path = env["PATH_INFO"] script_name = env['SCRIPT_NAME'] hHost, sName, sPort = env.values_at('HTTP_HOST','SERVER_NAME','SERVER_PORT') @mapping.each { |host, location, match, app| next unless (hHost == host || sName == host || (host.nil? && (hHost == sName || hHost == sName+':'+sPort))) next unless path.to_s =~ match && rest = $1 next unless rest.empty? || rest[0] == // env.merge!('SCRIPT_NAME' => (script_name + location), 'PATH_INFO' => rest) return app.call(env) } [404, {"Content-Type" => "text/plain", "X-Cascade" => "pass"}, ["Not Found: #{path}"]] ensure env.merge! 'PATH_INFO' => path, 'SCRIPT_NAME' => script_name end
# File lib/rack/urlmap.rb, line 21 def remap(map) longest_path_first = lambda do |(host, location, _, _)| [host ? -host.size : NEGATIVE_INFINITY, -location.size] end @mapping = map.map { |location, app| if location =~ %{\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(&longest_path_first) end
Generated with the Darkfish Rdoc Generator 2.