Go-RESTful 是一种流行的 Web 服务框架,它允许开发人员使用 REST(Representational State Transfer)架构风格构建 API。在 Go-RESTful 中,请求和响应是非常重要的概念。请求是客户端发送给服务器的数据,而响应是服务器返回给客户端的数据。
处理 HTTP 请求
在 Go-RESTful 中,可以使用路由来处理 HTTP 请求。路由是将 HTTP 请求映射到相应处理程序的机制。通常,路由由请求方法(GET、POST、PUT 等)和路径组成。
以下是一个简单的路由处理程序示例,它处理 GET 请求并返回一个字符串:
代码语言:javascript复制func helloHandler(req *restful.Request, res *restful.Response) {
res.Write([]byte("Hello, world!"))
}
func main() {
ws := new(restful.WebService)
ws.Route(ws.GET("/hello").To(helloHandler))
restful.Add(ws)
http.ListenAndServe(":8080", nil)
}
在这个示例中,我们使用 restful.WebService
创建一个新的 Web 服务。然后,我们使用 ws.Route()
方法为该服务添加一个路由,该路由将 GET 请求映射到 helloHandler
处理程序。最后,我们使用 restful.Add()
将服务添加到 HTTP 服务器中。
解析请求体和查询参数
在处理 HTTP 请求时,有时需要从请求中提取数据。在 Go-RESTful 中,您可以使用 Request
对象来访问请求体和查询参数。
以下是一个示例,演示如何解析 POST 请求中的 JSON 数据:
代码语言:javascript复制type Person struct {
Name string `json:"name"`
Age int `json:"age"`
}
func createPersonHandler(req *restful.Request, res *restful.Response) {
person := new(Person)
err := req.ReadEntity(person)
if err != nil {
res.WriteError(http.StatusInternalServerError, err)
return
}
// 保存 Person 对象到数据库
res.Write([]byte("Person created!"))
}
func main() {
ws := new(restful.WebService)
ws.Route(ws.POST("/people").To(createPersonHandler))
restful.Add(ws)
http.ListenAndServe(":8080", nil)
}
在这个示例中,我们定义了一个名为 Person
的结构体,它表示一个人的姓名和年龄。然后,我们编写了一个名为 createPersonHandler
的处理程序,它使用 req.ReadEntity()
方法从请求体中解析 JSON 数据并将其解析为 Person
对象。如果解析失败,我们使用 res.WriteError()
方法返回一个 HTTP 500 错误。最后,我们返回一个字符串表示 Person 对象已成功创建。
除了请求体外,还可以使用 Request
对象来访问查询参数。查询参数是在 URL 中传递的键值对,例如 https://example.com/search?q=go restful
中的 q=go restful
。
以下是一个示例,演示如何从查询参数中提取数据:
代码语言:javascript复制func searchHandler(req *restful.Request, res *restful.Response) {
query := req.QueryParameter("q")
// 在数据库中执行搜索操作
res.Write([]byte("Search results for: " query))
}
func main() {
ws := new(restful.WebService)
ws.Route(ws.GET("/search").To(searchHandler))
restful.Add(ws)
http.ListenAndServe(":8080", nil)
}
在这个示例中,我们编写了一个名为 searchHandler
的处理程序,它使用 req.QueryParameter()
方法从查询参数中提取查询字符串 q
的值。然后,我们使用提取的值在数据库中执行搜索操作,并将结果返回给客户端。