Golang如何实现REST API接口-Golang-PHP中文网

Golang如何实现REST API接口

P粉602998670

发布： 2025-10-16 22:46:02

原创

354人浏览过

使用标准库或Gin可快速实现REST API：先定义数据结构和处理器，再通过路由映射HTTP方法，结合JSON序列化与状态码返回；Gin框架简化了中间件、路由和错误处理，适合高效开发。

golang如何实现rest api接口

用Golang实现REST API接口其实不难，核心是利用标准库net/http或第三方框架（如Gin、Echo）来处理HTTP请求，结合路由、控制器和数据序列化。下面以标准库和Gin两种方式说明如何快速搭建一个基础的REST API。

使用标准库 net/http 实现

Go的标准库已经足够强大，适合轻量级项目。

步骤：

导入net/http和encoding/json
定义数据结构（如User）
编写处理函数（handler），处理GET、POST等请求
注册路由并启动服务器

示例代码：

package main

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

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

var users = []User{{ID: 1, Name: "Alice"}, {ID: 2, Name: "Bob"}}

func getUsers(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(users)
}

func createUser(w http.ResponseWriter, r *http.Request) {
    var user User
    json.NewDecoder(r.Body).Decode(&user)
    users = append(users, user)
    w.WriteHeader(http.StatusCreated)
    json.NewEncoder(w).Encode(user)
}

func main() {
    http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) {
        if r.Method == "GET" {
            getUsers(w, r)
        } else if r.Method == "POST" {
            createUser(w, r)
        }
    })

    log.Println("Server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

登录后复制

使用 Gin 框架更高效

Gin是一个高性能的Web框架，简化了路由、中间件和JSON处理。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

立即学习“go语言免费学习笔记（深入）”；

安装Gin：

go get -u github.com/gin-gonic/gin

登录后复制

示例代码：

package main

import (
    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default()

    // GET /users
    r.GET("/users", func(c *gin.Context) {
        users := []map[string]interface{}{
            {"id": 1, "name": "Alice"},
            {"id": 2, "name": "Bob"},
        }
        c.JSON(200, users)
    })

    // POST /users
    r.POST("/users", func(c *gin.Context) {
        var user map[string]interface{}
        if err := c.ShouldBindJSON(&user); err != nil {
            c.JSON(400, gin.H{"error": err.Error()})
            return
        }
        c.JSON(201, user)
    })

    r.Run(":8080")
}

登录后复制

关键点说明

无论用哪种方式，注意以下几点：

路由控制：明确每个端点对应的HTTP方法（GET/POST/PUT/DELETE）
数据序列化：使用json.Marshal/Unmarshal或框架自带方法处理JSON
错误处理：检查请求体解析、数据库操作等可能出错的地方
状态码设置：如200、201、400、404等，让客户端清楚结果
跨域支持（CORS）：生产环境建议添加CORS中间件

基本上就这些。标准库适合学习和简单服务，Gin更适合实际项目开发，提升效率。

以上就是Golang如何实现REST API接口的详细内容，更多请关注php中文网其它相关文章！