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

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

###  2.gorm 全局变量   
>   1.请按照配置文件 `congfig/gorm_v2.yml` 中的提示正确配置数据库，开启程序启动初始化数据库参数,程序在启动时会自动为您初始化全局变量.  
>   2.不同类型的数据库全局变量名不一样, 对照关系参见以下代码段说明.    
>   3.更多用法参见单元测试：[gorm_v2单元测试](../test/gormv2_test.go).  
>   4.本文档我们主要介绍 gorm 全局变量初始化的核心.        
```code 

//  例如：原始语法,我们以 mysql 驱动的初始化为例进行说明
// 1.连接数据库,获取mysql连接
 dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
 mysqlDb, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})  

// 2.查询
db.Select("id", "name", "phone", "email", "remark").Where("name  like ?", "%test%").Find(&users)


// 本项目中, `variable.GormDbMysql` 完全等于上文中返回的 mysqlDb
variable.GormDbMysql.Select("id", "name", "phone", "email", "remark").Where("name  like ?", "%test%").Find(&users)

// gorm 数据库驱动与本项目骨架对照关系
variable.GormDbMysql       <====完全等于==>      gorm.Open(mysql.Open(dsn), &gorm.Config{})    
variable.GormDbSqlserver   <====完全等于==>      gorm.Open(sqlserver.Open(dsn), &gorm.Config{})    
variable.GormDbPostgreSql  <====完全等于==>      gorm.Open(postgres.Open(dsn), &gorm.Config{})   
```


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


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

// 获取 config/config.yml 文件中 Websocket.Start 对应的 Int 值
variable.ConfigYml.GetInt("Websocket.Start")

// 获取 config/gorm_v2.yml 文件中 Gormv2.Mysql.IsInitGlobalGormMysql 对应的 Int 值
variable.ConfigGormv2Yml.GetInt("Gormv2.Mysql.IsInitGlobalGormMysql")

```
>   5.获取配置文件中键对应的值数据类型，函数清单，您可以使用 `variable.ConfigYml.` 或者  `variable.ConfigGormv2Yml.` 以下函数名 获取值   
```code  
    // 开发者常用函数
	GetString(keyName string) string
	GetInt(keyName string) int
	GetInt32(keyName string) int32
	GetInt64(keyName string) int64
	GetFloat64(keyName string) float64
	GetDuration(keyName string) time.Duration
	GetBool(keyName string) bool

    // 非常用函数，主要是项目骨架在使用
	ConfigFileChangeListen()
	Clone(fileName string) YmlConfigInterf
	Get(keyName string) interface{} // 该函数获取一个 键 对应的原始值，因此返回类型为 interface , 基本很少用
	GetStringSlice(keyName string) []string
```

###  5.雪花算法(snowflake)生成分布式场景唯一ID 
>   1.相关配置 ` config>config.yml` 配置项 `SnowFlakeMachineId` , 如果本项目同时部署在多台机器，并且需要同时使用该算法，请为每一台机器设置不同的ID，区间范围: [0,1023]  
>   2.随时随地，您可以非常方便的获取一个分布式场景的唯一ID  
>   3.更多详情参见: [SnowFlake单元测试](../test/snowflake_test.go)  
```code  

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

```
