跳至内容 跳至搜索
方法
D
E
F
H
N
O
P
R
S
U

常量

HOST_REGEXP = /(^[^:]+:\/\/)?(\[[^\]]+\]|[^:]+)(?::(\d+$))?/
 
IP_HOST_REGEXP = /\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/
 
PROTOCOL_REGEXP = /^([^:]+)(:)?(\/\/)?$/
 

类公共方法

extract_domain(host, tld_length)

返回给定域级别的主机域部分。

# Top-level domain example
extract_domain('www.example.com', 1) # => "example.com"
# Second-level domain example
extract_domain('dev.www.example.co.uk', 2) # => "example.co.uk"

来源： 显示 | GitHub 

# File actionpack/lib/action_dispatch/http/url.rb, line 22
def extract_domain(host, tld_length)
  extract_domain_from(host, tld_length) if named_host?(host)
end

extract_subdomain(host, tld_length)

返回给定域级别的主机子域作为 String。

# Top-level domain example
extract_subdomain('www.example.com', 1) # => "www"
# Second-level domain example
extract_subdomain('dev.www.example.co.uk', 2) # => "dev.www"

来源： 显示 | GitHub 

# File actionpack/lib/action_dispatch/http/url.rb, line 46
def extract_subdomain(host, tld_length)
  extract_subdomains(host, tld_length).join(".")
end

extract_subdomains(host, tld_length)

返回给定域级别的主机子域作为 Array。

# Top-level domain example
extract_subdomains('www.example.com', 1) # => ["www"]
# Second-level domain example
extract_subdomains('dev.www.example.co.uk', 2) # => ["dev", "www"]

来源： 显示 | GitHub 

# File actionpack/lib/action_dispatch/http/url.rb, line 32
def extract_subdomains(host, tld_length)
  if named_host?(host)
    extract_subdomains_from(host, tld_length)
  else
    []
  end
end

full_url_for(options)

来源： 显示 | GitHub 

# File actionpack/lib/action_dispatch/http/url.rb, line 58
def full_url_for(options)
  host     = options[:host]
  protocol = options[:protocol]
  port     = options[:port]

  unless host
    raise ArgumentError, "Missing host to link to! Please provide the :host parameter, set default_url_options[:host], or set :only_path to true"
  end

  build_host_url(host, port, protocol, options, path_for(options))
end

new()

来源： 显示 | GitHub 

# File actionpack/lib/action_dispatch/http/url.rb, line 179
def initialize
  super
  @protocol = nil
  @port     = nil
end

path_for(options)

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 70
def path_for(options)
  path = options[:script_name].to_s.chomp("/")
  path << options[:path] if options.key?(:path)

  path = "/" if options[:trailing_slash] && path.blank?

  add_params(path, options[:params]) if options.key?(:params)
  add_anchor(path, options[:anchor]) if options.key?(:anchor)

  path
end

url_for(options)

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 50
def url_for(options)
  if options[:only_path]
    path_for options
  else
    full_url_for options
  end
end

实例公共方法

domain(tld_length = @@tld_length)

返回主机域部分，例如“www.rubyonrails.org”中的“rubyonrails.org”。你可以指定不同的tld_length，例如 2，以在“www.rubyonrails.co.uk”中捕获 rubyonrails.co.uk。

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 321
def domain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_domain(host, tld_length)
end

host()

返回此请求的主机，例如“example.com”。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.host # => "example.com"

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 226
def host
  raw_host_with_port.sub(/:\d+$/, "")
end

host_with_port()

返回此请求的主机:端口字符串，例如“example.com”或“example.com:8080”。只有当端口不是默认端口（80 或 443）时才包含端口

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.host_with_port # => "example.com"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.host_with_port # => "example.com"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.host_with_port # => "example.com:8080"

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 242
def host_with_port
  "#{host}#{port_string}"
end

optional_port()

如果此请求的端口号不是默认 HTTP 端口 80 或 HTTPS 端口 443，则返回数字端口后缀，例如 8080。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.optional_port # => nil

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.optional_port # => 8080

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 292
def optional_port
  standard_port? ? nil : port
end

port()

返回此请求的端口号，为整数。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.port # => 80

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.port # => 8080

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 253
def port
  @port ||= if raw_host_with_port =~ /:(\d+)$/
    $1.to_i
  else
    standard_port
  end
end

port_string()

返回字符串端口后缀，包括冒号，如“：8080”，如果此请求的端口号不是默认 HTTP 端口 80 或 HTTPS 端口 443。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.port_string # => ""

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.port_string # => ":8080"

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 304
def port_string
  standard_port? ? "" : ":#{port}"
end

protocol()

如果这是 SSL 请求，则返回‘https://’；否则返回‘http://’。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.protocol # => "http://"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com', 'HTTPS' => 'on'
req.protocol # => "https://"

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 200
def protocol
  @protocol ||= ssl? ? "https://" : "http://"
end

raw_host_with_port()

返回此请求的主机和端口，如“example.com:8080”。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.raw_host_with_port # => "example.com"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.raw_host_with_port # => "example.com:80"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.raw_host_with_port # => "example.com:8080"

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 214
def raw_host_with_port
  if forwarded = x_forwarded_host.presence
    forwarded.split(/,\s?/).last
  else
    get_header("HTTP_HOST") || "#{server_name}:#{get_header('SERVER_PORT')}"
  end
end

server_port()

根据 SERVER_PORT 返回请求的端口，如 8080

req = ActionDispatch::Request.new 'SERVER_PORT' => '80'
req.server_port # => 80

req = ActionDispatch::Request.new 'SERVER_PORT' => '8080'
req.server_port # => 8080

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 315
def server_port
  get_header("SERVER_PORT").to_i
end

standard_port()

返回此请求的协议的标准端口号。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port # => 80

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 265
def standard_port
  if "https://" == protocol
    443
  else
    80
  end
end

standard_port?()

返回此请求是否使用标准端口

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.standard_port? # => true

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port? # => false

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 280
def standard_port?
  port == standard_port
end

subdomain(tld_length = @@tld_length)

将所有子域返回为字符串，因此“dev.www.rubyonrails.org”将返回“dev.www”。您可以指定不同的tld_length，例如 2，以在“www.rubyonrails.co.uk”中捕获“www”而不是“www.rubyonrails”。

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 337
def subdomain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
end

subdomains(tld_length = @@tld_length)

将所有子域返回为数组，因此“dev.www.rubyonrails.org”将返回“["dev", "www"]”。您可以指定不同的tld_length，例如 2，以在“www.rubyonrails.co.uk”中捕获“["www"]”而不是“["www", "rubyonrails"]”。

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 329
def subdomains(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
end

url()

返回用于此请求的完整URL。

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.url # => "http://example.com"

来源：显示 | 在 GitHub 上 

# File actionpack/lib/action_dispatch/http/url.rb, line 189
def url
  protocol + host_with_port + fullpath
end