
本教程将详细介绍如何在 go 语言的 `net/http` 包中获取传入 http 请求的请求方法(如 get, post)和完整的请求 uri。通过 `http.request` 结构体中的 `method` 和 `requesturi` 字段,开发者可以轻松访问这些关键的请求信息,从而实现更精细的请求处理逻辑,并提供一个完整的示例。
Go 语言的 net/http 包是构建 Web 服务的核心组件,它提供了处理 HTTP 请求和响应的强大功能。在处理客户端发来的请求时,经常需要获取请求的具体方法(例如 GET、POST、PUT 等)以及请求的完整 URI 字符串。这些信息都封装在 http.Request 结构体中,开发者可以方便地访问。
获取请求方法
http.Request 结构体提供了一个名为 Method 的字段,用于存储客户端发送请求时使用的 HTTP 方法。这是一个字符串类型,其值通常为大写的 HTTP 方法名称,如 "GET", "POST", "PUT", "DELETE" 等。
示例代码:
package main
import (
"fmt"
"net/http"
)
func myHandler(w http.ResponseWriter, r *http.Request) {
// 获取请求方法
requestMethod := r.Method
fmt.Fprintf(w, "请求方法: %s\n", requestMethod)
}
func main() {
http.HandleFunc("/", myHandler)
// 启动 HTTP 服务器
// log.Fatal(http.ListenAndServe(":8080", nil)) // 实际应用中会使用 log.Fatal
}在上述 myHandler 函数中,r.Method 将直接返回当前请求的 HTTP 方法。
获取请求 URI
http.Request 结构体还提供了一个名为 RequestURI 的字段,用于获取客户端在请求行中发送的原始 URI 字符串。这个字符串包含了路径和查询参数(如果存在),但不会包含协议、主机名和端口。
示例代码:
package main
import (
"fmt"
"net/http"
)
func myHandler(w http.ResponseWriter, r *http.Request) {
// 获取请求 URI 字符串
requestURI := r.RequestURI
fmt.Fprintf(w, "请求URI: %s\n", requestURI)
}
func main() {
http.HandleFunc("/", myHandler)
// 启动 HTTP 服务器
// log.Fatal(http.ListenAndServe(":8080", nil))
}例如,如果客户端请求 http://localhost:8080/users?id=123,那么 r.RequestURI 将会是 "/users?id=123"。
RequestURI 与 URL 字段的区别:
虽然 RequestURI 提供了原始的请求 URI 字符串,但在实际开发中,更常用的是 http.Request 结构体中的 URL 字段。URL 字段是一个指向 url.URL 结构体的指针,它包含了经过解析的 URI 组件,如路径 (URL.Path)、查询参数 (URL.RawQuery 或 URL.Query())、主机 (URL.Host) 等。
例如,对于 http://localhost:8080/users?id=123 这个请求:
- r.RequestURI 会是 "/users?id=123"
- r.URL.Path 会是 "/users"
- r.URL.RawQuery 会是 "id=123"
- r.URL.Query().Get("id") 会是 "123"
通常,当需要对 URI 的各个部分进行逻辑判断或参数提取时,使用 r.URL 字段及其子字段会更加方便和健壮。RequestURI 主要用于需要访问原始、未经解析的 URI 字符串的特定场景。
完整示例
下面是一个完整的 Go HTTP 服务器示例,展示了如何同时获取请求方法和请求 URI,并简要提及了 URL 字段的常用解析功能。
package main
import (
"fmt"
"log"
"net/http"
)
// handler 函数处理所有传入的 HTTP 请求
func handler(w http.ResponseWriter, req *http.Request) {
// 1. 获取请求方法
fmt.Fprintf(w, "请求方法: %s\n", req.Method)
// 2. 获取原始请求 URI 字符串
fmt.Fprintf(w, "原始请求URI: %s\n", req.RequestURI)
// 3. 演示通过 req.URL 字段获取解析后的 URI 组件
fmt.Fprintf(w, "解析后的路径 (req.URL.Path): %s\n", req.URL.Path)
fmt.Fprintf(w, "解析后的查询字符串 (req.URL.RawQuery): %s\n", req.URL.RawQuery)
// 获取特定查询参数
if id := req.URL.Query().Get("id"); id != "" {
fmt.Fprintf(w, "查询参数 'id': %s\n", id)
}
}
func main() {
// 注册处理函数,所有路径都由 handler 函数处理
http.HandleFunc("/", handler)
fmt.Println("HTTP 服务器正在监听 :8080...")
// 启动 HTTP 服务器,监听所有接口的 8080 端口
// log.Fatal 会在 ListenAndServe 返回错误时打印错误并退出程序
log.Fatal(http.ListenAndServe(":8080", nil))
}如何运行和测试:
- 将上述代码保存为 main.go。
- 打开终端,导航到文件所在目录。
- 运行 go run main.go。
- 打开浏览器或使用 curl 工具访问:
- http://localhost:8080/
- http://localhost:8080/hello
- http://localhost:8080/users?id=42&name=test
- 使用 curl -X POST http://localhost:8080/submit (或任何其他方法)
你将看到服务器返回的响应中包含了请求方法、原始 URI 以及解析后的路径和查询参数。
注意事项
- http.Request 结构体: 所有的请求信息都封装在 http.Request 结构体中。在 http.Handler 或 http.HandlerFunc 中,这个结构体作为参数 r (或 req) 传入。
- Method 字段: 总是返回大写的 HTTP 方法名称。
- RequestURI 字段: 返回客户端发送的原始 URI 字符串,包括路径和查询参数。它是一个未经 Go 服务器解析的原始字符串。
- URL 字段: req.URL 字段是 *url.URL 类型,提供了更结构化和易于操作的 URI 组件。对于大多数业务逻辑,推荐使用 req.URL.Path 和 req.URL.Query() 来获取路径和查询参数。
- 错误处理: 在实际应用中,http.ListenAndServe 应该进行错误检查,通常使用 log.Fatal 来处理启动服务器失败的情况。
总结
通过 http.Request 结构体中的 Method 和 RequestURI 字段,Go 语言的 net/http 包提供了直接访问 HTTP 请求方法和原始 URI 字符串的能力。同时,req.URL 字段提供了对 URI 各个组件的更精细的解析和访问方式,适用于更复杂的请求处理场景。理解这些字段的用途和区别,能够帮助开发者更高效、准确地构建健壮的 Go Web 服务。










