Class: ActiveMerchant::Connection

Inherits:
Object
  • Object
show all
Includes:
NetworkConnectionRetries
Defined in:
lib/active_merchant/connection.rb

Constant Summary collapse

MAX_RETRIES =
3
OPEN_TIMEOUT =
60
READ_TIMEOUT =
60
VERIFY_PEER =
true
CA_FILE =
File.expand_path('../certs/cacert.pem', File.dirname(__FILE__))
CA_PATH =
nil
MIN_VERSION =
:TLS1_1
RETRY_SAFE =
false
RUBY_184_POST_HEADERS =
{ 'Content-Type' => 'application/x-www-form-urlencoded' }

Constants included from NetworkConnectionRetries

NetworkConnectionRetries::DEFAULT_CONNECTION_ERRORS, NetworkConnectionRetries::DEFAULT_RETRIES

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from NetworkConnectionRetries

included, log, #retry_exceptions

Constructor Details

#initialize(endpoint) ⇒ Connection

Returns a new instance of Connection.


43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# File 'lib/active_merchant/connection.rb', line 43

def initialize(endpoint)
  @endpoint     = endpoint.is_a?(URI) ? endpoint : URI.parse(endpoint)
  @open_timeout = OPEN_TIMEOUT
  @read_timeout = READ_TIMEOUT
  @retry_safe   = RETRY_SAFE
  @verify_peer  = VERIFY_PEER
  @ca_file      = CA_FILE
  @ca_path      = CA_PATH
  @max_retries  = MAX_RETRIES
  @ignore_http_status = false
  @ssl_version = nil
  if Net::HTTP.instance_methods.include?(:min_version=)
    @min_version = MIN_VERSION
    @max_version = nil
  end
  @ssl_connection = {}
  @proxy_address = :ENV
  @proxy_port = nil
end

Instance Attribute Details

#ca_fileObject

Returns the value of attribute ca_file.


31
32
33
# File 'lib/active_merchant/connection.rb', line 31

def ca_file
  @ca_file
end

#ca_pathObject

Returns the value of attribute ca_path.


32
33
34
# File 'lib/active_merchant/connection.rb', line 32

def ca_path
  @ca_path
end

#endpointObject

Returns the value of attribute endpoint.


21
22
23
# File 'lib/active_merchant/connection.rb', line 21

def endpoint
  @endpoint
end

#ignore_http_statusObject

Returns the value of attribute ignore_http_status.


38
39
40
# File 'lib/active_merchant/connection.rb', line 38

def ignore_http_status
  @ignore_http_status
end

#loggerObject

Returns the value of attribute logger.


36
37
38
# File 'lib/active_merchant/connection.rb', line 36

def logger
  @logger
end

#max_retriesObject

Returns the value of attribute max_retries.


39
40
41
# File 'lib/active_merchant/connection.rb', line 39

def max_retries
  @max_retries
end

#max_versionObject

Returns the value of attribute max_version.


28
29
30
# File 'lib/active_merchant/connection.rb', line 28

def max_version
  @max_version
end

#min_versionObject

Returns the value of attribute min_version.


27
28
29
# File 'lib/active_merchant/connection.rb', line 27

def min_version
  @min_version
end

#open_timeoutObject

Returns the value of attribute open_timeout.


22
23
24
# File 'lib/active_merchant/connection.rb', line 22

def open_timeout
  @open_timeout
end

#pemObject

Returns the value of attribute pem.


33
34
35
# File 'lib/active_merchant/connection.rb', line 33

def pem
  @pem
end

#pem_passwordObject

Returns the value of attribute pem_password.


34
35
36
# File 'lib/active_merchant/connection.rb', line 34

def pem_password
  @pem_password
end

#proxy_addressObject

Returns the value of attribute proxy_address.


40
41
42
# File 'lib/active_merchant/connection.rb', line 40

def proxy_address
  @proxy_address
end

#proxy_portObject

Returns the value of attribute proxy_port.


41
42
43
# File 'lib/active_merchant/connection.rb', line 41

def proxy_port
  @proxy_port
end

#read_timeoutObject

Returns the value of attribute read_timeout.


23
24
25
# File 'lib/active_merchant/connection.rb', line 23

def read_timeout
  @read_timeout
end

#ssl_connectionObject (readonly)

Returns the value of attribute ssl_connection.


30
31
32
# File 'lib/active_merchant/connection.rb', line 30

def ssl_connection
  @ssl_connection
end

#ssl_versionObject

Returns the value of attribute ssl_version.


25
26
27
# File 'lib/active_merchant/connection.rb', line 25

def ssl_version
  @ssl_version
end

#tagObject

Returns the value of attribute tag.


37
38
39
# File 'lib/active_merchant/connection.rb', line 37

def tag
  @tag
end

#verify_peerObject

Returns the value of attribute verify_peer.


24
25
26
# File 'lib/active_merchant/connection.rb', line 24

def verify_peer
  @verify_peer
end

#wiredump_deviceObject

Returns the value of attribute wiredump_device.


35
36
37
# File 'lib/active_merchant/connection.rb', line 35

def wiredump_device
  @wiredump_device
end

Instance Method Details

#request(method, body, headers = {}) ⇒ Object


69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
# File 'lib/active_merchant/connection.rb', line 69

def request(method, body, headers = {})
  request_start = Process.clock_gettime(Process::CLOCK_MONOTONIC)

  headers = headers.dup
  headers['connection'] ||= 'close'

  retry_exceptions(max_retries: max_retries, logger: logger, tag: tag) do
    info "connection_http_method=#{method.to_s.upcase} connection_uri=#{endpoint}", tag

    result = nil

    realtime = Benchmark.realtime do
      http.start unless http.started?
      @ssl_connection = http.ssl_connection
      info "connection_ssl_version=#{ssl_connection[:version]} connection_ssl_cipher=#{ssl_connection[:cipher]}", tag

      result =
        case method
        when :get
          raise ArgumentError, 'GET requests do not support a request body' if body

          http.get(endpoint.request_uri, headers)
        when :post
          debug body
          http.post(endpoint.request_uri, body, RUBY_184_POST_HEADERS.merge(headers))
        when :put
          debug body
          http.put(endpoint.request_uri, body, headers)
        when :patch
          debug body
          http.patch(endpoint.request_uri, body, headers)
        when :delete
          # It's kind of ambiguous whether the RFC allows bodies
          # for DELETE requests. But Net::HTTP's delete method
          # very unambiguously does not.
          if body
            debug body
            req = Net::HTTP::Delete.new(endpoint.request_uri, headers)
            req.body = body
            http.request(req)
          else
            http.delete(endpoint.request_uri, headers)
          end
        else
          raise ArgumentError, "Unsupported request method #{method.to_s.upcase}"
        end
    end

    info '--> %d %s (%d %.4fs)' % [result.code, result.message, result.body ? result.body.length : 0, realtime], tag
    debug result.body
    result
  end
ensure
  info 'connection_request_total_time=%.4fs' % [Process.clock_gettime(Process::CLOCK_MONOTONIC) - request_start], tag
  http.finish if http.started?
end