Class: Async::HTTP::Body::Stream
- Inherits:
-
Object
- Object
- Async::HTTP::Body::Stream
- Defined in:
- lib/async/http/body/stream.rb
Overview
The input stream is an IO-like object which contains the raw HTTP POST data. When applicable, its external encoding must be “ASCII-8BIT” and it must be opened in binary mode, for Ruby 1.9 compatibility. The input stream must respond to gets, each, read and rewind.
Instance Attribute Summary collapse
-
#input ⇒ Object
readonly
Returns the value of attribute input.
-
#output ⇒ Object
readonly
Returns the value of attribute output.
Instance Method Summary collapse
-
#close ⇒ Object
Close the input and output bodies.
- #close_read ⇒ Object
-
#close_write ⇒ Object
close must never be called on the input stream.
-
#closed? ⇒ Boolean
Whether the stream has been closed.
-
#empty? ⇒ Boolean
Whether there are any output chunks remaining?.
- #flush ⇒ Object
-
#initialize(input, output = Writable.new) ⇒ Stream
constructor
A new instance of Stream.
-
#read(length = nil, buffer = nil) ⇒ Object
read behaves like IO#read.
- #read_nonblock(length, buffer = nil) ⇒ Object
-
#read_partial(size = nil) ⇒ Object
Read at most ‘size` bytes from the stream.
- #write(buffer) ⇒ Object (also: #write_nonblock)
Constructor Details
#initialize(input, output = Writable.new) ⇒ Stream
Returns a new instance of Stream.
28 29 30 31 32 33 34 35 36 37 |
# File 'lib/async/http/body/stream.rb', line 28 def initialize(input, output = Writable.new) @input = input @output = output raise ArgumentError, "Non-writable output!" unless output.respond_to?(:write) # Will hold remaining data in `#read`. @buffer = nil @closed = false end |
Instance Attribute Details
#input ⇒ Object (readonly)
Returns the value of attribute input.
39 40 41 |
# File 'lib/async/http/body/stream.rb', line 39 def input @input end |
#output ⇒ Object (readonly)
Returns the value of attribute output.
40 41 42 |
# File 'lib/async/http/body/stream.rb', line 40 def output @output end |
Instance Method Details
#close ⇒ Object
Close the input and output bodies.
138 139 140 141 142 143 |
# File 'lib/async/http/body/stream.rb', line 138 def close self.close_read self.close_write ensure @closed = true end |
#close_read ⇒ Object
128 129 130 |
# File 'lib/async/http/body/stream.rb', line 128 def close_read @input&.close end |
#close_write ⇒ Object
close must never be called on the input stream. huh?
133 134 135 |
# File 'lib/async/http/body/stream.rb', line 133 def close_write @output&.close end |
#closed? ⇒ Boolean
Whether the stream has been closed.
146 147 148 |
# File 'lib/async/http/body/stream.rb', line 146 def closed? @closed end |
#empty? ⇒ Boolean
Whether there are any output chunks remaining?
151 152 153 |
# File 'lib/async/http/body/stream.rb', line 151 def empty? @output.empty? end |
#flush ⇒ Object
125 126 |
# File 'lib/async/http/body/stream.rb', line 125 def flush end |
#read(length = nil, buffer = nil) ⇒ Object
read behaves like IO#read. Its signature is read([length, [buffer]]). If given, length must be a non-negative Integer (>= 0) or nil, and buffer must be a String and may not be nil. If length is given and not nil, then this method reads at most length bytes from the input stream. If length is not given or nil, then this method reads all data until EOF. When EOF is reached, this method returns nil if length is given and not nil, or “” if length is not given or is nil. If buffer is given, then the read data will be placed into buffer instead of a newly created String object.
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 |
# File 'lib/async/http/body/stream.rb', line 49 def read(length = nil, buffer = nil) buffer ||= Async::IO::Buffer.new buffer.clear until buffer.bytesize == length @buffer = read_next if @buffer.nil? break if @buffer.nil? remaining_length = length - buffer.bytesize if length if remaining_length && remaining_length < @buffer.bytesize # We know that we are not going to reuse the original buffer. # But byteslice will generate a hidden copy. So let's freeze it first: @buffer.freeze buffer << @buffer.byteslice(0, remaining_length) @buffer = @buffer.byteslice(remaining_length, @buffer.bytesize) else buffer << @buffer @buffer = nil end end return nil if buffer.empty? && length && length > 0 return buffer end |
#read_nonblock(length, buffer = nil) ⇒ Object
96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 |
# File 'lib/async/http/body/stream.rb', line 96 def read_nonblock(length, buffer = nil) @buffer ||= read_next chunk = nil return nil if @buffer.nil? if @buffer.bytesize > length chunk = @buffer.byteslice(0, length) @buffer = @buffer.byteslice(length, @buffer.bytesize) else chunk = @buffer @buffer = nil end if buffer buffer.replace(chunk) else buffer = chunk end return buffer end |
#read_partial(size = nil) ⇒ Object
Read at most ‘size` bytes from the stream. Will avoid reading from the underlying stream if possible.
78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 |
# File 'lib/async/http/body/stream.rb', line 78 def read_partial(size = nil) if @buffer buffer = @buffer @buffer = nil else buffer = read_next end if buffer and size if buffer.bytesize > size @buffer = buffer.byteslice(size, buffer.bytesize) buffer = buffer.byteslice(0, size) end end return buffer end |
#write(buffer) ⇒ Object Also known as: write_nonblock
119 120 121 |
# File 'lib/async/http/body/stream.rb', line 119 def write(buffer) @output.write(buffer) end |