《用Gin框架构建分布式应用》学习第4天，p32-p76总结，总计25页。
一、技术总结
1.Go知识点
(1)iouti
书上使用ioutil包读取JSON文件，但是从go 1.16 开始，不再推荐使用ioutil，应该使用os 包。
(2)json.Unmarshal() vs json.NewDecoder()
当数据已经被加载到内存中了(例如一个string,slice)，那么使用json.Unmarshal()；如果是读取文件，那么使用json.NewDecoder。
2.go-swagger
使用 go-swagger包生成API文档流程：
(1)安装
go install github.com/go-swagger/go-swagger/cmd/swagger@latest
(2)给函数添加swagger
/ swagger:route GET /recipes listRecipes
// Returns list of recipes
// ---
// produces:
// - application/json
// responses:
// '200':
// description: Successful operation
// ListRecipesHandler 差下recipes，因为是查询所有，所以名称这里用的是复数
func ListRecipesHandler(c *gin.Context) {
c.JSON(http.StatusOK, recipes)
}
(3)生成文档
swagger generate spec -o ./swagger.json
注：每次给函数添加注释后都需要执行该命令，否则API文档不会更新。
(4)启动API服务
swagger serve --no-open -F swager ./swagger.json
注：因为本人使用的是WSL，所以需要添加--no-open，否则报webbrowser: can't open browser错误，服务无法启动。
UI有两种风格：Redoc和 Swagger UI。上没“-F swagger”指定了UI风格为Swagger UI。
注：个人觉得书上这种方式比较麻烦且繁琐，同时大量的注释导致代码非常不简洁。
二、英语总结
无，第二章除了食物名，整体来说生词比较少。
三、其它
无。
四、参考资料
1. 编程
(1) Mohamed Labouardy，《Building Distributed Applications in Gin》：https://book.douban.com/subject/35610349
2. 英语
(1) Etymology Dictionary：https://www.etymonline.com
(2) Cambridge Dictionary：https://dictionary.cambridge.org
欢迎搜索及关注：编程人(a_codists)