Parent

ActiveResource::PersistentConnection

Duplicate of ActiveResource::HttpMock method


Class to handle connections to remote web services. This class is used by ActiveResource::Base to interface with REST services.

Attributes

auth_type[R]
connection_name[R]
format[RW]
password[R]
proxy[R]
site[R]
ssl_options[R]
timeout[R]
user[R]

Public Class Methods

new(site, format = ActiveResource::Formats::XmlFormat) click to toggle source

The site parameter is required and will set the site attribute to the URI for the remote resource service.

# File lib/active_resource/persistent_connection.rb, line 49
def initialize(site, format = ActiveResource::Formats::XmlFormat)
  raise ArgumentError, 'Missing site URI' unless site
  @user = @password = nil
  @uri_parser = URI.const_defined?(:Parser) ? URI::Parser.new : URI
  self.site = site
  self.format = format
end
requests() click to toggle source
# File lib/active_resource/persistent_connection.rb, line 37
def requests
  @@requests ||= []
end

Public Instance Methods

auth_type=(auth_type) click to toggle source

Sets the auth type for remote service.

# File lib/active_resource/persistent_connection.rb, line 80
def auth_type=(auth_type)
  @auth_type = legitimize_auth_type(auth_type)
end
connection_name=(name) click to toggle source

Name for this group of requests, passed to Net::HTTP::Persistent

# File lib/active_resource/persistent_connection.rb, line 101
def connection_name=(name)
  @connection_name = name
end
debug_output=(debug_output) click to toggle source

Sets the debug output stream for HTTP requests

# File lib/active_resource/persistent_connection.rb, line 85
def debug_output=(debug_output)
  @debug_output = debug_output
end
delete(path, headers = {}) click to toggle source

Executes a DELETE request (see HTTP protocol documentation if unfamiliar). Used to delete resources.

# File lib/active_resource/persistent_connection.rb, line 114
def delete(path, headers = {})
  with_auth { request(:delete, path, build_request_headers(headers, :delete, self.site.merge(path))) }
end
get(path, headers = {}) click to toggle source

Executes a GET request. Used to get (find) resources. Note; removed format.decode wrapper and .get method call

# File lib/active_resource/persistent_connection.rb, line 108
def get(path, headers = {})
  with_auth { request(:get, path, build_request_headers(headers, :get, self.site.merge(path))) }
end
head(path, headers = {}) click to toggle source

Executes a HEAD request. Used to obtain meta-information about resources, such as whether they exist and their size (via response headers).

# File lib/active_resource/persistent_connection.rb, line 138
def head(path, headers = {})
  with_auth { request(:head, path, build_request_headers(headers, :head, self.site.merge(path))) }
end
password=(password) click to toggle source

Sets the password for remote service.

# File lib/active_resource/persistent_connection.rb, line 75
def password=(password)
  @password = password
end
patch(path, body = '', headers = {}) click to toggle source

Executes a PATCH request. Used to create new resources.

# File lib/active_resource/persistent_connection.rb, line 132
def patch(path, body = '', headers = {})
  with_auth { request(:patch, path, body.to_s, build_request_headers(headers, :patch, self.site.merge(path))) }
end
post(path, body = '', headers = {}) click to toggle source

Executes a POST request. Used to create new resources.

# File lib/active_resource/persistent_connection.rb, line 126
def post(path, body = '', headers = {})
  with_auth { request(:post, path, body.to_s, build_request_headers(headers, :post, self.site.merge(path))) }
end
proxy=(proxy) click to toggle source

Set the proxy for remote service.

# File lib/active_resource/persistent_connection.rb, line 65
def proxy=(proxy)
  @proxy = proxy.is_a?(URI) ? proxy : @uri_parser.parse(proxy)
end
put(path, body = '', headers = {}) click to toggle source

Executes a PUT request (see HTTP protocol documentation if unfamiliar). Used to update resources.

# File lib/active_resource/persistent_connection.rb, line 120
def put(path, body = '', headers = {})
  with_auth { request(:put, path, body.to_s, build_request_headers(headers, :put, self.site.merge(path))) }
end
site=(site) click to toggle source

Set URI for remote service.

# File lib/active_resource/persistent_connection.rb, line 58
def site=(site)
  @site = site.is_a?(URI) ? site : @uri_parser.parse(site)
  @user = @uri_parser.unescape(@site.user) if @site.user
  @password = @uri_parser.unescape(@site.password) if @site.password
end
ssl_options=(opts={}) click to toggle source

Hash of options applied to Net::HTTP instance when site protocol is 'https'.

# File lib/active_resource/persistent_connection.rb, line 96
def ssl_options=(opts={})
  @ssl_options = opts
end
user=(user) click to toggle source

Sets the user for remote service.

# File lib/active_resource/persistent_connection.rb, line 70
def user=(user)
  @user = user
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.