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



129
130
131
 
# File 'lib/webmachine/adapters/rack.rb', line 129

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



159
160
161
162
163
164
165
166
 
# File 'lib/webmachine/adapters/rack.rb', line 159

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



138
139
140
 
# File 'lib/webmachine/adapters/rack.rb', line 138

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



145
146
147
148
149
150
151
152
 
# File 'lib/webmachine/adapters/rack.rb', line 145

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