class Stream < ::Protocol::HTTP2::Stream

def initialize(*)
	super
	
	@headers = nil
	
	@pool = nil
	
	# Input buffer, reading request body, or response body (receive_data):
	@length = nil
	@input = nil
	
	# The application can close its input before the peer finishes sending. HTTP/2 cannot close only the receiving side of a stream, so incoming data is discarded until local output also finishes. At that point, a no-error reset terminates the remaining wire stream.
	@input_closed = false
	
	# Output buffer, writing request body or response body (window_updated):
	@output = nil
end

parameter　key　String

The header name.

parameter　value　String

The header value.

def add_header(key, value, trailer: false)
	if key == CONNECTION
		raise ::Protocol::HTTP2::HeaderError, "Connection header is not allowed!"
	elsif key.start_with? ":"
		raise ::Protocol::HTTP2::HeaderError, "Invalid pseudo-header #{key}!"
	elsif key =~ /[A-Z]/
		raise ::Protocol::HTTP2::HeaderError, "Invalid upper-case characters in header #{key}!"
	else
		@headers.add(key, value, trailer: trailer)
	end
end

parameter　headers　Array

The trailing header key-value pairs.

parameter　end_stream　Boolean

Whether the stream ends after these headers.

def receive_trailing_headers(headers, end_stream)
	headers.each do |key, value|
		add_header(key, value, trailer: true)
	end
end

parameter　frame　Protocol::HTTP2::HeadersFrame

The headers frame to process.

def process_headers(frame)
	if @headers and frame.end_stream?
		self.receive_trailing_headers(super, frame.end_stream?)
	else
		self.receive_initial_headers(super, frame.end_stream?)
	end
	
	if @input and frame.end_stream?
		@input.close_write
	end
rescue ::Protocol::HTTP::InvalidTrailerError => error
	Console.warn(self, error)
	
	send_reset_stream(::Protocol::HTTP2::Error::PROTOCOL_ERROR)
rescue ::Protocol::HTTP2::HeaderError => error
	Console.debug(self, "Error while processing headers!", error)
	
	send_reset_stream(error.code)
end

returns　Input | Nil

The input body for this stream, if available.

def wait_for_input
	return @input
end

def prepare_input(length)
	if @input.nil?
		@input = Input.new(self, length)
	else
		raise ArgumentError, "Input body already prepared!"
	end
end

parameter　frame　Protocol::HTTP2::DataFrame

The received data frame.

def update_local_window(frame)
	consume_local_window(frame)
	
	# This is done on demand in `Input#read`:
	# request_window_update
end

parameter　frame　Protocol::HTTP2::DataFrame

The data frame to process.

returns　String

The unpacked data.

def process_data(frame)
	data = frame.unpack
	
	if input = @input
		unless data.empty?
			input.write(data)
		end
		
		if frame.end_stream?
			input.close_write
		end
	else
		# The application has closed the input, so discard incoming data while maintaining flow control for the stream.
		request_window_update
	end
	
	return data
rescue ::Protocol::HTTP2::ProtocolError
	raise
rescue # Anything else...
	send_reset_stream(::Protocol::HTTP2::Error::INTERNAL_ERROR)
end

parameter　input　Input

The input body being closed.

parameter　error　Exception | Nil

The error which closed the input.

def finish_input(input, error = nil)
	if @input.equal?(input)
		@input = nil
		@input_closed = true
		
		if error
			send_reset_stream(::Protocol::HTTP2::Error::INTERNAL_ERROR)
		else
			close_if_finished
		end
	end
end

def send_body(body, trailer = nil)
	@output = Output.new(self, body, trailer)
	
	@output.start
end

def finish_output(error = nil)
	return if self.closed?
	
	trailer = @output&.trailer
	
	@output = nil
	
	if error
		send_reset_stream(::Protocol::HTTP2::Error::INTERNAL_ERROR)
	else
		# Write trailer?
		if trailer&.any?
			send_headers(trailer, ::Protocol::HTTP2::END_STREAM)
		else
			send_data(nil, ::Protocol::HTTP2::END_STREAM)
		end
	end
end

parameter　size　Integer

The new window size.

returns　Boolean

Always returns true.

def window_updated(size)
	super
	
	@output&.window_updated(size)
	
	return true
end

def send_headers(...)
	result = super
	close_if_finished
	return result
end

def send_data(...)
	result = super
	close_if_finished
	return result
end

def closed(error)
	if error.is_a?(::Protocol::HTTP2::StreamError) && error.code == ::Protocol::HTTP2::Error::NO_ERROR
		error = nil
	end
	
	super
	
	if input = @input
		@input = nil
		input.close_write(error)
	end
	
	if output = @output
		@output = nil
		
		if error
			output.stop(error)
		else
			output.close_stream
		end
	end
	
	if pool = @pool and @connection
		pool.release(@connection)
	end
	
	return self
end

def close_if_finished
	if @input_closed && @state == :half_closed_local
		send_reset_stream(::Protocol::HTTP2::Error::NO_ERROR)
	end
end