In Files

  • net/http.rb

Net::HTTPResponse

Attributes

code[R]

HTTP result code string. For example, ‘302’. You can also determine the response type by which response subclass the response object is an instance of.

http_version[R]

The HTTP version supported by the server.

message[R]

HTTP result message. For example, ‘Not Found’.

msg[R]

HTTP result message. For example, ‘Not Found’.

Public Class Methods

body_permitted?() click to toggle source

true if the response has body.

 
               # File net/http.rb, line 1983
def HTTPResponse.body_permitted?
  self::HAS_BODY
end

Public Instance Methods

body() click to toggle source

Returns the entity body.

Calling this method a second or subsequent time will return the already read string.

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.rb, line 2403
def body
  read_body()
end
Also aliased as: entity
body=(value) click to toggle source

Because it may be necessary to modify the body, Eg, decompression this method facilitates that.

 
               # File net/http.rb, line 2409
def body=(value)
  @body = value
end
entity() click to toggle source
Alias for: body
inspect() click to toggle source 
 
               # File net/http.rb, line 2276
def inspect
  "#<#{self.class} #{@code} #{@message} readbody=#{@read}>"
end
read_body(dest = nil, &block) click to toggle source

Gets entity body. If the block given, yields it to block. The body is provided in fragments, as it is read in from the socket.

Calling this method a second or subsequent time will return the already read string.

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.rb, line 2371
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
to_ary() click to toggle source

For backward compatibility. To allow Net::HTTP 1.1 style assignment e.g.

response, body = Net::HTTP.get(....)
 
               # File net/http.rb, line 2285
def to_ary
  warn "net/http.rb: warning: Net::HTTP v1.1 style assignment found at #{caller(1)[0]}; use `response = http.get(...)' instead." if $VERBOSE
  res = self.dup
  class << res
    undef to_ary
  end
  [res, res.body]
end
value() click to toggle source

Raises HTTP error if the response is not 2xx.

 
               # File net/http.rb, line 2311
def value
  error! unless self.kind_of?(HTTPSuccess)
end

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please see Improve the docs, or visit Documenting-ruby.org.

blog comments powered by Disqus