域名查詢地址,網(wǎng)站排名優(yōu)化軟件哪家好,網(wǎng)站開發(fā)的基本語言,地推網(wǎng)推平臺在 Gin 框架中#xff0c;真正支撐路由能力的不是 gin.Engine#xff0c;而是 gin.RouterGroup。 gin.Engine 本質(zhì)上是嵌入了 RouterGroup 的增強結(jié)構(gòu)#xff08;type Engine struct { *RouterGroup ... }#xff09;#xff0c;因此你調(diào)用 r.GET()、r.Group() 時#xf…在 Gin 框架中真正支撐路由能力的不是gin.Engine而是gin.RouterGroup。gin.Engine本質(zhì)上是嵌入了RouterGroup的增強結(jié)構(gòu)type Engine struct { *RouterGroup ... }因此你調(diào)用r.GET()、r.Group()時實際上是在操作一個RouterGroup實例。RouterGroup是 Gin 的核心抽象它提供了路徑前綴管理自動拼接中間件作用域隔離嵌套分組能力統(tǒng)一的方法注冊接口GET/POST/Use/Static 等理解RouterGroup的工作方式是掌握 Gin 架構(gòu)設(shè)計的關(guān)鍵HTTP 方法路由// 所有 HTTP 方法GET(pathstring,handlers...HandlerFunc)IRoutesPOST(pathstring,handlers...HandlerFunc)IRoutesPUT(pathstring,handlers...HandlerFunc)IRoutesDELETE(pathstring,handlers...HandlerFunc)IRoutesPATCH(pathstring,handlers...HandlerFunc)IRoutesHEAD(pathstring,handlers...HandlerFunc)IRoutesOPTIONS(pathstring,handlers...HandlerFunc)IRoutesANY(pathstring,handlers...HandlerFunc)IRoutes// 自定義方法Handle(httpMethod,relativePathstring,handlers...HandlerFunc)IRoutes中間件管理// 添加中間件Use(middleware...HandlerFunc)IRoutes分組創(chuàng)建// 創(chuàng)建子分組Group(componentstring,handlers...HandlerFunc)*RouterGroup靜態(tài)文件服務(wù)// 靜態(tài)文件StaticFile(relativePath,filepathstring)IRoutesStatic(relativePath,rootstring)IRoutesStaticFS(relativePathstring,fs http.FileSystem)IRoutes路徑組合規(guī)則// 基礎(chǔ)路徑組合規(guī)則r:gin.Default()api:r.Group(/api)// basePath: /apiv1:api.Group(/v1)// basePath: /api/v1users:v1.Group(/users)// basePath: /api/v1/users// 最終路由// users.GET(/profile) → 實際路徑: /api/v1/users/profile// users.POST(/create) → 實際路徑: /api/v1/users/create基礎(chǔ)用法funcmain(){r:gin.Default()// Engine 本身就是一個 RouterGroupr.GET(/,handler)// r 是 *RouterGroup// 創(chuàng)建分組api:r.Group(/api)// 返回 *RouterGroupapi.GET(/users,handler)api.POST(/users,handler)}分組嵌套funcmain(){r:gin.Default()// 一級分組api:r.Group(/api){api.GET(/users,handler1)api.POST(/users,handler2)// 二級分組v1:api.Group(/v1){v1.GET(/users,handler3)v1.POST(/users,handler4)}v2:api.Group(/v2){v2.GET(/users,handler5)}}}中間件分組funcmain(){r:gin.Default()// 公共路由組無中間件public:r.Group(/public){public.GET(/info,handler1)}// 受保護路由組帶認證中間件protected:r.Group(/api)protected.Use(AuthMiddleware())// 該組所有路由都使用認證中間件{protected.GET(/profile,handler2)protected.POST(/posts,handler3)// 在分組內(nèi)再創(chuàng)建子分組admin:protected.Group(/admin)admin.Use(AdminMiddleware())// 管理員中間件{admin.GET(/dashboard,handler4)admin.DELETE(/users/:id,handler5)}}}完整示例packagemainimport(github.com/gin-gonic/ginnet/http)funcAuthMiddleware()gin.HandlerFunc{returnfunc(c*gin.Context){// 簡單認證邏輯token:c.GetHeader(Authorization)iftoken{c.JSON(401,gin.H{error:Unauthorized})c.Abort()return}c.Next()}}funcAdminMiddleware()gin.HandlerFunc{returnfunc(c*gin.Context){// 簡單管理員驗證role:c.GetHeader(Role)ifrole!admin{c.JSON(403,gin.H{error:Forbidden})c.Abort()return}c.Next()}}funcmain(){r:gin.Default()// 根分組Engine 本身r.GET(/,func(c*gin.Context){c.JSON(200,gin.H{message:Root path})})// API 分組api:r.Group(/api){api.GET(/health,func(c*gin.Context){c.JSON(200,gin.H{status:ok})})// 用戶相關(guān)接口users:api.Group(/users)users.Use(AuthMiddleware())// 用戶接口需要認證{users.GET(/,func(c*gin.Context){c.JSON(200,gin.H{users:[]string{user1,user2}})})users.GET(/:id,func(c*gin.Context){id:c.Param(id)c.JSON(200,gin.H{id:id,name:John})})users.POST(/,func(c*gin.Context){c.JSON(201,gin.H{message:User created})})}// 管理員接口admin:api.Group(/admin)admin.Use(AuthMiddleware(),AdminMiddleware())// 需要認證管理員權(quán)限{admin.GET(/dashboard,func(c*gin.Context){c.JSON(200,gin.H{message:Admin dashboard})})admin.GET(/users,func(c*gin.Context){c.JSON(200,gin.H{message:Admin users list})})}}// 靜態(tài)文件static:r.Group(/static)static.Static(/files,./files)// 靜態(tài)文件服務(wù)r.Run()}