Gin：自定义控制器及控制器继承

VSCode 搭建Gin
Gin：路由配置和获取参数
Gin：路由抽离与分组
Gin：自定义控制器及控制器继承
Gin：中间件
Gin：文件上传
Gin：Cookie及二级域名共享Cookie
Gin：Session

1. 创建baseController

• 创建controllers文件夹和baseController.go文件，包含Success方法和Error方法

package controllers

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

type BaseController struct{}

func (con BaseController) Success(c *gin.Context, msg string) {
	c.JSON(http.StatusOK, gin.H{
		"code": 0,
		"msg":  msg,
	})
}

func (con BaseController) Error(c *gin.Context, msg string) {
	c.JSON(http.StatusBadRequest, gin.H{
		"code": 1,
		"msg":  msg,
	})
}

2. 创建控制器

• 分别创建user和department文件，并各自创建userController.go和departmentController.go文件，同时继承baseController结构体，可以使用父类的Success方法和Error方法
• userController.go

package user

import (
	"ginDemo2/controllers"

	"github.com/gin-gonic/gin"
)

type UserController struct {
	controllers.BaseController
}

func (con UserController) AddUser(c *gin.Context) {
	con.Success(c, "添加用户--")
}

func (con UserController) EditUser(c *gin.Context) {
	con.Error(c, "修改用户--")
}

func (con UserController) QueryUser(c *gin.Context) {
	con.Success(c, "查询用户--")
}

• departementController.go

package department

import (
	"ginDemo2/controllers"

	"github.com/gin-gonic/gin"
)

type DepartmentController struct {
	controllers.BaseController
}

func (con DepartmentController) AddDept(c *gin.Context) {
	con.Success(c, "添加部门--")
}

func (con DepartmentController) EditDept(c *gin.Context) {
	con.Success(c, "修改部门--")
}

func (con DepartmentController) QueryDept(c *gin.Context) {
	con.Success(c, "查询部门--")
}

3. 配置路由

• 引用自定义的控制器，例如user.UserController{}.AddUser
• userRouters.go

package routers

import (
	"ginDemo2/controllers/user"

	"github.com/gin-gonic/gin"
)

func UserRoutersInit(router *gin.Engine) {

	userRouter := router.Group("/user")
	userRouter.GET("/addUser", user.UserController{}.AddUser)
	userRouter.GET("/editUser", user.UserController{}.EditUser)
	userRouter.GET("/queryUser", user.UserController{}.QueryUser)

}

• departmentRouters.go

package routers

import (
	"ginDemo2/controllers/department"

	"github.com/gin-gonic/gin"
)

func DeptRoutersInit(router *gin.Engine) {

	deptRouter := router.Group("/dept")
	deptRouter.GET("/addDept", department.DepartmentController{}.AddDept)
	deptRouter.GET("/editDept", department.DepartmentController{}.EditDept)
	deptRouter.GET("/queryDept", department.DepartmentController{}.QueryDept)

}

4. 配置main.go

package main

import (
	"ginDemo2/routers"

	"github.com/gin-gonic/gin"
)

func main() {

	// 创建一个默认的路由引擎
	r := gin.Default()

	// 配置路由
	r.GET("/", func(c *gin.Context) {
		c.JSON(200, gin.H{
			// c.JSON：返回 JSON 格式的数据
			"message": "Hello world!",
		})
	})

	// 路由抽离并分组
	routers.UserRoutersInit(r)

	routers.DeptRoutersInit(r)

	// 启动 HTTP 服务，默认在 0.0.0.0:8080 启动服务
	r.Run()

}

5. 启动服务

• http://localhost:8080/user/addUser

• http://localhost:8080/user/editUser