Class URI::HTTP
In: lib/open-uri.rb
lib/uri/http.rb
Parent: Object

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>.

Methods

build   new   request_uri  

Included Modules

OpenURI::OpenRead

Constants

DEFAULT_PORT = 80
COMPONENT = [ :scheme, :userinfo, :host, :port, :path, :query, :fragment

Public Class methods

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.

[Source]

    # File lib/uri/http.rb, line 57
57:     def self.build(args)
58:       tmp = Util::make_components_hash(self, args)
59:       return super(tmp)
60:     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'])

[Source]

    # File lib/uri/http.rb, line 77
77:     def initialize(*arg)
78:       super(*arg)
79:     end

Public Instance methods

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.

[Source]

    # File lib/uri/http.rb, line 89
89:     def request_uri
90:       r = path_query
91:       if r[0] != ?/
92:         r = '/' + r
93:       end
94: 
95:       r
96:     end

[Validate]