Ruby on Rails 5.2 - ActionDispatch::Http::URL

मॉड्यूल ActionDispatch :: Http :: URL




ruby

मॉड्यूल ActionDispatch :: Http :: URL

स्थिरांक

HOST_REGEXP
IP_HOST_REGEXP
PROTOCOL_REGEXP

पब्लिक क्लास के तरीके

extract_domain (होस्ट, tld_length) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 21
def extract_domain(host, tld_length)
  extract_domain_from(host, tld_length) if named_host?(host)
end

डोमेन स्तर को देखते हुए किसी होस्ट का डोमेन हिस्सा लौटाता है।

# 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"
extract_subdomain (होस्ट, tld_length) स्रोत दिखाएँ
# File actionpack/lib/action_dispatch/http/url.rb, line 45
def extract_subdomain(host, tld_length)
  extract_subdomains(host, tld_length).join(".")
end

एक होस्ट के उप डोमेन को 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"
extract_subdomains (होस्ट, tld_length) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 31
def extract_subdomains(host, tld_length)
  if named_host?(host)
    extract_subdomains_from(host, tld_length)
  else
    []
  end
end

एक होस्ट के उप डोमेन को एक 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"]
full_url_for (विकल्प) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 57
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
# File actionpack/lib/action_dispatch/http/url.rb, line 186
def initialize
  super
  @protocol = nil
  @port     = nil
end
सुपरक्लास विधि कहता है
path_for (विकल्प) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 69
def path_for(options)
  path = options[:script_name].to_s.chomp("/".freeze)
  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 (विकल्प) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 49
def url_for(options)
  if options[:only_path]
    path_for options
  else
    full_url_for options
  end
end

सार्वजनिक प्रवृत्ति के तरीके

डोमेन (tld_length = @@ tld_length) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 329
def domain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_domain(host, tld_length)
end

"Www.rubyonrails.org" में एक होस्ट के डोमेन भाग को "rubyonrails.org" के रूप में लौटाता है । आप एक अलग tld_length निर्दिष्ट कर सकते हैं, जैसे 2 " www.rubyonrails.co.uk " में rubyonrails.co.uk को पकड़ने के लिए।

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

इस अनुरोध के लिए होस्ट लौटाता है, जैसे कि "example.com"।

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.host # => "example.com"
# File actionpack/lib/action_dispatch/http/url.rb, line 249
def host_with_port
  "#{host}#{port_string}"
end

एक होस्ट लौटाता है: इस अनुरोध के लिए पोर्ट स्ट्रिंग, जैसे कि "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"
वैकल्पिक_पोर्ट () स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 300
def optional_port
  standard_port? ? nil : port
end

8080 की तरह एक नंबर पोर्ट प्रत्यय लौटाता है यदि इस अनुरोध का पोर्ट नंबर डिफ़ॉल्ट HTTP पोर्ट 80 या HTTPS पोर्ट 443 नहीं है।

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
# File actionpack/lib/action_dispatch/http/url.rb, line 260
def port
  @port ||= begin
    if raw_host_with_port =~ /:(\d+)$/
      $1.to_i
    else
      standard_port
    end
  end
end

पूर्णांक के रूप में इस अनुरोध की पोर्ट संख्या लौटाता है।

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

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.port # => 8080
# File actionpack/lib/action_dispatch/http/url.rb, line 312
def port_string
  standard_port? ? "" : ":#{port}"
end

कोई स्ट्रिंग पोर्ट प्रत्यय लौटाता है, जिसमें कोलन भी शामिल है: ": 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"
प्रोटोकॉल () स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 207
def protocol
  @protocol ||= ssl? ? "https://" : "http://"
end

यदि यह SSL अनुरोध है और 'http: //' अन्यथा तो 'https: //' लौटाता है।

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

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com', 'HTTPS' => 'on'
req.protocol # => "https://"
# File actionpack/lib/action_dispatch/http/url.rb, line 221
def raw_host_with_port
  if forwarded = x_forwarded_host.presence
    forwarded.split(/,\s?/).last
  else
    get_header("HTTP_HOST") || "#{server_name || server_addr}:#{get_header('SERVER_PORT')}"
  end
end

इस अनुरोध के लिए होस्ट और पोर्ट लौटाता है, जैसे कि "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"
# File actionpack/lib/action_dispatch/http/url.rb, line 323
def server_port
  get_header("SERVER_PORT").to_i
end

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
# File actionpack/lib/action_dispatch/http/url.rb, line 274
def standard_port
  case protocol
  when "https://" then 443
  else 80
  end
end

इस अनुरोध के प्रोटोकॉल के लिए मानक पोर्ट संख्या लौटाता है।

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port # => 80
# File actionpack/lib/action_dispatch/http/url.rb, line 288
def standard_port?
  port == standard_port
end

लौटाता है कि क्या यह अनुरोध मानक पोर्ट का उपयोग कर रहा है

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
उपडोमेन (tld_length = @@ tld_length) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 345
def subdomain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
end

सभी "dev.www" को एक स्ट्रिंग के रूप में लौटाता है, इसलिए "dev.www" को "देव" के लिए वापस किया जाएगा। www.rubyonrails.org ”। आप एक अलग tld_length निर्दिष्ट कर सकते हैं, जैसे "www.rubyonrails" में " www.rubyonrails " के बजाय "www" को पकड़ने के लिए 2।

उप डोमेन (tld_length = @@ tld_length) स्रोत दिखाएं
# File actionpack/lib/action_dispatch/http/url.rb, line 337
def subdomains(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
end

एक सरणी के रूप में सभी उप डोमेन लौटाता है, इसलिए ["dev", "www"] "देव" के लिए वापस आ जाएंगे। www.rubyonrails.org ”। आप एक अलग tld_length निर्दिष्ट कर सकते हैं, जैसे कि ["www", "rubyonrails"] में ["www", "rubyonrails"] बजाय ["www"] को पकड़ने के लिए 2।

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

इस अनुरोध के लिए उपयोग किया गया पूरा URL लौटाता है।

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