Ruby `Net::HTTP` 使用指南

1. 安装指南

Net::HTTP 是 Ruby 标准库的一部分，因此无需额外安装。只需确保你已经安装了 Ruby 环境，即可直接使用 Net::HTTP 进行 HTTP 请求。

2. 项目使用说明

Net::HTTP 是 Ruby 中用于发送 HTTP 请求的标准库。虽然它功能强大，但在现代开发中，使用 Net::HTTP 直接进行 HTTP 请求的场景已经较少，推荐使用更简洁的第三方库，如 RestClient。

2.1 基本使用

以下是使用 Net::HTTP 发送 GET 请求的示例：

require 'net/http'

uri = URI('http://example.com/index.html')
response = Net::HTTP.get_response(uri)

puts response.body

2.2 发送 POST 请求

以下是使用 Net::HTTP 发送 POST 请求的示例：

require 'net/http'

uri = URI('http://example.com/index.html')
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.path)
request.set_form_data('key1' => 'value1', 'key2' => 'value2')

response = http.request(request)
puts response.body

3. 项目 API 使用文档

3.1 GET 请求

Net::HTTP.get(URI('http://example.com/index.html'))

3.2 POST 请求

uri = URI('http://example.com/index.html')
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.path)
request.set_form_data('key1' => 'value1', 'key2' => 'value2')

response = http.request(request)

3.3 文件上传

使用 Net::HTTP 进行文件上传较为复杂，建议使用 RestClient 等第三方库。以下是使用 Net::HTTP 进行文件上传的示例：

BOUNDARY = "AaB03x"

uri = URI.parse("http://something.com/uploads")
file = "/path/to/your/testfile.txt"

post_body = []
post_body << "--#{BOUNDARY}\r\n"
post_body << "Content-Disposition: form-data; name=\"datafile\"; filename=\"#{File.basename(file)}\"\r\n"
post_body << "Content-Type: text/plain\r\n"
post_body << "\r\n"
post_body << File.read(file)
post_body << "\r\n--#{BOUNDARY}--\r\n"

http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.request_uri)
request.body = post_body.join
request["Content-Type"] = "multipart/form-data, boundary=#{BOUNDARY}"

http.request(request)

4. 项目安装方式

由于 Net::HTTP 是 Ruby 标准库的一部分，因此无需安装。只需确保你已经安装了 Ruby 环境，即可直接使用 Net::HTTP。

4.1 安装 Ruby

如果你还没有安装 Ruby，可以通过以下方式安装：

• macOS/Linux: 使用 rbenv 或 rvm 安装 Ruby。
• Windows: 下载并安装 RubyInstaller。

安装完成后，通过以下命令验证 Ruby 是否安装成功：

ruby -v

如果显示 Ruby 版本号，则表示安装成功。

总结

Net::HTTP 是 Ruby 中用于发送 HTTP 请求的标准库，虽然功能强大，但在现代开发中，推荐使用更简洁的第三方库，如 RestClient。通过本指南，你可以快速上手 Net::HTTP 的基本使用，并了解如何发送 GET 和 POST 请求。