Spec-Zone.ru › Ruby on Rails 4.2

модуль ActionDispatch::Http::URL

Константы

HOST_REGEXP
IP_HOST_REGEXP
PROTOCOL_REGEXP

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

extract_domain(host, tld_length) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 15
def extract_domain(host, tld_length)
  extract_domain_from(host, tld_length) if named_host?(host)
end
extract_subdomain(host, tld_length) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 27
def extract_subdomain(host, tld_length)
  extract_subdomains(host, tld_length).join('.')
end
extract_subdomains(host, tld_length) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 19
def extract_subdomains(host, tld_length)
  if named_host?(host)
    extract_subdomains_from(host, tld_length)
  else
    []
  end
end
full_url_for(options) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 39
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(env) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 169
def initialize(env)
  super
  @protocol = nil
  @port     = nil
end
Вызывает метод родительского класса
path_for(options) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 51
def path_for(options)
  path  = options[:script_name].to_s.chomp("/")
  path << options[:path] if options.key?(:path)

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

  path
end
url_for(options) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 31
def url_for(options)
  if options[:only_path]
    path_for options
  else
    full_url_for options
  end
end

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

domain(tld_length = @@tld_length) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 247
def domain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_domain(host, tld_length)
end

Возвращает доменную часть хоста, например, “rubyonrails.org” в “www.rubyonrails.org”. Вы можете указать другое tld_length, например, 2, чтобы получить rubyonrails.co.uk в “www.rubyonrails.co.uk”.

host() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 195
def host
  raw_host_with_port.sub(/:\d+$/, '')
end

Возвращает хост для данного запроса, например, example.com.

host_with_port() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 201
def host_with_port
  "#{host}#{port_string}"
end

Возвращает строку хост:порт для данного запроса, например, “example.com” или “example.com:8080”.

optional_port() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 231
def optional_port
  standard_port? ? nil : port
end

Возвращает числовой суффикс порта, например, 8080, если номер порта этого запроса не является стандартным портом HTTP 80 или HTTPS 443.

port() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 206
def port
  @port ||= begin
    if raw_host_with_port =~ /:(\d+)$/
      $1.to_i
    else
      standard_port
    end
  end
end

Возвращает номер порта этого запроса как целое число.

port_string() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 237
def port_string
  standard_port? ? '' : ":#{port}"
end

Возвращает строковый суффикс порта, включая двоеточие, например, “:8080”, если номер порта этого запроса не является стандартным портом HTTP 80 или HTTPS 443.

protocol() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 181
def protocol
  @protocol ||= ssl? ? 'https://' : 'http://'
end

Возвращает ‘https://’, если это запрос SSL, и ‘http://’ в противном случае.

raw_host_with_port() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 186
def raw_host_with_port
  if forwarded = env["HTTP_X_FORWARDED_HOST"].presence
    forwarded.split(/,\s?/).last
  else
    env['HTTP_HOST'] || "#{env['SERVER_NAME'] || env['SERVER_ADDR']}:#{env['SERVER_PORT']}"
  end
end

Возвращает хост для данного запроса, например, “example.com”.

server_port() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 241
def server_port
  @env['SERVER_PORT'].to_i
end
standard_port() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 217
def standard_port
  case protocol
    when 'https://' then 443
    else 80
  end
end

Возвращает стандартный номер порта для протокола данного запроса.

standard_port?() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 225
def standard_port?
  port == standard_port
end

Возвращает, использует ли данный запрос стандартный порт

subdomain(tld_length = @@tld_length) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 263
def subdomain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
end

Возвращает все доменные подстроки в виде строки, например, "dev.www" для “dev.www.rubyonrails.org”. Вы можете указать другой tld_length, например, 2, чтобы получить "www" вместо "www.rubyonrails" в “www.rubyonrails.co.uk”.

subdomains(tld_length = @@tld_length) Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 255
def subdomains(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
end

Возвращает все доменные подстроки в виде массива, например, ["dev", "www"] для “dev.www.rubyonrails.org”. Вы можете указать другой tld_length, например, 2, чтобы получить ["www"] вместо ["www", "rubyonrails"] в “www.rubyonrails.co.uk”.

url() Показать исходный код
# File actionpack/lib/action_dispatch/http/url.rb, line 176
def url
  protocol + host_with_port + fullpath
end

Возвращает полный URL, используемый для данного запроса.

© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API