在 go 中构建 restful api 的最佳实践包括：使用官方包、使用路由器、使用中间件、定义清晰的 api 路径、使用 restful 动词、处理错误、使用 json。实战案例展示了一个简单的 go restful api，用于管理人员数据。
在 Go 中构建 RESTful API 的最佳实践
在 Go 中构建 RESTful API 时，遵循最佳实践至关重要。这些实践可确保您的 API 健壮、可扩展且易于使用。以下是在 Go 中构建 RESTful API 时应遵循的一些最佳实践：
使用官方包
立即学习“go语言免费学习笔记（深入）”；
Go 标准库提供了 net/http 包来构建 HTTP 服务。建议使用此包，因为它可靠、高效且维护良好。
使用路由器
路由器负责将 HTTP 请求映射到适当的处理程序。Go 中有许多流行的路由器库，例如 gorilla/mux 和 chi。
使用中间件
中间件用于在处理程序执行前或后执行某些操作。中间件可以用于日志记录、身份验证和错误处理等任务。
定义清晰的 API 路径
您的 API 路径应清晰且易于理解。避免使用模棱两可或冗长的路径。
使用 RESTful 动词
RESTful API 通常使用 GET、POST、PUT 和 DELETE 等 RESTful 动词来表示 CRUD（创建、读取、更新、删除）操作。
处理错误
正确处理错误对于构建健壮的 API 至关重要。使用通用的错误格式，并针对常见的错误情况提供有意义的错误消息。
使用 JSON
JSON 是 API 数据交换的标准格式。建议使用 JSON 作为 API 的请求和响应格式。
实战案例
以下是一个使用 Go 构建简单 RESTful API 的示例：
package main
import (
"encoding/json"
"fmt"
"net/http"
"<a style='color:#f60; text-decoration:underline;' href="https://www.codesou.cn/" target="_blank">git</a>hub.com/gorilla/mux"
)
type Person struct {
ID int `json:"id"`
Name string `json:"name"`
}
var people []Person
func main() {
router := mux.NewRouter()
router.HandleFunc("/people", getPeople).Methods("GET")
router.HandleFunc("/people", createPerson).Methods("POST")
router.HandleFunc("/people/{id}", getPerson).Methods("GET")
router.HandleFunc("/people/{id}", updatePerson).Methods("PUT")
router.HandleFunc("/people/{id}", deletePerson).Methods("DELETE")
http.ListenAndServe(":8080", router)
}
func getPeople(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(people)
}
func createPerson(w http.ResponseWriter, r *http.Request) {
var person Person
json.NewDecoder(r.Body).Decode(&person)
people = append(people, person)
json.NewEncoder(w).Encode(person)
}
func getPerson(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
id := params["id"]
for _, person := range people {
if person.ID == id {
json.NewEncoder(w).Encode(person)
return
}
}
http.Error(w, "Not found", 404)
}
func updatePerson(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
id := params["id"]
var person Person
json.NewDecoder(r.Body).Decode(&person)
for i, p := range people {
if p.ID == id {
people[i] = person
json.NewEncoder(w).Encode(person)
return
}
}
http.Error(w, "Not found", 404)
}
func deletePerson(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
id := params["id"]
for i, person := range people {
if person.ID == id {
people = append(people[:i], people[i+1:]...)
w.WriteHeader(http.StatusNoContent)
return
}
}
http.Error(w, "Not found", 404)
}
该示例提供了一个简单的 RESTful API，用于管理人员数据。您可以使用该示例作为构建自己的 API 的基础。
