Go語言使用net/http構(gòu)建一個(gè)RESTful?API的示例代碼
引言
Go 的標(biāo)準(zhǔn)庫 net/http 提供了構(gòu)建 Web 服務(wù)所需的強(qiáng)大功能。雖然眾多第三方框架(如 Gin、Echo)已經(jīng)封裝了很多功能,但如果你真正想理解 Go 的底層 Web 服務(wù)機(jī)制,那么使用 net/http 實(shí)現(xiàn)一個(gè)原生的 RESTful API 是最好的入門方式。
本文將通過一個(gè)實(shí)戰(zhàn)案例:構(gòu)建一個(gè)用戶信息管理 API,帶你從零開始打造 RESTful 服務(wù)。
一、什么是 RESTful API?
REST(Representational State Transfer)是一種軟件架構(gòu)風(fēng)格,常用于 Web API 的設(shè)計(jì)。
常見 HTTP 方法與操作語義:
| 方法 | 語義 | 說明 |
|---|---|---|
| GET | 獲取資源 | 讀取某個(gè)資源的內(nèi)容 |
| POST | 創(chuàng)建資源 | 向服務(wù)器添加新資源 |
| PUT | 更新資源 | 修改已有資源 |
| DELETE | 刪除資源 | 移除某個(gè)資源 |
二、實(shí)戰(zhàn)目標(biāo):用戶信息管理 API
我們將構(gòu)建以下功能的 API:
GET /users:獲取用戶列表GET /users/{id}:獲取指定用戶POST /users:創(chuàng)建新用戶PUT /users/{id}:更新用戶DELETE /users/{id}:刪除用戶
三、代碼實(shí)現(xiàn)
1. 用戶數(shù)據(jù)結(jié)構(gòu)
package main
import (
"encoding/json"
"fmt"
"log"
"math/rand"
"net/http"
"strconv"
"strings"
"sync"
)
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Age int `json:"age"`
}
var (
users = make(map[int]User)
mu sync.Mutex
)
2. 工具函數(shù):ID提取
func parseID(path string) (int, error) {
parts := strings.Split(path, "/")
if len(parts) < 3 {
return 0, fmt.Errorf("invalid path")
}
return strconv.Atoi(parts[2])
}
3. 處理函數(shù)
func usersHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
switch r.Method {
case "GET":
// 獲取所有用戶
mu.Lock()
list := make([]User, 0, len(users))
for _, user := range users {
list = append(list, user)
}
mu.Unlock()
json.NewEncoder(w).Encode(list)
case "POST":
// 創(chuàng)建用戶
var user User
if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
user.ID = rand.Intn(10000)
mu.Lock()
users[user.ID] = user
mu.Unlock()
json.NewEncoder(w).Encode(user)
default:
http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
}
}
func userHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
id, err := parseID(r.URL.Path)
if err != nil {
http.Error(w, "Invalid ID", http.StatusBadRequest)
return
}
mu.Lock()
user, exists := users[id]
mu.Unlock()
switch r.Method {
case "GET":
if !exists {
http.NotFound(w, r)
return
}
json.NewEncoder(w).Encode(user)
case "PUT":
if !exists {
http.NotFound(w, r)
return
}
var updated User
if err := json.NewDecoder(r.Body).Decode(&updated); err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
updated.ID = id
mu.Lock()
users[id] = updated
mu.Unlock()
json.NewEncoder(w).Encode(updated)
case "DELETE":
if !exists {
http.NotFound(w, r)
return
}
mu.Lock()
delete(users, id)
mu.Unlock()
w.WriteHeader(http.StatusNoContent)
default:
http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
}
}
4. 主函數(shù)啟動服務(wù)
func main() {
http.HandleFunc("/users", usersHandler)
http.HandleFunc("/users/", userHandler)
fmt.Println("服務(wù)啟動中: http://localhost:8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
四、測試方式(推薦使用 curl 或 Postman)
# 創(chuàng)建用戶
curl -X POST -H "Content-Type: application/json" \
-d '{"name":"Tom","age":25}' http://localhost:8080/users
# 獲取所有用戶
curl http://localhost:8080/users
# 獲取指定用戶
curl http://localhost:8080/users/1234
# 更新用戶
curl -X PUT -H "Content-Type: application/json" \
-d '{"name":"Jerry","age":30}' http://localhost:8080/users/1234
# 刪除用戶
curl -X DELETE http://localhost:8080/users/1234
五、總結(jié)與建議
通過本案例,我們學(xué)習(xí)了如何用 Go 原生的 net/http:
- ? 實(shí)現(xiàn) RESTful 風(fēng)格的接口
- ? 處理不同的 HTTP 方法
- ? 編解碼 JSON 數(shù)據(jù)
- ? 線程安全地管理數(shù)據(jù)結(jié)構(gòu)
雖然這個(gè)例子是最基礎(chǔ)的,但它奠定了你進(jìn)一步使用更強(qiáng)大框架(如 Gin、Echo)的基礎(chǔ)。
六、進(jìn)階推薦
- 加入中間件(如日志、認(rèn)證)
- 使用
context處理請求生命周期 - 支持 URL 參數(shù)和 Query 參數(shù)
- 使用第三方路由庫如
gorilla/mux - 數(shù)據(jù)存儲替換為數(shù)據(jù)庫(如 GORM + MySQL)
以上就是Go語言使用net/http構(gòu)建一個(gè)RESTful API的示例代碼的詳細(xì)內(nèi)容,更多關(guān)于Go net/http構(gòu)建RESTful API的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
GoLang抽獎系統(tǒng)簡易實(shí)現(xiàn)流程
這篇文章主要介紹了GoLang抽獎系統(tǒng)實(shí)現(xiàn)流程,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)吧2022-12-12
優(yōu)雅使用GoFrame共享變量Context示例詳解
這篇文章主要為大家介紹了優(yōu)雅使用GoFrame共享變量Context示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-06-06
Go語言如何利用Mutex保障數(shù)據(jù)讀寫正確
這篇文章主要介紹了互斥鎖的實(shí)現(xiàn)機(jī)制,以及?Go?標(biāo)準(zhǔn)庫的互斥鎖?Mutex?的基本使用方法,文中的示例代碼講解詳細(xì),需要的小伙伴可以參考一下2023-05-05
golang封裝一個(gè)執(zhí)行命令行的函數(shù)(return?stderr/stdout/exitcode)示例代碼
在?Go?語言中,您可以使用?os/exec?包來執(zhí)行外部命令,不通過調(diào)用?shell,并且能夠獲得進(jìn)程的退出碼、標(biāo)準(zhǔn)輸出和標(biāo)準(zhǔn)錯(cuò)誤輸出,下面給大家分享golang封裝一個(gè)執(zhí)行命令行的函數(shù)(return?stderr/stdout/exitcode)的方法,感興趣的朋友跟隨小編一起看看吧2024-06-06
Go語言中的goroutine和channel如何協(xié)同工作
在Go語言中,goroutine和channel是并發(fā)編程的兩個(gè)核心概念,它們協(xié)同工作以實(shí)現(xiàn)高效、安全的并發(fā)執(zhí)行,本文將詳細(xì)探討goroutine和channel如何協(xié)同工作,以及它們在并發(fā)編程中的作用和優(yōu)勢,需要的朋友可以參考下2024-04-04
golang構(gòu)建工具M(jìn)akefile使用詳解
這篇文章主要為大家介紹了golang構(gòu)建工具M(jìn)akefile的使用詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-07-07

