Gin RESTful API

要弄清楚什么是RESTful API，首先要知道REST是什么

REST是Representational State Transfer的簡(jiǎn)稱(chēng)，中文翻譯為“表征狀態(tài)轉(zhuǎn)移”或“表現(xiàn)層狀態(tài)轉(zhuǎn)化”

簡(jiǎn)單來(lái)說(shuō)，REST的含義就是客戶端與Web服務(wù)器之間進(jìn)行交互的時(shí)候，使用HTTP協(xié)議中的4個(gè)請(qǐng)求方法代表不同的動(dòng)作

• GET用來(lái)獲取資源
• POST用來(lái)新建資源
• PUT用來(lái)更新資源
• DELETE用來(lái)刪除資源

只要API程序遵循了REST風(fēng)格，那就可以稱(chēng)其為RESTful API。目前在前后端分離的架構(gòu)中，前后端基本都是通過(guò)RESTful API來(lái)進(jìn)行交互

例如，我們現(xiàn)在要編寫(xiě)一個(gè)學(xué)生管理系統(tǒng)，我們可以對(duì)一個(gè)學(xué)生進(jìn)行查詢、創(chuàng)建、更新和刪除等操作，我們?cè)诰帉?xiě)程序的時(shí)候就要設(shè)計(jì)客戶端瀏覽器與我們Web服務(wù)端交互的方式和路徑。按照RESTful API我們通常會(huì)設(shè)計(jì)成如下模式：

Gin框架支持RESTful API的開(kāi)發(fā)，代碼如下

package main

import (
	"net/http"
	"github.com/gin-gonic/gin"
)

func main() {
	r := gin.Default()

	r.GET("/student", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "查詢學(xué)生信息成功",
		})
	})
	r.POST("/create_student", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "創(chuàng)建學(xué)生信息成功",
		})
	})
	r.PUT("/updata_student", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "更新學(xué)生信息成功",
		})
	})
	r.DELETE("/delete_student", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "刪除學(xué)生信息成功",
		})
	})
	r.Run()
}

開(kāi)發(fā)RESTful API的時(shí)候我們通常使用postman來(lái)做為客戶端的測(cè)試工具

結(jié)果如下