Class: Async::HTTP::Protocol::HTTP1::Client

Inherits:
Connection
  • Object
show all
Defined in:
lib/async/http/protocol/http1/client.rb

Instance Attribute Summary collapse

Attributes inherited from Connection

#count, #version

Instance Method Summary collapse

Methods inherited from Connection

#as_json, #concurrency, #http1?, #http2?, #peer, #reusable?, #to_json, #to_s, #viable?

Constructor Details

#initialize ⇒ Client

Returns a new instance of Client.



15
16
17
18
19
 
# File 'lib/async/http/protocol/http1/client.rb', line 15

def initialize(...)
	super
	
	@pool = nil
end

Instance Attribute Details

#pool ⇒ Object

Returns the value of attribute pool.



21
22
23
 
# File 'lib/async/http/protocol/http1/client.rb', line 21

def pool
  @pool
end

Instance Method Details

#call(request, task: Task.current) ⇒ Object

Used by the client to send requests to the remote server.



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/async/http/protocol/http1/client.rb', line 34

def call(request, task: Task.current)
	Console.logger.debug(self) {"#{request.method} #{request.path} #{request.headers.inspect}"}
	
	# Mark the start of the trailers:
	trailer = request.headers.trailer!
	
	# We carefully interpret https://tools.ietf.org/html/rfc7230#section-6.3.1 to implement this correctly.
	begin
		write_request(request.authority, request.method, request.path, @version, request.headers)
	rescue
		# If we fail to fully write the request and body, we can retry this request.
		raise RequestFailed
	end
	
	if request.body?
		body = request.body
		
		if protocol = request.protocol
			# This is a very tricky apect of handling HTTP/1 upgrade connections. In theory, this approach is a bit inefficient, because we spin up a task just to handle writing to the underlying stream when we could be writing to the stream directly. But we need to maintain some level of compatibility with HTTP/2. Additionally, we don't know if the upgrade request will be accepted, so starting to write the body at this point needs to be handled with care.
			task.async(annotation: "Upgrading request...") do
				# If this fails, this connection will be closed.
				write_upgrade_body(protocol, body)
			rescue => error
				self.close(error)
			end
		elsif request.connect?
			task.async(annotation: "Tunnneling request...") do
				write_tunnel_body(@version, body)
			rescue => error
				self.close(error)
			end
		else
			task.async(annotation: "Streaming request...") do
				# Once we start writing the body, we can't recover if the request fails. That's because the body might be generated dynamically, streaming, etc.
				write_body(@version, body, false, trailer)
			rescue => error
				self.close(error)
			end
		end
	elsif protocol = request.protocol
		write_upgrade_body(protocol)
	else
		write_body(@version, request.body, false, trailer)
	end
	
	return Response.read(self, request)
rescue => error
	self.close(error)
	raise
end

#closed(error = nil) ⇒ Object 



23
24
25
26
27
28
29
30
31
 
# File 'lib/async/http/protocol/http1/client.rb', line 23

def closed(error = nil)
	super
	
	if pool = @pool
		@pool = nil
		# If the connection is not reusable, this will retire it from the connection pool and invoke `#close`.
		pool.release(self)
	end
end