class Async::HTTP::Protocol::HTTP2::Output
def close(error = nil)
def close(error = nil) close_write(error) stop(error) end
def close_write(error = nil)
def close_write(error = nil) if stream = @stream @stream = nil stream.finish_output(error) end end
def initialize(stream, body, trailer = nil)
def initialize(stream, body, trailer = nil) @stream = stream @body = body @trailer = trailer @task = nil @guard = ::Mutex.new @window_updated = ::ConditionVariable.new end
def passthrough(task)
def passthrough(task) task.annotate("Writing #{@body} to #{@stream}.") while chunk = @body&.read self.write(chunk) # TODO this reduces memory usage? # chunk.clear unless chunk.frozen? # GC.start end rescue => error raise ensure # Ensure the body we are reading from is fully closed: if body = @body @body = nil body.close(error) end # Ensure the output of this body is closed: self.close_write(error) end
def send_data(chunk, maximum_size)
-
(String, nil)
- any data that could not be written.
Parameters:
-
stream
(Stream
) -- the stream to use for sending data frames. -
maximum_size
(Integer
) -- send up to this many bytes of data.
def send_data(chunk, maximum_size) if chunk.bytesize <= maximum_size @stream.send_data(chunk, maximum_size: maximum_size) else @stream.send_data(chunk.byteslice(0, maximum_size), maximum_size: maximum_size) # The window was not big enough to send all the data, so we save it for next time: return chunk.byteslice(maximum_size, chunk.bytesize - maximum_size) end return nil end
def start(parent: Task.current)
def start(parent: Task.current) raise "Task already started!" if @task if @body.stream? @task = parent.async(&self.method(:stream)) else @task = parent.async(&self.method(:passthrough)) end end
def stop(error)
def stop(error) if task = @task @task = nil task.stop(error) end end
def stream(task)
def stream(task) task.annotate("Streaming #{@body} to #{@stream}.") input = @stream.wait_for_input stream = ::Protocol::HTTP::Body::Stream.new(input, self) @body.call(stream) rescue => error self.close(error) raise end
def window_updated(size)
def window_updated(size) @guard.synchronize do @window_updated.signal end end
def write(chunk)
def write(chunk) until chunk.empty? maximum_size = @stream.available_frame_size # We try to avoid synchronization if possible: if maximum_size <= 0 @guard.synchronize do maximum_size = @stream.available_frame_size while maximum_size <= 0 @window_updated.wait(@guard) maximum_size = @stream.available_frame_size end end end break unless chunk = send_data(chunk, maximum_size) end end