Class: URI::Generic

Constants

 nil
 [       :scheme,        :userinfo, :host, :port, :registry,        :path, :opaque,        :query,        :fragment
 false

Attributes

 fragment
 host
 opaque
 path
 port
 query
 registry
 scheme

Public Class methods

build(args)

Synopsis

See new

Description

Creates a new URI::Generic instance from components of URI::Generic with check. Components are: scheme, userinfo, host, port, registry, path, opaque, query and fragment. You can provide arguments either by an Array or a Hash. See new for hash keys to use or for order of array items.

build2(args)

Synopsis

See new

Description

At first, tries to create a new URI::Generic instance using URI::Generic::build. But, if exception URI::InvalidComponentError is raised, then it URI::Escape.escape all URI components and tries again.

component()

Components of the URI in the order.

default_port()

Returns default port

new(scheme, userinfo, host, port, registry, path, opaque, query, fragment, arg_check = false)

Args

`scheme`:	Protocol scheme, i.e. ‘http’,’ftp’,’mailto’ and so on.
`userinfo`:	User name and password, i.e. ‘sdmitry:bla’
`host`:	Server host name
`port`:	Server port
`registry`:	DOC: FIXME!
`path`:	Path on server
`opaque`:	DOC: FIXME!
`query`:	Query data
`fragment`:	A part of URI after ’#’ sign
`arg_check`:	Check arguments [false by default]

Description

Creates a new URI::Generic instance from ``generic’’ components without check.

use_registry()

DOC: FIXME!

Public Instance methods

+(oth)

Alias for merge

-(oth)

Alias for route_from

==(oth)

Compares to URI’s

absolute()

Alias for absolute?

absolute?()

Checks if URI is an absolute one

coerce(oth)

component()

default_port()

eql?(oth)

fragment=(v)

hash()

hierarchical?()

Checks if URI has a path

host=(v)

inspect()

merge(oth)

Args

oth: URI or String

Description

Merges two URI’s.

Usage

  require 'uri'

  uri = URI.parse("http://my.example.com")
  p uri.merge("/main.rbx?page=1")
  # =>  #<URI::HTTP:0x2021f3b0 URL:http://my.example.com/main.rbx?page=1>

merge!(oth)

Args

oth: URI or String

Description

Destructive form of merge

Usage

  require 'uri'

  uri = URI.parse("http://my.example.com")
  uri.merge!("/main.rbx?page=1")
  p uri
  # =>  #<URI::HTTP:0x2021f3b0 URL:http://my.example.com/main.rbx?page=1>

normalize()

Returns normalized URI

normalize!()

Destructive version of normalize

opaque=(v)

password()

password=(password)

path=(v)

port=(v)

query=(v)

registry=(v)

relative?()

Checks if URI is relative

route_from(oth)

Args

oth: URI or String

Description

Calculates relative path from oth to self

Usage

  require 'uri'

  uri = URI.parse('http://my.example.com/main.rbx?page=1')
  p uri.route_from('http://my.example.com')
  #=> #<URI::Generic:0x20218858 URL:/main.rbx?page=1>

route_to(oth)

Args

oth: URI or String

Description

Calculates relative path to oth from self

Usage

  require 'uri'

  uri = URI.parse('http://my.example.com')
  p uri.route_to('http://my.example.com/main.rbx?page=1')
  #=> #<URI::Generic:0x2020c2f6 URL:/main.rbx?page=1>

scheme=(v)

select(*components)

Args

components: Multiple Symbol arguments defined in URI::HTTP

Description

Selects specified components from URI

Usage

  require 'uri'

  uri = URI.parse('http://myuser:[email protected]/test.rbx')
  p uri.select(:userinfo, :host, :path)
  # => ["myuser:mypass", "my.example.com", "/test.rbx"]

to_s()

Constructs String from URI

user()

user=(user)

userinfo()

userinfo=(userinfo)

Sets userinfo, argument is string like ‘name:pass’