项目中被初始化的全局变量清单介绍

1.前言

1.程序启动时初始化动作统一由 bootstrap/init.go 文件中的代码段负责，本次我们将介绍3个常用的全局变量.
2.全局变量只会使用法简洁化, 不对原始语法造成任何破坏, 封装全局变量时我们经过谨慎地评估、测试相关代码段、从而保证并发安全性.

2.gorm 全局变量

1.请按照配置文件 congfig/gorm_v2.yml 中的提示正确配置数据库，开启程序启动初始化数据库参数,程序在启动时会自动为您初始化全局变量.
2.不同类型的数据库全局变量名不一样, 对照关系参见以下代码段说明.
3.本文档我们主要介绍 gorm 全局变量初始化的核心.

  2. //  例如：原始语法,我们以 mysql 驱动的初始化为例进行说明
  3. // 1.连接数据库,获取mysql连接
  4.  dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
  5.  mysqlDb, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})  
  7. // 2.查询
  8. db.Select("id", "name", "phone", "email", "remark").Where("name  like ?", "%test%").Find(&users)
  11. // 本项目中, `variable.GormDbMysql` 完全等于上文中返回的 mysqlDb
  12. variable.GormDbMysql.Select("id", "name", "phone", "email", "remark").Where("name  like ?", "%test%").Find(&users)
  14. // gorm 数据库驱动与本项目骨架对照关系
  15. variable.GormDbMysql       <====完全等于==>      gorm.Open(mysql.Open(dsn), &gorm.Config{})    
  16. variable.GormDbSqlserver   <====完全等于==>      gorm.Open(sqlserver.Open(dsn), &gorm.Config{})    
  17. variable.GormDbPostgreSql  <====完全等于==>      gorm.Open(postgres.Open(dsn), &gorm.Config{})

3.日志全局变量

1.为了随意、方便地记录项目中日志，我们封装了全局变量 variable.ZapLog .
2.由于日志操作内容比较多，我们对它进行了单独介绍，详情参见： zap高性能日志

4.配置文件全局变量

1.为了更方便地操作配置文件 config/config.yml 、 config/gorm_v2.yml 我们同样在项目启动时封装了全局变量.
2.variable.ConfigYml ,该变量相当于配置文件 config/config.yml 文件打开后的指针.
3.variable.ConfigGormv2Yml ,该变量相当于配置文件 config/gorm_v2.yml 文件打开后的指针.
4.在任何地方您都可以使用以上全局变量直接获取对应配置文件的 键==>值.

  2. // 获取 config/config.yml 文件中 Websocket.Start 对应的 Int 值
  3. variable.ConfigYml.GetInt("Websocket.Start")
  5. // 获取 config/gorm_v2.yml 文件中 Gormv2.Mysql.IsInitGolobalGormMysql 对应的 Int 值
  6. variable.ConfigGormv2Yml.GetInt("Gormv2.Mysql.IsInitGolobalGormMysql")

5.获取配置文件中键对应的值数据类型，函数清单，您可以使用 variable.ConfigYml. 或者 variable.ConfigGormv2Yml. 以下函数名 获取值

  1.     // 开发者常用函数
  2.     GetString(keyName string) string
  3.     GetInt(keyName string) int
  4.     GetInt32(keyName string) int32
  5.     GetInt64(keyName string) int64
  6.     GetFloat64(keyName string) float64
  7.     GetDuration(keyName string) time.Duration
  8.     GetBool(keyName string) bool
  10.     // 非常用函数，主要是项目骨架在使用
  11.     ConfigFileChangeListen()
  12.     Clone(fileName string) YmlConfigInterf
  13.     Get(keyName string) interface{} // 该函数获取一个 键 对应的原始值，因此返回类型为 interface , 基本很少用
  14.     GetStringSlice(keyName string) []string

5.雪花算法(snowflake)生成唯一ID

1.相关配置 config>config.yml 配置项 SnowFlakeMachineId , 如果本项目同时部署在多台机器，并且需要同时使用该算法，请为每一台机器设置不同的ID，区间范围: [0,1023]
2.随时随地，您可以非常方便的获取一个唯一ID
3.更多详情参见: SnowFlake单元测试

  2. # 雪花算法生成的全局唯一ID数据类型为 int64
  3. variable.SnowFlake.GetId()