class Rack::URLMap

Rack::URLMap принимает хеш, сопоставляющий URL-адреса или пути приложениям, и выполняет диспетчеризацию соответствующим образом. Поддерживаются имена хостов HTTP/1.1, если URL-адреса начинаются с http:// или https://.

URLMap изменяет SCRIPT_NAME и PATH_INFO таким образом, чтобы часть, относящаяся к диспетчеризации, находилась в SCRIPT_NAME, а остальная часть — в PATH_INFO. Это следует учитывать, когда необходимо восстановить URL-адрес для создания ссылок.

URLMap выполняет диспетчеризацию таким образом, что сначала проверяются самые длинные пути, поскольку они наиболее специфичны.

Публичные методы класса

new (map = {}) Показать исходный код

# File lib/rack/urlmap.rb, line 21
def initialize(map = {})
  remap(map)
end

Публичные методы экземпляра

call (env) Показать исходный код

# File lib/rack/urlmap.rb, line 48
def call(env)
  path        = env[PATH_INFO]
  script_name = env[SCRIPT_NAME]
  http_host   = env[HTTP_HOST]
  server_name = env[SERVER_NAME]
  server_port = env[SERVER_PORT]

  is_same_server = casecmp?(http_host, server_name) ||
                   casecmp?(http_host, "#{server_name}:#{server_port}")

  is_host_known = @known_hosts.include? http_host

  @mapping.each do |host, location, match, app|
    unless casecmp?(http_host, host) \
        || casecmp?(server_name, host) \
        || (!host && is_same_server) \
        || (!host && !is_host_known) # If we don't have a matching host, default to the first without a specified host
      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

remap (map) Показать исходный код

# File lib/rack/urlmap.rb, line 25
def remap(map)
  @known_hosts = Set[]
  @mapping = map.map { |location, app|
    if location =~ %r{\Ahttps?://(.*?)(/.*)}
      host, location = $1, $2
      @known_hosts << host
    else
      host = nil
    end

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

    location = location.chomp('/')
    match = Regexp.new("\\A#{Regexp.quote(location).gsub('/', '/+')}(.*)", Regexp::NOENCODING).freeze

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