如何使用 Golang 构建 RESTful API 并处理错误？

本文展示了利用 Golang 构建 RESTful API 的步骤，包括导入必要的包、创建路由器、定义处理程序、注册路由以及启动服务器。此外，还提供了处理错误情况的说明，例如返回错误信息和正确的 HTTP 状态码。

使用 Golang 构建 RESTful API 并处理错误

在 Golang 中构建 RESTful API 既简单又高效，本文将带你逐步了解如何创建 API 并处理常见的错误场景。

1. 导入必要的包

import (
    "encoding/json"
    "fmt"
    "log"
    "net/http"

    "github.com/gorilla/mux"
)

2. 创建路由器

r := mux.NewRouter()

3. 定义处理程序

func indexHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprint(w, "Hello, World!")
}

func postHandler(w http.ResponseWriter, r *http.Request) {
    var data map[string]interface{}
    if err := json.NewDecoder(r.Body).Decode(&data); err != nil {
        http.Error(w, "Invalid JSON", http.StatusBadRequest)
        return
    }

    log.Printf("Received data: %v", data)
    json.NewEncoder(w).Encode(map[string]interface{}{"status": "success"})
}

4. 注册路由

r.HandleFunc("/", indexHandler).Methods("GET")
r.HandleFunc("/post", postHandler).Methods("POST")

5. 启动服务器

http.ListenAndServe(":8080", r)

实战案例

创建一个简单的 API 来存储和检索用户数据：

type User struct {
    Name  string `json:"name"`
    Email string `json:"email"`
}

func userHandler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        json.NewEncoder(w).Encode([]User{{Name: "John", Email: "john@example.com"}})
    case "POST":
        var user User
        if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
            http.Error(w, "Invalid JSON", http.StatusBadRequest)
            return
        }
        fmt.Fprint(w, "User created:", user)
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

然后注册路由：

r.HandleFunc("/users", userHandler)

现在，你可以使用 curl 或其他工具轻松地测试 API：

curl -X GET localhost:8080/users