Class: Protocol::HTTP::Body::Buffered

Inherits:
Readable
  • Object
show all
Defined in:
lib/protocol/http/body/buffered.rb

Overview

A body which buffers all it's contents.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Readable

#call, #close, #each, #join, #stream?

Constructor Details

#initialize(chunks = [], length = nil) ⇒ Buffered

Returns a new instance of Buffered.


54
55
56
57
58
59
60
# File 'lib/protocol/http/body/buffered.rb', line 54

def initialize(chunks = [], length = nil)
	@chunks = chunks
	@length = length
	
	@index = 0
	@digest = nil
end

Instance Attribute Details

#chunksObject (readonly)

Returns the value of attribute chunks.


62
63
64
# File 'lib/protocol/http/body/buffered.rb', line 62

def chunks
  @chunks
end

Class Method Details

.for(body) ⇒ Object


44
45
46
47
48
49
50
51
52
# File 'lib/protocol/http/body/buffered.rb', line 44

def self.for(body)
	chunks = []
	
	body.each do |chunk|
		chunks << chunk
	end
	
	self.new(chunks)
end

.wrap(body) ⇒ Readable?

Wraps an array into a buffered body.

Returns:

  • (Readable, nil)

    the wrapped body or nil if nil was given.


32
33
34
35
36
37
38
39
40
41
42
# File 'lib/protocol/http/body/buffered.rb', line 32

def self.wrap(body)
	if body.is_a?(Readable)
		return body
	elsif body.is_a?(Array)
		return self.new(body)
	elsif body.is_a?(String)
		return self.new([body])
	elsif body
		return self.for(body)
	end
end

Instance Method Details

#empty?Boolean

Returns:

  • (Boolean)

72
73
74
# File 'lib/protocol/http/body/buffered.rb', line 72

def empty?
	@index >= @chunks.length
end

#finishObject


64
65
66
# File 'lib/protocol/http/body/buffered.rb', line 64

def finish
	self
end

#inspectObject


98
99
100
# File 'lib/protocol/http/body/buffered.rb', line 98

def inspect
	"\#<#{self.class} #{@chunks.size} chunks, #{self.length} bytes>"
end

#lengthObject


68
69
70
# File 'lib/protocol/http/body/buffered.rb', line 68

def length
	@length ||= @chunks.inject(0) {|sum, chunk| sum + chunk.bytesize}
end

#readObject


81
82
83
84
85
86
87
# File 'lib/protocol/http/body/buffered.rb', line 81

def read
	if chunk = @chunks[@index]
		@index += 1
		
		return chunk.dup
	end
end

#ready?Boolean

A buffered response is always ready.

Returns:

  • (Boolean)

77
78
79
# File 'lib/protocol/http/body/buffered.rb', line 77

def ready?
	true
end

#rewindObject


94
95
96
# File 'lib/protocol/http/body/buffered.rb', line 94

def rewind
	@index = 0
end

#write(chunk) ⇒ Object


89
90
91
92
# File 'lib/protocol/http/body/buffered.rb', line 89

def write(chunk)
	@digest&.update(chunk)
	@chunks << chunk
end