## 使用包級全局變量
在前面的章節中,我們使用的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包
- 使用表驅動測試
- 使用第三方測試工具
- 模糊測試
- 行為驅動測試
- 第九章 并發和并行
- 第十章 分布式系統
- 第十一章 響應式編程和數據流
- 第十二章 無服務器編程
- 第十三章 性能改進