项目推进,需要实现在rails服务器后台通过http请求访问url来获取必要的信息。我们选择使用typhoeus来实现这一功能。
github:https://github.com/typhoeus/typhoeus
开发前需明确的问题
- 我们需要实现怎样得功能?
- Typhoeus 实现了怎样的功能?
- Typhoeus 提供了哪些接口?
问题解决
需要实现的功能
我们需要通过在rails后台实现http请求,附带参数,请求后获得该http响应。例如我们有一个get携带参数请求,访问一个url后获得返回的参数。
Typhoeus 提供的功能
明确了我们的需求后,我们再来看看这个gem能为我们提供怎样的功能。
The primary interface for Typhoeus is comprised of three classes: Request, Response, and Hydra. Request represents an HTTP request object, response represents an HTTP response, and Hydra manages making parallel HTTP connections.
我们可以看到,typhoeus为我们提供了三个基本接口,分别是Request、Response和Hydra这三个类。其中Request对应http请求,response对应http相应,而hydra则产生并发http连接。根据我们的需求,我们暂时并不需要并发http连接,因而暂时不对Hydra进行了解,主要了解request和response这两个功能。
Typhoeus 提供的部分接口
- Request接口
request = Typhoeus::Request.new(
"www.example.com",
method: :post,
body: "this is a request body",
params: { field1: "a field" },
headers: { Accept: "text/html" }
)
第一个参数是一个url,之后的参数都是可选的,默认的:method
方法是:get
.
:params
用来发送url参数,:body
则是作为请求实体的(:body
is for the request body)。
- 请求运行
request.run
- response
response = request.response
response.code
response.total_time
response.headers
response.body
response只有在请求运行后才能执行。
- 快速请求接口
Typhoeus.get("www.example.com")
Typhoeus.head("www.example.com")
Typhoeus.put("www.example.com/posts/1", body: "whoo, a body")
Typhoeus.patch("www.example.com/posts/1", body: "a new body")
Typhoeus.post("www.example.com/posts", body: { title: "test post", content: "this is my test"})
Typhoeus.delete("www.example.com/posts/1")Typhoeus.options("www.example.com")
- 请求错误处理接口
request = Typhoeus::Request.new("www.example.com", followlocation: true)
request.on_complete do |response|
if response.success?
# hell yeah
elsif response.timed_out?
# aw hell no
log("got a time out")
elsif response.code == 0
# Could not get an http response, something's wrong.
log(response.return_message)
else
# Received a non-successful http response.
log("HTTP request failed: " + response.code.to_s)
end
end
request.run
除了这些接口,typhoeus还提供了很多接口,包括并行连接的Hydra接口,使用代理连接的接口,处理文件上传的接口等等,可以看出,typhoeus是一个功能很强大的gem,这里不对其它接口再进行详述,具体可以参见github.
typhoeus 实现流程
- 安装typhoeus
gem "typhoeus"
- 调用Request
request = Typhoeus::Request.new(url)
- 运行request
request.run
- 获得响应response
response = request.response
- 获得响应中的信息
response.code
response.total_time
response.headers
response.body
总结
typhoeus是一个功能强大而且很方便的处理http连接的gem,实现后台http请求也是很方便的。