Class: URI::FILE

Inherits:
Generic show all
Includes:
REGEXP
Defined in:
lib/rio/uri/file.rb

Overview

The syntax of HTTP URIs is defined in RFC1738 section 3.3.

Note that the Ruby URI library allows HTTP URLs containing usernames and passwords. This is not legal as per the RFC, but used to be supported in Internet Explorer 5 and 6, before the MS04-004 security update. See <URL:support.microsoft.com/kb/834489>.

Constant Summary collapse

COMPONENT = 
[
  :scheme, 
  :host, 
  :path, 
].freeze

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(*arg) ⇒ FILE

Description

Create a new URI::HTTP object from generic URI components as per RFC 2396. No HTTP-specific syntax checking (as per RFC 1738) is performed.

Arguments are scheme, userinfo, host, port, registry, path, opaque, query and fragment, in that order.

Example:

uri = URI::HTTP.new(['http', nil, "www.example.com", nil, "/path",
  "query", 'fragment'])



111
112
113
114
 
# File 'lib/rio/uri/file.rb', line 111

def initialize(*arg)
  super(*arg)
  self.host = '' if self.host.nil?
end

Class Method Details

.build(args) ⇒ Object

Description

Create a new URI::HTTP object from components, with syntax checking.

The components accepted are userinfo, host, port, path, query and fragment.

The components should be provided either as an Array, or as a Hash with keys formed by preceding the component names with a colon.

If an Array is used, the components must be passed in the order [userinfo, host, port, path, query, fragment].

Example:

newuri = URI::HTTP.build({:host => 'www.example.com', 
  :path> => '/foo/bar'})

newuri = URI::HTTP.build([nil, "www.example.com", nil, "/path", 
  "query", 'fragment'])

Currently, if passed userinfo components this method generates invalid HTTP URIs as per RFC 1738.



55
56
57
58
 
# File 'lib/rio/uri/file.rb', line 55

def self.build(args)
  tmp = Util::make_components_hash(self, args)
  return super(tmp)
end

Instance Method Details

#host=(v) ⇒ Object 



89
90
91
92
93
 
# File 'lib/rio/uri/file.rb', line 89

def host=(v)
  check_host(v)
  set_host(v)
  v
end