Class: HTTParty::ConnectionAdapter

Inherits:
Object
  • Object
show all
Defined in:
lib/httparty/connection_adapter.rb

Overview

Default connection adapter that returns a new Net::HTTP each time

Custom Connection Factories

If you like to implement your own connection adapter, subclassing HTTPParty::ConnectionAdapter will make it easier. Just override the #connection method. The uri and options attributes will have all the info you need to construct your http connection. Whatever you return from your connection method needs to adhere to the Net::HTTP interface as this is what HTTParty expects.

Configuration

There is lots of configuration data available for your connection adapter in the #options attribute. It is up to you to interpret them within your connection adapter. Take a look at the implementation of HTTParty::ConnectionAdapter#connection for examples of how they are used. Something are probably interesting are as follows:

  • :timeout: timeout in seconds

  • :debug_output: see HTTParty::ClassMethods.debug_output.

  • :pem: contains pem data. see HTTParty::ClassMethods.pem.

  • :ssl_ca_file: see HTTParty::ClassMethods.ssl_ca_file.

  • :ssl_ca_path: see HTTParty::ClassMethods.ssl_ca_path.

  • :connection_adapter_options: contains the hash your passed to HTTParty.connection_adapter when you configured your connection adapter

Examples:

log the uri and options

class LoggingConnectionAdapter < HTTParty::ConnectionAdapter
  def connection
    puts uri
    puts options
    Net::HTTP.new(uri)
  end
end

count number of http calls

class CountingConnectionAdapter < HTTParty::ConnectionAdapter
  @@count = 0

  self.count
    @@count
  end

  def connection
    self.count += 1
    super
  end
end

Constant Summary

StripIpv6BracketsRegex =

Private: Regex used to strip brackets from IPv6 URIs.

/\A\[(.*)\]\z/

Instance Attribute Summary (collapse)

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (ConnectionAdapter) initialize(uri, options = {})

A new instance of ConnectionAdapter

Raises:

  • (ArgumentError) 


60
61
62
63
64
65
 
# File 'lib/httparty/connection_adapter.rb', line 60

def initialize(uri, options={})
  raise ArgumentError, "uri must be a URI, not a #{uri.class}" unless uri.kind_of? URI

  @uri = uri
  @options = options
end

Instance Attribute Details

- (Object) options (readonly)

Returns the value of attribute options



58
59
60
 
# File 'lib/httparty/connection_adapter.rb', line 58

def options
  @options
end

- (Object) uri (readonly)

Returns the value of attribute uri



58
59
60
 
# File 'lib/httparty/connection_adapter.rb', line 58

def uri
  @uri
end

Class Method Details

+ (Object) call(uri, options)

Public



54
55
56
 
# File 'lib/httparty/connection_adapter.rb', line 54

def self.call(uri, options)
  new(uri, options).connection
end

Instance Method Details

- (Object) connection 



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/httparty/connection_adapter.rb', line 67

def connection
  host = clean_host(uri.host)
  http = Net::HTTP.new(host, uri.port, options[:http_proxyaddr], options[:http_proxyport], options[:http_proxyuser], options[:http_proxypass])

  http.use_ssl = ssl_implied?(uri)

  attach_ssl_certificates(http, options)

  if options[:timeout] && (options[:timeout].is_a?(Integer) || options[:timeout].is_a?(Float))
    http.open_timeout = options[:timeout]
    http.read_timeout = options[:timeout]
  end

  if options[:debug_output]
    http.set_debug_output(options[:debug_output])
  end

  if options[:ciphers]
    http.ciphers = options[:ciphers]
  end

  return http
end