首页 > 后端开发 > Golang > 正文

如何在Golang中实现RESTful API

P粉602998670
发布: 2025-10-20 17:51:02
原创
783人浏览过
答案:Golang中实现RESTful API可通过标准库net/http或第三方库gorilla/mux;使用net/http注册路由、处理请求响应,结合json包解析数据;gorilla/mux支持路径变量和方法匹配,提升路由控制灵活性;需设置正确Content-Type,处理JSON编解码及错误;可引入中间件优化日志、认证等功能。

如何在golang中实现restful api

在Golang中实现RESTful API主要依赖标准库net/http,也可以结合第三方路由库如gorilla/mux或轻量框架如gin来提升开发效率。核心思路是通过HTTP方法(GET、POST、PUT、DELETE等)对资源进行操作。下面介绍使用标准库和<code>gorilla/mux两种方式。

使用 net/http 标准库

Go的net/http包足够强大,可以不依赖外部库构建RESTful服务。

基本结构:

  • 定义路由:使用http.HandleFunc注册路径和处理函数
  • 解析请求:读取URL参数、查询参数或JSON请求体
  • 返回响应:设置状态码并输出JSON数据
示例代码:
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 getUser(w http.ResponseWriter, r *http.Request) {
    id := r.URL.Query().Get("id")
    var user User
    for _, u := range users {
        if string(rune(u.ID)) == id {
            user = u
            break
        }
    }
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(user)
}

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) {
        switch r.Method {
        case "GET":
            getUsers(w, r)
        case "POST":
            createUser(w, r)
        default:
            http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        }
    })

    log.Println("Server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}
登录后复制

使用 gorilla/mux 路由库

gorilla/mux提供更灵活的路由控制,支持路径变量、正则匹配等。

立即学习go语言免费学习笔记(深入)”;

安装:

PHP5 和 MySQL 圣经
PHP5 和 MySQL 圣经

本书是全面讲述PHP与MySQL的经典之作,书中不但全面介绍了两种技术的核心特性,还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性,书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验,可用于解决开发者在实际中所面临的各种挑战。

PHP5 和 MySQL 圣经 466
查看详情 PHP5 和 MySQL 圣经
go get github.com/gorilla/mux
登录后复制

改进版示例:

package main

import (
    "encoding/json"
    "log"
    "net/http"
    "github.com/gorilla/mux"
)

func getUser(w http.ResponseWriter, r *http.Request) {
    vars := mux.Vars(r)
    id := vars["id"]
    // 根据 id 查找用户并返回
    user := User{ID: 1, Name: "Alice"} // 简化示例
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(user)
}

func main() {
    r := mux.NewRouter()
    r.HandleFunc("/users", getUsers).Methods("GET")
    r.HandleFunc("/users", createUser).Methods("POST")
    r.HandleFunc("/users/{id}", getUser).Methods("GET")
    r.HandleFunc("/users/{id}", updateUser).Methods("PUT")
    r.HandleFunc("/users/{id}", deleteUser).Methods("DELETE")

    log.Println("Server on :8080")
    log.Fatal(http.ListenAndServe(":8080", r))
}
登录后复制

处理JSON与错误

确保请求体正确解析,响应头设置Content-Type: application/json

  • 使用json.Marshaljson.Unmarshal处理数据
  • 检查解码错误,避免程序崩溃
  • 统一返回错误格式,例如:{"error": "invalid request"}

中间件与结构优化

可引入日志、认证、CORS等中间件增强功能。

将handler分离到独立包,使用服务层和数据层解耦逻辑,便于测试和维护。

基本上就这些。用标准库适合简单项目,追求效率可用ginecho,但理解net/http是基础。

以上就是如何在Golang中实现RESTful API的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号