11. 搭建较通用的GoWeb开发脚手架

2024-03-10 06:12
文章标签 通用 开发 搭建 脚手架 goweb

本文主要是介绍11. 搭建较通用的GoWeb开发脚手架，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

  • 导言
  • 一、加载配置
  • 二、初始化日志
  • 三、初始化MySQL连接
  • 四、初始化Redis连接
  • 五、初始化gin框架内置的校验器使用的翻译器
  • 六、注册路由
  • 七、 启动服务
  • 八、测试运行
  • 九：注意事项

代码地址：https://gitee.com/lymgoforIT/bluebell

导言

有了前述知识的基础后，我们便可以开始搭建基本脚手架了。

脚手架应该包含如下信息：

  1. 较好的代码管理、即清晰的目录结构，层次分明。
  2. 配置文件管理和加载。
  3. 日志组件初始化和加载。
  4. Redis初始化和加载。
  5. MySQL初始化和加载。
  6. 路由拆分管理。
  7. 中间件使用。
  8. 服务启动。

有了脚手架之后，后续的CRUD就比较简单啦。

本文完成后总体目录结构如下
在这里插入图片描述
注意：我们主要关注的是后端逻辑，所以涉及前端的static和templates两个目录没有过多介绍，可以直接从代码仓库获取即可。

最关键的是main文件，毕竟它是整个程序的入口，我们的main文件应该足够清晰，让人一眼就能看出做了哪些事情，大致结构如下：

package mainfunc main() {// 1. 加载配置// 2. 初始化日志// 3. 初始化MySQL连接// 4. 初始化Redis连接// 5. 初始化gin框架内置的校验器使用的翻译器// 6. 注册路由// 7. 启动服务（优雅关机和重启）
}

一、加载配置

首先我们应该定义一个config.yaml配置文件，将相关配置写到里面

config/config.yaml

name: "bluebell"
mode: "release"
port: 8084
version: "v0.0.1"log:level: "info"filename: "web_app.log"max_size: 200max_age: 30max_backups: 7mysql:host: "127.0.0.1"port: 3306user: "root"password: "root"dbname: "bluebell"max_open_conns: 200max_idle_conns: 50redis:host: "127.0.0.1"port: 6379password: ""db: 0pool_size: 100

由于我们后续是要将配置加载到一个全局结构体对象中，然后各个地方使用这个全局变量读取配置的，所以很自然的想到，我们应该定义对应的配置结构体，并提供一个全局变量以及相应的初始化函数。

setting/setting.go

package settingimport ("fmt""github.com/fsnotify/fsnotify""github.com/spf13/viper"
)var Conf = new(AppConfig)type AppConfig struct {Name    string `mapstructure:"name"`Mode    string `mapstructure:"mode"`Version string `mapstructure:"version"`Port    int    `mapstructure:"port"`*LogConfig   `mapstructure:"log"`*MySQLConfig `mapstructure:"mysql"`*RedisConfig `mapstructure:"redis"`
}type LogConfig struct {Level      string `mapstructure:"level"`Filename   string `mapstructure:"filename"`MaxSize    int    `mapstructure:"max_size"`MaxAge     int    `mapstructure:"max_age"`MaxBackups int    `mapstructure:"max_backups"`
}type MySQLConfig struct {Host         string `mapstructure:"host"`Port         int    `mapstructure:"port"`User         string `mapstructure:"user"`Password     string `mapstructure:"password"`DB           string `mapstructure:"dbname"`MaxOpenConns int    `mapstructure:"max_open_conns"`MaxIdleConns int    `mapstructure:"max_idle_conns"`
}type RedisConfig struct {Host         string `mapstructure:"host"`Port         int    `mapstructure:"port"`Password     string `mapstructure:"password"`DB           int    `mapstructure:"db"`PoolSize     int    `mapstructure:"pool_size"`MinIdleConns int    `mapstructure:"min_idle_conns"`
}func Init(filePath string) (err error) {// 方式1：直接指定配置文件路径（相对路径或者绝对路径）// 相对路径：相对执行的可执行文件的相对路径//viper.SetConfigFile("./conf/config.yaml")// 绝对路径：系统中实际的文件路径//viper.SetConfigFile("/Users/liwenzhou/Desktop/bluebell/conf/config.yaml")// 方式2：指定配置文件名和配置文件的位置，viper自行查找可用的配置文件// 配置文件名不需要带后缀// 配置文件位置可配置多个//viper.SetConfigName("config") // 指定配置文件名（不带后缀）//viper.AddConfigPath(".") // 指定查找配置文件的路径（这里使用相对路径）//viper.AddConfigPath("./conf")      // 指定查找配置文件的路径（这里使用相对路径）// 基本上是配合远程配置中心使用的，告诉viper当前的数据使用什么格式去解析//viper.SetConfigType("json")viper.SetConfigFile(filePath)err = viper.ReadInConfig() // 读取配置信息到viper中if err != nil {fmt.Printf("viper.ReadInconfig failed,err:%v\n", err)return}// 把读取到的配置信息反序列化到 Conf 全局变量中if err := viper.Unmarshal(Conf); err != nil {fmt.Printf("viper.Unmarshal failed,err:%v\n", err)}viper.WatchConfig()viper.OnConfigChange(func(in fsnotify.Event) {fmt.Println("配置文件修改了")if err := viper.Unmarshal(Conf); err != nil {fmt.Printf("viper.Unmarshal failed,err:%v\n", err)}})return
}

二、初始化日志

我们该项目使用之前介绍的Zap作为日志组件，并会仿照Gin中的Logger和Recovery中间件，写自己的中间件替换掉Gin自带的。如下

logger/logger.go

package loggerimport ("bluebell/setting""net""net/http""net/http/httputil""os""runtime/debug""strings""time""github.com/gin-gonic/gin""github.com/natefinch/lumberjack""go.uber.org/zap""go.uber.org/zap/zapcore"
)var lg *zap.Logger// Init 初始化lg
func Init(cfg *setting.LogConfig, mode string) (err error) {writeSyncer := getLogWriter(cfg.Filename, cfg.MaxSize, cfg.MaxBackups, cfg.MaxAge)encoder := getEncoder()var l = new(zapcore.Level)err = l.UnmarshalText([]byte(cfg.Level))if err != nil {return}var core zapcore.Coreif mode == "dev" {// 进入开发模式，日志输出到终端consoleEncoder := zapcore.NewConsoleEncoder(zap.NewDevelopmentEncoderConfig())core = zapcore.NewTee(zapcore.NewCore(encoder, writeSyncer, l),zapcore.NewCore(consoleEncoder, zapcore.Lock(os.Stdout), zapcore.DebugLevel),)} else {core = zapcore.NewCore(encoder, writeSyncer, l)}lg = zap.New(core, zap.AddCaller())// 使用 lg 替换zap中的全局L，从而外部可以直接使用zap.L().Info记录日志，而不是logger.lg.Infozap.ReplaceGlobals(lg)zap.L().Info("init logger success")return
}func getEncoder() zapcore.Encoder {encoderConfig := zap.NewProductionEncoderConfig()encoderConfig.EncodeTime = zapcore.ISO8601TimeEncoderencoderConfig.TimeKey = "time"encoderConfig.EncodeLevel = zapcore.CapitalLevelEncoderencoderConfig.EncodeDuration = zapcore.SecondsDurationEncoderencoderConfig.EncodeCaller = zapcore.ShortCallerEncoderreturn zapcore.NewJSONEncoder(encoderConfig)
}func getLogWriter(filename string, maxSize, maxBackup, maxAge int) zapcore.WriteSyncer {lumberJackLogger := &lumberjack.Logger{Filename:   filename,MaxSize:    maxSize,MaxBackups: maxBackup,MaxAge:     maxAge,}return zapcore.AddSync(lumberJackLogger)
}// GinLogger 接收gin框架默认的日志
func GinLogger() gin.HandlerFunc {return func(c *gin.Context) {start := time.Now()path := c.Request.URL.Pathquery := c.Request.URL.RawQueryc.Next()cost := time.Since(start)lg.Info(path,zap.Int("status", c.Writer.Status()),zap.String("method", c.Request.Method),zap.String("path", path),zap.String("query", query),zap.String("ip", c.ClientIP()),zap.String("user-agent", c.Request.UserAgent()),zap.String("errors", c.Errors.ByType(gin.ErrorTypePrivate).String()),zap.Duration("cost", cost),)}
}// GinRecovery recover掉项目可能出现的panic，并使用zap记录相关日志
func GinRecovery(stack bool) gin.HandlerFunc {return func(c *gin.Context) {defer func() {if err := recover(); err != any(nil) {// Check for a broken connection, as it is not really a// condition that warrants a panic stack trace.var brokenPipe boolif ne, ok := any(err).(*net.OpError); ok {if se, ok := ne.Err.(*os.SyscallError); ok {if strings.Contains(strings.ToLower(se.Error()), "broken pipe") || strings.Contains(strings.ToLower(se.Error()), "connection reset by peer") {brokenPipe = true}}}httpRequest, _ := httputil.DumpRequest(c.Request, false)if brokenPipe {lg.Error(c.Request.URL.Path,zap.Any("error", err),zap.String("request", string(httpRequest)),)// If the connection is dead, we can't write a status to it.c.Error(any(err).(error)) // nolint: errcheckc.Abort()return}if stack {lg.Error("[Recovery from panic]",zap.Any("error", err),zap.String("request", string(httpRequest)),zap.String("stack", string(debug.Stack())),)} else {lg.Error("[Recovery from panic]",zap.Any("error", err),zap.String("request", string(httpRequest)),)}c.AbortWithStatus(http.StatusInternalServerError)}}()c.Next()}
}

三、初始化MySQL连接

使用Gorm，初始化代码如下

dao/mysql/mysql.go

package mysqlimport ("bluebell/setting""fmt""gorm.io/driver/mysql""gorm.io/gorm"
)var db *gorm.DBfunc Init(cfg *setting.MySQLConfig) (err error) {dsn := fmt.Sprintf("%s:%s@(%s:%d)/%s?charset=utf8mb4&parseTime=true&loc=Local", cfg.User, cfg.Password, cfg.Host, cfg.Port, cfg.DB)db, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})if err != nil {panic(any("failed to connect to db"))}sqlDB, err := db.DB()if err != nil {panic(any("create table err"))}// SetMaxIdleConns sets the maximum number of connections in the idle connection pool.sqlDB.SetMaxIdleConns(cfg.MaxIdleConns)// SetMaxOpenConns sets the maximum number of open connections to the database.sqlDB.SetMaxOpenConns(cfg.MaxOpenConns)return nil
}

四、初始化Redis连接

与初始化MySQL非常类似

dao/redis/redis.go

package redisimport ("bluebell/setting""fmt""github.com/go-redis/redis"
)
var (client * redis.ClientNil = redis.Nil
)func Init(cfg *setting.RedisConfig) (err error) {client = redis.NewClient(&redis.Options{Addr:         fmt.Sprintf("%s:%d", cfg.Host, cfg.Port),Password:     cfg.Password, // no password setDB:           cfg.DB,       // use default DBPoolSize:     cfg.PoolSize,MinIdleConns: cfg.MinIdleConns,})// 注：使用Val()不会返回错误，出错时返回零值，使用Result则可以根据返回的error判断是否出错了_, err = client.Ping().Result()if err != nil {fmt.Println("init redis failed")return err}return nil 
}

五、初始化gin框架内置的校验器使用的翻译器

由于我们会使用validator组件进行gin的参数校验，所以为了错误提示信息更为友好，需要初始化翻译器。
controller/validator.go

package controllerimport ("bluebell/models""fmt""reflect""strings""github.com/gin-gonic/gin/binding""github.com/go-playground/locales/en""github.com/go-playground/locales/zh"ut "github.com/go-playground/universal-translator""github.com/go-playground/validator/v10"enTranslations "github.com/go-playground/validator/v10/translations/en"zhTranslations "github.com/go-playground/validator/v10/translations/zh"
)// 定义一个全局翻译器T
var trans ut.Translator// InitTrans 初始化翻译器
func InitTrans(locale string) (err error) {// 修改gin框架中的Validator引擎属性，实现自定制if v, ok := binding.Validator.Engine().(*validator.Validate); ok {// 注册一个获取json tag的自定义方法v.RegisterTagNameFunc(func(fld reflect.StructField) string {name := strings.SplitN(fld.Tag.Get("json"), ",", 2)[0]if name == "-" {return ""}return name})// 为SignUpParam注册自定义校验方法v.RegisterStructValidation(SignUpParamStructLevelValidation, models.ParamSignUp{})zhT := zh.New() // 中文翻译器enT := en.New() // 英文翻译器// 第一个参数是备用（fallback）的语言环境// 后面的参数是应该支持的语言环境（支持多个）// uni := ut.New(zhT, zhT) 也是可以的uni := ut.New(enT, zhT, enT)// locale 通常取决于 http 请求头的 'Accept-Language'var ok bool// 也可以使用 uni.FindTranslator(...) 传入多个locale进行查找trans, ok = uni.GetTranslator(locale)if !ok {return fmt.Errorf("uni.GetTranslator(%s) failed", locale)}// 注册翻译器switch locale {case "en":err = enTranslations.RegisterDefaultTranslations(v, trans)case "zh":err = zhTranslations.RegisterDefaultTranslations(v, trans)default:err = enTranslations.RegisterDefaultTranslations(v, trans)}return}return
}// removeTopStruct 去除提示信息中的结构体名称
func removeTopStruct(fields map[string]string) map[string]string {res := map[string]string{}for field, err := range fields {res[field[strings.Index(field, ".")+1:]] = err}return res
}// SignUpParamStructLevelValidation 自定义SignUpParam结构体校验函数
func SignUpParamStructLevelValidation(sl validator.StructLevel) {su := sl.Current().Interface().(models.ParamSignUp)if su.Password != su.RePassword {// 输出错误提示信息，最后一个参数就是传递的paramsl.ReportError(su.RePassword, "re_password", "RePassword", "eqfield", "password")}
}

其中我们为注册参数ParamSignUp校验做了自定义校验，用到了注册参数，所以这里也把model定义一下。

models/params.go

package models// ParamSignUp 注册请求参数
type ParamSignUp struct {Username   string `json:"username" binding:"required"`Password   string `json:"password" binding:"required"`RePassword string `json:"re_password" binding:"required,eqfield=Password"`
}

六、注册路由

注册路由用到了我们之前介绍的路由拆分和管理技巧。

package routerimport ("bluebell/logger""net/http""github.com/gin-gonic/gin"
)func SetupRouter(mode string) *gin.Engine {if mode == gin.ReleaseMode {gin.SetMode(gin.ReleaseMode) // gin 设置成发布模式}r := gin.New()// 使用我们自定义的两个中间件r.Use(logger.GinLogger(), logger.GinRecovery(true))// 加载首页html文件r.LoadHTMLFiles("./templates/index.html")// 加载静态文件r.Static("/static", "./static")r.GET("/ping", func(c *gin.Context) {c.String(http.StatusOK, "pong")})r.GET("/", func(c *gin.Context) {c.HTML(http.StatusOK, "index.html", nil)})r.NoRoute(func(c *gin.Context) {c.JSON(http.StatusOK, gin.H{"msg": "404",})})return r
}

七、 启动服务

main.go

package mainimport ("bluebell/controller""bluebell/dao/mysql""bluebell/dao/redis""bluebell/logger""bluebell/router""bluebell/setting""fmt""os"
)func main() {if len(os.Args) < 2 {fmt.Println("need config file. eg:bluebell config.yaml")return}// 1. 加载配置if err := setting.Init(os.Args[1]); err != nil {fmt.Printf("load config failed,err:%v\n", err)return}// 2. 初始化日志if err := logger.Init(setting.Conf.LogConfig, setting.Conf.Mode); err != nil {fmt.Printf("init logger failed,err:%v\n", err)return}// 3. 初始化MySQL连接if err := mysql.Init(setting.Conf.MySQLConfig); err != nil {fmt.Printf("init mysql failed,err:%v\n", err)}// 4. 初始化Redis连接if err := redis.Init(setting.Conf.RedisConfig); err != nil {fmt.Printf("init redis failed,err:%v\n", err)}// 5. 初始化gin框架内置的校验器使用的翻译器if err := controller.InitTrans("zh"); err != nil {fmt.Printf("init validator trans failed, err:%v\n", err)return}// 6. 注册路由r := router.SetupRouter(setting.Conf.Mode)// 7. 启动服务（优雅关机和重启）err := r.Run(fmt.Sprintf(":%d", setting.Conf.Port))if err != nil {fmt.Printf("run server failed, err:%v\n", err)return}
}

八、测试运行

运行前需要先保证MySQL中已经建立了对应的bluebell库，然后Redis服务端时开启的。

首先我们需要使用go build编译项目，在项目路径下执行go build即可，编译成功会出现一个可执行文件，如下
在这里插入图片描述

随后我们传入配置文件路径执行，可以看到启动后，没有报错且光标一直在闪烁，便是项目启动成功且在8084端口监听了（可通过Ctrl+C退出程序）。此外，我们也能看到产生了日志文件web_app.log
在这里插入图片描述
通过浏览器访问也成功了

在这里插入图片描述
还可以访问一下首页看看，访问成功！只是目前还没有业务数据，所以是一个非常简单的空页面而已。
在这里插入图片描述

九：注意事项

项目中我们使用了os.Args接收参数，实际也可以使用flag。那么为什么要运行时传配置文件路径，而不是直接在代码中用相对路径写死呢？

原因是项目运行时的基准目录，是以执行运行程序所在目录为准的，也就是说，编译后产生了.exe文件，我们如何放到了其他目录下去执行，代码中写死配置文件读取目录的话可能就读不到了，因为路径不对了。但是让用户自己指定目录，在执行时保证指定路径下配置文件存在，就可以正常执行。

这篇关于11. 搭建较通用的GoWeb开发脚手架的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/793309。

相关文章

这15个Vue指令，让你的项目开发爽到爆

这15个Vue指令，让你的项目开发爽到爆

1. V-Hotkey 仓库地址: github.com/Dafrok/v-ho… Demo: 戳这里 https://dafrok.github.io/v-hotkey 安装: npm install --save v-hotkey 这个指令可以给组件绑定一个或多个快捷键。你想要通过按下 Escape 键后隐藏某个组件，按住 Control 和回车键再显示它吗？小菜一碟： <template
阅读更多...
Hadoop企业开发案例调优场景

Hadoop企业开发案例调优场景

需求 （1）需求：从1G数据中，统计每个单词出现次数。服务器3台，每台配置4G内存，4核CPU，4线程。 （2）需求分析： 1G / 128m = 8个MapTask；1个ReduceTask；1个mrAppMaster 平均每个节点运行10个 / 3台 ≈ 3个任务（4    3    3） HDFS参数调优 （1）修改：hadoop-env.sh export HDFS_NAMENOD
阅读更多...
嵌入式QT开发：构建高效智能的嵌入式系统

嵌入式QT开发：构建高效智能的嵌入式系统

摘要： 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发，详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程，包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发，涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用，以及嵌入式 QT 与硬件设备的交互，包括输入输出设
阅读更多...
OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

1、简介 无感配网是指在设备联网过程中无需输入热点相关账号信息，即可快速实现设备配网，是一种兼顾高效性、可靠性和安全性的配网方式。 2、配网原理 2.1 通信原理 手机和智能设备之间的信息传递，利用特有的NAN协议实现。利用手机和智能设备之间的WiFi 感知订阅、发布能力，实现了数字管家应用和设备之间的发现。在完成设备间的认证和响应后，即可发送相关配网数据。同时还支持与常规Sof
阅读更多...
活用c4d官方开发文档查询代码

活用c4d官方开发文档查询代码

当你问AI助手比如豆包，如何用python禁止掉xpresso标签时候，它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来
阅读更多...
搭建Kafka+zookeeper集群调度

搭建Kafka+zookeeper集群调度

前言 硬件环境 172.18.0.5        kafkazk1        Kafka+zookeeper                Kafka Broker集群 172.18.0.6        kafkazk2        Kafka+zookeeper                Kafka Broker集群 172.18.0.7        kafkazk3
阅读更多...
【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站，手机流量可以访问IPV6网络的服务，为什么不在电脑搭建Home Assistant（hass），来控制你的设备呢？@智能家居 @万物互联
阅读更多...
Linux_kernel驱动开发11

Linux_kernel驱动开发11

一、改回nfs方式挂载根文件系统         在产品将要上线之前，需要制作不同类型格式的根文件系统         在产品研发阶段，我们还是需要使用nfs的方式挂载根文件系统         优点：可以直接在上位机中修改文件系统内容，延长EMMC的寿命         【1】重启上位机nfs服务         sudo service nfs-kernel-server resta
阅读更多...
【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

随着区块链技术的快速发展，越来越多的企业开始将其应用于实际业务中。然而，区块链技术的专业性使得其集成开发成为一项挑战。针对此，广东中创智慧科技有限公司基于国产开源联盟链 FISCO BCOS 推出了区块链集成开发平台。该平台基于区块链技术，提供一套全面的区块链开发工具和开发环境，支持开发者快速开发和部署区块链应用。此外，该平台还可以提供一套全面的区块链开发教程和文档，帮助开发者快速上手区块链开发。
阅读更多...
Vue3项目开发——新闻发布管理系统（六）

Vue3项目开发——新闻发布管理系统（六）

文章目录 八、首页设计开发1、页面设计2、登录访问拦截实现3、用户基本信息显示①封装用户基本信息获取接口②用户基本信息存储③用户基本信息调用④用户基本信息动态渲染 4、退出功能实现①注册点击事件②添加退出功能③数据清理 5、代码下载 八、首页设计开发 登录成功后，系统就进入了首页。接下来，也就进行首页的开发了。 1、页面设计 系统页面主要分为三部分，左侧为系统的菜单栏，右侧
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2