Class: HTTPX::Resolver::Multi

Inherits:
Object
  • Object
show all
Includes:
Callbacks
Defined in:
lib/httpx/resolver/multi.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Callbacks

#callbacks_for?, #emit, #on, #once

Constructor Details

#initialize(resolver_type, options) ⇒ Multi

Returns a new instance of Multi.



13
14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/httpx/resolver/multi.rb', line 13

def initialize(resolver_type, options)
  @current_selector = @current_session = nil
  @options = options
  @resolver_options = @options.resolver_options

  @resolvers = options.ip_families.map do |ip_family|
    resolver = resolver_type.new(ip_family, options)
    resolver.multi = self
    resolver
  end

  @errors = Hash.new { |hs, k| hs[k] = [] }
end

Instance Attribute Details

#options ⇒ Object (readonly)

Returns the value of attribute options.



11
12
13
 
# File 'lib/httpx/resolver/multi.rb', line 11

def options
  @options
end

#resolvers ⇒ Object (readonly)

Returns the value of attribute resolvers.



11
12
13
 
# File 'lib/httpx/resolver/multi.rb', line 11

def resolvers
  @resolvers
end

Instance Method Details

#close ⇒ Object 



57
58
59
 
# File 'lib/httpx/resolver/multi.rb', line 57

def close
  @resolvers.each(&:close)
end

#closed? ⇒ Boolean

Returns:

  • (Boolean) 


41
42
43
 
# File 'lib/httpx/resolver/multi.rb', line 41

def closed?
  @resolvers.all?(&:closed?)
end

#connections ⇒ Object 



61
62
63
 
# File 'lib/httpx/resolver/multi.rb', line 61

def connections
  @resolvers.filter_map { |r| r.resolver_connection if r.respond_to?(:resolver_connection) }
end

#current_selector=(s) ⇒ Object 



27
28
29
30
 
# File 'lib/httpx/resolver/multi.rb', line 27

def current_selector=(s)
  @current_selector = s
  @resolvers.each { |r| r.__send__(__method__, s) }
end

#current_session=(s) ⇒ Object 



32
33
34
35
 
# File 'lib/httpx/resolver/multi.rb', line 32

def current_session=(s)
  @current_session = s
  @resolvers.each { |r| r.__send__(__method__, s) }
end

#early_resolve(connection) ⇒ Object 



65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/httpx/resolver/multi.rb', line 65

def early_resolve(connection)
  hostname = connection.peer.host
  addresses = @resolver_options[:cache] && (connection.addresses || HTTPX::Resolver.nolookup_resolve(hostname))
  return false unless addresses

  resolved = false
  addresses.group_by(&:family).sort { |(f1, _), (f2, _)| f2 <=> f1 }.each do |family, addrs|
    # try to match the resolver by family. However, there are cases where that's not possible, as when
    # the system does not have IPv6 connectivity, but it does support IPv6 via loopback/link-local.
    resolver = @resolvers.find { |r| r.family == family } || @resolvers.first

    next unless resolver # this should ever happen

    # it does not matter which resolver it is, as early-resolve code is shared.
    resolver.emit_addresses(connection, family, addrs, true)

    resolved = true
  end

  resolved
end

#empty? ⇒ Boolean

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/httpx/resolver/multi.rb', line 45

def empty?
  @resolvers.all?(&:empty?)
end

#inflight? ⇒ Boolean

Returns:

  • (Boolean) 


49
50
51
 
# File 'lib/httpx/resolver/multi.rb', line 49

def inflight?
  @resolvers.any(&:inflight?)
end

#lazy_resolve(connection) ⇒ Object 



87
88
89
90
91
92
93
94
 
# File 'lib/httpx/resolver/multi.rb', line 87

def lazy_resolve(connection)
  @resolvers.each do |resolver|
    resolver << @current_session.try_clone_connection(connection, @current_selector, resolver.family)
    next if resolver.empty?

    @current_session.select_resolver(resolver, @current_selector)
  end
end

#log(*args, **kwargs, &blk) ⇒ Object 



37
38
39
 
# File 'lib/httpx/resolver/multi.rb', line 37

def log(*args, **kwargs, &blk)
  @resolvers.each { |r| r.__send__(__method__, *args, **kwargs, &blk) }
end

#timeout ⇒ Object 



53
54
55
 
# File 'lib/httpx/resolver/multi.rb', line 53

def timeout
  @resolvers.filter_map(&:timeout).min
end