0

0

Golang如何实现简单的JSON API服务

P粉602998670

P粉602998670

发布时间:2025-09-30 19:14:02

|

817人浏览过

|

来源于php中文网

原创

答案:使用Golang标准库net/http和encoding/json可快速构建JSON API服务。定义User结构体并用json标签指定字段名,通过http.HandleFunc注册/user和/health路由,分别返回JSON数据和健康检查响应。在处理函数中设置Content-Type为application/json,利用json.NewEncoder将结构体编码为JSON输出。支持GET请求获取用户信息,也可扩展POST请求解析JSON输入,使用json.NewDecoder解码请求体并返回创建结果。启动服务监听8080端口,通过curl或浏览器测试接口正常返回数据。

golang如何实现简单的json api服务

用Golang实现一个简单的JSON API服务并不复杂,核心是使用标准库中的 net/httpencoding/json。下面是一个完整的示例,展示如何创建一个返回JSON数据的HTTP服务。

1. 定义数据结构和路由处理函数

先定义一个结构体来表示要返回的数据,并编写处理请求的函数:

package main

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

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

func getUser(w http.ResponseWriter, r *http.Request) { user := User{ ID: 1, Name: "Alice", Email: "alice@example.com", }

w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(user)

}

说明:
- 使用 json: 标签控制字段在JSON中的名称。
- 设置响应头为 application/json,确保客户端正确解析。
- 使用 json.NewEncoder(w).Encode() 直接将结构体写入响应流。

2. 启动HTTP服务器并注册路由

在 main 函数中设置路由并启动服务:

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

func main() {
    http.HandleFunc("/user", getUser)
http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("OK"))
})

println("Server is running on :8080")
http.ListenAndServe(":8080", nil)

}

说明:
- 使用 http.HandleFunc 注册路径与处理函数的映射。
- 添加一个简单的健康检查接口 /health,用于测试服务是否正常。
- 调用 ListenAndServe 启动服务器,默认监听本地8080端口

3. 测试API

运行程序后,打开终端或浏览器测试:

有一导航
有一导航

有一导航延续了美国Groupon网站一贯的简约风格和购物流程,致力于打造中国本土化的精品消费限时团购网站,您会发现网站的页面非常简单,简单到每天只有一款产品。 产品通常不是实物,而是生活消费领域的各类服务型产品,比如服装、饰品、数码、化妆品、培训、健身等各类商品,用户只需在线购买,三分钟就可轻松买到超低折扣的团购产品!

下载
  • 访问 http://localhost:8080/user,会返回JSON:
{"id":1,"name":"Alice","email":"alice@example.com"}
  • 访问 http://localhost:8080/health,返回纯文本 OK。

也可以用 curl 测试:

curl -s http://localhost:8080/user | python -m json.tool

4. 处理POST请求(可选扩展)

如果需要接收JSON输入,可以这样处理:

func createUser(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }
var user User
err := json.NewDecoder(r.Body).Decode(&user)
if err != nil {
    http.Error(w, "Invalid JSON", http.StatusBadRequest)
    return
}

// 模拟保存成功,返回带ID的结果
user.ID = 100
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(user)

}

然后在 main 中注册:
http.HandleFunc("/user", createUser)(注意区分GET/POST)

基本上就这些。Golang的标准库足够应付大多数简单API场景,无需引入框架也能快速搭建稳定服务。关键点是设置正确的Content-Type、使用结构体标签、合理处理错误。后续可扩展日志、中间件、路由分组等功能。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

715

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

625

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

738

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1235

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

574

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

697

2023.08.11

桌面文件位置介绍
桌面文件位置介绍

本专题整合了桌面文件相关教程,阅读专题下面的文章了解更多内容。

0

2025.12.30

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 2.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 0.9万人学习

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

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