代码实现
main.go
package main import ( "fmt" "github.com/jihite/go-gin-example/pkg/setting" "github.com/jihite/go-gin-example/routers" "net/http" ) func main() { router := routers.InitRouter() s := &http.Server{ Addr: fmt.Sprintf(":%d", setting.HTTPPort), Handler: router, ReadTimeout: setting.ReadTimeout, WriteTimeout: setting.WriteTimeout, MaxHeaderBytes: 1 << 20, } s.ListenAndServe() }
http:Server:
- Addr:监听的TCP地址,格式为
:8000
- Handler:http句柄,实质为
ServeHTTP
,用于处理程序响应HTTP请求 - ReadTimeout:允许读取的最大时间
- WriteTimeout:允许写入的最大时间
- MaxHeaderBytes:请求头的最大字节数
实现InitRouter()
func InitRouter() *gin.Engine { r := gin.New() r.Use(gin.Logger()) r.Use(gin.Recovery()) gin.SetMode(setting.RunMode) r.GET("/ping", func(c *gin.Context) { c.JSON(200, gin.H{ "message": "pong", }) }) apig := r.Group("/api") { apig.GET("/tags", api.GetTags) apig.POST("/tags", api.AddTag) apig.PUT("/tags/:id", api.EditTag) apig.DELETE("/tags/:id", api.DeleteTag) apig.POST("/tags/export", api.ExportTag) apig.POST("/tags/import", api.ImportTag) } return r }
/ping 对应的是匿名函数
/tags对应的是具体的函数
func GetTags(c *gin.Context) { } func AddTag(c *gin.Context) { }
其中
gin.Context:Context
是gin
中的上下文,它允许我们在中间件之间传递变量、管理流、验证JSON请求、响应JSON请求等,在gin
中包含大量Context
的方法,如我们常用的DefaultQuery
、Query
、DefaultPostForm
、PostForm
等
RESTFUL中的方法:GET、POST、PUT、DELETE、OPTIONS
方法 | 安全 | 幂等 | 作用 |
GET | ✔️ | ✔️ | 获取资源 |
POST | × | × | 创建子资源 |
PUT | ✔️ | ✔️ | 创建、更新资源 |
DELETE | × | ✔️ | 删除资源 |
OPTIONS | ✔️ | ✔️ | 验证服务是否正产 |
幂等:使用相同参数重复执行,并能获得相同结果的函数
POST、PUT区别
POST新建子资源;而PUT, 如果资源不存在则创建,否则更新