Module: Rest::InternalClient::AbstractResponse

Included in:
RawResponse, Response
Defined in:
lib/rest/wrappers/internal_client/internal/abstract_response.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#argsObject (readonly)

Returns the value of attribute args.



8
9
10
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 8

def args
  @args
end

#net_http_resObject (readonly)

Returns the value of attribute net_http_res.



8
9
10
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 8

def net_http_res
  @net_http_res
end

Class Method Details

.beautify_headers(headers) ⇒ Object



86
87
88
89
90
91
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 86

def AbstractResponse.beautify_headers(headers)
  headers.inject({}) do |out, (key, value)|
    out[key.gsub(/-/, '_').downcase.to_sym] = %w{ set-cookie }.include?(key.downcase) ? value : value.first
    out
  end
end

Instance Method Details

#codeObject

HTTP status code



11
12
13
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 11

def code
  @code ||= @net_http_res.code.to_i
end

#cookiesObject

Hash of cookies extracted from response headers



27
28
29
30
31
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 27

def cookies
  @cookies ||= (self.headers[:set_cookie] || {}).inject({}) do |out, cookie_content|
    out.merge parse_cookie(cookie_content)
  end
end

#descriptionObject



59
60
61
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 59

def description
  "#{code} #{STATUSES[code]} | #{(headers[:content_type] || '').gsub(/;.*$/, '')} #{size} bytes\n"
end

#follow_redirection(request = nil, result = nil, &block) ⇒ Object

Follow a redirection



64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 64

def follow_redirection request = nil, result = nil, & block
  url = headers[:location]
  if url !~ /^http/
    url = URI.parse(args[:url]).merge(url).to_s
  end
  args[:url] = url
  if request
    if request.max_redirects == 0
      raise MaxRedirectsReached
    end
    args[:password] = request.password
    args[:user] = request.user
    args[:headers] = request.headers
    args[:max_redirects] = request.max_redirects - 1
    # pass any cookie set in the result
    if result && result['set-cookie']
      args[:headers][:cookies] = (args[:headers][:cookies] || {}).merge(parse_cookie(result['set-cookie']))
    end
  end
  Request.execute args, &block
end

#headersObject

A hash of the headers, beautified with symbols and underscores. e.g. “Content-type” will become :content_type.



17
18
19
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 17

def headers
  @headers ||= AbstractResponse.beautify_headers(@net_http_res.to_hash)
end

#raw_headersObject

The raw headers.



22
23
24
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 22

def raw_headers
  @raw_headers ||= @net_http_res.to_hash
end

#return!(request = nil, result = nil, &block) ⇒ Object

Return the default behavior corresponding to the response code: the response itself for code in 200..206, redirection for 301, 302 and 307 in get and head cases, redirection for 303 and an exception in other cases



35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 35

def return! request = nil, result = nil, & block
  if (200..207).include? code
    self
  elsif [301, 302, 307].include? code
    unless [:get, :head].include? args[:method]
      raise Exceptions::EXCEPTIONS_MAP[code].new(self, code)
    else
      follow_redirection(request, result, & block)
    end
  elsif code == 303
    args[:method] = :get
    args.delete :payload
    follow_redirection(request, result, & block)
  elsif Exceptions::EXCEPTIONS_MAP[code]
    raise Exceptions::EXCEPTIONS_MAP[code].new(self, code)
  else
    raise RequestFailed.new(self, code)
  end
end

#to_iObject



55
56
57
# File 'lib/rest/wrappers/internal_client/internal/abstract_response.rb', line 55

def to_i
  code
end