URI::HTTP

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.

 
               # File uri/http.rb, line 60
def self.build(args)
  tmp = Util::make_components_hash(self, args)
  return super(tmp)
end
            

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')

See also URI::Generic.new

 
               # File uri/http.rb, line 83
def initialize(*arg)
  super(*arg)
end
            

Description¶ ↑

Returns the full path for an HTTP request, as required by Net::HTTP::Get.

If the URI contains a query, the full path is URI#path + ‘?’ + URI#query. Otherwise, the path is simply URI#path.

 
               # File uri/http.rb, line 95
def request_uri
  r = path_query
  if r && r[0] != ?/
    r = '/' + r
  end

  r
end