首页 资讯中心 文章详情

第七篇：《初识 net/http：构建第一个 RESTful API》

发布时间：2026/7/23 11:09:32
第七篇：《初识 net/http：构建第一个 RESTful API》 掌握了 Go 的基础语法和并发模型后我们正式进入 Web 开发领域。Go 的标准库 net/http 已经足够强大无需第三方框架就能构建一个完整的 RESTful API 服务。本文从 http.Handler 接口和 http.ServeMux 路由器讲起深入讲解如何编写 Handler 处理 HTTP 请求、如何读取请求参数和请求体、如何返回 JSON 响应以及如何用闭包实现中间件。最后通过一个完整的“图书管理”CRUD API 实战帮你建立 Go Web 开发的基础认知。一、net/http 核心接口http.Handlernet/http 包的核心是 http.Handler 接口typeHandlerinterface{ServeHTTP(w http.ResponseWriter,r*http.Request)}任何实现了 ServeHTTP 方法的类型都可以作为 HTTP 处理器。1.1 函数式 Handlerhttp.HandlerFunchttp.HandlerFunc 是一个函数类型它实现了 http.Handler 接口允许将普通函数直接转换为 Handlerpackagemainimport(fmtnet/http)// 普通函数作为 HandlerfunchelloHandler(w http.ResponseWriter,r*http.Request){fmt.Fprintf(w,Hello, World!)}funcmain(){// http.HandlerFunc 将函数转换为 Handlerhttp.HandleFunc(/hello,helloHandler)// 启动服务器http.ListenAndServe(:8080,nil)}访问 http://localhost:8080/hello即可看到 Hello, World!。1.2 结构体 Handler面向对象风格typeGreetingHandlerstruct{Namestring}func(h*GreetingHandler)ServeHTTP(w http.ResponseWriter,r*http.Request){fmt.Fprintf(w,Greeting from %s,h.Name)}funcmain(){handler:GreetingHandler{Name:MyApp}http.Handle(/greeting,handler)http.ListenAndServe(:8080,nil)}二、处理 HTTP 请求2.1 读取 URL 参数Query String使用 r.URL.Query() 读取查询参数funcgetUserHandler(w http.ResponseWriter,r*http.Request){// 获取查询参数query:r.URL.Query()name:query.Get(name)// /user?nameAliceage:query.Get(age)// /user?nameAliceage30fmt.Fprintf(w,name: %s, age: %s,name,age)}2.2 读取路径参数Path ParametersGo 标准库不直接支持路由参数如 /user/123需要自行解析路径或使用 http.ServeMux 的路径匹配模式。更常用的是直接使用 r.URL.Path 解析或者后续章节引入 Gin 框架来处理更复杂的路由。funcuserHandler(w http.ResponseWriter,r*http.Request){// 解析路径/users/123path:r.URL.Path// 简单解析parts:strings.Split(path,/)iflen(parts)3{id:parts[2]// 123fmt.Fprintf(w,User ID: %s,id)}}2.3 读取请求体POST / PUT对于 POST/PUT 请求需要从请求体中读取数据import(encoding/jsonionet/http)typeUserstruct{Namestringjson:nameAgeintjson:age}funccreateUserHandler(w http.ResponseWriter,r*http.Request){// 只允许 POST 方法ifr.Method!http.MethodPost{http.Error(w,Method not allowed,http.StatusMethodNotAllowed)return}// 读取请求体body,err:io.ReadAll(r.Body)iferr!nil{http.Error(w,读取请求体失败,http.StatusBadRequest)return}deferr.Body.Close()// 解析 JSONvaruser Useriferr:json.Unmarshal(body,user);err!nil{http.Error(w,JSON 解析失败,http.StatusBadRequest)return}fmt.Fprintf(w,接收到用户: %s, 年龄: %d,user.Name,user.Age)}三、返回 HTTP 响应3.1 返回 JSON 响应使用 json.NewEncoder 可以方便地返回 JSON 格式的响应typeResponsestruct{Codeintjson:codeMessagestringjson:messageDatainterface{}json:data,omitempty}funcapiHandler(w http.ResponseWriter,r*http.Request){// 设置响应头w.Header().Set(Content-Type,application/json)// 构造响应数据resp:Response{Code:200,Message:success,Data:map[string]string{status:ok},}// 返回 JSONw.WriteHeader(http.StatusOK)json.NewEncoder(w).Encode(resp)}3.2 设置状态码和响应头funchandler(w http.ResponseWriter,r*http.Request){// 设置响应头w.Header().Set(X-Custom-Header,my-value)w.Header().Set(Content-Type,application/json)// 设置状态码w.WriteHeader(http.StatusCreated)// 201// 写入响应体w.Write([]byte({status:ok}))}四、中间件Middleware中间件是一个高阶函数它接收一个 http.Handler 并返回一个新的 http.Handler可以在请求处理前后执行逻辑。net/http 标准库中没有直接定义中间件模式但通过闭包可以非常方便地实现。// 日志中间件funcloggerMiddleware(next http.Handler)http.Handler{returnhttp.HandlerFunc(func(w http.ResponseWriter,r*http.Request){fmt.Printf([%s] %s %s\n,time.Now().Format(2006-01-02 15:04:05),r.Method,r.URL.Path)next.ServeHTTP(w,r)// 调用下一个处理器})}// Recovery 中间件捕获 panicfuncrecoveryMiddleware(next http.Handler)http.Handler{returnhttp.HandlerFunc(func(w http.ResponseWriter,r*http.Request){deferfunc(){iferr:recover();err!nil{log.Printf(panic 恢复: %v,err)http.Error(w,服务器内部错误,http.StatusInternalServerError)}}()next.ServeHTTP(w,r)})}// 应用中间件funcmain(){mux:http.NewServeMux()mux.HandleFunc(/,helloHandler)// 中间件链handler:recoveryMiddleware(loggerMiddleware(mux))http.ListenAndServe(:8080,handler)}五、实战图书管理 CRUD API纯标准库下面是一个完整的图书管理 API包含创建、查询、更新、删除操作全部基于标准库实现packagemainimport(encoding/jsonfmtnet/httpsync)// 图书模型typeBookstruct{IDstringjson:idTitlestringjson:titleAuthorstringjson:authorPriceintjson:price}// 图书仓库typeBookStorestruct{mu sync.RWMutex booksmap[string]Book}funcNewBookStore()*BookStore{returnBookStore{books:make(map[string]Book),}}func(s*BookStore)Create(book Book){s.mu.Lock()defers.mu.Unlock()s.books[book.ID]book}func(s*BookStore)Get(idstring)(Book,bool){s.mu.RLock()defers.mu.RUnlock()book,ok:s.books[id]returnbook,ok}func(s*BookStore)GetAll()[]Book{s.mu.RLock()defers.mu.RUnlock()books:make([]Book,0,len(s.books))for_,book:ranges.books{booksappend(books,book)}returnbooks}func(s*BookStore)Update(idstring,book Book)bool{s.mu.Lock()defers.mu.Unlock()if_,ok:s.books[id];!ok{returnfalse}book.IDid s.books[id]bookreturntrue}func(s*BookStore)Delete(idstring)bool{s.mu.Lock()defers.mu.Unlock()if_,ok:s.books[id];!ok{returnfalse}delete(s.books,id)returntrue}// ---- HTTP Handlers ----varstoreNewBookStore()funcrespondJSON(w http.ResponseWriter,statusint,datainterface{}){w.Header().Set(Content-Type,application/json)w.WriteHeader(status)json.NewEncoder(w).Encode(data)}funcgetAllBooks(w http.ResponseWriter,r*http.Request){books:store.GetAll()respondJSON(w,http.StatusOK,books)}funcgetBookByID(w http.ResponseWriter,r*http.Request){// 简单路径解析/books/123id:r.URL.Path[len(/books/):]ifid{http.Error(w,id 不能为空,http.StatusBadRequest)return}book,ok:store.Get(id)if!ok{http.Error(w,图书不存在,http.StatusNotFound)return}respondJSON(w,http.StatusOK,book)}funccreateBook(w http.ResponseWriter,r*http.Request){ifr.Method!http.MethodPost{http.Error(w,Method not allowed,http.StatusMethodNotAllowed)return}varbook Bookiferr:json.NewDecoder(r.Body).Decode(book);err!nil{http.Error(w,JSON 解析失败,http.StatusBadRequest)return}deferr.Body.Close()ifbook.ID{http.Error(w,id 不能为空,http.StatusBadRequest)return}store.Create(book)respondJSON(w,http.StatusCreated,book)}funcupdateBook(w http.ResponseWriter,r*http.Request){ifr.Method!http.MethodPut{http.Error(w,Method not allowed,http.StatusMethodNotAllowed)return}id:r.URL.Path[len(/books/):]ifid{http.Error(w,id 不能为空,http.StatusBadRequest)return}varbook Bookiferr:json.NewDecoder(r.Body).Decode(book);err!nil{http.Error(w,JSON 解析失败,http.StatusBadRequest)return}deferr.Body.Close()if!store.Update(id,book){http.Error(w,图书不存在,http.StatusNotFound)return}respondJSON(w,http.StatusOK,book)}funcdeleteBook(w http.ResponseWriter,r*http.Request){ifr.Method!http.MethodDelete{http.Error(w,Method not allowed,http.StatusMethodNotAllowed)return}id:r.URL.Path[len(/books/):]ifid{http.Error(w,id 不能为空,http.StatusBadRequest)return}if!store.Delete(id){http.Error(w,图书不存在,http.StatusNotFound)return}w.WriteHeader(http.StatusNoContent)}funcmain(){// 初始化一些示例数据store.Create(Book{ID:1,Title:Go 入门,Author:张三,Price:59})store.Create(Book{ID:2,Title:微服务架构,Author:李四,Price:89})// 路由http.HandleFunc(/books,func(w http.ResponseWriter,r*http.Request){switchr.Method{casehttp.MethodGet:getAllBooks(w,r)casehttp.MethodPost:createBook(w,r)default:http.Error(w,Method not allowed,http.StatusMethodNotAllowed)}})http.HandleFunc(/books/,func(w http.ResponseWriter,r*http.Request){switchr.Method{casehttp.MethodGet:getBookByID(w,r)casehttp.MethodPut:updateBook(w,r)casehttp.MethodDelete:deleteBook(w,r)default:http.Error(w,Method not allowed,http.StatusMethodNotAllowed)}})fmt.Println(服务器启动在 :8080)http.ListenAndServe(:8080,nil)}测试 API# 获取所有图书curlhttp://localhost:8080/books# 创建图书curl-XPOST http://localhost:8080/books-HContent-Type: application/json-d{id:3,title:Go 并发, author:王五, price:69}# 获取单本图书curlhttp://localhost:8080/books/1# 更新图书curl-XPUT http://localhost:8080/books/1-HContent-Type: application/json-d{title:Go 入门第二版, author:张三, price:79}# 删除图书curl-XDELETE http://localhost:8080/books/1六、小结http.Handler核心接口ServeHTTP(w http.ResponseWriter, r *http.Request) 是 Go Web 的起点。路由http.ServeMux 是标准库的路由器支持路径匹配。请求处理r.URL.Query() 读取查询参数io.ReadAll(r.Body) 读取请求体json.Unmarshal 解析 JSON。响应返回w.Header().Set() 设置响应头w.WriteHeader() 设置状态码json.NewEncoder(w).Encode() 返回 JSON。中间件使用闭包实现接收 http.Handler 返回 http.Handler可以实现日志、鉴权、恢复等功能。

相关新闻

重庆AGV叉车厂商怎么选？实用选型指南

重庆AGV叉车厂商怎么选？实用选型指南

2026/7/23 11:08:31

在工业自动化浪潮下，重庆AGV叉车市场蓬勃发展，众多厂商纷纷涌入。面对众多选择，企业该如何挑选合适的厂商呢？接下来为大家提供实用的选型指南。产品性能与适配性重庆AGV叉车的性能直接影响作业效率。要关注叉车的载重能力、运行速…

MSPM0硬件CRC加速器原理、配置与嵌入式数据校验实战

MSPM0硬件CRC加速器原理、配置与嵌入式数据校验实战

2026/7/23 11:08:31

1. 项目概述与CRC核心价值在嵌入式开发，尤其是涉及通信协议、文件系统或者固件安全校验的场景里，数据完整性验证是个绕不开的坎。你辛辛苦苦通过UART、SPI或者I2C接收了一长串数据，或者从Flash里读取了一段关键配置，怎么才能确信数…

Codex CLI：终端AI编码助手的功能与应用

Codex CLI：终端AI编码助手的功能与应用

2026/7/23 11:08:31

1. Codex CLI 项目概述Codex CLI 是 OpenAI 推出的终端编码智能体工具链核心组件，它让开发者能在本地终端环境中直接调用 AI 编码能力。这个基于 Rust 构建的开源工具，本质上是一个桥梁 - 将自然语言指令转化为具体的代码操作，在保持终端工作…

硬件开发中评估模块的正确使用：从核心定位到安全合规实践

硬件开发中评估模块的正确使用：从核心定位到安全合规实践

2026/7/23 11:47:45

1. 评估模块：工程师的“探路石”与“安全手册”在硬件开发的早期阶段，面对一颗全新的芯片，最让工程师头疼的问题莫过于：“这颗芯片的数据手册写得天花乱坠，但实际性能到底如何？我的电路设计思路是否可行&am…

下一代地热能技术：EGS与超临界系统的突破与应用

下一代地热能技术：EGS与超临界系统的突破与应用

2026/7/23 11:47:45

1. 下一代地热能技术概述地热能作为可再生能源的重要分支，正在经历从传统 hydrothermal 系统向增强型地热系统(EGS)和超临界地热系统的技术跃迁。与传统地热相比，下一代地热技术最显著的特征是突破了"天然热储天然流体天然渗透率"的三重限制&a…

VRChat本地CDN部署与性能优化实战

VRChat本地CDN部署与性能优化实战

2026/7/23 11:47:45

1. 为什么VRChat玩家需要本地CDN？在VRChat这类社交VR平台上，用户生成内容（UGC）的实时加载速度直接影响体验。当你在猫娘角色里蹦迪时，突然遇到模型加载卡顿或者贴图模糊，这种体验就像跳舞时踩到香蕉皮——既…

Docker资源管理文档详细总结001篇

Docker资源管理文档详细总结001篇

2026/7/23 11:47:45

文章目录 Docker资源管理文档详细总结 一、整体概述 二、容器重启策略（--restart） 动态修改命令 三、CPU资源管控 1. 压力测试工具 stress 2. CPU权重（--cpu-shares） 3. CPU核心绑定（--cpuset-cpus） 综合启动示例 动态调整CPU权重 四、内存资源管控 1. 核心限制参数 `-m`…

TI GDK标准命令集解析：构建可靠BMS的底层控制与故障诊断

TI GDK标准命令集解析：构建可靠BMS的底层控制与故障诊断

2026/7/23 11:46:45

1. 项目概述与核心价值在嵌入式系统，尤其是便携式设备和物联网终端的设计中，电池管理系统（BMS）的稳定性和可靠性直接决定了产品的用户体验与安全底线。很多工程师在初次接触BMS开发时，往往会被底层复杂的模拟前端&…

油泥处理设备哪里能买到

油泥处理设备哪里能买到

2026/7/23 0:00:16

油泥处理设备哪里有？这是许多从事油田、炼化、清罐业务的从业者最关心的问题。根据河南三丰环保设备有限公司的行业经验，选购油泥处理设备的核心在于设备能否适配当地环保法规与原料特性，而非单纯看价格。该公司总经理王钦田先生指出&#xf…

Unity与Python本地通信：基于Flask的跨语言数据交换实战

Unity与Python本地通信：基于Flask的跨语言数据交换实战

2026/7/22 11:54:37

1. 项目概述：为什么我们需要一个本地通信服务器？在游戏开发、数字孪生、仿真训练等众多领域，Unity作为强大的实时3D内容创作平台，其核心逻辑通常由C#驱动。然而，当我们需要进行复杂的数据分析、机器学习推理、科学计算…

科研课题设计全流程：从选题到成果落地的实战指南

科研课题设计全流程：从选题到成果落地的实战指南

2026/7/22 11:55:27

1. 课题设计全流程解析：从选题到成果落地的实战指南课题设计是科研工作者、高校师生以及企业研发人员日常工作中的核心环节。一个优秀的课题设计不仅决定了研究的方向和质量，更直接影响最终成果的学术价值和应用前景。作为在科研一线摸爬滚打多年的从业者…

数据分析师必学MySQL：从零构建电商销售分析实战

数据分析师必学MySQL：从零构建电商销售分析实战

2026/7/22 19:00:43

你是不是也遇到过这样的困惑：想学数据分析，看了很多Python、R语言的教程，结果发现第一步就被卡住了——数据从哪里来？怎么存？怎么查？怎么保证数据准确？很多数据分析教程都默认你已经有了一个干净…

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合

2026/7/22 15:49:47

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合 【免费下载链接】HS2-HF_Patch Automatically translate, uncensor and update HoneySelect2! 项目地址: https://gitcode.com/gh_mirrors/hs/HS2-HF_Patch HS2-HF Patch是专为HoneySelect2玩家设计的一站…