Go net/http 包：获取 HTTP 请求方法与 URI

本教程将详细介绍如何在 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 字段的区别：

达芬奇

达芬奇——你的AI创作大师

144

查看详情

虽然 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))
}

如何运行和测试：

1. 将上述代码保存为 main.go。
2. 打开终端，导航到文件所在目录。
3. 运行 go run main.go。
4. 打开浏览器或使用 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 服务。

以上就是Go net/http 包：获取 HTTP 请求方法与 URI的详细内容，更多请关注php中文网其它相关文章！