Class: RedHatSupportLib::Network::HttpResource

Inherits:
Object
  • Object
show all
Defined in:
lib/network/http_resource.rb

Overview

A class that can be instantiated for access to a RESTful resource, including authentication.

Example:

resource = RestClient::Resource.new('http://some/resource')
jpg = resource.get(:accept => 'image/jpg')

With HTTP basic authentication:

resource = RestClient::Resource.new('http://protected/resource', :user => 'user', :password => 'password')
resource.delete

With a timeout (seconds):

RestClient::Resource.new('http://slow', :timeout => 10)

With an open timeout (seconds):

RestClient::Resource.new('http://behindfirewall', :open_timeout => 10)

You can also use resources to share common headers. For headers keys, symbols are converted to strings. Example:

resource = RestClient::Resource.new('http://some/resource', :headers => { :client_version => 1 })

This header will be transported as X-Client-Version (notice the X prefix, capitalization and hyphens)

Use the [] syntax to allocate subresources:

site = RestClient::Resource.new('http://example.com', :user => 'adam', :password => 'mypasswd')
site['posts/1/comments'].post 'Good article.', :content_type => 'text/plain'

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(url, options = {}, backwards_compatibility = nil, &block) ⇒ HttpResource

Returns a new instance of HttpResource.



42
43
44
45
46
47
48
49
50
 
# File 'lib/network/http_resource.rb', line 42

def initialize(url, options={}, backwards_compatibility=nil, &block)
  @url = url
  @block = block
  if options.class == Hash
    @options = options
  else # compatibility with previous versions
    @options = {:user => options, :password => backwards_compatibility}
  end
end

Instance Attribute Details

#block ⇒ Object (readonly)

Returns the value of attribute block.



40
41
42
 
# File 'lib/network/http_resource.rb', line 40

def block
  @block
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



40
41
42
 
# File 'lib/network/http_resource.rb', line 40

def options
  @options
end

#url ⇒ Object (readonly)

Returns the value of attribute url.



40
41
42
 
# File 'lib/network/http_resource.rb', line 40

def url
  @url
end

Instance Method Details

#[](suburl, &new_block) ⇒ Object

Construct a subresource, preserving authentication.

Example:

site = RestClient::Resource.new('http://example.com', 'adam', 'mypasswd')
site['posts/1/comments'].post 'Good article.', :content_type => 'text/plain'

This is especially useful if you wish to define your site in one place and call it in multiple locations:

def orders
  RestClient::Resource.new('http://example.com/orders', 'admin', 'mypasswd')
end

orders.get                     # GET http://example.com/orders
orders['1'].get                # GET http://example.com/orders/1
orders['1/items'].delete       # DELETE http://example.com/orders/1/items

Nest resources as far as you want:

site = RestClient::Resource.new('http://example.com')
posts = site['posts']
first_post = posts['1']
comments = first_post['comments']
comments.post 'Hello', :content_type => 'text/plain'



153
154
155
156
157
158
159
160
161
162
 
# File 'lib/network/http_resource.rb', line 153

def [](suburl, &new_block)
  case
    when block_given? then
      self.class.new(concat_urls(url, suburl), options, &new_block)
    when block then
      self.class.new(concat_urls(url, suburl), options, &block)
    else
      self.class.new(concat_urls(url, suburl), options)
  end
end

#concat_urls(url, suburl) ⇒ Object

:nodoc:



164
165
166
167
168
169
170
171
172
 
# File 'lib/network/http_resource.rb', line 164

def concat_urls(url, suburl) # :nodoc:
  url = url.to_s
  suburl = suburl.to_s
  if url.slice(-1, 1) == '/' or suburl.slice(0, 1) == '/'
    url + suburl
  else
    "#{url}/#{suburl}"
  end
end

#delete(additional_headers = {}, &block) ⇒ Object 



95
96
97
98
99
100
101
 
# File 'lib/network/http_resource.rb', line 95

def delete(additional_headers={}, &block)
  headers = (options[:headers] || {}).merge(additional_headers)
  HttpRequest.execute(options.merge(
      :method => :delete,
      :url => url,
      :headers => headers), &(block || @block))
end

#get(additional_headers = {}, &block) ⇒ Object 



52
53
54
55
56
57
58
 
# File 'lib/network/http_resource.rb', line 52

def get(additional_headers={}, &block)
  headers = (options[:headers] || {}).merge(additional_headers)
  HttpRequest.execute(options.merge(
      :method => :get,
      :url => url,
      :headers => headers), &(block || @block))
end

#head(additional_headers = {}, &block) ⇒ Object 



60
61
62
63
64
65
66
 
# File 'lib/network/http_resource.rb', line 60

def head(additional_headers={}, &block)
  headers = (options[:headers] || {}).merge(additional_headers)
  HttpRequest.execute(options.merge(
      :method => :head,
      :url => url,
      :headers => headers), &(block || @block))
end

#headers ⇒ Object 



115
116
117
 
# File 'lib/network/http_resource.rb', line 115

def headers
  options[:headers] || {}
end

#open_timeout ⇒ Object 



123
124
125
 
# File 'lib/network/http_resource.rb', line 123

def open_timeout
  options[:open_timeout]
end

#password ⇒ Object 



111
112
113
 
# File 'lib/network/http_resource.rb', line 111

def password
  options[:password]
end

#patch(payload, additional_headers = {}, &block) ⇒ Object 



86
87
88
89
90
91
92
93
 
# File 'lib/network/http_resource.rb', line 86

def patch(payload, additional_headers={}, &block)
  headers = (options[:headers] || {}).merge(additional_headers)
  HttpRequest.execute(options.merge(
      :method => :patch,
      :url => url,
      :payload => payload,
      :headers => headers), &(block || @block))
end

#post(payload, additional_headers = {}, &block) ⇒ Object 



68
69
70
71
72
73
74
75
 
# File 'lib/network/http_resource.rb', line 68

def post(payload, additional_headers={}, &block)
  headers = (options[:headers] || {}).merge(additional_headers)
  HttpRequest.execute(options.merge(
      :method => :post,
      :url => url,
      :payload => payload,
      :headers => headers), &(block || @block))
end

#put(payload, additional_headers = {}, &block) ⇒ Object 



77
78
79
80
81
82
83
84
 
# File 'lib/network/http_resource.rb', line 77

def put(payload, additional_headers={}, &block)
  headers = (options[:headers] || {}).merge(additional_headers)
  HttpRequest.execute(options.merge(
      :method => :put,
      :url => url,
      :payload => payload,
      :headers => headers), &(block || @block))
end

#timeout ⇒ Object 



119
120
121
 
# File 'lib/network/http_resource.rb', line 119

def timeout
  options[:timeout]
end

#to_s ⇒ Object 



103
104
105
 
# File 'lib/network/http_resource.rb', line 103

def to_s
  url
end

#user ⇒ Object 



107
108
109
 
# File 'lib/network/http_resource.rb', line 107

def user
  options[:user]
end