GO语言（十三）使用Go和Gin开发RESTfulAPI（下）

　　编写处理程序以添加新项目
　　当客户端在 发出POST请求时/albums，您希望将请求正文中描述的专辑添加到现有专辑数据中。
　　为此，您将编写以下内容： 将新专辑添加到现有列表的逻辑。 将请求路由POST到您的逻辑的一些代码。
　　1、编写代码
　　a.添加代码以将专辑数据添加到专辑列表。
　　在语句之后的某处import，粘贴以下代码。（文件末尾是这段代码的好地方，但 Go 并不强制你声明函数的顺序。） // postAlbums adds an album from JSON received in the request body. func postAlbums(c *gin.Context) {     var newAlbum album      // Call BindJSON to bind the received JSON to     // newAlbum.     if err := c.BindJSON(&newAlbum); err != nil {         return     }      // Add the new album to the slice.     albums = append(albums, newAlbum)     c.IndentedJSON(http.StatusCreated, newAlbum) }
　　在此代码中：
　　1）用于Context.BindJSON 将请求正文绑定到newAlbum。
　　2）album将从 JSON 初始化的结构附加到albums 切片。
　　3）向响应添加201状态代码，以及表示您添加的专辑的 JSON。
　　b.更改您的main函数，使其包含该router.POST函数，如下所示。 func main() {     router := gin.Default()     router.GET(＂/albums＂, getAlbums)     router.POST(＂/albums＂, postAlbums)      router.Run(＂localhost:8080＂) }
　　在此代码中：
　　1）将路径中的POST方法与 /albumspostAlbums函数相关联。
　　使用 Gin，您可以将处理程序与 HTTP 方法和路径组合相关联。这样，您可以根据客户端使用的方法将发送到单个路径的请求单独路由。
　　2、运行代码
　　a.如果服务器从上一节开始仍在运行，请停止它。
　　b.从包含 main.go 的目录中的命令行，运行代码。 $ go run .
　　c.从不同的命令行窗口，用于curl向正在运行的 Web 服务发出请求。 $ curl http://localhost:8080/albums      --include      --header ＂Content-Type: application/json＂      --request ＂POST＂      --data ＂{＂id＂: ＂4＂,＂title＂: ＂The Modern Sound of Betty Carter＂,＂artist＂: ＂Betty Carter＂,＂price＂: 49.99}＂
　　该命令应显示添加专辑的标题和 JSON。 HTTP/1.1 201 Created Content-Type: application/json; charset=utf-8 Date: Wed, 02 Jun 2021 00:34:12 GMT Content-Length: 116  {     ＂id＂: ＂4＂,     ＂title＂: ＂The Modern Sound of Betty Carter＂,     ＂artist＂: ＂Betty Carter＂,     ＂price＂: 49.99 }
　　d.与上一节一样，使用curl检索完整的专辑列表，您可以使用它来确认添加了新专辑。 $ curl http://localhost:8080/albums      --header ＂Content-Type: application/json＂      --request ＂GET＂
　　该命令应显示专辑列表。 [         {                 ＂id＂: ＂1＂,                 ＂title＂: ＂Blue Train＂,                 ＂artist＂: ＂John Coltrane＂,                 ＂price＂: 56.99         },         {                 ＂id＂: ＂2＂,                 ＂title＂: ＂Jeru＂,                 ＂artist＂: ＂Gerry Mulligan＂,                 ＂price＂: 17.99         },         {                 ＂id＂: ＂3＂,                 ＂title＂: ＂Sarah Vaughan and Clifford Brown＂,                 ＂artist＂: ＂Sarah Vaughan＂,                 ＂price＂: 39.99         },         {                 ＂id＂: ＂4＂,                 ＂title＂: ＂The Modern Sound of Betty Carter＂,                 ＂artist＂: ＂Betty Carter＂,                 ＂price＂: 49.99         } ]
　　编写处理程序以返回特定项目
　　当客户端向 发出请求时GET /albums/[id]，您希望返回 ID 与id路径参数匹配的专辑。
　　为此，您将： 添加逻辑以检索请求的相册。 将路径映射到逻辑。
　　1、编写代码
　　a.在您在上一节中添加的函数下方postAlbums，粘贴以下代码以检索特定专辑。
　　此getAlbumByID函数将提取请求路径中的 ID，然后找到匹配的专辑。 // getAlbumByID locates the album whose ID value matches the id // parameter sent by the client, then returns that album as a response. func getAlbumByID(c *gin.Context) {     id := c.Param(＂id＂)      // Loop over the list of albums, looking for     // an album whose ID value matches the parameter.     for _, a := range albums {         if a.ID == id {             c.IndentedJSON(http.StatusOK, a)             return         }     }     c.IndentedJSON(http.StatusNotFound, gin.H{＂message＂: ＂album not found＂}) }
　　在此代码中：
　　（1）Context.Param用于从 URL 中检索id路径参数。当您将此处理程序映射到路径时，您将在路径中包含参数的占位符。
　　（2）循环album切片中的结构，寻找其ID 字段值与id参数值匹配的结构。如果找到，则将该album结构序列化为 JSON，并将其作为带有200 OK HTTP 代码的响应返回。
　　如上所述，实际使用中的服务可能会使用数据库查询来执行此查找。
　　（3）如果找不到专辑，则返回 HTTP 404错误。
　　b.最后，更改您的main，使其包含对router.GET的新调用，路径现在为/albums/:id ，如以下示例所示。 func main() {     router := gin.Default()     router.GET(＂/albums＂, getAlbums)     router.GET(＂/albums/:id＂, getAlbumByID)     router.POST(＂/albums＂, postAlbums)      router.Run(＂localhost:8080＂) }
　　在此代码中：
　　（1）将/albums/:id路径与getAlbumByID功能相关联。在 Gin 中，路径中项目前面的冒号表示该项目是路径参数。
　　2、运行代码
　　a.如果服务器从上一节开始仍在运行，请停止它。
　　b.在包含 main.go 的目录中的命令行中，运行代码以启动服务器。 $ go run .
　　c.从不同的命令行窗口，用于curl向正在运行的 Web 服务发出请求。 $ curl http://localhost:8080/albums/2
　　该命令应显示您使用其 ID 的专辑的 JSON。如果找不到专辑，您将收到带有错误消息的 JSON。 {         ＂id＂: ＂2＂,         ＂title＂: ＂Jeru＂,         ＂artist＂: ＂Gerry Mulligan＂,         ＂price＂: 17.99 }
　　结论
　　恭喜！您刚刚使用 Go 和 Gin 编写了一个简单的 RESTful Web 服务。
　　完成的代码
　　本节包含您使用本教程构建的应用程序的代码。 package main  import (     ＂net/http＂      ＂github.com/gin-gonic/gin＂ )  // album represents data about a record album. type album struct {     ID     string  `json:＂id＂`     Title  string  `json:＂title＂`     Artist string  `json:＂artist＂`     Price  float64 `json:＂price＂` }  // albums slice to seed record album data. var albums = []album{     {ID: ＂1＂, Title: ＂Blue Train＂, Artist: ＂John Coltrane＂, Price: 56.99},     {ID: ＂2＂, Title: ＂Jeru＂, Artist: ＂Gerry Mulligan＂, Price: 17.99},     {ID: ＂3＂, Title: ＂Sarah Vaughan and Clifford Brown＂, Artist: ＂Sarah Vaughan＂, Price: 39.99}, }  func main() {     router := gin.Default()     router.GET(＂/albums＂, getAlbums)     router.GET(＂/albums/:id＂, getAlbumByID)     router.POST(＂/albums＂, postAlbums)      router.Run(＂localhost:8080＂) }  // getAlbums responds with the list of all albums as JSON. func getAlbums(c *gin.Context) {     c.IndentedJSON(http.StatusOK, albums) }  // postAlbums adds an album from JSON received in the request body. func postAlbums(c *gin.Context) {     var newAlbum album      // Call BindJSON to bind the received JSON to     // newAlbum.     if err := c.BindJSON(&newAlbum); err != nil {         return     }      // Add the new album to the slice.     albums = append(albums, newAlbum)     c.IndentedJSON(http.StatusCreated, newAlbum) }  // getAlbumByID locates the album whose ID value matches the id // parameter sent by the client, then returns that album as a response. func getAlbumByID(c *gin.Context) {     id := c.Param(＂id＂)      // Loop through the list of albums, looking for     // an album whose ID value matches the parameter.     for _, a := range albums {         if a.ID == id {             c.IndentedJSON(http.StatusOK, a)             return         }     }     c.IndentedJSON(http.StatusNotFound, gin.H{＂message＂: ＂album not found＂}) }