类 Net::HTTPRequest

此类是 Net::HTTP 请求类的基类。不应直接使用此类；而应使用其子类，如下所示。

创建请求¶ ↑

可以使用 URI 或字符串主机名创建请求对象

require 'net/http'
uri = URI('https://jsonplaceholder.typicode.com/')
req = Net::HTTP::Get.new(uri)          # => #<Net::HTTP::Get GET>
req = Net::HTTP::Get.new(uri.hostname) # => #<Net::HTTP::Get GET>

以及任何子类

req = Net::HTTP::Head.new(uri) # => #<Net::HTTP::Head HEAD>
req = Net::HTTP::Post.new(uri) # => #<Net::HTTP::Post POST>
req = Net::HTTP::Put.new(uri)  # => #<Net::HTTP::Put PUT>
# ...

新实例适合用作 Net::HTTP#request 的参数。

请求头¶ ↑

默认情况下，新的请求对象具有以下头字段

req.to_hash
# =>
{"accept-encoding"=>["gzip;q=1.0,deflate;q=0.6,identity;q=0.3"],
"accept"=>["*/*"],
"user-agent"=>["Ruby"],
"host"=>["jsonplaceholder.typicode.com"]}

参见

您可以添加头或覆盖默认头

#   res = Net::HTTP::Get.new(uri, {'foo' => '0', 'bar' => '1'})

此类（及其子类）还包含（间接）模块 Net::HTTPHeader，它提供对其设置头的方法的访问。

请求子类¶ ↑

HTTP 请求的子类

WebDAV 请求的子类

公共类方法

new(path, initheader = nil) 点击切换源代码

为 path 创建一个 HTTP 请求对象。

initheader 是要使用的默认头。 Net::HTTP 添加 Accept-Encoding 以启用对响应主体进行压缩，除非在 initheader 中提供了 Accept-Encoding 或 Range。

调用超类方法 BasicObject::new

# File lib/net/http/request.rb, line 82
def initialize(path, initheader = nil)
  super self.class::METHOD,
        self.class::REQUEST_HAS_BODY,
        self.class::RESPONSE_HAS_BODY,
        path, initheader
end