0

0

如何使用 Golang 编写一个 JSON 接口服务器_Golang RESTful API 实战演练

P粉602998670

P粉602998670

发布时间:2025-11-16 16:00:10

|

357人浏览过

|

来源于php中文网

原创

答案:使用Golang标准库构建RESTful API,实现用户管理的增删改查功能。通过net/http处理路由与请求,encoding/json解析数据,sync.Mutex保障并发安全,以map模拟存储,创建、读取、更新和删除用户,并用curl测试接口,展示轻量高效的JSON服务实现过程。

如何使用 golang 编写一个 json 接口服务器_golang restful api 实战演练

构建一个 JSON 接口服务器是 Golang 的常见应用场景。它轻量、高效,非常适合编写 RESTful API。下面通过一个简单的实战示例,带你一步步实现一个支持增删改查(CRUD)的用户管理接口。

初始化项目结构

创建项目目录并初始化模块:

mkdir go-rest-api
cd go-rest-api
go mod init go-rest-api

我们不依赖第三方框架,仅使用标准库 net/http 和 encoding/json,保持简洁。

定义数据模型和存储

创建一个 User 结构体,并使用 map 模拟内存存储:

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

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

用 map 存储用户数据,配合互斥锁保证并发安全:

var (
  users = make(map[int]User)
  mu   = sync.Mutex{}
  nextID = 1
)

编写处理函数

每个 HTTP 请求对应一个处理函数。这些函数需满足 http.HandlerFunc 签名。

获取所有用户

viable
viable

基于GPT-4的AI非结构化数据分析平台

下载
func getUsers(w http.ResponseWriter, r *http.Request) {
  mu.Lock()
  defer mu.Unlock()
  
  var result []User
  for _, u := range users {
    result = append(result, u)
  }
  
  w.Header().Set("Content-Type", "application/json")
  json.NewEncoder(w).Encode(result)
}

创建用户

func createUser(w http.ResponseWriter, r *http.Request) {
  if r.Method != http.MethodPost {
    http.Error(w, "只允许 POST 方法", http.StatusMethodNotAllowed)
    return
  }
  
  var user User
  if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
    http.Error(w, err.Error(), http.StatusBadRequest)
    return
  }
  
  mu.Lock()
  defer mu.Unlock()
  
  user.ID = nextID
  nextID++
  users[user.ID] = user
  
  w.Header().Set("Content-Type", "application/json")
  w.WriteHeader(http.StatusCreated)
  json.NewEncoder(w).Encode(user)
}

获取单个用户

func getUser(w http.ResponseWriter, r *http.Request) {
  id, _ := strconv.Atoi(r.URL.Path[len("/users/"):])
  mu.Lock()
  defer mu.Unlock()
  
  user, exists := users[id]
  if !exists {
    http.Error(w, "用户不存在", http.StatusNotFound)
    return
  }
  
  w.Header().Set("Content-Type", "application/json")
  json.NewEncoder(w).Encode(user)
}

更新和删除用户 可以类似实现,分别使用 PUT 和 DELETE 方法,解析路径中的 ID 并操作 map。

注册路由并启动服务器

在 main 函数中设置路由并监听端口

func main() {
  http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) {
    if r.Method == http.MethodGet {
      getUsers(w, r)
    } else if r.Method == http.MethodPost {
      createUser(w, r)
    }
  })
  
  http.HandleFunc("/users/", func(w http.ResponseWriter, r *http.Request) {
    if r.Method == http.MethodGet {
      getUser(w, r)
    }
  })
  
  fmt.Println("服务器启动在 :8080")
  log.Fatal(http.ListenAndServe(":8080", nil))
}

运行服务后,可用 curl 测试:

curl -X POST http://localhost:8080/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@example.com"}'

基本上就这些。这个例子展示了如何用 Go 标准库快速搭建一个可用的 JSON 接口服务。虽然没有使用 Gin 或 Echo 等框架,但理解底层机制有助于写出更可控的代码。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

173

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

224

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

334

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

204

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

387

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

193

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

184

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

苹果官网入口直接访问
苹果官网入口直接访问

苹果官网直接访问入口是https://www.apple.com/cn/,该页面具备0.8秒首屏渲染、HTTP/3与Brotli加速、WebP+AVIF双格式图片、免登录浏览全参数等特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

10

2025.12.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 7.9万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

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