class Net::HTTPResponse

此类是 Net::HTTP 响应类的基类。

关于示例

此处的示例假设已加载 net/http（这也将加载 uri）

require 'net/http'

这里的许多代码示例都使用了这些示例网站

• jsonplaceholder.typicode.com.

• example.com.

一些示例还假定存在这些变量

uri = URI('https://jsonplaceholder.typicode.com/')
uri.freeze # Examples may not modify.
hostname = uri.hostname # => "jsonplaceholder.typicode.com"
path = uri.path         # => "/"
port = uri.port         # => 443

因此，示例请求可以这样编写

Net::HTTP.get(uri)
Net::HTTP.get(hostname, '/index.html')
Net::HTTP.start(hostname) do |http|
  http.get('/todos/1')
  http.get('/todos/2')
end

需要修改 URI 的示例首先复制 uri，然后修改副本

_uri = uri.dup
_uri.path = '/todos/1'

返回的响应

方法 Net::HTTP.get_response 返回 Net::HTTPResponse 的某个子类的实例

Net::HTTP.get_response(uri)
# => #<Net::HTTPOK 200 OK readbody=true>
Net::HTTP.get_response(hostname, '/nosuch')
# => #<Net::HTTPNotFound 404 Not Found readbody=true>

方法 Net::HTTP#request 也是如此

req = Net::HTTP::Get.new(uri)
Net::HTTP.start(hostname) do |http|
  http.request(req)
end # => #<Net::HTTPOK 200 OK readbody=true>

类 Net::HTTPResponse 包含模块 Net::HTTPHeader，该模块通过（除其他外）提供对响应头值的访问

• 类哈希方法 []。

• 特定的读取器方法，例如 content_type。

示例

res = Net::HTTP.get_response(uri) # => #<Net::HTTPOK 200 OK readbody=true>
res['Content-Type']               # => "text/html; charset=UTF-8"
res.content_type                  # => "text/html"

响应子类

类 Net::HTTPResponse 为每个 HTTP 状态码都有一个子类。您可以查找给定状态码的响应类

Net::HTTPResponse::CODE_TO_OBJ['200'] # => Net::HTTPOK
Net::HTTPResponse::CODE_TO_OBJ['400'] # => Net::HTTPBadRequest
Net::HTTPResponse::CODE_TO_OBJ['404'] # => Net::HTTPNotFound

并且您可以检索响应对象的状​​态码

Net::HTTP.get_response(uri).code                 # => "200"
Net::HTTP.get_response(hostname, '/nosuch').code # => "404"

响应子类（缩进显示类层次结构）

• Net::HTTPUnknownResponse（用于未处理的 HTTP 扩展）。

• Net::HTTPInformation:

  • Net::HTTPContinue (100)

  • Net::HTTPSwitchProtocol (101)

  • Net::HTTPProcessing (102)

  • Net::HTTPEarlyHints (103)

• Net::HTTPSuccess:

  • Net::HTTPOK (200)

  • Net::HTTPCreated (201)

  • Net::HTTPAccepted (202)

  • Net::HTTPNonAuthoritativeInformation (203)

  • Net::HTTPNoContent (204)

  • Net::HTTPResetContent (205)

  • Net::HTTPPartialContent (206)

  • Net::HTTPMultiStatus (207)

  • Net::HTTPAlreadyReported (208)

  • Net::HTTPIMUsed (226)

• Net::HTTPRedirection:

  • Net::HTTPMultipleChoices (300)

  • Net::HTTPMovedPermanently (301)

  • Net::HTTPFound (302)

  • Net::HTTPSeeOther (303)

  • Net::HTTPNotModified (304)

  • Net::HTTPUseProxy (305)

  • Net::HTTPTemporaryRedirect (307)

  • Net::HTTPPermanentRedirect (308)

• Net::HTTPClientError:

  • Net::HTTPBadRequest (400)

  • Net::HTTPUnauthorized (401)

  • Net::HTTPPaymentRequired (402)

  • Net::HTTPForbidden (403)

  • Net::HTTPNotFound (404)

  • Net::HTTPMethodNotAllowed (405)

  • Net::HTTPNotAcceptable (406)

  • Net::HTTPProxyAuthenticationRequired (407)

  • Net::HTTPRequestTimeOut (408)

  • Net::HTTPConflict (409)

  • Net::HTTPGone (410)

  • Net::HTTPLengthRequired (411)

  • Net::HTTPPreconditionFailed (412)

  • Net::HTTPRequestEntityTooLarge (413)

  • Net::HTTPRequestURITooLong (414)

  • Net::HTTPUnsupportedMediaType (415)

  • Net::HTTPRequestedRangeNotSatisfiable (416)

  • Net::HTTPExpectationFailed (417)

  • Net::HTTPMisdirectedRequest (421)

  • Net::HTTPUnprocessableEntity (422)

  • Net::HTTPLocked (423)

  • Net::HTTPFailedDependency (424)

  • Net::HTTPUpgradeRequired (426)

  • Net::HTTPPreconditionRequired (428)

  • Net::HTTPTooManyRequests (429)

  • Net::HTTPRequestHeaderFieldsTooLarge (431)

  • Net::HTTPUnavailableForLegalReasons (451)

• Net::HTTPServerError:

  • Net::HTTPInternalServerError (500)

  • Net::HTTPNotImplemented (501)

  • Net::HTTPBadGateway (502)

  • Net::HTTPServiceUnavailable (503)

  • Net::HTTPGatewayTimeOut (504)

  • Net::HTTPVersionNotSupported (505)

  • Net::HTTPVariantAlsoNegotiates (506)

  • Net::HTTPInsufficientStorage (507)

  • Net::HTTPLoopDetected (508)

  • Net::HTTPNotExtended (510)

  • Net::HTTPNetworkAuthenticationRequired (511)

还有一个 Net::HTTPBadResponse 异常，当出现协议错误时会引发该异常。