Class: Webmachine::Adapters::Rack::RequestBody Private

Inherits:
Object
  • Object
show all
Defined in:
lib/webmachine/adapters/rack.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Wraps the Rack input so it can be treated like a String or Enumerable.

Instance Method Summary collapse

Constructor Details

#initialize(request) ⇒ RequestBody

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of RequestBody.

Parameters:

  • request (Rack::Request) —

    the Rack request



160
161
162
 
# File 'lib/webmachine/adapters/rack.rb', line 160

def initialize(request)
  @request = request
end

Instance Method Details

#each {|chunk| ... } ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Iterates over the body in chunks. If the body has previously been read, this method can be called again and get the same sequence of chunks.

Yields:

  • (chunk)

Yield Parameters:

  • chunk (String) —

    a chunk of the request body



190
191
192
193
194
195
196
197
198
199
200
 
# File 'lib/webmachine/adapters/rack.rb', line 190

def each
  if @value
    @value.each { |chunk| yield chunk }
  else
    @value = []
    @request.body.each { |chunk|
      @value << chunk
      yield chunk
    }
  end
end

#to_io ⇒ IO

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Rack Servers differ in the way you can access their request bodys. While some allow you to directly get a Ruby IO object others don’t. You have to check the methods they expose, like #gets, #read, #each, #rewind and maybe others. See: github.com/rack/rack/blob/rack-1.5/lib/rack/lint.rb#L296

Returns:

  • (IO) —

    the request body



169
170
171
 
# File 'lib/webmachine/adapters/rack.rb', line 169

def to_io
  @request.body
end

#to_s ⇒ String

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Converts the body to a String so you can work with the entire thing.

Returns:

  • (String) —

    the request body as a string



176
177
178
179
180
181
182
183
 
# File 'lib/webmachine/adapters/rack.rb', line 176

def to_s
  if @value
    @value.join
  else
    @request.body.rewind
    @request.body.read
  end
end