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. All classes are defined under the Net module. Indentation indicates inheritance. For a list of the classes see Net::HTTP.
Correspondence HTTP code => class is stored in CODE_TO_OBJ constant:
Net::HTTPResponse::CODE_TO_OBJ['404'] #=> Net::HTTPNotFound
The HTTP version supported by the server.
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.
The HTTP result message sent by the server. For example, ‘Not Found’.
Set to true automatically when the request did not contain an Accept-Encoding header from the user.
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 22
def body_permitted?
self::HAS_BODY
end
true if the response has a body.
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 54
def each_response_header(sock)
key = value = nil
while true
line = sock.readuntil("\n", true).sub(/\s+\z/, '')
break if line.empty?
if line[0] == ?\s or line[0] == ?\t and value
value << ' ' unless value.empty?
value << line.strip
else
yield key, value if key
key, value = line.strip.split(/\s*:\s*/, 2)
raise Net::HTTPBadResponse, 'wrong header line format' if value.nil?
end
end
yield key, value if key
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 41
def read_status_line(sock)
str = sock.readline
m = /\AHTTP(?:\/(\d+\.\d+))?\s+(\d\d\d)(?:\s+(.*))?\z/in.match(str) or
raise Net::HTTPBadResponse, "wrong status line: #{str.dump}"
m.captures
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 48
def response_class(code)
CODE_TO_OBJ[code] or
CODE_CLASS_TO_OBJ[code[0,1]] or
Net::HTTPUnknownResponse
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 234
def body
read_body()
end
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 tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 240
def body=(value)
@body = value
end
Because it may be necessary to modify the body, Eg, decompression this method facilitates that.
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 109
def inspect
"#<#{self.class} #{@code} #{@message} readbody=#{@read}>"
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 343
def procdest(dest, block)
raise ArgumentError, 'both arg and block given for HTTP method' if
dest and block
if block
Net::ReadAdapter.new(block)
else
dest || ''
end
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 202
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
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.
If dest argument is given, response is read into that variable, with dest#<< method (it could be String or IO, or any other object responding to <<).
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 tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 289
def read_body_0(dest)
inflater do |inflate_body_io|
if chunked?
read_chunked dest, inflate_body_io
return
end
@socket = inflate_body_io
clen = content_length()
if clen
@socket.read clen, dest, true # ignore EOF
return
end
clen = range_length()
if clen
@socket.read clen, dest
return
end
@socket.read_all dest
end
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 339
def stream_check
raise IOError, 'attempt to read body out of block' if @socket.closed?
end
# File tmp/rubies/ruby-3.0.5/lib/net/http/response.rb, line 132
def value
error! unless self.kind_of?(Net::HTTPSuccess)
end
Raises an HTTP error if the response is not 2xx (success).