## 使用包级全局变量
在前面的章节中,我们使用的log都是包级别的变量。有时,构建库以支持具有各种方法和顶级函数的结构是有用的,这样就可以直接使用它们而无需传递。
本节演示了如何使用sync.Once确保全局日志logger仅初始化一次。它也可以通过Set方法绕过。示例中只导出WithField和Debug,但对于你可以想象到的其他附加到日志对象的每个方法也适用。
### 实践
1. 获取第三方库:
```
go get github.com/apex/log
```
2. 建立global.go:
```
package global
import (
"errors"
"os"
"sync"
"github.com/sirupsen/logrus"
)
var (
log *logrus.Logger
initLog sync.Once
)
// Init设置logger 如果多次初始化 会返回错误
func Init() error {
err := errors.New("already initialized")
initLog.Do(func() {
err = nil
log = logrus.New()
log.Formatter = &logrus.JSONFormatter{}
log.Out = os.Stdout
log.Level = logrus.DebugLevel
})
return err
}
// SetLog 设置log
func SetLog(l *logrus.Logger) {
log = l
}
// WithField 使用全局log返回logrus.Entry指针
func WithField(key string, value interface{}) *logrus.Entry {
return log.WithField(key, value)
}
// Debug 使用全局log记录信息
func Debug(args ...interface{}) {
log.Debug(args...)
}
```
3. 建立log.go:
```
package global
// UseLog 演示了使用全局 log
func UseLog() error {
if err := Init(); err != nil {
return err
}
// 如果在其他包 应该调用global.WithField 和 global.Debug
WithField("key", "value").Debug("hello")
Debug("test")
return nil
}
```
4. 建立main.go:
```
package main
import "github.com/agtorre/go-cookbook/chapter4/global"
func main() {
if err := global.UseLog(); err != nil {
panic(err)
}
}
```
5. 这会输出:
```
{"key":"value","level":"debug","msg":"hello","time":"2017-02-
12T19:22:50-08:00"}
{"level":"debug","msg":"test","time":"2017-02-12T19:22:50-
08:00"}
```
### 说明
这些全局包级对象的常见模式是保持全局未导出,并仅通过方法公开所需的功能。 通常,你还可以包含一个方法,以便为需要调用对象的包返回该对象的副本。
sync.Once类型是新引入的结构。这个结构与Do方法一起只在代码中执行一次。我们在初始化代码中使用它,如果多次调用Init,Init函数将抛出一个错误。
虽然此示例使用的是日志操作,但同样也可以想象为对数据库连接,数据流和许多常见用例的使用。
* * * *
学识浅薄,错误在所难免。欢迎在群中就本书提出修改意见,以飨后来者,长风拜谢。
Golang中国(211938256)
beego实战(258969317)
Go实践(386056972)
- 前言
- 第一章 I/O和文件系统
- 常见 I/O 接口
- 使用bytes和strings包
- 操作文件夹和文件
- 使用CSV格式化数据
- 操作临时文件
- 使用 text/template和HTML/templates包
- 第二章 命令行工具
- 解析命令行flag标识
- 解析命令行参数
- 读取和设置环境变量
- 操作TOML,YAML和JSON配置文件
- 操做Unix系统下的pipe管道
- 处理信号量
- ANSI命令行着色
- 第三章 数据类型转换和解析
- 数据类型和接口转换
- 使用math包和math/big包处理数字类型
- 货币转换和float64注意事项
- 使用指针和SQL Null类型进行编码和解码
- 对Go数据编码和解码
- Go中的结构体标签和反射
- 通过闭包实现集合操作
- 第四章 错误处理
- 错误接口
- 使用第三方errors包
- 使用log包记录错误
- 结构化日志记录
- 使用context包进行日志记录
- 使用包级全局变量
- 处理恐慌
- 第五章 数据存储
- 使用database/sql包操作MySQL
- 执行数据库事务接口
- SQL的连接池速率限制和超时
- 操作Redis
- 操作MongoDB
- 创建存储接口以实现数据可移植性
- 第六章 Web客户端和APIs
- 使用http.Client
- 调用REST API
- 并发操作客户端请求
- 使用OAuth2
- 实现OAuth2令牌存储接口
- 封装http请求客户端
- 理解GRPC的使用
- 第七章 网络服务
- 处理Web请求
- 使用闭包进行状态处理
- 请求参数验证
- 内容渲染
- 使用中间件
- 构建反向代理
- 将GRPC导出为JSON API
- 第八章 测试
- 使用标准库进行模拟
- 使用Mockgen包
- 使用表驱动测试
- 使用第三方测试工具
- 模糊测试
- 行为驱动测试
- 第九章 并发和并行
- 第十章 分布式系统
- 第十一章 响应式编程和数据流
- 第十二章 无服务器编程
- 第十三章 性能改进