Go language web development series 30: gin: grouping by version for routing

One , Libraries used for installation :

1,gin In the framework of github The address of :

https://github.com/gin-gonic/gin

2, Install... From the command line :

[email protected]:/data/go/ginhello# go get -u github.com/gin-gonic/[email protected]

explain ： Liu Hongdi's go The forest is a focus golang The blog of ,
           Address ：https://blog.csdn.net/weixin_43881017

explain ： author : Liu Hongdi mailbox : [email protected]

Two , Information about the demonstration project

1, Address :

https://github.com/liuhongdi/digv30

2, function ： Demonstrate grouping routes by version number

3, Project structure ： Pictured :

3、 ... and ,go Code instructions

1,router/router.go

package router

import (
	"github.com/gin-gonic/gin"
	"github.com/liuhongdi/digv30/controller"
	v1 "github.com/liuhongdi/digv30/controller/v1"
	v2 "github.com/liuhongdi/digv30/controller/v2"
	"github.com/liuhongdi/digv30/global"
	"log"
	"runtime/debug"
)

func Router() *gin.Engine {
	router := gin.Default()
	// Handling exceptions 
	router.NoRoute(HandleNotFound)
	router.NoMethod(HandleNotFound)
	router.Use(Recover)
	//  Path mapping 
	// nothing group
	indexc:=controller.NewIndexController()
	router.GET("/index/index", indexc.Index);
    //v1 group
	apiv1 := router.Group("/v1")
	{
		goodsc:=v1.NewGoodsController()
		apiv1.GET("/goods/one", goodsc.GoodsOne)
		apiv1.GET("/goods/list", goodsc.GoodsList)
		//v1.POST("/read", readEndpoint)
	}
	//v2 group
	apiv2 := router.Group("/v2")
	{
		goodsc:=v2.NewGoodsController()
		apiv2.GET("/goods/one", goodsc.GoodsOne)
		apiv2.GET("/goods/list", goodsc.GoodsList)
	}
	return router
}

func HandleNotFound(c *gin.Context) {
	global.NewResult(c).Error(404," Resource not found ")
	return
}

func Recover(c *gin.Context) {
	defer func() {
		if r := recover(); r != nil {
			// Print error stack information 
			log.Printf("panic: %v\n", r)
			debug.PrintStack()
			global.NewResult(c).Error(500," Server internal error ")
		}
	}()
	// Finished loading  defer recover, Continue with subsequent interface calls 
	c.Next()
}

2,controller/v1/goodsController.go

package v1

import (
	"github.com/gin-gonic/gin"
	"github.com/liuhongdi/digv30/global"
)

type GoodsController struct{}
func NewGoodsController() GoodsController {
	return GoodsController{}
}
// v1  Goods details 
func (g *GoodsController) GoodsOne(c *gin.Context) {
	result := global.NewResult(c)
	result.Success("v1 one");
	return
}
// v1  List of goods 
func (g *GoodsController) GoodsList(c *gin.Context) {
	result := global.NewResult(c)
	result.Success("v1 list");
	return
}

3,controller/v2/goodsController.go

package v2

import (
	"github.com/gin-gonic/gin"
	"github.com/liuhongdi/digv30/global"
)

type GoodsController struct{}
func NewGoodsController() GoodsController {
	return GoodsController{}
}
// v2  Goods details 
func (g *GoodsController) GoodsOne(c *gin.Context) {
	result := global.NewResult(c)
	result.Success("v2 one");
	return
}
// v2  List of goods 
func (g *GoodsController) GoodsList(c *gin.Context) {
	result := global.NewResult(c)
	result.Success("v2 list");
	return
}

4, Other codes are accessible github

Four , The test results

1, Check the console output at startup :

[GIN-debug] GET    /index/index              --> github.com/liuhongdi/digv30/controller.(*IndexController).Index-fm (4 handlers)
[GIN-debug] GET    /v1/goods/one             --> github.com/liuhongdi/digv30/controller/v1.(*GoodsController).GoodsOne-fm (4 handlers)
[GIN-debug] GET    /v1/goods/list            --> github.com/liuhongdi/digv30/controller/v1.(*GoodsController).GoodsList-fm (4 handlers)
[GIN-debug] GET    /v2/goods/one             --> github.com/liuhongdi/digv30/controller/v2.(*GoodsController).GoodsOne-fm (4 handlers)
[GIN-debug] GET    /v2/goods/list            --> github.com/liuhongdi/digv30/controller/v2.(*GoodsController).GoodsList-fm (4 handlers)

2, visit url:

http://127.0.0.1:8080/v1/goods/one

return :

visit url:

http://127.0.0.1:8080/v2/goods/list

return :

5、 ... and , View the version of the library :

module github.com/liuhongdi/digv30

go 1.15

require (
	github.com/gin-gonic/gin v1.6.3
)