Class: Restify::Context

Inherits:
Object
  • Object
show all
Defined in:
lib/restify/context.rb

Overview

A resource context.

The resource context contains relations and the effective response URI. The context is used to resolve relative URI and follow links.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(uri, **kwargs) ⇒ Context

Returns a new instance of Context.



23
24
25
26
27
28
29
30
31
 
# File 'lib/restify/context.rb', line 23

def initialize(uri, **kwargs)
  @uri = if uri.is_a?(Addressable::URI)
           uri
         else
           @uri = Addressable::URI.parse(uri.to_s)
         end

  @options = kwargs
end

Instance Attribute Details

#options ⇒ Hash (readonly)

Options passed to this context.

Returns:

  • (Hash) —

    Options.



21
22
23
 
# File 'lib/restify/context.rb', line 21

def options
  @options
end

#uri ⇒ Addressable::URI (readonly)

Effective context URI.

Returns:

  • (Addressable::URI) —

    Effective context URI.



15
16
17
 
# File 'lib/restify/context.rb', line 15

def uri
  @uri
end

Class Method Details

.raise_response_error(response) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
 
# File 'lib/restify/context.rb', line 79

def raise_response_error(response)
  case response.code
    when 400...500
      raise ClientError.new(response)
    when 500...600
      raise ServerError.new(response)
    else
      raise "Unknown response code: #{response.code}"
  end
end

Instance Method Details

#inherit(uri, **kwargs) ⇒ Object 



37
38
39
40
 
# File 'lib/restify/context.rb', line 37

def inherit(uri, **kwargs)
  uri = self.uri unless uri
  Context.new uri, kwargs.merge(options)
end

#join(uri) ⇒ Object 



33
34
35
 
# File 'lib/restify/context.rb', line 33

def join(uri)
  self.uri.join uri
end

#process(response) ⇒ Object 



42
43
44
45
46
47
48
 
# File 'lib/restify/context.rb', line 42

def process(response)
  context   = inherit response.uri
  processor = Restify::PROCESSORS.find {|p| p.accept? response }
  processor ||= Restify::Processors::Base

  processor.new(context, response).resource
end

#request(method, uri, data = nil, _opts = {}) ⇒ Object

rubocop:disable Metrics/MethodLength



51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
 
# File 'lib/restify/context.rb', line 51

def request(method, uri, data = nil, _opts = {})
  request = Request.new \
    method: method,
    uri: join(uri),
    data: data,
    headers: options.fetch(:headers, {})

  ret = cache.call(request) {|req| adapter.call(req) }
  ret.then do |response|
    if response.success?
      process response
    else
      Context.raise_response_error(response)
    end
  end
end