Golang 标准库log的实现
前一篇文章我们看到了Golang标准库中log模块的使用,那么它是如何实现的呢?下面我从log.Logger开始逐步分析其实现。 其源码可以参考官方地址
1.Logger结构
首先来看下类型Logger的定义:
1
2
3
4
5
6
7
|
type Logger struct {
mu sync.Mutex // ensures atomic writes; protects the following fields
prefix string // prefix to write at beginning of each line
flag int // properties
out io.Writer // destination for output
buf []byte // for accumulating text to write
}
|
主要有5个成员,其中3个我们比较熟悉,分别是表示Log前缀的 "prefix",表示Log头标签的 "flag" ,以及Log的输出目的地out。 buf是一个字节数组,主要用来存放即将刷入out的内容,相当于一个临时缓存,在对输出内容进行序列化时作为存储目的地。 mu是一个mutex主要用来作线程安全的实习,当有多个goroutine同时往一个目的刷内容的时候,通过mutex保证每次写入是一条完整的信息。
2.std及整体结构
在前一篇文章中我们提到了log模块提供了一套包级别的简单接口,使用该接口可以直接将日志内容打印到标准错误。那么该过程是怎么实现的呢?其实就是通过一个内置的Logger类型的变量 "std" 来实现的。该变量使用:
1
|
var std = New(os.Stderr, "" , LstdFlags)
|
进行初始化,默认输出到系统的标准输出 "os.Stderr" ,前缀为空,使用日期加时间作为Log抬头。
当我们调用 log.Print的时候是怎么执行的呢?我们看其代码:
1
2
3
|
func Print(v ... interface {}) {
std.Output( 2 , fmt.Sprint(v...))
}
|
这里实际就是调用了Logger对象的 Output方法,将日志内容按照fmt包中约定的格式转义后传给Output。Output定义如下 :
1
|
func (l *Logger) Output(calldepth int , s string) error
|
其中s为日志没有加前缀和Log抬头的具体内容,xxxxx 。该函数执行具体的将日志刷入到对应的位置。
3.核心函数的实现
Logger.Output是执行具体的将日志刷入到对应位置的方法。
该方法首先根据需要获得当前时间和调用该方法的文件及行号信息。然后调用formatHeader方法将Log的前缀和Log抬头先格式化好 放入Logger.buf中,然后再将Log的内容存入到Logger.buf中,最后调用Logger.out.Write方法将完整的日志写入到输出目的地中。
由于写入文件以及拼接buf的过程是线程非安全的,因此使用mutex保证每次写入的原子性。
1
2
|
l.mu.Lock()
defer l.mu.Unlock()
|
将buf的拼接和文件的写入放入这个后面,使得在多个goroutine使用同一个Logger对象是,不会弄乱buf,也不会杂糅的写入。
该方法的第一个参数最终会传递给runtime.Caller的skip,指的是跳过的栈的深度。这里我记住给2就可以了。这样就会得到我们调用log 是所处的位置。
在golang的注释中说锁住 runtime.Caller的过程比较重,这点我还是不很了解,只是从代码中看到其在这里把锁打开了。
1
2
3
4
5
6
7
8
9
10
11
|
if l.flag&(Lshortfile|Llongfile) != 0 {
// release lock while getting caller info - it's expensive.
l.mu.Unlock()
var ok bool
_, file, line, ok = runtime.Caller(calldepth)
if !ok {
file = "???"
line = 0
}
l.mu.Lock()
}
|
在formatHeader里面首先将前缀直接复制到Logger.buf中,然后根据flag选择Log抬头的内容,这里用到了一个log模块实现的 itoa的方法,作用类似c的itoa,将一个整数转换成一个字符串。只是其转换后将结果直接追加到了buf的尾部。
纵观整个实现,最值得学习的就是线程安全的部分。在什么位置合适做怎样的同步操作。
4.对外接口的实现
在了解了核心格式化和输出结构后,在看其封装就非常简单了,几乎都是首先用Output进行日志的记录,然后在必要的时候 做os.exit或者panic的操作,这里看下Fatal的实现。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
func (l *Logger) Fatal(v ... interface {}) {
l.Output( 2 , fmt.Sprint(v...))
os.Exit( 1 )
}
// Fatalf is equivalent to l.Printf() followed by a call to os.Exit(1).
func (l *Logger) Fatalf(format string, v ... interface {}) {
l.Output( 2 , fmt.Sprintf(format, v...))
os.Exit( 1 )
}
// Fatalln is equivalent to l.Println() followed by a call to os.Exit(1).
func (l *Logger) Fatalln(v ... interface {}) {
l.Output( 2 , fmt.Sprintln(v...))
os.Exit( 1 )
}
|
这里也验证了我们之前做的Panic的结果,先做输出日志操作。再进行panic。
5.Golang的log模块设计
Golang的log模块主要提供了三类接口 :
Print : 一般的消息输出
Fatal : 类似assert一般的强行退出
Panic : 相当于OO里面常用的异常捕获
与其说log模块提供了三类日志接口,不如说log模块仅仅是对类C中的 printf、assert、try...catch...的简单封装。Golang的log模块 并没有对log进行分类、分级、过滤等其他类似log4j、log4c、zlog当中常见的概念。当然在使用中你可以通过添加prefix,来进行简单的 分级,或者改变Logger.out改变其输出位置。但这些并没有在API层面给出直观的接口。
Golang的log模块就像是其目前仅专注于为服务器编程一样,他的log模块也专注于服务器尤其是基础组件而服务。就像nginx、redis、lighttpd、keepalived自己为自己写了一个简单的日志模块而没有实现log4c那样庞大且复杂的日志模块一样。他的日志模块仅仅需要为 本服务按照需要的格式和方式提供接口将日志输出到目的地即可。
Golang的log模块可以进行一般的信息记录,assert时的信息输出,以及出现异常时的日志记录,通过对其Print的包装可以实现更复杂的 输出。因此这个log模块可谓是语言层面上非常基础的一层库,反应的是语言本身的特征而不是一个服务应该怎样怎样。
本文出自 “Done_in_72_hours” 博客,请务必保留此出处http://gotaly.blog.51cto.com/8861157/1406905
转载于:https://www.cnblogs.com/lvdongjie/p/6511029.html
Golang 标准库log的实现相关推荐
- Go语言自学系列 | golang标准库log
视频来源:B站<golang入门到项目实战 [2021最新Go语言教程,没有废话,纯干货!持续更新中...]> 一边学习一边整理老师的课程内容及试验笔记,并与大家分享,侵权即删,谢谢支持! ...
- Go语言学习笔记—golang标准库log包
文章目录 一 log简介 二 log简单使用 2.1 log.Print/Println/Printf函数 2.2 log.Panic/Panicf/Panicln函数 2.3 log.Fatal/F ...
- golang 标准库间依赖的可视化展示
简介 国庆看完 << Go 语言圣经 >>,总想做点什么,来加深下印象.以可视化的方式展示 golang 标准库之间的依赖,可能是一个比较好的切入点.做之前,简单搜了下相关的内 ...
- Golang标准库RPC实践及改进
转载自:http://daizuozhuo.github.io/golang-rpc-practice/ 一直用Golang标准库里的的RPC package来进行远程调用,简单好用. 但是随着任务数 ...
- Go 标准库: log
原文链接 http://ironxu.com/775 本文介绍Go 标准库 log 的常用导出函数,结构体及方法. log 包实现了简单的日志服务,log 包定义了Logger类型,该类型提供了一些格 ...
- Golang标准库CHM格式文档
上手Go后,想熟悉golang标准库来做一些项目.在学习和使用golang标准库的时候,发现golang标准库文档不太友好.主要是导航区域和内容区域无法同屏浏览,在包和包间.包内不同对象间来回切换 ...
- Go语言常用标准库——log、net_http、strconv、time包
文章目录 log 使用Logger 配置logger 标准logger的配置 flag选项 配置日志前缀 配置日志输出位置 创建logger 总结 net_http net/http介绍 HTTP协议 ...
- golang标准库os模块-文件目录相关
golang标准库os模块-文件目录相关 本文视频教程:https://www.bilibili.com/video/BV1zR4y1t7Wj?from=search&seid=7990946 ...
- Golang标准库-syscall(什么是系统调用/Go 语言中的系统调用)
文章目录 一.什么是系统调用 二.Golang标准库-syscall 1. syscall无处不在 2. syscall demo举例: go版本的strace Strace go版本的strace ...
最新文章
- Java awt Desktop 无法调用系统浏览器
- minecraft正版整合包服务器,我的世界1.7.2基佬整合包
- python调用父类构造函数需要放在第一句吗_Python继承和调用父类构造函数
- mysql 索引 lt =_MySQL索引相关
- centOS 6 和centOS 7 防火墙指令
- 推销自己的前端技术书籍
- OpenvSwitch架构
- document.body和document.documentElement的区别
- 1046 划拳 (15 分)—PAT (Basic Level) Practice (中文)
- 使用docker-compose 大杀器来部署服务 上(转)
- qi无线充电协议_iOS 13.1封杀第三方无线快充:疑似苹果无线充电私有协议来了...
- new InputStream().available()方法的讲解
- C语言--求一元二次方程的根(分支)
- [转载]使用 Apache Geronimo 和 JMS 构建事件驱动的框架
- qimgv(图片视频浏览器)-小工具
- 角色攻击、角色特殊动作
- 正则系列2: re.search用法
- 输出一个 n 阶的方阵
- 回答离职原因的6条法则
- 2008/09赛季德甲第九轮 拜仁慕尼黑 vs 沃尔夫斯堡
热门文章
- Android自动化测试之monkeyrunner基本要素(七)
- 数学图形(2.7)sphere sine wave
- 2011.5.21信息系统项目管理师考试案例关注点
- 安装Exchange2003时出0XC1037AE6错误的解决方法.
- SQL Server 2005数据库日志文件损坏的情况下如何恢复数据库
- DrawerLayout + Toolbar + ViewPager
- Libnids库-网络入侵检测的基础框架
- 分数阶累加的Python实现
- Activity中加载器的总结
- explain 之 select_type