Object
HTTP response class.
This class wraps together the response header and the response body (the entity requested).
It mixes in the HTTPHeader module, which provides access to response header values both via hash-like methods and via individual readers.
Note that each possible HTTP response code defines its own HTTPResponse
subclass. These are listed below.
All classes are defined under the Net
module. Indentation indicates inheritance. For a list of the classes see Net::HTTP
.
The HTTP result code string. For example, '302'. You can also determine the response type by examining which response subclass the response object is an instance of.
Returns the full entity body.
Calling this method a second or subsequent time will return the string already read.
http.request_get('/index.html') {|res| puts res.body } http.request_get('/index.html') {|res| p res.body.object_id # 538149362 p res.body.object_id # 538149362 }
# File net/http/response.rb, line 228 def body read_body() end
Because it may be necessary to modify the body, Eg, decompression this method facilitates that.
# File net/http/response.rb, line 234 def body=(value) @body = value end
# File net/http/response.rb, line 107 def inspect "#<#{self.class} #{@code} #{@message} readbody=#{@read}>" end
Gets the entity body returned by the remote HTTP server.
If a block is given, the body is passed to the block, and the body is provided in fragments, as it is read in from the socket.
Calling this method a second or subsequent time for the same HTTPResponse
object will return the value already read.
http.request_get('/index.html') {|res| puts res.read_body } http.request_get('/index.html') {|res| p res.read_body.object_id # 538149362 p res.read_body.object_id # 538149362 } # using iterator http.request_get('/index.html') {|res| res.read_body do |segment| print segment end }
# File net/http/response.rb, line 196 def read_body(dest = nil, &block) if @read raise IOError, "#{self.class}\#read_body called twice" if dest or block return @body end to = procdest(dest, block) stream_check if @body_exist read_body_0 to @body = to else @body = nil end @read = true @body end