Class: Async::HTTP::URLEndpoint
- Inherits:
-
IO::Endpoint
- Object
- IO::Endpoint
- Async::HTTP::URLEndpoint
- Defined in:
- lib/async/http/url_endpoint.rb
Constant Summary collapse
- DEFAULT_ALPN_PROTOCOLS =
['h2', 'http/1.1'].freeze
Instance Attribute Summary collapse
-
#options ⇒ Object
readonly
Returns the value of attribute options.
-
#url ⇒ Object
readonly
Returns the value of attribute url.
Class Method Summary collapse
Instance Method Summary collapse
- #address ⇒ Object
- #alpn_protocols ⇒ Object
- #bind(*args, &block) ⇒ Object
- #connect(*args, &block) ⇒ Object
- #default_port ⇒ Object
- #each ⇒ Object
- #endpoint ⇒ Object
- #eql?(other) ⇒ Boolean
- #hash ⇒ Object
- #hostname ⇒ Object
-
#initialize(url, endpoint = nil, **options) ⇒ URLEndpoint
constructor
A new instance of URLEndpoint.
- #key ⇒ Object
- #port ⇒ Object
- #protocol ⇒ Object
- #secure? ⇒ Boolean
- #ssl_context ⇒ Object
- #to_s ⇒ Object
Constructor Details
#initialize(url, endpoint = nil, **options) ⇒ URLEndpoint
Returns a new instance of URLEndpoint.
37 38 39 40 41 42 43 44 |
# File 'lib/async/http/url_endpoint.rb', line 37 def initialize(url, endpoint = nil, **) super(**) raise ArgumentError.new("URL must be absolute (include scheme, host): #{url}") unless url.absolute? @url = url @endpoint = endpoint end |
Instance Attribute Details
#options ⇒ Object (readonly)
Returns the value of attribute options.
51 52 53 |
# File 'lib/async/http/url_endpoint.rb', line 51 def @options end |
#url ⇒ Object (readonly)
Returns the value of attribute url.
50 51 52 |
# File 'lib/async/http/url_endpoint.rb', line 50 def url @url end |
Class Method Details
.parse(string, **options) ⇒ Object
31 32 33 34 35 |
# File 'lib/async/http/url_endpoint.rb', line 31 def self.parse(string, **) url = URI.parse(string).normalize self.new(url, **) end |
Instance Method Details
#address ⇒ Object
53 54 55 |
# File 'lib/async/http/url_endpoint.rb', line 53 def address endpoint.address end |
#alpn_protocols ⇒ Object
83 84 85 |
# File 'lib/async/http/url_endpoint.rb', line 83 def alpn_protocols @options.fetch(:alpn_protocols, DEFAULT_ALPN_PROTOCOLS) end |
#bind(*args, &block) ⇒ Object
113 114 115 |
# File 'lib/async/http/url_endpoint.rb', line 113 def bind(*args, &block) endpoint.bind(*args, &block) end |
#connect(*args, &block) ⇒ Object
117 118 119 |
# File 'lib/async/http/url_endpoint.rb', line 117 def connect(*args, &block) endpoint.connect(*args, &block) end |
#default_port ⇒ Object
69 70 71 |
# File 'lib/async/http/url_endpoint.rb', line 69 def default_port secure? ? 443 : 80 end |
#each ⇒ Object
121 122 123 124 125 126 127 |
# File 'lib/async/http/url_endpoint.rb', line 121 def each return to_enum unless block_given? self.endpoint.each do |endpoint| yield self.class.new(@url, endpoint, @options) end end |
#endpoint ⇒ Object
97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 |
# File 'lib/async/http/url_endpoint.rb', line 97 def endpoint unless @endpoint @endpoint = Async::IO::Endpoint.tcp(hostname, port) if secure? # Wrap it in SSL: @endpoint = Async::IO::SSLEndpoint.new(@endpoint, ssl_context: ssl_context, hostname: self.hostname ) end end return @endpoint end |
#eql?(other) ⇒ Boolean
133 134 135 |
# File 'lib/async/http/url_endpoint.rb', line 133 def eql? other self.key.eql? other.key end |
#hash ⇒ Object
137 138 139 |
# File 'lib/async/http/url_endpoint.rb', line 137 def hash self.key.hash end |
#hostname ⇒ Object
77 78 79 |
# File 'lib/async/http/url_endpoint.rb', line 77 def hostname @options.fetch(:hostname, @url.hostname) end |
#key ⇒ Object
129 130 131 |
# File 'lib/async/http/url_endpoint.rb', line 129 def key [@url.scheme, @url.userinfo, @url.host, @url.port, @options] end |
#port ⇒ Object
73 74 75 |
# File 'lib/async/http/url_endpoint.rb', line 73 def port @url.port || default_port end |
#protocol ⇒ Object
61 62 63 64 65 66 67 |
# File 'lib/async/http/url_endpoint.rb', line 61 def protocol if secure? Protocol::HTTPS else Protocol::HTTP1 end end |
#secure? ⇒ Boolean
57 58 59 |
# File 'lib/async/http/url_endpoint.rb', line 57 def secure? ['https', 'wss'].include?(@url.scheme) end |
#ssl_context ⇒ Object
87 88 89 90 91 92 93 94 95 |
# File 'lib/async/http/url_endpoint.rb', line 87 def ssl_context @options[:ssl_context] || ::OpenSSL::SSL::SSLContext.new.tap do |context| if alpn_protocols = self.alpn_protocols context.alpn_protocols = alpn_protocols end context.set_params end end |
#to_s ⇒ Object
46 47 48 |
# File 'lib/async/http/url_endpoint.rb', line 46 def to_s "\#<#{self.class} #{@url} #{@options.inspect}>" end |